想了解一个 AI 编程工具的真实水平。有两条路：读它的文档，或者读它的代码。文档写的是意图，代码才是现实两者之间往往隔着好几轮产品妥协。这篇文章走后一条路，解剖对象是 Claude Code v2. 的源码。下文所有行数、目录数和代码引用都基于这个版本逐一核对过。

读法有三种。架构解构法，从入口点反推设计意图；工程度量法，用代码规模和组织方式评估复杂度治理；对比参照法，把 Claude Code 放进 VSCode Copilot、Cursor、GitHub CLI 的坐标系里看它选择了什么、放弃了什么。三种方法各解剖一次答案会自己浮出来。

一、架构解构法：从入口点逆向推导设计意图

cli.tsx：一个被成入口的路由表

打开 src/entrypoints/cli.tsx 行。它的函数注释把设计意图写得很坦白：

/**
* Bootstrap entrypoint - checks for special flags before loading full CLI.
* All imports are dynamic to minimize module evaluation for fast paths.
* Fast-path for --version has zero imports beyond this file.
*/

这个文件做的事只有一件：在加载完整 CLI 之前，先检查 argv 里有没有特殊标志。数一下会发现，它里面藏着十几条快捷方式：--version--dump-system-prompt--claude-in-chrome-mcp--chrome-native-host--computer-use-mcp--daemon-worker-remote-control、-daemon、-ps/logs/attach/kill、new/list/reply、environment-runnerself-hosted-runner。--tmux --worktree 组合,最终才是默认方法——加载 main.js,进入完整 CLI。

使用者痛点:

• 启动速度慢: 快捷方式让高频操作跳过全量初始化。但普通使用者可能不清楚这些参数存在,无法调整自己的体验。再看例如，❌ 耐心等待 ✅ claude --version / claude ps 这让开发者在CI/CD中使用时能更高效地获取版本信息或管理后台进程。

feature:编译时就把代码删掉

feature来自bun:bundle,是Bun的编译时特性标志.它和运行时的if有本质区别:建立产物里根本不包含被关掉的分支.

✅ 内部版本与公开版本完全分离
✅ 按客户需要定制裁剪产物
✅ 减少泄密风险


从❌传统方法来看。


// runtime flag approach
if {
// feature code...
}
 ✅Claude Code方法:


// compile-time feature flag
if ) {
// feature code...
}



⚠️ 增加了建立复杂度:需要精确管理各个feature标志之间的依赖关系


ABLATION_BASELINE:为什么这段代码必须放在入口?

消融实验基线内嵌在入口说明团队程序地衡量每个智能功能贡献.更关键的是注释解释位置约束显示精确理解ES模块求值顺序.


🧠
功能价值评估困难:
难以科学衡量智能提高功能对实际工作效率提高贡献.


✅ 内置消融基线可随时退化为问答循环作为实验对照组
✅ 根据数据调整决策哪些功能值得保留或投资







init.ts:启动决策链