第0节： 概要&学习路径

课程概述

深入分析 Claude Code 的源代码结构、架构设计和核心功能，帮助开发者理解 AI 辅助开发工具的实现原理，掌握构建智能开发助手的关键技术。

课程特点

• 深度源码分析：基于 Claude Code v2.1.88 版本源码，全面剖析其架构设计
• 技术原理讲解：详细解释核心概念和技术实现，包括 Agent 循环、工具系统、权限管理等
• 实战项目：通过构建自定义 AI 代理，应用所学知识
• 前瞻性分析：探讨未发布功能和未来发展方向

课程目录

学习目标

通过本课程的学习，你将能够：

1. 理解 AI 辅助开发工具的架构设计：掌握 Claude Code 的核心架构和组件关系
2. 掌握 Agent 系统的实现原理：理解 Agent 循环、消息处理和工具执行机制
3. 构建自定义 AI 代理：应用所学知识构建具有特定功能的 AI 代理
4. 分析和优化 AI 系统性能：了解上下文管理、压缩策略和性能优化技术
5. 预见 AI 辅助开发的未来趋势：了解 Claude Code 的未来发展方向和未发布功能

技术要求

• 编程语言：TypeScript、JavaScript 基础
• 开发环境：Node.js v18+、npm/yarn
• 工具链：Git、TypeScript 编译器
• API 访问：Anthropic API 密钥（用于实战项目）

学习方法

1. 按顺序学习：建议从第 1 节开始，逐步深入理解各个组件
2. 代码实践：结合源码阅读，尝试理解和修改核心组件
3. 项目实践：完成第 15 节的实战项目，构建自定义 AI 代理
4. 实验探索：尝试启用实验性功能，体验 Claude Code 的高级特性

学习路径

本课程设计为一个循序渐进的学习路径，从基础概念到高级功能，最后通过实战项目巩固所学知识。建议按照以下顺序学习：

第一阶段：基础架构（第 1-3 节）

• 第 1 节：项目概述与架构总览 - 了解项目背景和整体架构
• 第 2 节：核心 Agent 循环与 Query Engine - 理解代理的核心工作机制
• 第 3 节：工具系统设计与实现 - 掌握工具系统的设计和使用

第二阶段：安全与扩展（第 4-8 节）

• 第 4 节：权限系统与安全机制 - 了解安全设计和权限管理
• 第 5 节：子代理与多代理架构 - 掌握多代理协作机制
• 第 6 节：上下文管理与压缩系统 - 学习上下文优化技术
• 第 7 节：MCP 集成与扩展能力 - 了解扩展系统设计
• 第 8 节：Bridge 层与远程控制 - 掌握远程控制机制

第三阶段：高级功能（第 9-13 节）

• 第 9 节：会话持久化与状态管理 - 了解状态管理架构
• 第 10 节：特性标志与功能门控 - 掌握功能发布控制
• 第 11 节：遥测与隐私分析 - 了解数据收集和隐私保护
• 第 12 节：高级功能分析 - 卧底模式 - 探索高级安全功能
• 第 13 节：远程控制与紧急开关 - 掌握系统控制机制

第四阶段：未来与实践（第 14-15 节）

• 第 14 节：未来路线图与未发布功能 - 了解项目发展方向
• 第 15 节：实战项目 - 构建自定义 AI 代理 - 应用所学知识

第五阶段：高级专题（第 16-20 节）

• 第 16 节：用户界面与交互设计 - 前端组件架构和用户体验
• 第 17 节：错误处理与异常管理 - 全局错误处理和异常管理
• 第 18 节：性能优化策略 - 缓存、资源管理和性能优化
• 第 19 节：插件系统深度分析 - 插件架构和自定义插件开发
• 第 20 节：测试策略与质量保证 - 测试框架和质量保证体系

章节导航

第 1 节：项目概述与架构总览

• 主要内容：项目背景、架构概述、目录结构、技术栈
• 核心文件：
  • src/QueryEngine.ts - 核心查询引擎
  • src/main.tsx - 主入口文件
  • src/commands.ts - 命令定义

第 2 节：核心 Agent 循环与 Query Engine

• 主要内容：主代理循环、QueryEngine 设计、消息处理、流式响应
• 核心文件：
  • src/query.ts - 查询处理逻辑
  • src/QueryEngine.ts - 核心查询引擎
  • src/replLauncher.tsx - REPL 启动器

第 3 节：工具系统设计与实现

• 主要内容：工具接口、buildTool 工厂、工具注册、执行引擎
• 核心文件：
  • src/Tool.ts - 工具基类
  • src/tools.ts - 工具注册和管理
  • src/tools/ - 具体工具实现

第 4 节：权限系统与安全机制

• 主要内容：权限检查流程、规则引擎、交互式提示、安全边界
• 核心文件：
  • src/types/permissions.ts - 权限类型定义
  • src/utils/QueryGuard.ts - 查询守卫

第 5 节：子代理与多代理架构

• 主要内容：子代理类型、生成模式、通信机制、Swarm 模式
• 核心文件：
  • src/commands/agents/ - 代理相关命令
  • src/tools/AgentTool/ - 代理工具

第 6 节：上下文管理与压缩系统

• 主要内容：上下文窗口管理、压缩策略、性能优化
• 核心文件：
  • src/context.ts - 上下文管理
  • src/utils/analyzeContext.ts - 上下文分析

第 7 节：MCP 集成与扩展能力

• 主要内容：MCP 架构、连接管理、认证、工具注册
• 核心文件：
  • src/services/mcp/ - MCP 服务
  • src/tools/MCPTool/ - MCP 工具

第 8 节：Bridge 层与远程控制

• 主要内容：Bridge 架构、会话管理、远程控制机制、安全
• 核心文件：
  • src/bridge/ - Bridge 相关文件
  • src/bridge/bridgeMain.ts - Bridge 主逻辑

第 9 节：会话持久化与状态管理

• 主要内容：会话存储、恢复机制、状态管理架构、性能优化
• 核心文件：
  • src/state/ - 状态管理
  • src/history.ts - 历史记录管理

第 10 节：特性标志与功能门控

• 主要内容：编译时特性标志、运行时功能门、特性标志生命周期
• 核心文件：
  • src/constants/betas.ts - 特性标志定义
  • 各处使用特性标志的代码

第 11 节：遥测与隐私分析

• 主要内容：遥测架构、数据收集范围、隐私保护措施、用户选择
• 核心文件：
  • src/services/api/logging.ts - 日志记录
  • 遥测相关代码

第 12 节：高级功能分析 - 卧底模式

• 主要内容：卧底模式工作原理、触发条件、行为规范、伦理考虑
• 核心文件：
  • src/utils/undercover.ts - 卧底模式实现

第 13 节：远程控制与紧急开关

• 主要内容：远程控制架构、远程设置管理、紧急开关系统、安全机制
• 核心文件：
  • src/bridge/pollConfig.ts - 配置轮询
  • src/bridge/bridgeConfig.ts - Bridge 配置

第 14 节：未来路线图与未发布功能

• 主要内容：下一代模型 Numbat、KAIROS 自主代理模式、语音模式、未上线工具
• 核心文件：
  • src/constants/prompts.ts - 提示模板
  • src/utils/undercover.ts - 未发布模型信息
  • src/voice/ - 语音模式相关

第 15 节：实战项目 - 构建自定义 AI 代理

• 主要内容：基于 Claude Code 架构构建 DevAssistant 代理
• 项目结构：
  • dev-assistant/ - 项目目录
  • 完整的代理实现

第 16 节：用户界面与交互设计

• 主要内容：前端组件架构、用户体验设计、交互流程实现
• 核心文件：
  • src/components/ - 前端组件
  • src/ink/ - 终端 UI 库
  • src/hooks/ - 自定义 hooks

第 17 节：错误处理与异常管理

• 主要内容：全局错误处理、API 错误处理、工具执行错误处理
• 核心文件：
  • src/utils/errorHandler.ts - 错误处理工具
  • src/services/api/errors.ts - API 错误处理
  • src/utils/logger.ts - 日志系统

第 18 节：性能优化策略

• 主要内容：缓存机制、资源管理、并行处理、启动速度优化
• 核心文件：
  • src/utils/cache.ts - 缓存实现
  • src/utils/memoryManager.ts - 内存管理
  • src/utils/parallel.ts - 并行处理

第 19 节：插件系统深度分析

• 主要内容：插件架构、生命周期管理、插件 API、自定义插件开发
• 核心文件：
  • src/plugins/ - 插件系统
  • src/types/plugin.ts - 插件类型定义
  • src/skills/ - 内置插件

第 20 节：测试策略与质量保证

• 主要内容：测试框架、测试类型、持续集成、质量保证体系
• 核心文件：
  • jest.config.js - Jest 配置
  • playwright.config.ts - Playwright 配置
  • .eslintrc.js - ESLint 配置

实验环境设置

1. 克隆 Claude Code 源码

git clone 
cd claude-code
npm install

2. 配置环境变量

创建 .env 文件，添加以下内容：

ANTHROPIC_API_KEY=your_api_key_here

3. 构建和运行

# 构建项目
npm run build

# 运行 Claude Code
npm start

4. 启用实验性功能

# 启用语音模式
claude config set feature_flags.voice_mode true

# 启用 KAIROS 模式
claude config set feature_flags.kairos true

学习资源

官方文档

• Claude Code 官方文档
• Anthropic API 文档

技术博客

• Anthropic 官方博客
• AI 代理技术相关文章

社区资源

• GitHub 仓库
• Discord 社区

常见问题

Q: 如何获取 Anthropic API 密钥？

A: 访问 Anthropic 控制台 创建账号并获取 API 密钥。

Q: 课程内容基于哪个版本的 Claude Code？

A: 本课程基于 Claude Code v2.1.88 版本。

Q: 实战项目需要哪些依赖？

A: 实战项目需要 Node.js v18+、TypeScript v5+、Anthropic SDK 等依赖。

Q: 如何启用未发布的功能？

A: 通过设置对应的 feature flag 可以启用实验性功能，但请注意这些功能可能不稳定。

Q: 课程是否会随着 Claude Code 的更新而更新？

A: 是的，课程内容会定期更新以反映 Claude Code 的最新变化。