我们要读的仓库叫 claude-code-best（简称 CCB）。package.json 第 2-3 行写得很清楚：

"name": "claude-code-best",
"version": "2.8.3",
"description": "Reverse-engineered Anthropic Claude Code CLI — interactive AI coding assistant in the terminal"

翻译过来：它是 Anthropic 官方 Claude Code CLI（那个在终端里跟你结对编程的 AI 助手）的逆向工程 / 反编译后完整重写的 TypeScript 版本。CLAUDE.md:7 也明说 "This is a reverse-engineered / decompiled version of Anthropic's official Claude Code CLI tool."

它甚至比官方版功能更多：README（README.md:19-37）列出它额外实现了 Goal 持续驱动、Artifacts HTML 托管、Ultracode 多 Agent 编排、Remote Control 远程控制、Voice 语音、Web Search 等——而且"关闭了外部封控点"、完全兼容官方配置文件。

很多人以为"复刻一个 CLI"就是包一层调官方的包。CCB 完全不是。它没有运行时依赖官方 @anthropic-ai/claude-code 包，而是自己从头重实现了每一个子系统：agent 循环、工具系统、终端 UI、MCP、skills、hooks、workflow 引擎……

官方的 @anthropic-ai/claude-agent-sdk 只作为 devDependency（package.json:85）存在——只用来对齐类型/协议定义，运行时一点不依赖它。

零基础最需要先有的一个直觉——Agent 不是"聊天机器人"，它会"动手"。区别在于：

• 聊天机器人：你问，它答（只输出文字）。
• Agent：你给个目标，它自己反复调用工具（读文件、改代码、跑测试），观察结果，再决定下一步，直到把事办完。

所以这个 CLI 的灵魂是一个循环（就是总目录页那个转圈动画）：

这个循环在本项目由 src/query.ts + src/QueryEngine.ts 驱动（Day 03、06 细讲）。今天你只要记住"Agent = 模型 + 工具 + 一个不停转的循环"。

先有个体量的心理准备（别怕，我们会拆开读）：

src/ 下按文件数排：utils/(773)、components/(418)、commands/(400)、services/(301)、hooks/(119)…… 数量最大的是工具函数和 UI 组件，这很正常——一个成熟 CLI 大量代码花在"界面"和"打杂"上，真正的"agent 大脑"反而集中在少数几个文件里。

这是本教程最重要的一张图——记住这几大块各在哪、干什么，后面每天都是往里钻：

package.json:32-36 定义 workspaces = packages/*、packages/@ant/*、packages/@anthropic-ai/*。关键包：

装好后你会得到几个命令行入口（package.json:27-31）：

"bin": {
  "ccb": "dist/cli-node.js",           // 用 node 跑
  "ccb-bun": "dist/cli-bun.js",        // 用 bun 跑
  "claude-code-best": "dist/cli-node.js"
}

这些 cli-*.js 是构建生成的极薄 shim（就一行 import "./cli.js"），真正的产物是 dist/cli.js，它打包自源码入口 src/entrypoints/cli.tsx。所以完整映射链是：

你敲 ccb
  → dist/cli-node.js          (#!/usr/bin/env node, 一行 import)
  → dist/cli.js               (打包产物)
  → src/entrypoints/cli.tsx   (真正的源码入口 ★)

三条主线（贯穿本教程）

✋ 动手 5 分钟（可选）

# 1. 确认项目身份
cd claude-code
head -10 package.json          # 看 name/description
sed -n '1,10p' CLAUDE.md        # 看"逆向"声明

# 2. 感受规模
find src -name '*.ts' -o -name '*.tsx' | wc -l
for d in src/*/; do echo "$(find $d -name '*.ts*'|wc -l) $d"; done | sort -rn | head

# 3. 看 bin 映射和入口
sed -n '27,36p' package.json
ls src/entrypoints/

# 4. 看 monorepo 包
ls packages/