《Claude Code 源码学习：如何设计一个强大的 AI Agent》
总目录
第一部分：全景视角（第 1–4 章）
| 章节 | 标题 | 文件 |
|---|---|---|
| 第 1 章 | 一次请求的完整旅程 | ch01.md |
| 第 2 章 | 架构分层与模块划分 | ch02.md |
| 第 3 章 | 核心设计原则 | ch03.md |
| 第 4 章 | 技术选型与权衡 | ch04.md |
第二部分：Agent 引擎——核心循环（第 5–9 章）
| 章节 | 标题 | 文件 |
|---|---|---|
| 第 5 章 | Agentic Loop——Agent 的心脏 | ch05.md |
| 第 6 章 | 流式响应架构 | ch06.md |
| 第 7 章 | 工具调度与并发执行 | ch07.md |
| 第 8 章 | Plan Mode——思考与行动的分离 | ch08.md |
| 第 9 章 | QueryEngine——查询编排器 | ch09.md |
第三部分：上下文管理——Agent 的记忆（第 10–13 章）
| 章节 | 标题 | 文件 |
|---|---|---|
| 第 10 章 | 上下文窗口——Agent 最稀缺的资源 | ch10.md |
| 第 11 章 | 上下文组装——给 Agent 看什么 | ch11.md |
| 第 12 章 | 上下文压缩与摘要（Compact） | ch12.md |
| 第 13 章 | 跨会话记忆（SessionMemory） | ch13.md |
第四部分：工具系统——Agent 的双手（第 14–19 章）
| 章节 | 标题 | 文件 |
|---|---|---|
| 第 14 章 | 工具架构——统一接口与注册表 | ch14.md |
| 第 15 章 | 文件操作工具的设计哲学 | ch15.md |
| 第 16 章 | Shell 执行——Agent 最危险的工具 | ch16.md |
| 第 17 章 | 搜索工具——让 Agent 找到信息 | ch17.md |
| 第 18 章 | 子 Agent 调度——AgentTool 与任务委派 | ch18.md |
| 第 19 章 | MCP——开放的工具协议 | ch19.md |
第五部分：权限与安全——Agent 的缰绳（第 20–23 章）
| 章节 | 标题 | 文件 |
|---|---|---|
| 第 20 章 | 权限模型——信任与控制 | ch20.md |
| 第 21 章 | 权限的运行时执行 | ch21.md |
| 第 22 章 | 沙箱——Agent 的活动围栏 | ch22.md |
| 第 23 章 | 安全设计总结——纵深防御 | ch23.md |
第六部分：多 Agent 协作（第 24–27 章）
| 章节 | 标题 | 文件 |
|---|---|---|
| 第 24 章 | Swarm——多 Agent 协调架构 | ch24.md |
| 第 25 章 | Worktree——并行工作流 | ch25.md |
| 第 26 章 | Teleport——远程协作 | ch26.md |
| 第 27 章 | 后台任务与异步执行 | ch27.md |
第七部分：状态管理（第 28–30 章）
| 章节 | 标题 | 文件 |
|---|---|---|
| 第 28 章 | 全局状态设计 | ch28.md |
| 第 29 章 | 状态变更与响应式更新 | ch29.md |
| 第 30 章 | 对话历史的持久化与恢复 | ch30.md |
第八部分：终端 UI 架构（第 31–34 章）
| 章节 | 标题 | 文件 |
|---|---|---|
| 第 31 章 | React 在终端——Ink 框架的设计 | ch31.md |
| 第 32 章 | 消息渲染——从 AI 输出到终端显示 | ch32.md |
| 第 33 章 | 输入系统——用户如何与 Agent 交互 | ch33.md |
| 第 34 章 | 虚拟滚动与渲染性能 | ch34.md |
第九部分：可扩展性架构（第 35–38 章）
| 章节 | 标题 | 文件 |
|---|---|---|
| 第 35 章 | 命令系统——可插拔的命令架构 | ch35.md |
| 第 36 章 | 插件系统——第三方扩展机制 | ch36.md |
| 第 37 章 | 技能系统（Skills） | ch37.md |
| 第 38 章 | Feature Flag 与渐进式发布 | ch38.md |
第十部分：系统韧性（第 39–42 章）
| 章节 | 标题 | 文件 |
|---|---|---|
| 第 39 章 | 错误处理与重试策略 | ch39.md |
| 第 40 章 | 成本控制与速率限制 | ch40.md |
| 第 41 章 | OAuth 与认证架构 | ch41.md |
| 第 42 章 | 可观测性——日志、遥测与诊断 | ch42.md |
第十一部分：启动与生命周期（第 43–44 章）
| 章节 | 标题 | 文件 |
|---|---|---|
| 第 43 章 | 启动流程——从命令行到 Agent 就绪 | ch43.md |
| 第 44 章 | 应用状态机——从引导到就绪 | ch44.md |
第十二部分：总结（第 45 章）
| 章节 | 标题 | 文件 |
|---|---|---|
| 第 45 章 | 架构模式总结与启示 | ch45.md |
全书统计
- 总章节数：45 章
- 分为：12 个部分
- 每章包含：架构分析、设计思想讲解、Mermaid 图表、源码引用
阅读建议
- 入门路径：从第一部分（第 1–4 章）开始，建立全景认知
- 核心必读：第 5 章（Agent 循环）、第 14 章（工具架构）、第 20 章（权限模型）
- 实践导向：第 45 章（总结）提炼了七个核心架构模式，适合快速回顾
- 按兴趣跳读：每个部分相对独立，可根据兴趣选择性阅读