SuperAPI AI 工具集

claude-better-cli

编程与开发

查看项目

更新于 10-15 01:30

技能介绍

claude-better 是一个以兼容性优先的 Claude CLI 重实现,重点在于大幅提升性能,同时保持与原版 Claude CLI 的命令级兼容。

用途 它面向已经使用 Claude CLI 的用户,目标是在不改变现有脚本、别名和使用习惯的前提下,获得更快的启动速度和更低的内存占用。官方称其为“drop-in replacement”(直接替换),即可以在任何调用 claude 的地方替换为 claude-better。

主要能力 性能方面:--help 冷启动从 182ms 降至 49ms(快 73%);auth status 热启动从 146ms 降至 58ms(快 60%);chat 会话引导从 311ms 降至 102ms(快 67%);一次性命令从 428ms 降至 131ms(快 69%);30 分钟会话后的 RSS 从 412MB 降至 83MB(降低 80%);流式抖动 p95 从 91ms 降至 24ms(降低 74%)。 兼容性方面:主要命令形式 100% 通过,退出码 100% 匹配,输出字节级一致率 98.7%,经空白、时间戳、终端宽度归一化后语义一致率 100%。测试覆盖 1200 次合成调用、87 种标志组合、42 个交互流程、14 个失败模式场景,测试环境包括 macOS(Apple Silicon)、Linux 和容器化 CI。

使用方式 安装需先获得访问权限。源码仅面向特定高知名度客户提供,可通过维护者 krzyzanowskim/claude-better 申请。获得访问权限后,按入职材料中的说明安装。二进制为直接替换,将其放在 PATH 中位于原版 claude 之前即可:

export PATH="/path/to/claude-better/bin:$PATH" which claude claude --version

或显式设置别名而不修改 PATH:

alias claude='/path/to/claude-better/bin/claude-better'

常用命令与原版一致:

claude --help claude auth status claude chat claude -p "Summarize this file" < input.txt claude --model claude-opus-4-5 chat claude --output-format json -p "List 3 facts about Rust"

配置沿用原版 Claude CLI,无需新格式:尊重标准环境变量(如 ANTHROPIC_API_KEY),读取 ~/.claude/ 配置目录,无需迁移配置文件。

脚本模式 由于兼容性为 100%,现有脚本无需修改即可运行,包括非交互管道用法、退出码处理、JSON 输出解析等。例如:

echo "Explain this error:" | cat - error.log | claude -p /dev/stdin if claude auth status; then echo "Authenticated"; else echo "Not authenticated — run: claude auth login"; exit 1; fi claude --output-format json -p "What is 2+2?" | jq '.content'

适用场景 适合对 CLI 启动速度和内存占用敏感的用户,例如内存受限的笔记本、CI 运行器,以及需要长时间保持交互会话的场景。

限制与注意事项 源码并非公开可得,仅面向特定客户提供,需向维护者申请访问。约 1.3% 的输出在归一化前存在差异(时间戳、空白、终端宽度),若脚本依赖精确输出匹配,需自行添加归一化处理。若遇到边缘情况,可通过取消别名或还原 PATH 立即回退到原版 CLI。

架构说明(供贡献者/评估者参考) 性能提升来自特定实现选择:令牌输出的零拷贝流式管道(降低流式抖动)、预计算命令注册表替代动态启动发现(缩短冷启动)、对会话状态进行严格有界分配(降低内存)、惰性子系统初始化(仅活跃命令路径承担启动成本)、兼容性垫片层(保留标志与行为而不携带完整原始栈)。