Claude Code 源码深度研究报告

Claude Code 源码深度研究报告Xiao TanX: x.com/tvytlx公众号：Xiao Tan AIMarch 31, 2026Contents1Claude Code 源码深度研究报告（增强完整版）41.1目录. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .421. 研究范围与结论总览42.11.1 这次到底研究了什么 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42.21.2 关键确认事实 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42.31.3 先给最重要的总判断 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .532. 源码结构全景：它为什么更像 Agent Operating System53.12.1 顶层结构暴露出的系统复杂度 . . . . . . . . . . . . . . . . . . . . . . . . .53.22.2 入口层说明它是平台，而不是单一界面. . . . . . . . . . . . . . . . . . . .63.32.3 命令系统是整个产品的操作面板 . . . . . . . . . . . . . . . . . . . . . . . .63.42.4 Tools 层才是模型真正“能做事”的根 . . . . . . . . . . . . . . . . . . . . .743. 系统提示词总装：prompts.ts 的真实地位74.13.1 真正的主入口：src/constants/prompts.ts . . . . . . . . . . . . . . .74.23.2 getSystemPrompt() 不是文本，而是编排器 . . . . . . . . . . . . . . . .84.2.1静态前缀（更适合 cache）. . . . . . . . . . . . . . . . . . . . . . . .84.2.2动态后缀（按会话条件注入）. . . . . . . . . . . . . . . . . . . . . . .84.33.3 Prompt cache boundary：基础设施级思维 . . . . . . . . . . . . . . . . .854. Prompt 全量提取与模块级拆解95.14.1 身份与基础定位：getSimpleIntroSection(). . . . . . . . . . . . . .95.24.2 基础系统规范：getSimpleSystemSection() . . . . . . . . . . . . . . .95.34.3 做任务哲学：getSimpleDoingTasksSection(). . . . . . . . . . . . .105.44.4 风险动作规范：getActionsSection() . . . . . . . . . . . . . . . . . . .105.54.5 工具使用规范：getUsingYourToolsSection(). . . . . . . . . . . . .105.64.6 Session‑specific guidance：运行时可变的局部指令 . . . . . . . . . . . . .115.74.7 Output efficiency：高价值但常被忽视的 section . . . . . . . . . . . . . .115.84.8 Tone and style：统一交互感受 . . . . . . . . . . . . . . . . . . . . . . . .115.94.9 DEFAULT_AGENT_PROMPT：子 Agent 的基础人格 . . . . . . . . . . . .12165. Agent Prompt 与 built‑in agents 深挖126.15.1 AgentTool/prompt.ts：Agent 协议说明书 . . . . . . . . . . . . . . . .126.25.2 fork 语义为什么很强 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126.35.3 “How to write the prompt”一节非常值钱 . . . . . . . . . . . . . . . . .136.45.4 built‑in agents：职责分工而不是万能 worker . . . . . . . . . . . . . . . .136.55.5 Explore Agent：纯读模式的代码探索专家 . . . . . . . . . . . . . . . . . .136.5.1绝对只读. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146.5.2核心能力. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146.65.6 Plan Agent：纯规划，不做编辑 . . . . . . . . . . . . . . . . . . . . . . . .146.75.7 Verification Agent：为什么它非常值钱. . . . . . . . . . . . . . . . . . .1476. Agent 调度链深挖：从 AgentTool 到 runAgent 再到 query157.16.1 总体调用链长什么样 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .157.26.2 AgentTool.call()：真正的调度总控 . . . . . . . . . . . . . . . . . . . .157.36.3 fork path vs normal path. . . . . . . . . . . . . . . . . . . . . . . . . .167.3.1fork path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167.3.2normal path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167.46.4 为什么 fork 会强调 cache‑identical prefix. . . . . .