为什么选 MiniClaude：一个精简开源替代方案的选型过程

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 的原因是：在保持官方配置兼容的前提下，获得一个可审计、去遥测、精简的开源客户端。

成本是一次性的源码构建，收益是长期的可控性和精简度。