跳转至

Claude Code 源码导读手册 v2

guidebookv2/ 是当前这套手册的正式阅读入口,也是整本书按 7 个认知台阶 重组后的主线版本。

这里不再按旧卷目录或源码目录平铺,而是优先按读者理解这套系统所需要跨过的认知坡度来组织全书。

先读这一句

卷一到卷七不是材料分桶,而是一条连续问题链:先看清这是什么系统,再看它一轮怎么跑、怎么执行、怎么持续、怎么长能力、怎么长成协作 runtime,最后怎么收成今天这个产品。

当前状态

guidebookv2/ 现在已经形成完整七卷主线:

  1. 卷一|Claude Code 系统全景导论
  2. 卷二|一次 Agent Turn 怎么跑起来
  3. 卷三|工具系统怎么把模型意图落成执行
  4. 卷四|上下文与状态怎么维持系统持续工作
  5. 卷五|外部扩展与多代理能力
  6. 卷六|多 agent 协作运行时
  7. 卷七|命令、工作流与产品层整合

说明: - guidebookv2/ 是当前默认导航与默认阅读入口 - guidebook/ 旧资产仍保留在仓库中,主要作为迁移素材与历史参考 - 后续站点入口、README、导航与公开阅读链,默认都以 guidebookv2/ 为主线


七个认知台阶分别回答什么

卷一:Claude Code 是什么系统

回答:Claude Code 到底是什么系统,它的核心对象和基本轮廓是什么。

卷二:一次 Agent Turn 是怎么跑起来的

回答:一条用户请求怎样真正进入系统,并闭合成一轮 agent turn。

卷三:工具系统怎么把模型意图落成执行

回答:模型已经决定做事之后,runtime 怎样把意图真正落成现实动作。

卷四:上下文与状态怎么维持系统持续工作

回答:Claude Code 为什么不是跑一轮就散,而是能持续工作、能恢复、能长期维持。

卷五:外部扩展与多代理能力

回答:这套系统怎样长出更多能力,并把系统之外的能力源接进来,最终收成平台层。

卷六:多 agent 协作运行时

回答:Claude Code 为什么不只是“多开几个 agent”,而是已经长出一层正式协作运行时。

卷七:命令、工作流与产品层整合

回答:用户入口、运行时接口、工作流控制层,最后怎样被收成今天这个产品形态。


推荐阅读方式

如果你第一次读这套手册

建议这样进入:

如果你已经熟悉 coding agent,想直接看运行主线

可以先读:

如果你更关心平台、协作和产品层

可以直接进入后半段:


这版重组和旧结构的关键区别

这次重组最关键的变化,不是换了几个标题,而是把整套内容改成了明确的认知递进:

  • 卷优先于文章
  • 主问题优先于材料归档
  • 认知递进优先于源码目录
  • 卷与卷之间必须形成自然导流
  • 每一卷只解决自己这一层问题,不提前抢下一卷的职责

也就是说:

读者不是在逛源码目录,而是在一层一层理解 Claude Code 这套系统。


从这里继续

  • 想先看全景:从 卷一 开始
  • 想先看主循环:从 卷二 开始
  • 想先看平台到产品的后半段:从 卷五 开始