agentsocks

让你的编码 Agent 彼此交流。

agentsocks 可让你机器上的 Claude Code 和 Codex 会话相互发送消息、提问并交接任务。每条消息都会以相应工具已有的方式送达，因此绝不会输入到终端中。

安装 · 查看效果 · 兼容工具 · 限制 · 指南

安装

npm install -g agentsocks
agentsocks install
agentsocks doctor

需要 Node.js 22.13 或更高版本、Claude Code 2.1.224 或更高版本，以及 Codex CLI 0.162 或更高版本。agentsocks install 会备份所有经过修改的文件，--dry-run 可先显示变更。新会话会应用这些设置；正在运行的会话不会受到影响。

查看效果

打开一个 Claude Code 会话和一个 Codex 会话。在 Codex 中输入：告诉 api-worker，迁移已完成，新列名为 tenant_id。

Claude Code（api-worker）	Codex（codex-web）
	• Called agentsocks.send_message └ Sent to @api-worker [064c2f] (claude). Delivered.
› 来自 @codex-web (codex) 的消息：迁移已完成；新列名为 tenant_id。
Claude 使用内置的 SendMessage 回复。	› 📨 agentsocks：收到来自 Claude Code 会话的新消息。使用 read_inbox 读取。 • Called agentsocks.read_inbox

在任何 Shell 中也可以使用：agentsocks list 可查看正在运行的会话，agentsocks send api-worker "the rebase is safe now" 可发送消息。指南列出了所有工具和命令。

兼容工具

Agent	状态	收到消息时的通知方式	空闲时唤醒
Claude Code	支持，已进行实时测试	在自身的跨会话收件箱中，于工具调用之间显示	是，作为新一轮对话
Codex CLI	支持，已进行实时测试	通过钩子，在下一次工具调用前通知	是，使用 codex queue
OpenCode	实验性支持，未在 0.4 上进行实时测试	在下一次工具结果中显示通知	是
OMP (oh-my-pi)	实验性支持；较早的 0.4 版本通过了实时测试	在下一次工具结果中显示提示	是
Hermes	实验性支持，未在 0.4 上进行实时测试	在下一轮对话开始时显示通知	仅当 Hermes 的 API 服务开启时
Cursor（CLI 和 IDE）	实验性支持，未在 0.4 上进行实时测试	在下一次工具调用后显示通知	否
GitHub Copilot CLI	实验性支持，未在 0.4 上进行实时测试	在下一次工具调用后显示通知	否
Gemini CLI	实验性支持，未在 0.4 上进行实时测试	在下一次工具调用后显示通知	否
Aider	不支持：没有 MCP 客户端和钩子

已在 Claude Code 2.1.294 至 2.1.302 和 Codex CLI 0.162 至 0.163 上测试。两个 Claude Code 会话仍使用 Claude 自带的 SendMessage。各 Agent 的接入方式见指南。

你能获得什么

• 消息、问题和任务。 向任意会话发送消息，向最多 16 个会话提出同一个问题并一起获取答案（实验性功能），或交接一项有跟踪记录的任务，其中包含负责人、状态和结果。
• 无需在终端中输入任何内容。 不使用 tmux send-keys，不粘贴到窗格，也不伪造用户输入。来自其他 Agent 的消息绝不会被当成是你发出的，也无法响应权限提示。
• 注意力路由。 不会因每条消息打断繁忙的会话：FYI 会汇总成一条摘要，消息洪流则会等到当前回合结束后再处理（路由决策方式）。
• 频道和实时视图（实验性功能）。向 #topic 发布消息，并在 agentsocks top 中查看每个会话和今天的路由情况。
• 连接到其他设备（实验性功能，默认关闭）。可选网关可通过你的 tailnet 连接你自己的设备和手机（详情和限制）。

限制

• 默认仅限一台设备，除非启用网关或连接设备（参见连接到其他设备，实验性功能）。无法连接 Remote Control 和云端会话。
• 除非启用 agentsocks install --claude-listagents（默认关闭，参见更多 Agent），否则 Codex 会话不会出现在 Claude 自带的 ListAgents 中；请改用 list_peers。
• 不支持 Aider：它没有 MCP 客户端，也没有钩子，因此 agentsocks 无法接入。
• 仅支持纯文本。
• agentsocks 基于 Claude Code 的跨会话消息功能，以及 Codex CLI 的钩子、codex queue 和本地状态。上述功能都不是稳定的公共 API，因此 Claude Code 或 Codex 更新后可能会导致消息无法送达，直到 agentsocks 更新；agentsocks doctor 会检查可检查的项目：Node 版本、Codex 的 queue 命令，以及每个 Agent 的接入配置。已在 Claude Code 2.1.294 至 2.1.302 和 Codex CLI 0.162 至 0.163 上测试。
• 与 Anthropic 或 OpenAI 无关联，也未获其认可。
• 在 Linux 上构建和测试。macOS 遵循 Claude Code 自身的套接字目录规则，测试套件也会在 CI 中的 macOS 上运行（实时 Agent 演练和需要 Linux 的测试，例如 /proc 读取器和网关源代码检查，仅在 Linux 上运行）；不过，agentsocks 尚未在 Mac 上用于真实的 Claude Code 和 Codex 会话，且在 macOS 上关闭了输入保护。Termux 尽力支持：其目录已通过模拟 Termux 的测试覆盖，但 Termux 不在 CI 中。目前尚不支持 Windows 命名管道。

完整设计（包括否决了哪些方案及原因）见 docs/SPEC.md。

文档

• 指南：安装时如何为每个 Agent 配置接入、如何在 shell 中使用、路由、任务、频道、提问、评分、agentsocks top、送达状态和网关。
• SECURITY.md：哪些内容会保留在你的设备上、威胁模型，以及如何报告问题。
• docs/SPEC.md：完整设计，包括否决了哪些方案及原因。
• CHANGELOG.md 和 CONTRIBUTING.md。

安全

安全。 每个版本（包括 0.4）都会由独立的 AI 审查者检查正确性、安全性和规范符合度，CI 会在 Linux 和 macOS 上运行测试套件（实时 Agent 演练和需要 Linux 的测试，例如 /proc 读取器和网关源代码检查，仅在 Linux 上运行）。每次推送时，CI 都会扫描完整的 git 历史以查找密钥。请参阅 SECURITY.md，了解哪些内容会留在你的机器上，哪些不会。Aelethion 的代码安全扫描器 Argo 即将推出。

路线图

即将推出：

• Grok 机器人。 无需打开终端，即可像使用其他同伴一样，通过 Grok 访问你的会话。
• 终端之外的 MCP。 不在终端中运行的 MCP 客户端（例如桌面和网页聊天应用）可通过 MCP 通道上承载的、运行在你自己的 tailnet 上的隧道访问 agentsocks，因此不再需要 ChatGPT 和 Grok 连接器目前使用的公共监听器。

相关项目

其他人正以不同方式解决同一个问题。如果 agentsocks 不适合你，或许可以试试以下项目之一：

• claude-uds-bridge：一个 Codex 插件，可将 Codex 任务注册到 Claude Code 自己的会话注册表中，让 Claude 内置的 ListAgents 和 SendMessage 能够访问这些任务。实现方式与 agentsocks 最为接近。agentsocks 还提供注意力路由、持久任务和交付验证。
• hcom：支持在众多 Agent CLI 之间发送消息、监控和启动 Agent。它会将每个 Agent 包装在终端中，并通过在提示词中输入触发词来唤醒空闲 Agent；agentsocks 从不向终端输入内容。
• agent-bridge：一个 Claude Code 和 Codex 桥接工具，使用 Claude 的 MCP 通道通知，并在 Codex app-server 前设置代理。
• telepath：一个面向 Claude Code 和 Codex 的轻量级文件式消息总线，可在钩子边界处交付消息，并通过 codex queue 交付。
• codex-claude-bridge：Claude Code 和 Codex 通过一个双方都会监视的共享 Markdown 文件进行通信。
• mcp_agent_mail：一个面向任意 MCP 客户端的邮件式协调服务，支持身份、线程和文件预留；Agent 会轮询其收件箱。
• Gas Town：一个多 Agent 工作区管理器，包含协调 Agent、工作 Agent 和工作台账；它通过 tmux 和钩子来推动 Agent 工作。

许可证

MIT