2026/8/2
背景：从官方版本说起
电脑上原本装的是官方 @anthropic-ai/claude-code（v2.1.215）。这是一个由 Anthropic 官方发布的命令行 AI 编程助手，在 GitHub 上有 139k star。
安装方式也很简单：sudo npm install -g @anthropic-ai/claude-code，装完就能用。
那为什么要换？
官方版本的几个问题
用了一段时间后，逐渐发现了一些不太舒服的地方：
第一，闭源。
官方 Claude Code 是闭源的。作为一个需要频繁处理代码的工具，它的内部逻辑无法审计------它读取了哪些文件、发了什么数据出去、有没有额外的上传行为，这些都无从确认。对于习惯在终端里跑各种命令的开发者来说，这层不确定性是一个隐形成本。
第二，遥测。
官方版本内置了遥测和云同步。虽然不是所有用户都在意，但至少可以关掉------官方提供了 DISABLE_TELEMETRY 环境变量来关闭遥测。但问题是，它默认是开启的，需要用户主动去关，而且即使关了，代码闭源也无法确认数据是否真的没发出去。
第三，体积臃肿。
官方版本通过 npm 安装，依赖链很长，npm 包体积大，磁盘占用和内存开销都不小。对于一个只是终端里跑个助手的工具来说，显得有点重了。
第四，扩展性受限。
官方版本主要支持 Anthropic 自己的 API 接口。如果想接入其他模型平台（比如 DeepSeek、Kiro 等），需要额外配置，官方并不原生支持。
有没有替代品？
决定替换官方版本后，看了几个候选：
| 项目 | Stars | 定位 | 分析 |
|---|---|---|---|
| 官方 anthropic/claude-code | 139k | 官方全功能 | 闭源、有遥测、重 |
| CCB / claude-code-best | 21.7k | fork/逆向，功能最全 | 做加法，代码量大 |
| MiniClaude | 174 | 精简、去遥测 | ✅ 符合"减法"原则 |
| nano-claude | 351 | 极简 | 功能太少，参考用 |
CCB 的问题在于它走的是另一个方向：尽可能还原官方所有功能，甚至加更多。代码量非常大，体积重，不符合"精简优先"的诉求。
MiniClaude 则正好反过来：把官方的非必要功能去掉，保持核心功能可用，同时兼容官方配置结构。
它的定位非常明确：精简、开源、可审计、去遥测。
关键兼容性：配置目录结构
MiniClaude 完全兼容官方 Claude Code 的配置目录结构：
text
~/.claude/
├── settings.json # 用户级主配置
├── settings.local.json # 项目级本地覆盖
├── projects/ # 会话历史
└── CLAUDE.md # 项目指令文件这意味着什么？意味着如果之前用过官方版本，所有的配置、会话历史、项目设置都可以直接复用，不需要重新配置。同时，这套配置结构也能被 cc-switch 等第三方工具接管，扩展了使用场景。
一个关键的坑
MiniClaude 的 GitHub 上有 174 颗星，看起来不起眼，但它解决了几个核心问题：
-
去遥测 ：通过环境变量
DISABLE_TELEMETRY和CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC完全禁用非必要流量 -
开源可审计：代码在 GitHub 上，可以自己看、自己改
-
精简：单文件自包含，没有复杂的依赖链
但有一个坑：MiniClaude 不能通过 npm install -g 一键安装。
因为 npm 上的包名 miniclaude 已经被另一个 Python 项目占用了。所以 MiniClaude 没有 npm 版本，也没有预编译产物，只能源码构建。
bash
git clone --depth 1 https://github.com/txl16095/MiniClaude.git
bun install
bun run build --compile
cp dist/cli ~/.local/bin/claude构建依赖 bun 1.3.11 以上版本。构建完成后生成一个单文件可执行文件，约 176MB。
部署策略
既然只有一份成品，这个工具的部署也考虑了对 SSD 写入的优化：
-
源码和编译临时文件放内存盘（
/tmp） -
只把最终生成的
claude可执行文件放到~/.local/bin/ -
可复用缓存（
~/.bun/install/cache、~/.npm）保留在 SSD
这样 SSD 上只保留最终成品，一次性构建垃圾不落地。
总结
| 对比项 | 官方 Claude Code | MiniClaude |
|---|---|---|
| 开源 | ❌ 闭源 | ✅ 开源可审计 |
| 遥测 | ⚠️ 有，需手动关闭 | ✅ 默认无遥测 |
| 体积 | 大 | 精简，单文件 |
| 安装方式 | npm install -g | 源码构建 |
| 配置兼容 | 官方结构 | 完全兼容 |
| 扩展性 | 仅官方 API | 多 Provider 热切换 |
最终选择 MiniClaude 的原因是：在保持官方配置兼容的前提下，获得一个可审计、去遥测、精简的开源客户端。
成本是一次性的源码构建，收益是长期的可控性和精简度。