agentcourier

agentcourier

让你的 AI Agent 安全地跨设备相互交流。
一个用于 Claude Code、Codex、GitHub Copilot 和其他 MCP 客户端之间 Agent 对 Agent 消息与文件传递的 MCP 服务，
可在你的笔记本电脑、HPC 集群或同事的设备上运行。端到端加密，无需服务器，无需云端。

功能

• Agent 之间传递消息和文件。 笔记本电脑上的 Agent 可以让集群上的 Agent 检查模拟；检查结果会返回到同一对话中。也可以发送文件。
• 配对一次，即可持续使用。 设备只需配对一次。Agent 可以关闭后重新启动；它们会保留名称，离线 Agent 收到的消息会一直等待，直到它重新上线。
• 支持正在运行的会话。 在 Claude Code 中，消息会直接显示在会话中。其他客户端只需调用一次工具即可读取消息，你还会收到桌面通知。
• 仅限已配对的设备。 无需账户、服务器或云端。每个连接都经过端到端加密，并能抵御未来的量子计算机。
• 内置防护机制。 个人数据和机密会被屏蔽，文件会经过恶意软件扫描，并会告知 Agent 将收到的消息视为不可信内容。

对于 Agent 来说，agentcourier 就是一个普通的 MCP 服务，提供 courier_send、courier_send_file、courier_inbox、courier_peers 和 courier_set_name 工具。

开始使用

1. 在每台机器上安装（一个小程序，无需管理员权限）：

pip install agentcourier

或者使用 Rust：cargo install --git https://github.com/alhermann/agentcourier。

2. 配对两台机器，只需一次。在另一台机器要连接的机器上（例如你的集群）：

agentcourier invite laptop

它会打印一个一次性代码。在另一台机器上粘贴该代码，并说明如何连接到第一台机器（这里通过 SSH 隧道）：

ssh -N -L 17312:127.0.0.1:7312 you@cluster-login-node
agentcourier join agentcourier-… hpc 127.0.0.1:17312

提示：用机器所有者的名字为机器命名（agentcourier invite jana），这样你就可以说“询问 Jana 的 Agent”。

3. 将 agentcourier 添加到你的 Agent 中：

claude mcp add --scope user agentcourier -- agentcourier mcp --channel
claude --dangerously-load-development-channels server:agentcourier

{
  "servers": {
    "agentcourier": { "type": "stdio", "command": "agentcourier", "args": ["mcp"] }
  }
}

[mcp_servers.agentcourier]
command = "agentcourier"
args = ["mcp"]

如果系统找不到 agentcourier 命令，请使用 pip 或 cargo 在安装过程中打印的完整路径。

4. 开始交流。 告诉你的 Agent，例如：“问问 hpc 上的 Claude，我的网格研究是否已完成，并把 results/summary.csv 发给它。”

每个会话都会根据其工具和项目获得一个清晰的名称，例如 copilot-paper 或 claude-femsim；完整地址为 claude-femsim@hpc。你也可以告诉 Agent “把你的名字设为 fe-runs”。Agent 会通过 courier_peers 查询当前在线的对象，以及之前出现过的对象。

查看当前状态

agentcourier peers      # who is reachable, and agents seen before
agentcourier status     # connections, paired machines, refused attempts
agentcourier log        # recent activity (no message text)
agentcourier untrust X  # cut off a machine immediately

常见问题

如何让两个 Claude Code 会话互相交流？

将 agentcourier 添加到 Claude Code 中（第 3 步）。每个会话都会获得一个名称，例如 claude-femsim，并可按名称向任何其他会话发送消息，无论对方在同一台机器上还是已配对的机器上。

Claude Code、Codex 和 GitHub Copilot 可以互相交流吗？

可以。agentcourier 是标准的 MCP 服务，因此不同厂商的 Agent 可以用相同的方式互相连接，例如笔记本电脑上的 Copilot 窗口和服务器上的 Claude Code 会话。

如何连接笔记本电脑上的 Agent 与远程服务或 HPC 集群上的 Agent？

在两边都运行 agentcourier，配对一次，然后通过 SSH 隧道连接；无需更改防火墙设置或管理员权限。请参阅指南，其中还介绍了两台仅共享 SSH 服务的办公室电脑的配置方法。

我的 Agent 可以和同事的 Agent 交流吗？

可以，只要你们的两台机器已配对即可。你们分别为对方的机器命名，这样你就可以说“询问 Jana 的 Agent”。收到的消息会被视为不可信文本，Agent 会在执行操作前征求用户同意。

安全吗？需要服务端或账号吗？

整个过程不涉及服务端、账号或云端服务：只有已配对的机器才能连接，并且每个连接都经过端到端加密，并具有后量子保护。个人数据和机密信息会被屏蔽，收到的文件会经过恶意软件检测。详情和限制请参阅安全。

这与 A2A 或多 Agent 框架有什么不同？

AutoGen、CrewAI 或 LangGraph 等框架会在一个程序中运行多个 Agent，而 A2A 则通过 Web 连接 Agent 服务。agentcourier 会连接你已在使用的编码 Agent，让它们在运行中的会话里跨机器和人员协作。

了解更多

• 用户指南：名称和地址、文件、通知、命令、配置、集群
• 安全：配对、加密、遮蔽和文件筛查的工作方式及其限制

许可证

Apache-2.0