· Claude Code 源码解析 · 4 min read
拆解 Claude Code:逆向一个顶级 AI Agent 的架构与设计
基于 Claude Code v2.1.88 恢复源码快照,拆解其内部架构,提炼可复用的 Agent 工程模式。系列文章索引。
基于 Claude Code
v2.1.88恢复源码快照、当前仓库实现,以及官方公开文档/仓库交叉验证,拆解其内部架构,提炼可复用的 Agent 工程模式。
为什么是架构,不只是功能
市面上的 Claude Code 分析多数聚焦”它能做什么”。但真正的竞争壁垒不在模型能力——而在运行时工程:冷启动如何做到亚秒级、上下文窗口耗尽后如何无损压缩、多代理协作如何共享 Prompt Cache 降低 90% 成本、权限管线如何在 YOLO 模式下仍保证安全底线。这些是 51 万行代码中 99% 的内容,也是本系列要拆解和提炼的核心。
目标:不是复刻 Claude Code,而是从中提取可迁移到你自己 Agent 项目的工程模式。
资料口径
- 产品能力、公开术语和对外入口:以官方文档 Claude Code overview、How Claude Code works 和官方仓库 anthropics/claude-code 为准
- 实现细节、代码锚点和跟跑验证:以本仓库中的
v2.1.88-cjm恢复源码树为主 - 文中的“五层架构”“八类权限检查”等说法是为了讲解做的归纳,不是官方命名
系列文章
| 篇 | 标题 | 关键词 |
|---|---|---|
| 01 | 逆向一个顶级 Agent:Claude Code 的全景架构 | 逆向方法、技术栈、五层架构、环境搭建 |
| 02 | 让 LLM 安全地操作世界:工具引擎与权限管线 | Tool 体系、流式执行、权限裁决、按需加载 |
| 03 | 有限窗口里的无限对话:上下文管理的工程艺术 | 五级压缩、Cache 拓扑、Token 预算 |
| 04 | 从单兵到军团:多智能体协作与可扩展架构 | Coordinator/Worker、Fork Cache、Agent 定义体系、Teams 集群、MCP/Plugin/Skill |
| 05 | 从 Claude Code 到你的 Agent:12 个可复用架构模式 | 模式清单、决策框架、速查表 |
| 加餐 | 源码里的产品路线图:Claude Code 隐藏功能全景解读 | 隐藏功能、Feature Flag、门控机制、产品路线图 |
| 07 | 让 Agent 拥有长期记忆:持久化记忆系统的工程实现 | Memdir、记忆生命周期、自动提取、跨 Agent 同步 |
阅读建议
- 建议按顺序阅读,每篇末尾有下一篇预告
- 每篇都有跟跑验证环节,需要搭建本地环境(第一篇有完整指南)
- 每篇的 Spotlight 深度框可选读,不影响主线理解
项目信息
- 分析样本:Claude Code
v2.1.88恢复快照(source map 还原版本) - 当前工作树:
package.json版本为v2.1.88-cjm,src/下本地统计约 2010 个源码文件、513,792 行 TS/JS - 运行要求:Bun >= 1.3.5、Node >= 24.0.0
- 分析文档:
docs/source-analysis/(20 篇子系统分析)、docs/Highlights/(26 篇源码亮点)