SOURCE_READING_INDEX.md

OpenClaudeCode 文档总索引

这是 OpenClaudeCode 根目录下源码解读文档的统一入口。建议把它当作文档导航页使用，而不是仓库说明页。

一篇看全局

• CLAUDE_CODE_SOURCE_MANUAL.md 适合先建立整体心智模型。
• CLAUDE_CODE_CALL_CHAIN_DIAGRAM.md 适合先抓主调用链。

实现级精读

入口：

• source-reading/README.md

这套文档适合：

• 对照 claude-code-main/src/ 读源码
• 追主循环、工具系统、状态系统和扩展体系
• 快速定位关键实现文件

核心推荐：

• source-reading/12-main-tsx-deep-dive.md
• source-reading/04-repl-tsx-deep-dive.md
• source-reading/11-query-engine-ts-deep-dive.md
• source-reading/01-query-loop-deep-dive.md
• source-reading/20-complete-runtime-call-chain.md
• source-reading/31-core-file-index.md
• source-reading/32-reading-roadmap.md

架构综述版

入口：

• claude-code-main/docs/source-reading/README.md

这套文档适合：

• 先按模块理解 Claude Code
• 先建立分层视角，再回到实现细节

建议先读：

• claude-code-main/docs/source-reading/12-complete-architecture-map.md
• claude-code-main/docs/source-reading/01-startup-and-entry.md
• claude-code-main/docs/source-reading/02-session-and-query-loop.md

PDF 版

PDF 全部放在：

• pdf-reading

常用入口：

• pdf-reading/SOURCE_READING_INDEX.pdf
• pdf-reading/CLAUDE_CODE_SOURCE_MANUAL.pdf
• pdf-reading/CLAUDE_CODE_CALL_CHAIN_DIAGRAM.pdf

推荐进入方式

如果你第一次读 Claude Code：

1. CLAUDE_CODE_SOURCE_MANUAL.md
2. claude-code-main/docs/source-reading/12-complete-architecture-map.md
3. source-reading/32-reading-roadmap.md

如果你准备直接改核心运行时：

1. source-reading/31-core-file-index.md
2. source-reading/27-query-runtime-subsystem-map.md
3. source-reading/20-complete-runtime-call-chain.md

如果你想快速看调用链：

1. CLAUDE_CODE_CALL_CHAIN_DIAGRAM.md
2. source-reading/20-complete-runtime-call-chain.md

一句话总结

这份索引只做一件事：把总手册、实现级精读、架构综述版和 PDF 入口统一收口到一个页面。