一本从入门到精通系统拆解 Claude Code Best (CCB) 源码的中文技术书,13 章 + 13 张深色架构图,约 9 万字。
CCB 是 Anthropic 官方 Claude Code CLI 的开源逆向还原项目,在 npm 上叫 claude-code-best。本书基于 package.json version 2.6.5 的实际源码撰写,每章关键事实都附 file_path:line_number 引用,所有架构图使用 architecture-diagram-generator Skill 规范生成。
| # | 章节 | 主题 |
|---|---|---|
| 0 | 前言 & 目录 | 项目背景、阅读对象、术语约定 |
| 1 | 项目概览 | 反编译背景、能力地图、Bun 运行时定位 |
| 2 | 启动与入口分发 | cli.tsx 14 条 Fast Path、main.tsx Commander |
| 3 | Query Loop 主循环 | query.ts / QueryEngine、Terminal 11 + Continue 7 状态机 |
| 4 | Tool System | 60+ 内置工具、CORE_TOOLS=28、TF-IDF 延迟加载 |
| 5 | API 与 Provider 体系 | 7 个 Provider、queryModel:1039 if 链路由 |
| 6 | 多 API 兼容层 | OpenAI 6 文件适配 / Gemini / Grok / DeepSeek thinking |
| 7 | Feature Flag 系统 | bun:bundle feature()、34 启用 + 8 注释 |
| 8 | UI 层 Ink + React | @anthropic/ink 框架、4 层 Provider、6 主题预设 |
| 9 | 状态管理 | store.ts 真实 34 行、bootstrap/state.ts 1762 行 |
| 10 | MCP 协议与集成 | mcp-client 13 文件 + services/mcp 22 文件 |
| 11 | ACP / Bridge / RCS | ACP 13 方法、bridgeMain:2001 + runBridgeHeadless:2810 |
| 12 | Workspace 与 Skill | 17 workspace(11 direct + 6 @ant)、Skill 双路径 |
| 13 | 构建、测试与发布 | build.ts 5 步、4 GitHub workflow、precheck 三件套 |
diagrams/ 目录下 13 张深色 HTML 架构图(slate-950 + 语义色彩 + JetBrains Mono):
ch01-capability-map.html— CCB 能力地图ch02-entrypoint-flow.html— 入口分发流程ch03-query-loop.html— Query 状态机ch04-tools.html— Tool 体系- ……每章一张
查看方式:用 Chrome 打开任意 .html 文件,右上角有「导出 PNG / PDF」按钮。
源码(TypeScript spec)在 diagrams/contents/,统一通过 diagrams/_generator.ts 生成。重新生成命令:
bun diagrams/_generator.ts ch01-capability-map- 新人:按章节顺序读,重点看每章末尾的「关键文件」表
- 资深工程师:可以直接跳到感兴趣的章节,每章独立成篇
- 架构师:建议先看 ch01、ch11、ch12 三章建立全局视角
- 二次开发者:ch04(加工具)、ch07(加 flag)、ch12(加 skill)是高频参考
本书研究对象 CCB 的源码仓库:github.com/claude-code-best/claude-code
CCB 本身是 Anthropic 官方 Claude Code 的反编译/开源还原版,遵循其原始设计但扩展了多 Provider(OpenAI/Gemini/Grok)、ACP、Bridge、RCS、Skill 等开放生态能力。
本书所有事实均经过源码核对,但仍可能有遗漏或随版本演进而过时。如发现错误:
- 直接提 Issue / PR
- 引用格式:
第 X 章,"小节名",原文:"xxx",建议改为:"yyy",证据:file_path:line_number
本书内容采用 CC BY-NC 4.0 协议 —— 允许非商业转载、改编,需署名「Claude Code 源码全解」。
CCB 源码本身的版权归原作者所有,本书仅作技术解读。