Skip to content

README.md

Latest commit

 

History

History
163 lines (130 loc) · 9.22 KB

README.md

File metadata and controls

163 lines (130 loc) · 9.22 KB

Claude Code 文档地图

如果你刚进入仓库，请先看根目录的 README.md。根 README 负责回答“这套文档整体在讲什么”；这里负责把全书按分卷展开。

这张地图怎么读

当前文档更适合按“分卷阅读”来理解。更稳妥的阅读方式是把它当成一本围绕 Claude Code 源码展开的研究书：

  • 先认识系统
  • 再理解运行机制
  • 再看扩展、远程与协作
  • 再进入记忆与上下文
  • 再进入 Anthropic 的 agent 研究
  • 最后用操作手册、研究手册和术语表收尾

Mermaid 图：分卷结构图

flowchart TD
    A["README\n书籍首页"] --> B["卷一\n认识 Claude Code"]
    A --> C["卷二\nClaude Code 如何运行"]
    A --> D["卷三\n扩展、远程与协作"]
    A --> E["卷四\n记忆与上下文"]
    A --> F["卷五\nAnthropic Agent 设计研究"]
    A --> G["卷六\n操作、研究与索引"]
    B --> B1["00 / 01 / 02"]
    C --> C1["03 / 04 / 05 / 06 / 07 / 08 / 16 / 17 / 18 / 19"]
    D --> D1["09 / 10 / 11 / 20 / 22 / 23 / 24 / 25 / 26 / 27 / 28 / 30 / 31 / 32 / 44 / 45"]
    E --> E1["21 / 29 / 33 / 34 / 35 / 36 / 37 / 38"]
    F --> F1["15 / 39 / 40 / 41 / 42 / 43"]
    G --> G1["12 / 13 / 14"]
Loading

卷一：认识 Claude Code

这一卷回答“Claude Code 到底是什么系统”。

推荐顺序：

  1. 00. 快照与边界
  2. 01. 项目总览
  3. 02. 目录导览与阅读顺序

先读这两篇最稳妥：

卷二：Claude Code 如何运行

这一卷是整套文档的主干，解释启动、命令、工具、UI、上下文、权限、恢复和提示词装配。

推荐顺序：

  1. 03. 启动与主循环
  2. 04. 命令系统
  3. 05. 工具系统
  4. 06. UI、状态与 REPL
  5. 07. QueryEngine 与上下文
  6. 08. 权限与安全控制
  7. 16. 会话持久化与恢复机制
  8. 17. 系统提示词与模型决策
  9. 18. Settings、Policy 与托管配置
  10. 19. 上下文压缩与历史治理

这一卷最关键的三篇：

卷三：扩展、远程与协作

这一卷解释 Claude Code 如何接入外部能力、远程环境和多人式协作。

推荐顺序：

  1. 09. 扩展体系：Plugins、Skills、MCP、LSP
  2. 10. Bridge、Remote 与 IDE 集成
  3. 11. 子代理与任务系统
  4. 20. Coordinator、Swarm 与 Teammate 协作
  5. 22. CLI Structured IO、Control Protocol 与 Transports
  6. 23. API Client、鉴权与 Provider 路由
  7. 24. GrowthBook、Analytics 与 Feature Control
  8. 25. Hooks 与 Runtime Extensibility
  9. 26. Keybindings 与 Vim 输入状态机
  10. 27. Output Styles 与 Response Shaping
  11. 28. Direct Connect、Server 与 Upstream Proxy
  12. 30. Assistant、Voice 与 Runtime Modes
  13. 31. Buddy、Git 状态与 Workflow Observability
  14. 32. Harness 与 Eval Runtime
  15. 44. Provider 能力限制审计
  16. 45. Telemetry、Analytics 与上报规则审计

这一卷最关键的三篇：

卷四：记忆与上下文

这一卷专门研究 Claude Code 如何处理长期会话、记忆写入、文件视图与上下文压缩。

推荐顺序：

  1. 21. 记忆系统：CLAUDE.md、Session Memory 与 Agent Memory
  2. 29. Team Memory Sync 与 Shared Repo Memory
  3. 33. Session Memory 调度与并发控制
  4. 34. History Snip、Replay 与 Projected View
  5. 35. CLAUDE.md 加载算法与指令装配
  6. 36. Memory Taxonomy 与 Drift 防护
  7. 37. Agent Memory Snapshot 与 Sync Protocol
  8. 38. ReadFileState、Context Cache 与 Partial View 机制

这一卷最关键的三篇：

卷五：Anthropic Agent 设计研究

这一卷不是再讲“怎么调用 agent”，而是专门研究 Anthropic 如何把 agent 做成一种可治理的工程组织系统。

推荐顺序：

  1. 15. Agent 设计理念研究
  2. 39. Forking、子代理与上下文经济学
  3. 40. Agent 运行时生命周期：Background 与 Resume
  4. 41. Agent 隔离：Worktree、Remote 与 CWD Override
  5. 42. Agent Definition 加载与可用性
  6. 43. Agent 组织学与 Anthropic 的工作模型

这一卷最关键的三篇：

卷六：操作、研究与索引

这一卷负责收口：如何实际操作、如何继续追源码、术语怎么统一。

推荐顺序：

  1. 12. CLI 操作手册
  2. 13. 源码研究操作手册
  3. 14. 术语表

按目标直接进入

如果你想… 先读
快速知道 Claude Code 是什么 01. 项目总览
从启动链路理解整体执行 03. 启动与主循环
研究工具调用为什么不是普通 function calling 05. 工具系统
研究 prompt、上下文和记忆 17、21
研究长会话压缩与文件视图 33、34、38
研究 Anthropic 的 agent 方法论 15. Agent 设计理念研究
研究 fork、background、isolation 这些 agent 运行机制 39、40、41
研究 agent 是如何被装配成“当前可用集合”的 42
研究 Anthropic 的组织化多 agent 模型 43
审计 provider 限制而不是读散落的条件分支 44. Provider 能力限制审计
审计 telemetry 和具体上报规则 45. Telemetry、Analytics 与上报规则审计

写作约定

  • 结论优先来自源码可见事实。
  • 研究型章节会显式区分“源码事实”和“设计归纳”。
  • Mermaid 图用于帮助理解流程、层级和协议，不代表官方图纸。
  • 章节编号保持连续，结构感主要通过根 README 和本文档的分卷导航体现。