从 /list-agents 到 SendMessage：手把手实现多个 Claude Code 会话互通
2026 年 8 月 7 日，Anthropic 发布 Claude Code v2.1.224。本次更新最受关注的功能便是跨会话消息通信——你在多个终端窗口运行的 Claude，终于能够互相交流。
但"具备通信能力"和"熟练用好通信能力"完全是两回事。本文不空谈概念，只讲解实操流程，从 /list-agents 到 SendMessage，一步步完整走通。
前置条件：零配置，但需核查两件事
跨会话通信要求 Claude Code v2.1.224 及以上版本，运行环境为 macOS 或 Linux（含 WSL 2）。满足条件时，功能默认开启，无需额外配置。
排查问题时，先在终端执行：
claude --version确认版本号 ≥ 2.1.224。
⚠️ 需要注意的边界：原生 Windows 客户端目前暂不支持；Amazon Bedrock、Claude Platform on AWS、Google Cloud Agent Platform、Microsoft Foundry 等第三方接入渠道未开放该特性，仅支持直连 Anthropic API 或 claude.ai 环境使用。跨设备主动发起通信，需要升级至 v2.1.225 及以上版本。
第一步：/list-agents 查询所有在线会话
跨会话通信的首要任务：找到通信对象。/list-agents（别名 /peers） 就是用于检索会话的指令。
在任意 Claude Code 会话内输入：
/list-agents或者：
/peersClaude 会扫描本机所有活跃会话的注册信息，返回可通信对象列表，包含三类会话：
子智能体：当前会话内派生出来的子任务
其他本地会话：同一设备上运行的其余 Claude Code 会话（包含后台运行会话）
远程受控会话：通过远程控制建立的跨机器会话（标注 Remote Control）
每个会话都拥有标识名称。你可以用 /rename 给会话设置易懂名称（例如"前端会话"），列表中将展示自定义名称；未命名时，Claude Code 会基于工作目录自动生成名称，格式类似 myapp-3f。
💡 一个细节：智能体团队（Agent Teams）内的协作成员不会出现在这份列表中。Claude 通过团队独立成员清单联络它们，寻址机制不同。
第二步：用自然语言驱动 SendMessage
找到目标之后，下一步就是发送消息，SendMessage 负责实现消息推送。但你不必手动调用 SendMessage，只需要用自然语言把意图告诉 Claude。
举个例子，你在 A 会话（前端）修改了接口字段：
通知 B 会话，我已经将 users.name 修改为 users.show_name
Claude 会自动调用 ListAgents 定位 B 会话，再通过 SendMessage 发送变更摘要。你甚至不需要组织消息文本，Claude 会自行提炼关键信息。
还有一种场景：当 Claude 检测到本次代码改动会影响其他正在运行的会话时，还会主动发送提醒。你只需要下达一句指令，剩下全部交由 Claude 处理。
第三步：理解消息的传输规则
SendMessage 仅传输纯文本摘要，不会附带对话历史、源码文件以及系统权限。
接收端的 Claude 只会在单轮任务的工具调用间隙读取消息；正在执行 Shell 命令或工具调用时不会被打断。当前操作完成后，会携带这条消息开启新一轮工作。收到消息的终端会弹出带标签卡片，并附带发送方会话入口。
接收方会对每条消息进行判定，分为三种状态：
交付执行（accept）：直接交由 Claude 处理
暂存等待（hold）：临时保存消息，等待进一步确认
直接拒绝（refuse）：丢弃本条消息
入站行为可通过 crossSessionInbound 参数精细管控。若未显式设置，Claude Code 会比较收发双方的权限模式类别：若权限类别不一致，消息会被暂存，等待用户批准，审批对话框默认 5 分钟过期。这套设计体现了"权限越松、入站门槛越高"的防御思路。
第四步：跨机器通信的边界
同一台设备依靠本地 Unix 套接字通信，整个流程不经过 Anthropic 服务器，即便断网状态下多个终端之间依旧能够收发消息。
跨机器通信依靠远程控制通道中转，存在一条关键限制：v2.1.224 版本中，跨机器场景下 Claude 只能回复收到的消息，无法主动发起对话。自 v2.1.225 版本起，SendMessage 已经能够主动向跨机器远程受控会话发起通信，跨机交互正从"被动应答模式"转向"主动发起模式"。
社区已有的落地实践
社区基于这套机制开发了不少工具。Peer sessions 是一套实用方案：可在单台设备拉起一整组 Claude Code 会话，支持互相收发消息，能够一键创建协作小组、分配任务、汇总反馈、解散团队。借助相关插件，你可以直接在一个会话发起查询："问问后端会话鉴权令牌的格式是否变更"，目标会话将自动给出答复。
从执行 /list-agents 查询在线会话，到用自然语言指挥 Claude 调用 SendMessage 推送消息，再到接收方静默处理通知。整套流程从头到尾，不需要你手动调用任何工具。你只需要说出需求，Claude 会完成全部后续流程。
当多智能体协同成为常态，模型接入更需稳定底座
跨会话消息让单个开发者得以调动 3-5 个乃至更多 AI 智能体并行作战。但当多智能体协同成为工程常态，模型调用的稳定性、成本与合规性，就成为决定团队效能的关键变量。
对于需要大规模调用 Claude、Gemini、ChatGPT、DeepSeek 等全球主流大模型的团队而言，逐一注册海外账号、配置跨境支付、应对地区可用性限制，往往比模型本身更难攻克。UseAIAPI 一站式聚合上述全球主流大模型的最新版本，支持企业级定制化部署，让开发者无需为每个大模型分别注册海外账号，一套 API Key 即可打通多模型调用。
在具体权益上，平台的优势体现为三个层面：
显著的价格优惠。UseAIAPI 平台折扣最低可达官方价格的 50%。
企业级定制能力。平台支持按需定制并发、配额与路由策略，满足高强度内容生成、自动化智能体、大规模文档处理等重消耗场景。无论是面对 Claude Opus 级别的编程旗舰，还是 Gemini 3.5 Flash 这类高性价比主力，企业用户均可根据业务特征灵活配置，将长上下文、高并发、持续运行的智能体工作流的单位成本压到更低。
合规的基础设施。通过海外合规节点接入官方 API，提供企业级 SLA 保障，规避个人开发者难以解决的地区可用性门槛与数据中心 IP 风控风险。平台层面可对接 Gemini API 原生的项目支出上限与使用分层机制，让开发者同样享受到谷歌 2026 年推出的预算管控能力，实现成本精细化管控。
💡 当 Claude Code 的智能体集群在工作树间自主协同，真正的竞争力不仅在于"用得起多少个 AI"，更在于"以多低的成本、多高的稳定性，把每一次模型迭代的红利稳定地用起来"。通过 UseAIAPI 接入，叠加最低官方价 5 折的优惠权益，真正实现"无忧接入、按需扩展"，不再为高频调用的成本压力而担忧。
从 /list-agents 的会话发现，到 SendMessage 的消息推送，再到 UseAIAPI 的模型接入普惠——AI 并行编程的完整基础设施，正在一次次迭代中清晰成形。而当这套能力真正触达每一位开发者时，"一个 AI 开发团队"才不再是一句比喻，而是每一次 claude --worktree 启动后真实运转的现实。