AI 多代理编程:2026 年最热门的开发范式
当一个 AI Agent 不够用时,让多个 Agent 协作——把一个开发任务拆开,并行开发、专业分工,从架构设计、实现、测试到代码审查、大规模重构都能同时进行。Claude Code、Codex、OpenCode 的官方文档都给出了各自的多代理做法,涵盖开启方式、配置写法与成本提醒。
什么是多代理编程?
多代理编程是指让多个 AI Agent 同时工作,各自负责不同的任务(如架构设计、前端开发、后端 API、单元测试与代码审查),通过协调机制实现高效协作:每个 Agent 在独立上下文里承担一部分,由主 Agent 或脚本负责拆分与汇总。截至 2026 年 10 月核对,Claude Code、Codex、OpenCode 都提供了写进官方文档的多代理做法,形式各不相同。
并行开发
多个 Agent 同时编码,前端和后端可以并行推进,互不等待。
专业分工
每个 Agent 专注一个领域(架构、实现、测试、安全),发挥各自所长
质量提升
Agent 之间互相审查代码,从多个角度发现问题。
Claude Code、OpenCode、Codex 的多代理方案
Claude Code Agent Teams
Claude Code 官方文档里的多代理功能:一个 lead 带多个 teammates,共享任务列表并可直接互发消息。
架构:lead → teammates(各自独立实例)→ 共享 Task List
OpenCode 多代理
开源多代理架构,内置 Build/Plan 代理,支持自定义代理,组合起来覆盖不同的开发流程。OpenCode 的官方文档把 agent 分为主代理与子代理:主代理是你直接对话的,子代理由主代理调用,也可以在消息里用 @ 唤起;两种都能自定义。第三方插件 oh-my-opencode 的仓库已更名为 oh-my-openagent,QCode 文档说明它的旧版内置代理角色表不再列出。
架构:主代理 + 子代理,内置 Build/Plan 与 General/Explore/Scout,均可自定义
Codex 子代理
OpenAI 的 Codex 官方文档:当前版本默认启用子代理工作流,按需并行启动多个 agent 并把结果汇总成一个回复;自定义 agent 用 TOML 文件定义。
架构:主会话 + 并行 agent 线程(/subagents 查看与切换)
| 特性 | Claude Code | OpenCode | Codex |
|---|---|---|---|
| 通信方式 | 共享 Task List + 直接互发消息 | 主代理调用,或消息里 @ 唤起 | 独立执行 |
| 代理数量 | 由任务决定(官方:无硬性上限) | 内置 2 个主代理与 3 个子代理,可再加自定义 | 按需为任务启动 |
| 任务管理 | 共享 Task List,由 teammates 领取并完成 | 主代理按任务分派专门的子代理 | 线程数上限可在 config.toml 设置 |
| 成本(相对) | plan mode 下约为普通会话的 7 倍(官方) | 取决于各代理选的模型 | 比单个代理运行更耗 token(官方提醒) |
示例场景
并行功能开发
前端 Agent 构建 UI 组件,后端 Agent 编写 API,测试 Agent 同步编写测试用例,几路工作并行推进。
多角度代码审查
安全 Agent 检查漏洞,性能 Agent 分析瓶颈,覆盖率 Agent 评估测试完备性,问题从多个角度被挑出来。
大规模迁移重构
按目录或模块分配 Agent,各自处理一部分迁移工作,合并后统一验证,重构并行推进。
通过 QCode.cc 统一管理
一把 QCode.cc API Key 可同时用于 Claude Code、Codex、OpenCode 等工具;按 token 计费,各模型单价见 /models。
一把密钥通用 — Claude Code、OpenCode、Codex 都用这一把 Key
成本可控 — 控制台的使用统计页按调用显示模型、token 数量与费用
灵活切换 — 按任务挑合适的工具与模型
2026 年 10 月实操:Claude Code、Codex 与 OpenCode 的多代理怎么开、怎么配
Claude Code:五种并行方式怎么选
截至 2026-10-20,Claude Code 官方文档列出五种同时处理多个任务的方式:子代理(subagents)、agent view、agent teams、动态工作流(dynamic workflows)和 projects。区别在于由谁协调、工人之间要不要互相通信、会不会改同一批文件。
- 子代理:在一个会话内派出的工人,在自己的上下文里做旁支任务并返回摘要。用 Markdown 文件定义,放在 .claude/agents/(项目)或 ~/.claude/agents/(个人);只有 name 与 description 必填,model 可写 sonnet、opus 等别名,也可写完整模型 ID。
- Agent teams:一个 lead 加多个 teammate,共享任务列表并可直接互发消息。属于实验功能、默认关闭,要设置 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 才能开启,而且只在交互式会话里生成 teammate。
- 动态工作流:由 Claude 写一个脚本来调度许多子代理,适合全仓审查、500 个文件的迁移这类任务;在提示里写 ultracode,或直接要求用工作流即可。
- Agent view:用 claude agents 打开,在一个界面里派发并监控后台会话(研究预览)。
- 会改同一批文件吗?agent teams 不会把 teammate 隔离到各自的 worktree,要按文件划分任务;子代理可以用 isolation: worktree 各拿一份独立副本。
Codex:子代理与自定义 agent
OpenAI 的 Codex 文档写明,当前版本的 Codex 默认启用子代理工作流。直接说「spawn two agents」或「每个要点一个 agent」,Codex 就会并行启动多个 agent,并把结果汇总成一个回复;在 CLI 里用 /subagents 在各个 agent 线程之间切换。Codex 内置 default、worker、explorer 三个 agent。
自定义 agent 是放在 ~/.codex/agents/(个人)或 .codex/agents/(项目)下的 TOML 文件,每个文件必须包含 name、description 和 developer_instructions,可以另设 model 与 model_reasoning_effort。自定义 agent 会继承父会话的权限、provider 和 MCP 服务器,所以主会话接好之后,子代理也沿用同一套配置。
全局设置写在 config.toml 的 [agents] 下,例如用 agents.max_concurrent_threads_per_session 限制并发线程数,用 agents.default_subagent_model 指定子代理的默认模型。官方提醒:子代理工作流比同类单代理运行消耗更多 token;建议先把并行用在读多写少的任务上(探索、测试、分诊、总结),并行改代码要更谨慎。
OpenCode:主代理与子代理
OpenCode 文档把 agent 分成两类。主代理是你直接对话的那一个,内置 Build 与 Plan,用 Tab 键切换;子代理是主代理可以调用的专门助手,也可以在消息里用 @ 提及来手动调用,例如 @general,内置的有 General、Explore 和 Scout。
自定义 agent 可以写在 opencode.json 的 agent 字段里,也可以作为 Markdown 文件放在 ~/.config/opencode/agents/(全局)或 .opencode/agents/(项目)。
一把 QCode Key 给三款工具供模型
截至 2026-10-20:Claude Code 设置 ANTHROPIC_BASE_URL=https://api.qcode.cc/api 和 ANTHROPIC_AUTH_TOKEN(以 cr_ 开头的 QCode 密钥);Codex 在 ~/.codex/config.toml 里加一个自定义 provider,填 base_url = https://api.qcode.cc/openai、wire_api = responses(provider 名字可自定);OpenCode 按 QCode 文档的 OpenCode 接入页配置——文档写明使用 OpenCode 需要开通 API 直接请求权限,该权限默认关闭,联系在线客服即可开通。
分工示例:lead 或编排用 claude-opus-5-5,执行子任务用 claude-sonnet-5-5 或 claude-haiku-5-5;Codex 侧可用 gpt-6.1-sol、gpt-6-sol 或 gpt-5.6-terra。OpenAI 文档建议轻量子代理用 gpt-6-luna,但 QCode 暂不提供 gpt-6-luna,请改用其他 GPT 模型。按 token 计费,各模型单价见 /models。
成本提醒:Claude Code 文档称,teammate 在 plan mode 下运行时,agent teams 的 token 用量约为普通会话的 7 倍。多代理任务先小范围试跑,再在 QCode 控制台按模型查看用量。
多代理编程常见问题
多代理编程是什么?
让多个 AI agent 各自在独立的上下文里处理任务的一部分,再由主 agent 或脚本拆分任务、汇总结果。Claude Code 的子代理、agent teams 和动态工作流,Codex 的子代理,OpenCode 的子代理,都属于这种做法。
Claude Code 的子代理和 agent teams 有什么区别?
按 Claude Code 文档:子代理把结果返回给调用方,结果以摘要形式回到主上下文,token 成本较低;agent teams 是完全独立的会话,teammate 之间直接互发消息、共享任务列表,每个 teammate 都是一个单独的 Claude 实例,token 成本更高。
Codex 怎么开多 agent 协作?
当前版本的 Codex 默认启用子代理工作流:直接跟 Codex 说「spawn two agents」或「delegate this work in parallel」即可,在 CLI 里用 /subagents 切换线程。想复用固定角色,就在 .codex/agents/ 下加 TOML 文件,写上 name、description 和 developer_instructions。
多代理会多花多少钱?
会更多,与 agent 数量和运行时长成正比。Claude Code 文档称 teammate 在 plan mode 下运行时,agent teams 的 token 用量约为普通会话的 7 倍;工作流文档和 Codex 文档也都提醒并行 agent 比单次运行消耗更多 token。先小范围试跑,简单子任务交给更轻的模型。个人套餐按天给额度、30 天有效,当天不够就买加油包。没有套餐、不想包月的,按量包 ¥26 起买一笔额度,7 天内用完为止(人民币充值 ¥30 起)。
多个 agent 同时改代码会互相覆盖吗?
可能会。给每个工人分配各自的文件或各自的 worktree:Claude Code 的子代理支持 isolation: worktree,agent teams 则需要按文件划分任务;OpenAI 文档也提醒,在 Codex 里并行做大量写入要谨慎。
在国内没有境外信用卡,怎么付款开通 QCode 给这些工具用?
可以用支付宝或微信支付,无需境外信用卡;也支持信用卡(Visa / Mastercard / AMEX)、Apple Pay、Google Pay 和加密货币(多币种多网络)。一把 Key 调用 Claude、GPT 与主流国产模型,Claude Code、Codex、OpenCode 可以共用;全程自助,几分钟上手。