Skip to content

samson-samson/claude-code-analysis

Repository files navigation

Claude Code 源码全解(Deep Dive)

一本从入门到精通系统拆解 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

License

本书内容采用 CC BY-NC 4.0 协议 —— 允许非商业转载、改编,需署名「Claude Code 源码全解」。

CCB 源码本身的版权归原作者所有,本书仅作技术解读。

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors