muaaz9329/cheap-ag

项目介绍

Cheap Agent 解决的是「贵模型在干打字活」的问题。在 Claude Code 里，Opus 负责写一份简短的任务说明，一个便宜模型在独立的 git worktree 里实现它，并且必须为这次改动写一个先失败、后通过的测试才会落地。测试由 Cheap Agent 自己执行，不采信模型的口头结论；Opus 读回的是一份十来行的结果，而不是整段实现。

适合已有 Claude Code 订阅、希望同一份额度干更多活的人，也适合想省钱但坚持改动必须过测试的小团队。不适合指望它把最难的问题也做得和 Opus 一样好的场景。

快速开始

准备：Claude Code、Node.js 20+，以及 OpenRouter、DeepSeek、OpenCode Go 或 Command Code 上带少量余额的 API key。

推荐路径：把 README 里的安装提示词粘进 Claude Code。它会依次询问服务商和模型预设，检查 Node 与 claude CLI，若你选了自定义模型则写入 ~/.config/cheapag/config.json，最后给出要你自己执行的 npx cheap-agent login --preset <预设> 命令，并告诉你在服务商菜单里选哪个数字：1 OpenCode Go、2 OpenRouter、3 DeepSeek、4 Command Code。API key 由你在终端输入，提示词不会索要。

手动路径：

npx cheap-agent

选服务商（拿不准就选 OpenRouter），回车采用推荐模型，粘贴 API key。CLI 校验 key 可用后，把自己注册为 Claude Code 的 MCP server，跨项目生效。然后在每个项目里执行一次：

/cheapag:allow

这一步是授权把该项目代码发给便宜模型，并会显示具体哪些模型能看到代码。之后像平常一样让 Claude 改代码即可。

常用命令还有：/cheapag:status 查看近期任务和花费，/cheapag:hook on 强制 Claude 把代码改动交给便宜模型，/cheapag:clean 清理旧任务目录。

使用约束

• 支持 macOS 和 Linux。Windows 为 beta：CI 测过但没有 Windows 用户实际用过，需要 Git for Windows，首次任务可能要等约 2 分钟让 OpenCode 初始化；若 OpenCode 崩溃，进程可能残留，需要手动结束或重启。
• 代码只会发往你选定的第三方服务商，且必须先在该项目执行 /cheapag:allow。API key 保存在本地凭据存储中。
• 改动以未提交状态落地，既不 commit 也不 push，提交前由你自己看 diff。
• 便宜模型在 worktree 里读不到 node_modules 这类依赖目录，但测试仍可正常运行。
• 便宜模型卡住时，默认由 Sonnet 助手接手完成该步；可在 cheapag.json 里把 takeover 设为 "self" 让 Opus 接手（最多 15 次工具调用）。limits.max_turns 默认 25。
• 作者自己说明：在最难的 bug 上单次表现略差（9 个解出 6 个，纯 Opus 为 7 个），在几行代码或从零搭小应用这类小任务上省不下什么。
• MIT 许可，可在公司内使用和修改。

更新与卸载

更新执行 npx cheap-agent@latest，新版本会在 Releases 页面 公布。卸载分两步：claude plugin uninstall cheapag@cheapag，再执行 claude mcp remove -s user cheapag。

HotRepo 点评

该项目在 2026-11-01 进入 HotRepo 的 TypeScript 新项目榜，当时 169 stars、13 forks，统计窗口从 2026-10-31T14:45:34Z 开始，窗口内新增 67 stars。按小时采样看，不到一天里从 102 涨到 169，对一个新仓库来说节奏很快，但这不代表质量或实际采用情况；站内没有记录到 GitHub 日榜名次，也没有 Hacker News 讨论。更值得关注的是设计本身：把贵模型限制在规划、把实现交给便宜模型，前提是测试这道闸门真的可靠，而这一结论目前来自作者的演示数据，并非针对这套工具链的独立基准。