委托模式:用 Claude Code 同时调度 Codex 和 Gemini 绕过限速
Claude Code 作为父代理,同时调度 Codex 和 Gemini CLI 并行执行任务——三套独立 API 配额,互相兜底,零额外费用绕过单模型限速。本文介绍这套委托模式的工作原理和配置方式。

Claude Code、Codex CLI 和 Gemini CLI 各自有独立的 API 配额池。当一个工具触发限速时,另外两个还在跑——把它们并联起来,就是零额外成本的限速旁路。委托模式的核心是:Claude Code 作为父代理(编排者)负责规划和综合,Codex 和 Gemini 作为子代理并行执行具体任务,用文件作为通信媒介,结果汇总回 Claude Code。
为什么要并行而不是串行
单独使用一个工具,遇到限速就只能等待。而三套工具并行意味着:
- Claude Code 触发 Anthropic 的速率限制时,Codex 和 Gemini 继续执行
- 机械性任务(批量重构、文件扫描、测试生成)分发给多个代理并行完成,总时间接近最慢那个代理的单任务时间
- 不同模型在不同任务上各有优势:Gemini 的 100 万 token 上下文窗口适合大规模代码库分析,Codex 在终端任务上轻量快速
基础架构:文件作为通信媒介
三套 CLI 不需要直接通信,用文件系统中转就够了:
Claude Code (父代理 · 编排者)
├─ Bash → Codex CLI → Tasks/task_codex.md → Reports/codex_result.md
└─ Bash → Gemini CLI → Tasks/task_agy.md → Reports/agy_result.md
↓
Claude Code 读取所有结果,综合并决定下一步
任务文件由 Claude Code 写入,子代理读取后完成工作,把结果写回报告文件,Claude Code 再读取汇总。Claude Code 内置的完成通知基础设施会自动处理等待和回调,不需要轮询循环。
工具准备
| 工具 | 角色 | 安装 |
|---|---|---|
| Claude Code | 父代理 · 编排者 | claude.ai/code |
| Codex CLI | 子代理 A(OpenAI) | npm install -g @openai/codex |
| Gemini CLI(AGY) | 子代理 B(Google) | npm install -g @google/gemini-cli |
Codex 需要 OpenAI 付费计划。Gemini CLI 需要 Gemini 订阅。三者的费用各自计入自己的账单,互不影响。
在 Claude Code 里启动并行任务
# 同时在后台启动两个子代理
codex exec "读取 Tasks/task_codex.md,完成后把结果写回 Reports/codex_result.md" \
--dangerously-bypass-approvals-and-sandbox \
-o "codex_out.txt"
agy --prompt "读取 Tasks/task_agy.md,完成后把结果写回 Reports/agy_result.md" \
> agy_out.txt &
两个子代理后台运行期间,Claude Code 可以继续响应你的下一条指令。等两个代理都写回报告后,告诉 Claude Code 去读取和综合结果即可。
任务分配原则
不是所有任务都适合委托:
适合委托给子代理的:
- 批量重构(修改 50 个文件的命名约定)
- 代码扫描和审查(Gemini 的长上下文窗口优势明显)
- 测试生成(机械性工作,不需要全局规划视角)
- 文档更新(按模板批量生成)
应该留给 Claude Code 的:
- 架构决策和规划
- 跨子任务的结果综合
- 有依赖关系的顺序步骤
- 需要理解全局上下文的判断
与串行多代理的对比
串行模式(Claude Code → Codex → 等结果 → 下一步)的问题是时间线性累积。委托模式把独立任务并行化,总时间取决于最慢的子任务,而不是所有子任务的总和。
在实测场景(写这篇文章的方法本身也用了委托模式:Claude Code 同时生成 3 个草稿,然后综合成最终版本)下,总时间比串行快 2-3 倍。
注意事项
上下文隔离:子代理只看到它的任务文件,不看父代理的完整上下文。这既是优点(防止上下文污染),也是限制(复杂任务的前置背景需要在任务文件里明确写清楚)。
结果质量验证:父代理综合结果前,需要对子代理的输出做基本的合理性检查,不能盲目信任。子代理可能基于不完整的上下文做出局部合理但全局错误的决策。
限速旁路的边界:这个模式绕过的是每个工具自身的速率限制,但如果你同时对同一个服务的不同端点并发请求,仍然可能触发账户级别的限制。
常见问题
问:三个工具的费用加起来比单用一个贵吗? 答:每个工具只在被使用时产生费用。如果你把一个任务拆成三份并行执行,总 token 消耗和串行差不多,但完成时间更短。如果你充分利用了 Gemini 的免费额度和 Codex 的包月额度,边际成本可以接近零。
问:Cursor 也能用这套模式吗? 答:Cursor 目前没有内置的子代理调度系统。这套模式依赖 Claude Code 的 Bash 工具直接调用其他 CLI,是 Claude Code 特有的能力。Cursor 里用类似思路需要更多手工步骤。
问:子代理的结果如何合并回主项目? 答:子代理把结果(代码修改或报告)写入约定的报告文件,Claude Code 读取后决定怎么处理——可以直接 apply 补丁,也可以用结果作为下一步规划的输入。Git 作为最终的合并层,子代理的修改在主代理审核后才提交。