Claude Code 源码解析

Anthropic AI 编程智能体的架构、模式与内部实现 —— 基于 Source Maps 的逆向工程解析

在线阅读：claude-code-from-source.com

---

本仓库仅供教育学习使用。 它不包含 Claude Code 的任何源代码 —— 甚至连一行都没有。所有代码块均为原创伪代码，旨在阐述架构模式。其目的是帮助工程师理解生产环境下的 AI Agent 是如何构建的，而非为了复制或分发专有软件。

---

当 Anthropic 在 npm 上发布 Claude Code 时，其 .js.map Source Maps 文件中包含了完整的原始 TypeScript 代码。本书正是深入研究该架构的成果，我们将其中的模式、权衡方案和设计决策提炼为技术叙述，供每一位工程师参考学习。

全书共 7 部分，计 18 章。 相当于约 400 页的印刷版内容。

每一章都具备多维度的深度：适合技术负责人的叙述流程、适合实现者的深入剖析，以及每章结尾的 “如何应用” (Apply This) 部分，提炼出可供您直接迁移到自己系统中的通用模式。图表使用 Mermaid 绘制，可在 GitHub 上原生渲染。

---

本书受众

• 构建智能体系统的资深工程师 — 借鉴其中的模式，理解架构权衡，并在自己的技术栈中实现。
• 评估架构的技术领导者 — 跟随叙述流程，无需逐行阅读代码即可掌握核心。
• 任何对生产级 AI 工具底层原理感兴趣的开发者。

---

目录

第一部分：基础

在智能体思考之前，必须先建立起运行流程。

#	章节	你将学到
1	AI Agent 的架构	6 大核心抽象、数据流、权限系统、构建系统
2	极速启动 — 引导管道	5 阶段初始化、模块级 I/O 并行处理、信任边界
3	状态 — 双层架构	引导单例、AppState 存储、粘性锁、成本追踪
4	与 Claude 对话 — API 层	多提供商客户端、Prompt 缓存、流式传输、错误恢复

第二部分：核心循环

智能体的心跳：流式处理、行动、观察、循环往复。

#	章节	你将学到
5	智能体循环	query.ts 深度解析、4 层压缩、错误恢复、Token 预算
6	工具 — 从定义到执行	工具接口、14 步处理管道、权限系统
7	并发工具执行	分区算法、流式执行器、推测执行

第三部分：多智能体编排

单个智能体已足够强大，而多个智能体协同工作则具备变革性。

#	章节	你将学到
8	派生子智能体	AgentTool、15 步 runAgent 生命周期、内置智能体类型
9	分叉智能体与 Prompt 缓存	字节一致前缀技巧、缓存共享、成本优化
10	任务、协调与群体智能	任务状态机、协调器模式、群体消息传递

第四部分：持久化与智能

没有记忆的智能体只会重复犯同样的错误。

#	章节	你将学到
11	记忆 — 跨对话学习	基于文件的内存、4 种分类法、LLM 回溯、数据陈旧性
12	可扩展性 — 技能与钩子	两阶段技能加载、生命周期钩子、快照安全性

第五部分：接口

用户所见的一切都通过此层呈现。

#	章节	你将学到
13	终端 UI	自定义 Ink 分支、渲染管道、双缓冲、池化
14	输入与交互	键解析、快捷键绑定、和弦指令支持、Vim 模式

第六部分：连接性

智能体触达本地环境之外。

#	章节	你将学到
15	MCP — 通用工具协议	8 种传输方式、MCP 的 OAuth 认证、工具封装
16	远程控制与云端执行	Bridge v1/v2、CCR、上游代理

第七部分：性能工程

让一切运行得足够快，使人类感知不到机器的存在。

#	章节	你将学到
17	性能 — 每一毫秒与 Token 都至关重要	启动速度、上下文窗口、Prompt 缓存、渲染、搜索优化
18	结语 — 我们的收获	5 大架构博弈、可迁移经验、智能体的发展趋势