AB
AB
AiBoss站

全部分类

project

cheap-ag - 让前沿模型只做规划、便宜模型负责写代码的 Claude Code / Codex 插件

cheap-ag（npm 包名 cheap-agent）是一个面向 Claude Code 与 Codex 的开源插件：前沿模型负责规划与决策，低成本模型在自己的项目副本里写代码，并且必须用测试证明改动有效。项目采用 MIT 许可证，截至 2026-11-03 获得 231 星标。

cheap-ag 是一个面向 Claude Code 与 Codex 的开源插件，npm 包名为 cheap-agent。按项目自述，它要解决的是「用最贵的模型打字」这件事：前沿模型（如 Claude Opus）负责读需求、做规划、下判断，真正的代码编写交给一个成本极低的模型，在项目的一份私有副本里完成，并且必须先写出一条会失败的测试、再让改动通过这条测试，成果才会落回你的工作区。它适合已经在用 Claude Code 或 Codex、希望让现有订阅额度撑更久的开发者，也适合预算有限但想在难问题上用上强模型的学生与独立开发者。

维护者与状态

项目由 muaaz9329 维护，仓库创建于 2026-10-28，最后一次提交在 2026-11-02，同日发布了最新版本 v1.3.2。截至 2026-11-03，仓库获得 231 个星标。许可证为 MIT。项目另有一个官网入口，见下文「使用入口」。

从时间线看，这是一个非常年轻的项目：创建到最新版本之间只有数天，版本号已经推进到 v1.3.2，说明迭代节奏较快。读者在采用前应把这一点纳入考量。

主要能力

以下能力均据项目 README 自述，未经本站独立验证。

  • 分工式协作：前沿模型负责规划与决策，低成本模型负责实际敲代码。README 用一个比喻说明设计意图——你不会雇一位资深首席工程师去手打 CSV 导出器。
  • 测试作为验收闸门：据项目说明，低成本模型必须写出一条在修复前失败、修复后通过的测试，由 cheap-ag 自己运行测试，而不是采信模型的自我声明。
  • 隔离工作区：工作在 git worktree 形式的私有副本中进行，只有通过测试的改动才会以未提交状态落回，供你像平常一样审阅 diff。
  • 约束前沿模型：README 称其 hooks 会阻止前沿模型悄悄重做已经通过的工作，或在 Claude Code 中亲自执行本可交给 Sonnet 辅助模型完成的失败步骤。
  • 成本可见：提供状态命令查看近期任务与低成本模型的花费。
  • 不提交、不推送：项目明确表示不会执行 commit 或 push，改动一律以未提交形式留下。
  • 可选配置：项目根目录可放 cheapag.json，用于设置失败步骤由谁接手（默认 Sonnet 辅助，或设为 self 交给前沿模型，上限 15 次工具调用）、每步最大轮数（默认 25）以及使用的低成本模型。

README 还给出了若干命令，Claude Code 与 Codex 各有一套写法，涵盖授权项目代码发送给低成本模型、查看状态、强制前沿模型交出代码改动、清理旧任务目录等操作。此外可以在第二个终端运行 npx cheap-agent watch 逐步跟踪任务进展。

使用入口

仓库地址：muaaz9329/cheap-ag；官网：cheapag.com。

据 README，安装前需要准备：Claude Code 或 Codex 之一、Node.js 20 及以上版本，以及一个在 OpenRouter、DeepSeek、OpenCode Go 或 Command Code 上充值了几美元的 API key。项目称可在 macOS、Linux 与 Windows 上运行，Windows 还需要 Git for Windows（Git Bash）。

Claude Code 下的手动流程是运行安装器、选择服务商、粘贴 API key，随后在每个项目中执行一次授权命令：

npx cheap-agent
/cheapag:allow

Codex 下则先运行同一个安装器（若不用 Claude Code，可在它询问是否加入 Claude Code 时选择否），再添加插件并启动：

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

之后在项目中执行一次 $cheapag:allow。README 也提供了一段可直接粘贴进 Claude Code 的引导提示词，由它代为检查环境并给出要执行的命令。

许可与限制

许可证为 MIT，按事实表原样记录。README 中亦声明可在任何公司使用、修改与分享。

项目自述的已知限制包括：

  • 首次任务可能需要约两分钟，用于低成本模型所依赖的引擎（OpenCode）完成自举，之后的任务可在数秒内启动。
  • 若该引擎在会话中途崩溃，cheap-ag 会启动新实例，但崩溃的副本可能继续驻留（Windows 任务管理器中可见 opencode.exe），直到手动结束或重启。
  • 低成本模型在其项目副本中无法读取依赖目录（如 node_modules），但测试仍可正常运行。
  • README 坦承，在最难的一类问题上，其表现不及直接使用前沿模型；在极小的任务上也没有节省空间，其价值集中在中等规模的真实功能与修复上。
  • 代码只会在你于该项目中执行授权命令后，发送给你选定的服务商；API key 保存在本机。

需要强调：上述能力与效果描述均来自项目自述，本站未运行该项目，也未复核其测试方法与数据。

返回