Code Relay 是一个基于 MCP 的编码代理集成工具，用于跨机器开发与验证。它让 AI 在一台机器（Dev Host）上实现请求，在另一台机器（Target Host）上运行真实验证，并通过结构化回执返回结果，指导下一轮修复迭代。它支持 Codex、Claude Code、Cursor、VS Code 等兼容 MCP 的编码代理。
【用途】 Code Relay 适用于以下场景：
- 不同环境：在 Windows 或 macOS 上开发，在 Linux、私有网络或类生产主机上验证。
- 特殊硬件：将模型代码发送到 CUDA/GPU 机器，或验证摄像头、串口设备、传感器等连接位置。
- 真实集成：测试支付回调、队列、数据库、浏览器或无法在本地复现的内部服务。
- AI 驱动迭代：返回具体的预期/实际结果，让编码代理修复、重新发布并重试。
【主要能力】
- 按分支限定的项目绑定与短期加入链接。
- 在隔离工作树中精确验证源代码提交。
- 通过 code-relay-checkpoint GitHub Actions 自托管运行器执行检查点。
- 经过允许列表的安全验证命令，带输出边界与超时限制。
- 生成结构化的 receipt.json 和人类可读回执，记录通过、失败或阻塞的运行。
【使用方式】 AI 客户端安装：可让编码代理阅读并遵循相关说明，将 codex 替换为 claude-code、cursor、vscode 或 generic 等即可。 MCP 服务器详情：Code Relay 是一个本地 MCP 服务器，通过 stdio 通信。npm 包启动服务器。该服务器直接用 Go 实现 MCP JSON-RPC 接口（不依赖第三方 MCP SDK），支持 initialize、ping、tools/list 和 tools/call，并暴露相应工具。实现与传输循环位于 internal/relay/mcp.go。 工作流程：Dev Host 通过 Relay 发送绑定仓库与分支的运行手册；Target Host 在其真实环境中检查确切的源代码提交，并返回记录检查点结果的回执。每个运行手册都绑定到仓库、分支和源代码提交。Target Host 充当检查点，产生的回执记录通过、失败或阻塞的验证，用于下一轮迭代。 相关指南包括：AI 客户端安装指南、本地桌面安装运行手册、部署与运行手册。
【限制】 资料中未提供价格、平台支持的具体完整列表、运行手册的详细内容或其他使用限制。
