Claude Code Internals Orange Book — Development skill for Claude Code

Claude Code 内核内幕橙皮书

**从 0.2.8 还原源码树读懂 Claude Code 的 Agent 内核：骨架、造法与演进**

橙皮书系列 | 2026 | 卷〇~卷三

[在线阅读版](https://tefuirnever.github.io/claude-code-internals-orange-book/)

关于这套书

Claude Code 的 Research Preview 0.2.8 是这款产品「刚能给人用」的那一年：没有 Skills，没有 Hooks，没有操作系统沙箱，没有自动压缩——但 Agent 的内核已经完整焊好：一个递归生成器循环、一张工具表、一个运行时权限函数、一个 Ink 终端界面。

这套书对着一棵从公开安装包 sourcemap 还原出来的 0.2.8 源码树（211 个 TypeScript/TSX 文件，共 25979 行），把这件事讲透：内核长什么样（卷一）、照着它自己造一个（卷二）、后来的能力什么时候为什么长出来（卷三）；卷〇是使用向姊妹卷，全部时效性论断对照官方文档核验（核验版本 2.1.241，2026-08-24）。


下载

卷	PDF
卷〇 · 实战指南	Claude-Code-In-Practice-zh-v260824.pdf（103页）
卷一 · 源码走读	Claude-Code-Source-Walkthrough-zh-v260822.pdf（37页）
卷二 · 新手造 Agent 专项	Build-Your-First-Terminal-Agent-zh-v260822.pdf（70页）
卷三 · 演进史	Claude-Code-Evolution-zh-v260822.pdf（14页）

💡 PDF 文件建议下载后阅读，体验更佳。GitHub 在线预览可能无法完整渲染。套装当前为纯中文版；历史英文版产物（PDF / 源稿 / 页面）可从 git 历史中取回。

四卷定位

• 卷〇 · 实战指南：给日常使用者——安装、心智模型、CLAUDE.md、权限与工作流、prompt 与 context 工程、省钱、Skills、Hooks、MCP、subagents 与插件、/goal 无人值守、并行编排、dynamic workflows 与 CI 集成。13 章 + 4 附录，每章带验收清单与本机可复现的验证示例，全部论断标注核验日期与官方信源。
• 卷一 · 源码走读：顺着 25979 行还原源码把终端 Agent 的内核读穿——从你敲下 claude 那一刻，到 query 循环、工具契约、权限函数、Ink 界面，每一句论断都能对回文件和行号。
• 卷二 · 新手造 Agent 专项：给想自己写终端 Agent 的新手——七章七关，照着 0.2.8 的骨架从零搭出自己的 mini-agent，全部练习零 npm 依赖，一个文件直接 node 跑。
• 卷三 · 演进史：从 0.2.8 到今天——自动压缩、Hooks、沙箱、Skills、插件系统、auto mode，逐个能力回答「是什么、为什么加、住在内核还是外层」，落成一份给自己造 Agent 的人的路线图。

配套代码：mini-agent 参考实现

卷二七章练习的主线产物——一个 ~200 行、纯 Node.js 零依赖的可跑 mini-agent——随套装收在 [`mini-age