Claude Code 源码解读
从源码层面理解 Claude Code 的架构设计。不是使用教程,是工程解剖——每个模块怎么设计、为什么这么设计。
01
全局视角:不只是 CLI 工具
Claude Code 的代码库有 4756 个文件、50+ 顶层模块。它不是一个 CLI 工具,是一个 Agent Operating System。
02引擎:主循环与 Prompt 编排
query.ts 是整个系统的心脏——1729 行的状态机。从请求链路到 prompt 组装,拆解 Claude Code 的核心引擎。
03工具系统:42 个工具和一条治理流水线
不是模型说调就调。从 Tool 接口设计到 14 步执行 pipeline,看 Claude Code 怎么管理工具调用。
04多 Agent 体系:分工和调度
6 种内建 Agent、fork 与 spawn 的缓存优化、Verification Agent 的对抗性 prompt——Claude Code 的多 Agent 架构。
05安全层:权限、Hook 和三层防护网
权限系统 27 个文件、Hook 的三个时点、resolveHookPermissionDecision 的粘合逻辑——Claude Code 的安全不是一道墙,是三层网。
06生态:Skill、Plugin、MCP
三种扩展机制,三个不同层次。Skill 是带元数据的 workflow,Plugin 改变模型行为,MCP 是工具桥 + 行为说明注入。
07上下文经济学:Token 就是预算
四道压缩机制、Reactive Compact、Token Budget、按需注入——Claude Code 怎么在有限的上下文窗口里装最多有用的信息。
08设计原则与产品化
从源码里提炼出 7 条设计原则,加上产品化必须处理的第二天问题。每条原则都有对应的源码实现。