EN
Claude Code from Source — 封面

Anthropic 如何构建出全球最受广泛使用的 AI 编码智能体

当 Claude Code 在 npm 发布时,完整的 source maps 被一同打包释出。我们研读了每一个文件。本书将系统架构、核心权衡与设计哲学提炼为 18 个完整章节,供每一位软件工程师学习并应用到自己的生产系统中。

开始阅读

你将学到什么

Agent 循环驱动引擎

探究异步生成器(AsyncGenerator)如何驱动整个系统——流式输出处理、工具并发调度、错误自动恢复以及跨越 4 层的上下文压缩机制。

生产级大规模工具执行

从模型请求到工具结果的 14 步严格防护流水线。权限动态决策、流式推测性执行,以及基于并发安全分类的分批调度。

多智能体协同与集群

子智能体(Sub-agents)如何通过共享 Prompt 缓存前缀将调用成本直降 95%。分叉智能体、协调者模式 (Coordinator) 与基于邮箱通信的 Swarm 架构。

摒弃数据库的纯文件记忆

基于纯 Markdown 文本文件与 LLM 智能召回的记忆系统。四类记忆模型、时效衰减机制,以及超越向量检索的 Sonnet 侧边查询设计。

极致性能工程调优

借助模块级 I/O 并发重叠实现 240ms 极速启动。输出槽位预留机制在 99% 的请求中节省上下文。用于模糊匹配的 26 位字符位图预过滤器。

可扩展性与防注入安全

技能(Skills)两阶段延迟加载。27 个生命周期 Hooks、启动期静态配置快照机制,从根源上免疫运行时 Prompt 注入修改攻击。

交互式系统架构全景探索

六大核心抽象驱动着整个 Claude Code。可拖拽节点探索关联、悬停查看细节、点击进入对应深度章节。

本书适合谁读

构建生产级 Agent 系统的工程师。 每一章均以“实战应用 (Apply This)”结尾——提炼出 5 大具备实操落地价值的设计模式,直接借鉴优秀架构,避开已知暗坑。

评估技术选型的技术主管与架构师。 即使不通读每一行代码,也能紧跟叙述脉络,深入理解“为什么这样设计”背后的核心工程权衡。

对前沿 AI 开发者工具内部原理充满好奇的技术探索者。 Claude Code 已被数十万开发者广泛使用,这里为您完整揭示其幕后的工程机制。

全书章节目录

让 Agent 系统顺畅运转的 10 大核心模式

若时间有限,以下 10 项架构决策是 Claude Code 最具迁移价值的工程精华。

1
AsyncGenerator 驱动 Agent 循环 —— Yield 结构化 Message,提供天然的背压控制、取消传播与进度共享
2
推测性工具执行 (Speculative Execution) —— 在模型流式输出工具调用的同时预先启动只读操作与权限校验
3
并发安全分批调度 —— 根据工具自身声明的安全边界将工具分批,读操作并发执行,写操作串行安全落盘
4
分叉智能体 (Fork Agents) 实现缓存共享 —— 子智能体严格复用父会话字节完全一致的 Prompt 前缀,立省 95% 输入 Token
5
4 层渐进式上下文压缩 —— Snip 修剪、Microcompact 微压缩、Collapse 折叠、Auto-compact 全量摘要
6
基于文件与 LLM 召回的记忆机制 —— 摒弃复杂的向量数据库依赖,使用结构化 Markdown 文件配合轻量模型侧边查询
7
技能 (Skills) 两阶段延迟加载 —— 启动时仅加载元数据与简介,在被调用或意图命中时才加载正文
8
粘性锁存器 (Sticky Latches) —— 一旦启用了 Beta Header,在整个会话期间绝不解闭,强保服务端 Prompt Cache 不击穿
9
输出槽位预留策略 (Slot Reservation) —— 默认预留 8K 输出空间,命中上限时无缝升阶至 64K,在 99% 的请求中省下宝贵上下文
10
配置不可变快照 (Snapshot Security) —— 启动时对所有 Hook 与策略进行只读快照冻结,从根本上免疫运行时 Prompt 注入修改攻击

学术与技术研究声明: 本书不包含 Claude Code 的任何专有源代码——每个代码块均为阐释架构设计模式而重新编写的伪代码。目标是帮助工程师深刻理解生产级 AI 编码智能体的系统设计思想。