Cheap Agent
让前沿模型负责规划,把编码任务交给低成本模型并用测试验证结果。
- Star 数
- ★ 339
- 最近更新
- 5 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 57/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude CodeOpenAI API(部分支持)
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 使用 Claude Code 或 Codex、希望把常见功能的编码工作交给低成本模型的个人开发者。
- 不适合
- 不愿将项目代码发送给所选模型提供商的团队
- 希望由前沿模型直接编写每一行代码的开发者
- 官网
- cheapag.com ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-16最新版本 v1.4.3(2026-11-16)近 7 天每天 +1.3 ★
- 源码审查
- 57/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
Cheap Agent 是面向 Claude Code 和 Codex 的 CLI、MCP server 与插件,使用 Node.js 20+ 运行。前沿模型负责规划任务,低成本模型在项目的 Git worktree 副本中编写代码和测试。Cheap Agent 会自行运行测试,只有通过检查的更改才会落回项目,而且保持未提交状态供你审阅。支持 OpenRouter、DeepSeek、OpenCode Go、Command Code、OpenCode Zen,以及兼容 OpenAI API 的自定义端点。每个项目首次使用前,需要运行对应的 allow 命令,确认该项目代码可发送给所选模型。
安装时运行 npx cheap-agent,选择提供商和模型并输入 API key;也可配置自定义端点或本地模型。之后在 Claude Code 中运行 /cheapag:allow,或在 Codex 中运行 $cheapag:allow,授权当前项目使用所选模型。前沿模型提交任务后,Cheap Agent 在 Git worktree 中让低成本模型实现更改并编写失败后再通过的测试,然后自行运行测试。通过检查的更改会以未提交状态落回项目;无法验证的复现会附带风险说明。可使用 /cheapag:status 查看任务和费用,使用 /cheapag:model 选择主模型与备用模型,或用 /cheapag:provider 切换已登录的提供商。
- 使用 Claude Code 或 Codex、希望把常见功能的编码工作交给低成本模型的个人开发者。
- 希望减少 Opus 用量,同时仍由 Opus 规划较大代码更改的团队。
- 需要在隔离的 Git worktree 中尝试修复,并在合并前查看未提交差异的维护者。
- 想为低成本模型实现的功能和修复运行测试、确认结果后再接收更改的开发者。
- 有本地模型或自建 OpenAI 兼容端点,并愿意自行配置模型参数的开发者。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npx cheap-agentnpx cheap-agent watch
- 运行环境
- Node.js 20+
- 安装说明涉及
- Windows
如何安装或部署这个 Agent?
需要 Node.js 20+、Claude Code 或 Codex,以及所选提供商的 API key(自定义端点可能无需 key)。在终端运行:
npx cheap-agent按提示选择提供商、模型并输入 API key。若只使用 Codex,在提示时选择不安装到 Claude Code;随后添加 Codex 插件:
codex plugin marketplace add muaaz9329/cheap-ag
codex plugin add cheapag@cheap-agentWindows 还需要 Git for Windows(Git Bash)。
如何使用这个 Agent?
在 Claude Code 项目中首次授权:
/cheapag:allow在 Codex 项目中,启动 Codex 并信任提示中的 3 个 cheapag hooks,然后运行:
$cheapag:allow之后像平常一样向 Claude Code 或 Codex 提出代码更改请求。可在 Claude Code 使用 /cheapag:status、/cheapag:model、/cheapag:provider;在 Codex 中使用对应的 $cheapag: 命令。需要跟踪任务进展时,在另一终端运行:
npx cheap-agent watch这个 Agent 有哪些优点和局限?
- 同时支持 Claude Code 和 Codex,并提供 MCP server 与 Codex 插件接入方式。
- 低成本模型在独立 Git worktree 中工作;通过测试检查的更改以未提交状态落回,便于审阅。
- 支持多个托管提供商、自定义 OpenAI 兼容端点和本地模型,提供商可在已登录选项间切换。
- README 报告 SWE-bench Verified 的日常修复测试中,7 个问题均由两种配置解决,Opus tokens 减少 59%。
- 使用前需有 Node.js 20+、Claude Code 或 Codex,以及配置的模型提供商;托管模型通常需要 API key 和按量费用。
- 项目代码会在明确授权后发送到所选模型提供商;不适合禁止此类数据传输的项目。
- README 报告最难的 9 个问题中,Cheap Agent 配置解决 6 个,纯 Opus 配置解决 7 个;小任务也可能没有节省。
- Windows 用户还需 Git for Windows;首次任务可能因 OpenCode 引擎初始化耗时约两分钟。
这个 Agent 与同类方案有什么区别?
README 将其与直接使用 Claude Code + Opus 对比:在所述 SWE-bench Verified 实验中,日常修复的 Opus tokens 少 59%,但最难的问题中完成数为 6/9,而纯 Opus 为 7/9。对于低成本模型无法完成的步骤,Claude Code 可按设置询问、由 Sonnet 接手或自行完成;Codex 会在聊天中询问或自行继续。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Cheap Agent 当前 | 57 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 339 | 5 天前 | TypeScript | Codex · Claude Code |
| Agent Deck | 74 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.3k | 1 天前 | Go | Codex · Claude Code |
| ECC 工程智能体工作台 | 63 · 存在缺口 | Agent 插件 / 技能免费版 + 付费版 | ★ 308k | 1 天前 | JavaScript | Codex · Claude Code |
| Puppetmaster | 73 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 479 | 今天 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
信任维度:最小权限方面,技能通过 allowed-tools 限定为 npx cheap-agent 子命令,MCP 工具以 stdio 运行,未见过度权限,但 server.ts 被截断,无法确认全部工具面,故扣分至 2。用户确认方面,/cheapag:allow 显式记录项目级同意,takeover 默认 ask,且明确禁止模型自行批准同意,表现良好;但 hook 编辑守卫会拦截 Claude 的编辑,属较强干预,仅部分说明。数据流透明方面,README 说明代码仅在 allow 后发往所选 provider 并展示模型,但未见逐字段的数据流清单。敏感数据处理方面,API key 通过隐藏提示与本地凭据存储,redact() 包裹所有工具输出,自定义端点仅引用环境变量名或文件而不读取密钥,较好;但凭据存储实现未在样本中。依赖安全方面,依赖含 @opencode-ai/sdk、opencode-ai 固定 1.19.0 及 MCP SDK,未见锁文件或漏洞审计证据,故仅 1。外部影响方面,明确不 commit/push,改动以未提交形式落地,工作树隔离,较好。回滚方面,提供 clean 命令、retention 清理、worktree 隔离与未提交落地便于丢弃,但无显式撤销已落地改动的机制。来源归属方面,MIT 与作者署名存在,但发布者身份未经验证,且 SWE-bench 数据仅指向个人博客,归属证据薄弱。
可靠性:README、SKILL.md、package.json 版本 1.4.1 与技能中固定的 [email protected] 一致,命令表与 index.ts 子命令分发基本吻合,一致性较好;但 server.ts 被截断,无法核对全部工具与指令。依赖可用性:依赖声明清晰、engines 要求 node>=20.11,但样本无 package-lock,且 opencode-ai 引擎首次运行需下载,Windows 已知会残留进程,可用性存在外部依赖风险,故 1。失败信息:instructions 中定义了 OK/PARTIAL/FAIL/BLOCKED/CONFLICT/TIMEOUT/BUDGET/PROVIDER/CONSENT 等结构化结果码及处置指引,失败信息较完善。
适配性:面向 Claude Code 与 Codex 双宿主,覆盖学生、预算敏感用户、企业使用等场景,并支持本地模型与自定义端点,场景覆盖较广。能力边界:明确说明小任务无收益、最难 bug 成功率略低、Windows 限制、本地小模型工具调用弱等边界,边界陈述清晰。触发精度:技能均设 disable-model-invocation,需用户显式调用;MCP 指令明确要求代码改动走 delegate,触发规则具体。环境适配:支持 macOS/Linux/Windows,Windows 需 Git Bash 并列出已知问题,环境适配说明充分。
惯例:README 结构清晰,含安装、命令、设置、FAQ、更新移除等章节,信息架构良好。安装说明:提供 agent 自动安装脚本、Claude Code 与 Codex 分步命令、依赖要求,安装说明详尽。命名稳定性:包名 cheap-agent、命令 cheapag、插件 cheapag 一致,但 README 中卸载命令出现 cheapag@cheapag 与 cheapag@cheap-agent 两种写法,存在轻微不一致。示例与 FAQ:有前后对比表、FAQ、演示图,示例充分。已知限制:明确列出最难 bug 表现、小任务无收益、Windows 问题等,限制披露充分。许可证:MIT 全文存在,package.json 声明一致。版本与变更日志:有版本号与 Releases 页指引,但样本无 CHANGELOG 文件,故 1。维护责任:作者署名与 Reddit/博客渠道存在,但发布者未经验证,维护责任归属证据有限。
有效性:输出以结构化结果块(OK/PARTIAL/FAIL 等)返回,改动以未提交 diff 落地便于审阅,输出可用性较好。边际价值:在真实功能与修复场景可显著减少前沿模型 token,README 给出前后对比,价值主张具体;但小任务无收益,价值有条件。成本收益:宣称 63% token 减少与半美分成本,但数据来自作者单次运行与个人博客,缺乏独立复现,成本收益证据为断言,故 1。
可验证性:SWE-bench 与 token 数据指向作者博客与图表,未提供可复现的原始日志或 harness 输出,溯源薄弱。交叉佐证:README 数字与 assets 图表一致,但均为同一作者来源,缺乏独立第三方佐证。事实与推断分离:README 部分承认局限(最难 bug 6/9 vs 7/9),有一定诚实度,但营销性表述(50x、63%)与实测细节混排,分离不彻底。
- 发布者身份未经验证,安装前应自行核实 npm 包与 GitHub 仓库归属。
- SWE-bench 与 token 节省数据来自作者个人博客与单次运行,未经独立复现,不应视为已验证性能。
- 依赖 opencode-ai 引擎首次运行需下载,Windows 上崩溃可能残留 opencode.exe 进程,需手动清理。
- hook 编辑守卫会拦截 Claude 的大改动并强制转交,属较强干预,启用前应理解其行为。
- 样本中 server.ts 被截断,无法完整审查全部 MCP 工具面与权限边界。
- README 卸载命令存在 cheapag@cheapag 与 cheapag@cheap-agent 两种写法,可能造成混淆。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v1.4.3 1.4.3
发布说明摘录
Ollama is a provider. Pick Ollama at login (number 4), then one of two endpoints: - This machine: no key. Login lists the models you've pulled and reads each one's context window from Ollama. Nothing leaves your machine, so even /cheapag:allow --zdr-only allows it. - Ollama Cloud: export OLLAMA_API_KEY where Claude Code starts, then log in and pick a preset. Like the other providers, jobs switch to another cloud model when one hits a limit, and move up to a stronger one when stuck. If a cloud job can't find its model, pick one from your account with /cheapag:model. …在 GitHub 查看 ↗ -
v1.4.1 1.4.1
发布说明摘录
Fewer failed jobs, and you decide before Claude spends tokens. When the cheap worker can't finish, Claude now asks you first: continue with Claude, retry the worker on another model, or stop. Before, it handed the step to a Sonnet subagent on its own, often costing several hundred thousand tokens. The old behaviour is still available with takeover: "sonnet". …在 GitHub 查看 ↗ -
v1.3.2 1.3.2
发布说明摘录
Updating is one command again. npx cheap-agent@latest on a machine that's already set up now just updates: no provider or key questions, the Claude Code server entry moves to the new version (before, it stayed pinned to the old one, so only the plugin updated), and the plugin updates. It prints what it did and tells you to restart Claude Code. npx cheap-agent login still runs the full setup when you want to change provider or models. If you're on 1.2.7 or 1.3.1: the update notice already says to run npx cheap-agent@latest, and that command now does the right thing. …在 GitHub 查看 ↗
常见问题
代码会发送到哪里?
/cheapag:allow 或 $cheapag:allow 后,代码才会发送给你选择的模型提供商;授权时会显示涉及的模型。API key 保存在本机凭据存储中,不会放进聊天。是否需要付费模型账户?
如果低成本模型卡住,会发生什么?
takeover 设置先询问、交给 Sonnet helper 或自行完成;Codex 会在聊天中询问或自行完成。通过检查的代码会自动提交或推送吗?
可以用本地模型吗?
Cheap Agent 官网是什么?
Cheap Agent 开源吗?
Cheap Agent 安全吗?
Cheap Agent 还在维护吗?
Cheap Agent 是谁开发的?
谢谢反馈,我们会据此改进页面。