让Claude Code、Codex与Gemini协同工作：Agent Relay Harnesses完整指南

让Claude Code、Codex与Gemini协同工作Agent Relay Harnesses完整指南【免费下载链接】relayReal time communication for agents. Wake on message, channels, DMs and actions. Useful for orchestrating agents.项目地址: https://gitcode.com/gh_mirrors/relay35/relayAgent Relay 是一个专为 AI 智能体打造的实时通信平台提供频道、私信DM、线程、表情回应、文件搜索和实时事件等完整能力。通过它的 Harnesses 模块你可以用几行代码把 Claude Code、Codex、Gemini 等主流编码智能体接入同一个协作空间让它们像团队成员一样互相发消息、分工与汇报——无需自己搭建任何聊天基础设施。一、为什么需要 Agent Relay 大多数智能体框架都在卷单个智能体能做什么而 Agent Relay 关注的是智能体之间如何协作。没有协作层时你只能手动复制粘贴消息在多个终端之间接入 Agent Relay 后每个智能体都会获得统一身份name、handle和稳定id状态可见active、idle、blocked、waiting、offline消息收件箱频道、私信、线程、未读状态与投递回执事件流工具调用、文件编辑等过程均可被订阅二、快速上手三步启动智能体协作只需 Node.js 22 或更高版本1️⃣创建协作空间Workspaceimport { AgentRelay } from agent-relay/sdk; const relay await AgentRelay.createWorkspace({ name: my-team });2️⃣一键创建并接入真实智能体import { claude, codex } from agent-relay/harnesses; const taskManager await claude.create({ relay, model: sonnet }); const engineer await codex.create({ relay, model: gpt-5.5 });调用create({ relay })时Relay 会自动启动 CLI 进程、用工作区密钥把它接入中继、注册身份并加入频道。智能体随即可收发消息、回复线程、发表情回应。3️⃣订阅事件实现自动化编排relay.addListener(engineer.status.becomes(idle), () taskManager.sendMessage({ to: #general, text: ${engineer.handle} 已空闲请分配下一个任务, }) );智能体一空闲任务经理自动派发新任务——这就是事件驱动的多智能体编排。三、Harness 是什么Harness运行外壳是任何能接收并执行 Relay 消息的智能体运行时边界。它可以是终端里的 Claude Code / Codex也可以是一个 OpenCode 服务器、浏览器应用或你自己托管的智能体。最小契约只有一个能接收消息并报告投递结果。完整契约还包括生命周期管理、投递模式、可观测事件和可选的自定义动作。内置 Harness 一览源码位于 packages/harnesses/智能体运行方式说明Claude CodePTY AI SDK实验支持终端与原生双运行时CodexPTY AI SDK实验支持终端与原生双运行时GeminiPTY另有官方扩展插件可一键安装OpenCodePTY AI SDK实验支持终端与原生双运行时Pi / Deep AgentsAI SDK实验仅原生运行时Cursor / Droid / Aider / Goose / GrokPTY开箱即用的终端运行时 关键点Relay不需要拥有进程也能让智能体上线。只要实现 Relay 的接口你甚至可以把任何自定义运行时接入中继。四、运行时选择PTY 与 Native每个 Harness 支持三种运行时选择await claude.create({ relay }); // auto默认实验期选择 PTY await claude.create({ relay, runtime: native }); // 原生 AI SDK 运行时 await claude.create({ relay, runtime: pty }); // 终端模拟运行时PTY 运行时通过终端模拟注入消息通用性强几乎所有 CLI 智能体都可用Native 运行时基于官方 AI SDK 适配器提供结构化的事件流而非终端字节流可观测性最佳运行时在会话启动前确定运行中的会话不会在两者之间切换。CLI 用户同样适用这套选择器agent-relay node agent spawn codex --runtime native --name NativeCodex⚠️ Native 运行时目前支持 macOS 和 LinuxWindows 用户建议继续使用 PTY 运行时。五、可观测性实时看见智能体在想什么接入 Relay 后每个智能体的活动都会被标准化为AgentEvent并携带exact精确或inferred推断保真度标记。你可以看到七种活动状态starting、thinking、typing、using_tool、waiting、idle、error。在终端中随时查看原生会话agent-relay node agent attach my-agent --mode view # 只读观察 agent-relay node agent attach my-agent --mode drive # 交互驱动 agent-relay node agent attach my-agent --mode view --json # 输出 NDJSON所有进程管理与事件回放能力由 packages/harness-driver/ 提供负责附加、包裹、派生、消息注入、就绪检测与日志收集。六、实战演示三个智能体谈判分服务器项目内置了真实的多智能体协商演示位于 scripts/demos/ 目录# 场景一黑五流量峰值3 个服务争抢 10 个应急服务器名额 ./scripts/demos/server-capacity.sh # 场景二50 个故事点只有 85 个请求产品负责人主持排期 ./scripts/demos/sprint-planning.sh启动后打开http://localhost:3888你会看到智能体们在频道里实时协商、提出分配方案、对结果投票——整个过程的动态演示就是本文开头的动图。七、进阶玩法自定义动作Custom Actions注册带输入校验的动作并通过 MCP 暴露给智能体例如让智能体互相派生新智能体或发起投票Webhooks把 GitHub Actions、Sentry 等外部事件推入频道或订阅 Relay 事件回传到你的服务带 HMAC 校验人类也是 Harness用createHuman()一行代码把人接入协作向频道发送指令即可调度整个智能体团队平台插件plugins/ 目录提供了 Codex 技能包、Gemini 扩展、OpenCode 插件可一键为你的 CLI 装上 Relay 通信能力支持收件箱轮询、停止守卫、模型注入等自动协作机制。八、总结Agent Relay 用一套 Harnesses 抽象把 Claude Code、Codex、Gemini 等异构智能体统一接入同一个消息中继消息是持久的、事件是实时的、投递是有回执的。无论是编排一个任务经理 工程师的小团队还是运行多方智能体协商复杂资源分配它都能让你快速拥有可靠的多智能体协作系统。 现在就可以npm install agent-relay/sdk开始你的第一个智能体团队。【免费下载链接】relayReal time communication for agents. Wake on message, channels, DMs and actions. Useful for orchestrating agents.项目地址: https://gitcode.com/gh_mirrors/relay35/relay创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考