Agent 用法 GitHub · LeiZiKang/codex-delegate
用 codex-delegate 让 Claude 规划评审、Codex CLI 编码测试,省 Claude 配额
在 Claude Code 里说一句话,由 Claude 写任务 brief、Codex 在沙箱里实现和跑测试,Claude 读简短报告复核后提交。
效果
原站没有结果截图;README 说有 examples/ 目录存放一次演示运行的真实 brief 与 Codex 报告,网页未展示具体内容。
这是什么
新在哪里:以前编码会话里读文件、改代码、追构建测试失败都由 Claude 自己消耗配额;现在把这条重 token 的循环交给本机 Codex CLI,Claude 只负责架构、brief 与评审。
怎么做到的:以插件方式在 Claude Code 中执行 /plugin marketplace add LeiZiKang/codex-delegate 与 /plugin install codex-delegate@codex-delegate,或用 git clone 后把 skills/codex-delegate 拷到 ~/.claude/skills/。之后用自然语言触发(如「Use codex-delegate for this refactor.」),Claude 先跑 check-setup.sh 预检、把 brief.md 模板写到仓库外的 notes 目录,再以后台任务运行 scripts/run-codex.sh --repo … --notes … --brief …,该脚本在 workspace-write 沙箱内执行 codex exec;完成后 Claude 只读报告、检查 git status、在沙箱外复跑 xcodebuild/网络等,通过后提交,否则发简短补充 brief。
- 适合谁
- 同时用 Claude Code 和 Codex CLI、想在不追加 Claude 配额的条件下分工推进编码任务的开发者。
- 能帮你
- 把重 token 的编码与测试循环迁到 Codex 的配额上,让 Claude 的用量集中在规划与评审,并靠报告契约和沙箱外复核保持可控。
评分 三项分开看,不合成总分;热度不等于好用
- 新颖性
- 全新做法 · 2026-10-21 出现
- 热度
- 未知
- 易上手
- 需要一些准备
怎么评的
三项都由本站记录的事实按固定规则算出,编辑不能直接改档位;规则改动会写进更新说明。
新颖性
- ●●● 全新做法,且有来源依据的出现时间在最近 30 天内
- ●●○ 老工具新用法或近期刚开放,且有来源依据的时间在最近 30 天内
- ●○○ 出现时间超过 30 天、未核实到精确日期,或已不再是新做法
- 其他 出现时间未核实、晚于今天,或新颖类型未核实时按最低一档处理,不靠猜测加分
热度
- ●●● 最近一次每周人工确认为“热门”:最近 14 天里独立讨论、实际案例、持续时间、传播平台、相对关注五项门槛全部满足(规则 heat-v1)
- ●●○ 最近一次人工确认为“观察中”:前三项至少一项达到,或讨论增长 ≥ 50%,且至少 2 个独立案例
- ●○○ 最近一次人工确认为“未进入跟踪”
- 其他 还没有人工确认过的热度记录时显示“未知”。热度只统计本站已接入的信源,不代表全网
易上手
- ●●● 准备门槛低且难度入门:不需要新账号或付费,首次尝试不超过 30 分钟,公开可用,会复制粘贴即可
- ●●○ 准备门槛中等,或门槛低但需要改少量代码或配置
- ●○○ 准备门槛高:需要商业软件或付费服务、首次尝试超过 2 小时、特殊硬件或网络、排队或邀请且无替代方案,或需要专业知识
- 其他 只有介绍、还没有站内步骤,或关键步骤已失效时显示“暂不可试”;门槛未核实时显示“未核实”
怎么尝试
- 时间 首次约 25 分钟
- 费用 需订阅:网页未标注本仓库费用(MIT 开源),但明确要求已登录的 Codex CLI 与 Claude Code,二者均需相应账号额度/订阅,具体价格原站未说明。
- 账号 不需要新账号
- 环境 Claude Code(CLI、桌面应用或 IDE 扩展)+ 已登录的 Codex CLI + git + bash;README 写明在 macOS 上测试,Linux 未测试。
- 准备 Claude Code:运行 Skill、写 brief、读报告并提交
- 准备 Codex CLI 并已登录:在沙箱内执行 codex exec 完成实现与测试(npm i -g @openai/codex 后 codex login,或 brew install codex)
- 准备 git 与 bash:克隆仓库、运行脚本、检查 git status
- 准备 Claude Code 与 Codex 的账号额度/订阅:两端都要消耗各自配额
- 准备 仓库外的 notes 目录(选用):存放 brief、运行日志与 Codex 报告,避免写进仓库
替代方案:手动在两个 CLI 之间复制粘贴任务。能做到:不用装 Skill,直接把任务描述贴给 Codex CLI 跑,再到 Claude 里评审。;差别:缺少 brief 模板、后台完成通知、报告契约与沙箱外复核流程,需人工同步状态,容易漏掉杂散文件与提交前检查。。
完成替代方案不算复现本实践。
按下面的步骤就能做出第一个结果。复制命令不会自动执行。
安装 Codex CLI 并登录
在终端安装 Codex CLI 并完成登录(如用 Homebrew 安装,改为 brew install codex)。
bash原始来源命令npm i -g @openai/codex预期结果:codex 命令可用
登录 Codex 账号
运行登录命令,按提示完成授权。
bash原始来源命令codex login预期结果:终端显示已登录,codex 能读取到账号额度
给 Claude Code 加插件市场
在 Claude Code 会话内执行,添加本仓库作为插件市场。
Claude Code原始来源命令/plugin marketplace add LeiZiKang/codex-delegate预期结果:插件市场中列出 codex-delegate
安装 codex-delegate 插件
在同一 Claude Code 会话内安装插件(也可改为 git clone 后把 skills/codex-delegate 拷到 ~/.claude/skills/)。
Claude Code原始来源命令/plugin install codex-delegate@codex-delegate预期结果:插件安装成功,Skill 可用
跑一次只读预检
在仓库的 skills/codex-delegate/scripts 目录下运行预检脚本,确认环境并检查 codex 是否为设置 CODEX_HOME 的 shell 函数或别名。
bash原始来源命令skills/codex-delegate/scripts/check-setup.sh预期结果:输出环境检查结果,指出缺失项或别名问题
发起第一次委派
在 Claude Code 里用自然语言触发,例如:Use codex-delegate for this refactor. Claude 会跑预检、写 brief 到仓库外 notes 目录、以后台任务运行 run-codex.sh,完成后读报告、查 git status 并在沙箱外复跑构建,通过后提交。
预期结果:notes 目录出现 run-<task>.log、last-<task>.txt 与 <task>.done,Claude 给出 Codex 最后消息、token 用量与 git status --short,并完成或请示后续