Waihub Docs

MultiAgent ​

建议

配置 MultiAgent 工作流时，建议先让 AI 帮你生成团队分工、执行计划和质量门槛，再由你人工确认权限、文件边界和验收标准。

Subagent 能提高并行效率，但实际使用中也有明显瓶颈：多个 agent 之间通常不能直接交流、不能同步上下文，也没有共享任务面板。它适合“各做各的”，但不适合需要持续沟通和协作推进的大任务。

MultiAgent 更适合复杂团队任务。它把多个 agent 组织成一个协作团队，支持分工、同步、任务推进和结果整合。

Subagent 与 AgentTeam 对比
Subagent 与 AgentTeam 的协作方式对比。

推荐方案 ​

目前更推荐两类多代理能力：

  • Claude Code AgentTeam：适合本地工程开发、代码库改造、测试与审查协作
  • Kimi Agent Swarm：适合大规模并行任务、研究、文档、网页和综合交付

AgentTeam 的优势是工程开发更贴近 Claude Code 工作流；Kimi Swarm 的优势是横向扩展，适合大量子任务并行。

AgentTeam 和 Subagent 的区别 ​

类型通信方式协作方式适合场景
Subagent只向主会话返回结果主会话统一分配和汇总代码审查、调查、测试、单点验证
AgentTeamteam 成员之间可以沟通共享任务、互相同步、协同推进APP 开发、复杂重构、多模块交付
Kimi Swarm大量子代理并行自动拆解和并行执行大规模研究、资料整理、复杂交付

开启 AgentTeam ​

Claude Code 的 AgentTeam 是实验功能，默认关闭。需要在 settings.json 中开启。

用户级配置文件位置：

text
~/.claude/settings.json

写入：

json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

如果你已经配置了 Waihub，可以把它合并到原来的 env 中：

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "xxxx",
    "ANTHROPIC_BASE_URL": "https://waihub.top",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

注意

示例里的 xxxx 请替换为你自己的 Waihub API Key 和 Claude 渠道地址。不要把真实密钥提交到仓库或公开截图。

修改后，重新启动 Claude Code。

使用流程 ​

1. 进入 tmux 终端 ​

AgentTeam 会启动多个 Claude Code 会话。推荐在 tmux 中运行，方便同时观察多个会话。

bash
tmux new -s agent-team

进入项目目录后启动 Claude Code：

bash
cd /path/to/your/project
claude

2. 给出团队任务 ​

示例提示：

text
阅读 @docs/PRD.md，创建一个 agent team 完成 APP 开发。

团队至少包括：
- 前端工程师：负责页面、交互、样式和响应式
- 后端工程师：负责接口、数据模型、鉴权和错误处理
- 测试工程师：负责测试计划、关键用例、回归检查

要求：
1. 先列出分工、文件边界和计划
2. 不同成员不要修改同一批文件
3. 每个阶段结束后同步进度和风险
4. 完成后由测试工程师做验收

3. 自动化 AgentTeam ​

Claude Code 会根据任务创建 team，分配成员，并协调推进。

Claude Code AgentTeam 自动协作
Claude Code AgentTeam 自动拆解和协作推进任务。

适合 AgentTeam 的任务 ​

适合：

  • 从 PRD 开发一个完整 APP
  • 前后端同时推进
  • 大型重构
  • 多模块迁移
  • 需要测试、审查、文档同步参与的任务
  • 需要多人角色互相讨论和同步的复杂任务

角色设计 ​

常见团队配置：

APP 开发 ​

  • Product Lead：梳理 PRD、拆任务、确认验收标准
  • Frontend Engineer：页面、状态、交互、样式
  • Backend Engineer：接口、数据库、鉴权、错误处理
  • Test Engineer：测试用例、回归、边界检查
  • Reviewer：最终审查和风险汇总

重构任务 ​

  • Architect：拆解模块和迁移顺序
  • Module Owner A：负责一个明确模块
  • Module Owner B：负责另一个明确模块
  • Test Engineer：跑测试、定位失败
  • Reviewer：检查行为兼容性

代码审查 ​

  • Security Reviewer：安全和权限
  • Regression Reviewer：行为回归
  • Test Reviewer：测试覆盖
  • Docs Reviewer：文档和迁移说明

使用建议 ​

  • 先让 team 输出计划，再开始写代码
  • 给每个成员明确文件边界
  • 让测试角色尽早介入，而不是最后才验收
  • 中途要求 team 汇报当前状态、阻塞和风险
  • 复杂任务用 tmux 保持会话可见
  • 完成后仍要人工审查 Git diff

注意

AgentTeam 会产生更高的 token 和工具调用成本。任务越大、成员越多，成本越高。建议从 3 到 5 个角色开始，不要一上来创建过大的团队。

Kimi Swarm ​

Kimi Agent Swarm 是 Kimi K2.6 Agent 的多代理并行能力，适合让大量子代理并行处理研究、资料整理、网页生成、文档和综合交付任务。

适合场景：

  • 大规模信息收集
  • 多主题研究
  • 资料对比和归纳
  • 文档、表格、PPT 综合产出
  • 不需要精细本地代码权限控制的复杂任务

如果任务是本地代码库开发，优先使用 Claude Code AgentTeam；如果任务是资料密集型、产出型、可大规模并行的任务，可以考虑 Kimi Swarm。

资源网站 ​

建议

从 Subagent 过渡到 AgentTeam，不要只增加人数。关键是让角色之间有明确协作关系、共享任务节奏和最终验收标准。

Waihub Documentation

Copyright © 2026 Waihub