Claude Code 源码学习与分析手册

本仓库仅供学习、研究和源码分析使用，不是 Anthropic 官方仓库。 Claude Code 及相关代码、商标与知识产权归属于 Anthropic。

项目说明

这个仓库保存了一份 Claude Code 的源码快照，并围绕它补充了系统化的中文分析文档，目标是帮助读者理解一个大型 Agent CLI/TUI 系统是如何分层、编排、扩展和持久化运行状态的。

版权与使用边界

• Claude Code 的原始版权归 Anthropic 所有。
• 本仓库中的源码快照仅用于学习、研究、教学讨论与源码分析。
• 本仓库不是 Anthropic 官方仓库，也不代表 Anthropic 官方说明。

文档结构

• docs/design/ 设计总览文档，适合先建立全局架构认知。
• docs/tutorial/ 分模块教程，适合结合源码逐步深入。

总入口见 docs/README.md。

如何快速学习

15 分钟快速建立地图

1. docs/design/01-overview.md
2. docs/design/02-runtime-flows.md
3. docs/tutorial/01-architecture-overview.md

1 到 2 小时看懂 Claude Code 主干

1. docs/tutorial/03-context-management.md
2. docs/tutorial/10-query-engine.md
3. docs/tutorial/07-tool-system.md
4. docs/tutorial/12-session.md

想重点看 Agent

1. docs/tutorial/02-prompt-system.md
2. docs/tutorial/04-memory-system.md
3. docs/tutorial/05-sub-agent.md
4. docs/tutorial/06-agent-team.md

想重点看扩展能力

1. docs/tutorial/08-command-system.md
2. docs/tutorial/09-state-management.md
3. docs/tutorial/11-mcp-system.md
4. docs/design/04-module-design.md
5. docs/design/05-dependencies.md

推荐完整阅读顺序

如果你只想按一条顺序读完，建议这样：

1. docs/design/01-overview.md
2. docs/design/02-runtime-flows.md
3. docs/tutorial/01-architecture-overview.md
4. docs/tutorial/03-context-management.md
5. docs/tutorial/10-query-engine.md
6. docs/tutorial/07-tool-system.md
7. docs/tutorial/12-session.md
8. docs/tutorial/02-prompt-system.md
9. docs/tutorial/04-memory-system.md
10. docs/tutorial/05-sub-agent.md
11. docs/tutorial/06-agent-team.md
12. docs/tutorial/08-command-system.md
13. docs/tutorial/11-mcp-system.md
14. docs/design/03-domain-models.md
15. docs/design/04-module-design.md
16. docs/design/05-dependencies.md

适合研究的问题

• Claude Code 的 Query Loop 如何组织多轮工具调用
• Prompt、Context、Memory、Session 如何协作
• Sub Agent、Coordinator、Team Worker 如何实现
• Tool Registry、权限系统、MCP 接入如何落地

免责声明

本仓库及文档仅供学习参考。若你需要 Claude Code 的官方产品信息、正式文档、许可证说明或商用政策，请以 Anthropic 官方渠道为准。