Cheap Agent

Cheap Agent

把 Claude Code 或 Codex 里的日常编码交给一个必须用测试证明成果的低成本模型，让你的主力模型的额度用得更久。

由 muaaz9329 在 GitHub 上制作。这些说明是 Mindket 根据其 README 写的，项目自己的文件和许可证在它的仓库里。

简介

它是什么：Cheap Agent 在 Claude Code 或 Codex 里把编码工作分给两个模型。你的主力模型负责规划和决定。一个便宜得多的模型在项目的私有副本里动手写，必须拿出一个通过的测试，你才会看到结果。目的是让你的 Claude 或 ChatGPT 套餐用得更久。

适合谁：它适合因为顶级模型把额度花在日常敲代码上、而碰到套餐限额的开发者。

行业 | 谁在用 | 怎么用 | 例子
软件开发 | 用 Claude 或 ChatGPT 套餐的开发者 | 让便宜的模型来敲代码，主力模型负责规划 | 一个功能只花 57k Opus 令牌，而不是 154k
教育 | 负担不起 $100 套餐的学生 | 把已经在付费的套餐用得更久 | 这个项目的目标是让 $20 的套餐发挥出 $50 到 70 的价值
小团队 | 关注 AI 开销的团队 | 只花几美元的 API 用量来做敲代码的活 | 几美元能用上数百个任务

不用 Claude Code 也不用 Codex 的人可以跳过它。

用在哪里：它会把自己加到 Claude Code 或 Codex 里，可以在 macOS、Linux 和 Windows 上运行。

• Claude Code：它会为每个项目安装自己，之后你在每个项目里允许一次
• Codex：它以插件形式来自一个市场，首次运行时有三个钩子需要你信任
• Windows：还需要 Git for Windows，它提供 Git Bash
• 提供商：OpenRouter、DeepSeek、OpenCode Go、OpenCode Zen、Command Code，或者本地服务器

使用场景 | 适合谁 | 他们能得到什么
构建功能 | 开发者 | 一次经过测试的改动，由在项目另一份副本里干活的便宜模型完成
节省套餐额度 | 碰到用量限额的人 | 同一个功能花掉更少的 Opus 令牌
选择模型 | 在意成本的用户 | 均衡、最便宜或最强的预设，或者你自己的提供商和模型

如何设置：开始之前，你需要 Claude Code 或 Codex、Node.js 和一个 API 密钥。

• Claude Code 或 Codex
• Node.js 20+
• 一个充了值的 API 密钥（几美元就够），来自 OpenRouter、DeepSeek、Command Code、OpenCode Go 或 OpenCode Zen，或者改用本地模型
• 在 Windows 上，需要 Git for Windows

1. 运行登录命令并选一个提供商。拿不准就选 OpenRouter。
2. 按回车使用推荐的模型，然后粘贴你的 API 密钥。
3. 它会测试你的密钥，然后把自己注册到 Claude Code 里，覆盖你所有的项目。
4. 在每个项目里运行一次允许命令。

npx cheap-agent

然后在每个项目里，在 Claude Code 中运行一次：

/cheapag:allow

用 Codex 的话，用同一条命令登录。如果你不用 Claude，在它提出把自己装进 Claude Code 时拒绝即可。然后添加插件：

codex plugin marketplace add muaaz9329/cheap-ag
codex plugin add cheapag@cheap-agent

在你的项目里启动 codex。当它询问那 3 个 cheapag 钩子时，选择信任。然后在每个项目里运行一次：

$cheapag:allow

如果你愿意，也可以把 README 里的安装提示词粘贴到 Claude Code 里。它会询问你的提供商和模型，然后给你一条要运行的命令。

如何使用：像平时一样让 Claude 或 Codex 做修改。主力模型负责规划，便宜的模型在项目的另一份副本里写代码，测试必须通过，结果才会送到你面前。

工具 | 作用
npx cheap-agent | 让你登录，检查你的密钥，并把 Cheap Agent 加到 Claude Code 里
/cheapag:allow | 在每个项目里运行一次，之后才能在 Claude Code 里使用
$cheapag:allow | 在 Codex 里的同样一次性步骤
claude mcp list | 在 Claude Code 安装成功时会显示 cheapag

示例：你像平时一样让 Claude Code 加一个功能。在 README 里对同一个功能做的并排测试中，只用 Claude Code 花了 154k Opus 令牌、5 个回合。用了 Cheap Agent，同样的活花了 57k Opus 令牌、2 个回合，少了 63%，另外便宜的模型花了大约半美分。两个版本都通过了测试。

新手与专家：如果你付费使用 Claude 或 ChatGPT，你的套餐有用量上限，而大模型会把其中一部分花在日常敲代码上。Cheap Agent 把这部分敲代码的活交给一个便宜得多的模型。先为 Claude Code 装上它，再让它做一个小改动。

在底层，你的主力模型负责规划和决定，一个便宜的模型通过 OpenCode 引擎运行，在项目的独立副本里动手实现。它被标注为在 SWE-bench Verified 上测试过。作者说它不会让 Opus 便宜十倍。便宜的模型在它的副本里也读不到 node_modules 这类依赖文件夹，不过你的测试仍然正常运行。

你的主力模型负责规划和决定
便宜的模型在自己的项目副本里接到任务
它写出代码，并用测试证明它
测试通过后，结果才会交到你手里

注意事项：

• 成本：API 密钥上的几美元能用上数百个任务
• 提供商说明：Command Code 的密钥需要包含 API 权限的套餐，用 DeepSeek 模型时 OpenCode Go 要求控制台里的 Regions 设成 Global
• Windows 启动：第一个任务大约要 2 分钟，等 OpenCode 引擎自己装好
• Windows 崩溃：引擎崩溃后留下的副本可能一直以 opencode.exe 的形式运行，直到你关掉它或重启
• 数字：令牌数量来自作者自己的并排运行
• 许可证：MIT

Title: README 里两次测试的 Opus 令牌数
测试 1，只用 Claude Code: 154 千令牌
测试 1，用了 Cheap Agent: 57 千令牌
测试 2，只用 Claude Code: 233 千令牌
测试 2，用了 Cheap Agent: 132 千令牌

GitHub 上的数据（2026年11月7日）

• 星标：310
• 复刻：29
• 未关闭的议题和拉取请求：2
• 语言：TypeScript
• 许可证：MIT
• 话题：agentic-coding, ai-agents, anthropic, cheap-llm, claude, claude-code, claude-code-hooks, claude-code-plugin, claude-code-skill, cost-optimization, deepseek, developer-tools

链接

• 代码：https://github.com/muaaz9329/cheap-ag
• 网站：https://cheapag.com/
• 发布版本：https://github.com/muaaz9329/cheap-ag/releases
• 议题：https://github.com/muaaz9329/cheap-ag/issues
• 星标历史：https://www.star-history.com/#muaaz9329/cheap-ag&Date

获取代码

git clone https://github.com/muaaz9329/cheap-ag.git

然后按它的 README 完成设置。这个工具包里没有会自己运行的东西。