Agent Teams 与 Channels

Agent Teams 和 Channels 都是“让 Claude Code 不只等你输入”的能力,但它们解决的问题不同:

#Agent Teams 什么时候用

Agent Teams 适合需要多个独立 Claude instance 互相协调的工作。它不是 subagent 的简单别名。

官方当前把 Agent Teams 作为实验能力,默认关闭。启用方式:

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

如果要让 teammate 用分屏显示,可以设置 teammateMode,或单次启动时传 claude --teammate-mode auto。分屏模式依赖 tmux 或 iTerm2 的 it2 CLI。只做普通协作时,默认 in-process 模式更稳。

典型用法:

Spawn 3 teammates: one for security review, one for performance review, and one for test coverage. Have them report separately, then cross-check each other's findings.

#Team lead、teammate 和 mailbox

官方把 Agent Teams 拆成几个角色:

使用时要给每个 teammate 明确角色、输入材料和验证口径。不要只说“帮我 review”,应该说明严重性标准、要跑的测试、哪些文件不可改。

#权限和质量门

Agent Teams 的风险来自“多个 agent 同时有工具权限”。建议:

1. 默认先让 teammate 做 research 和 review,不要一开始就允许所有人编辑。
2. 写操作走 ask 或限定目录。
3. 大任务用 worktree 隔离,避免多个 teammate 改同一文件。
4. 用 Hooks 做质量门,例如测试失败不能完成任务。
5. 让 team lead 等 teammate 完成后再汇总,不要提前结束。

#Channels 是什么

Channels 让 MCP server 主动向 Claude Code session 推送事件。普通 MCP 是 Claude 需要时去调用工具,Channels 是外部系统有事时把消息送进会话。

Claude 会把事件作为 <channel> 内容读到上下文中,然后按 instructions 判断要不要回复、要不要调用工具、要不要等待人工批准。

#官方 channel 入口

官方预置 channel 通常通过插件安装,再用 --channels 启动:

claude --channels plugin:fakechat@claude-plugins-official

开发自己的 channel 时,研究预览期间需要开发 flag:

claude --dangerously-load-development-channels server:webhook

.mcp.json 中存在 server 不代表它能推送 channel 事件。server 还必须在启动参数中被列为 channel,并且没有被组织 policy 阻断。

#Channel MCP server 需要什么

官方 reference 里,Channel server 通过 MCP capabilities 声明自己支持 channel。

通知 payload 通常包含:

meta key 只能使用标识符字符。带连字符或特殊字符的 key 可能被丢弃,所以建议统一用 snake_case。

#Webhook channel 架构

通知没有端到端 ack。mcp.notification() 只说明写入 transport,不代表 Claude 已经处理。如果需要确认,让 Claude 调用 reply tool 回传状态。

最小事件形态:

<channel source="webhook" severity="high" run_id="1234">
build failed on main: https://ci.example.com/run/1234
</channel>

#Permission relay

Permission relay 可以把本地工具审批转发到远端 channel。你在手机或聊天工具里看到一个审批请求,回复批准或拒绝后,Claude Code 再继续。

安全重点是 sender gating:只有可信发送者能触发消息或批准权限。不要让公开 webhook 直接拥有批准生产命令的能力。

#企业控制

Channels 处于研究预览或快速演进阶段时,组织更应该集中控制。

#缓存和成本影响

如果事件很频繁,要控制 channel 内容长度。把长日志放链接或 artifact,让 Claude 按需抓取,不要每次把完整日志推入会话。

#Passion8 边界

#官方参考

• Agent teams
• Channels
• Channels reference
• Run agents in parallel
• Agent View
• Dynamic workflows

#相关页面