Skip to content

README.md

Latest commit

 

History

History
106 lines (71 loc) · 4.12 KB

README.md

File metadata and controls

106 lines (71 loc) · 4.12 KB
title Claude Code 源码导读手册 v2
date 2026-04-12
status draft

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 这套系统。

从这里继续

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