AX Vibe 项目

项目简介

AX（Agent Exchange）是一个本地优先的开源消息交换平台，专门解决多个 AI 编码 Agent 在同一台机器上协作时的通信问题。当前开发团队常会在同一个项目中同时运行 Claude Code（后端）、OpenCode（前端）和 Grok Build（代码审查）等多个 Agent，但这些 Agent 各自独立运行、互相感知不到，经常出现重复工作或接口不一致的情况。

AX 充当这些 Agent 之间的本地路由器和信箱：每个 Agent 连接时注册一个名字，其他 Agent 就可以通过名字向其发消息，消息通过本地代理路由，回复同样沿原路返回。整个通信过程完全在本地运行，不经过任何云端中转，也不产生额外的遥测数据。

核心功能

1. 本地消息路由

AX 的代理（broker）和信箱（mailbox）完全运行在用户本地机器上，不依赖任何云服务。Agent 发送的消息经本地路由后直接投递给目标 Agent 的会话，全程无网络传输。

2. 多 Agent 名字寻址

每个 Agent 运行时指定一个名字（如 api、web、reviewer），其他 Agent 通过这个名字发送定向消息。例如：Claude Code 可以对 OpenCode 说「请询问 api 关于响应格式，然后构建 UI」。

3. 多引擎支持

支持 Claude Code、Codex CLI、Grok Build、OpenCode 和 Pi 五种主流编码 Agent，覆盖 OpenAI、Anthropic、Grok 和开源模型提供商。不同引擎的 Agent 可以在同一个工作流中协作。

4. 权限边界保留

任务委托保持了原 Agent 的沙箱和工具审批控制权。接收 Agent 只能在自身权限范围内操作，不能突破发送方设定的工具访问边界。

5. 跨仓库通信

Agent 名字在同一个操作系统用户下跨目录生效，后端和前端即使分别位于不同代码仓库，也能通过 AX 互相通信。

6. 会话恢复

支持通过原生语法恢复已有对话，名字始终关联到创建时的会话，断连重连后消息继续可靠投递。

技术实现

AX 的技术架构包含三个核心组件：本地 WebSocket 代理（broker）、每 Agent 独立信箱（mailbox）和带投递回执的持久化消息队列。

代理进程启动后在本地端口监听，每个 Agent 以子进程方式连接并在代理处注册唯一的会话名字。消息发送时，发送方 Agent 调用 AX SDK 或 CLI 将消息体和目标名字发送到本地代理，代理查询名字到会话的映射后将消息写入目标信箱并等待确认回执。如果目标 Agent 当前不可达，消息进入持久化队列，在目标上线后立即投递。所有消息存储在本地文件系统（~/.ax/mailboxes/），不经过任何第三方服务器。

代理同时维护每个会话的元数据（最后活跃时间、在线状态），供发送方在消息发送前检查目标是否可达，实现可靠的同步/异步通信模式。Agent 的内容仍然发送给各自的 AI 提供商（OpenAI、Anthropic 等），AX 仅负责本地路由和交换，不介入模型调用。

快速上手

步骤一：安装 AX

在 macOS、Linux 或 WSL 2 终端运行安装脚本：

curl -fsSL https://useax.dev/install.sh | sh

或阅读 https://useax.dev/agents.md 手动安装 Agent Exchange 扩展。

步骤二：为每个 Agent 命名并启动

在独立终端窗口分别启动参与协作的 Agent，为每个指定一个简短名字：

# 终端 1：Claude Code 作为 API Agent
ax claude -n api

# 终端 2：OpenCode 作为 Web Agent  
ax opencode -n web

# 终端 3：（可选）Grok Build 作为 Reviewer
ax grok -n reviewer

步骤三：发起跨 Agent 协作

在 OpenCode 会话中直接用自然语言发出指令，例如：「请向 api 询问响应的字段格式，然后基于该格式构建注册表单UI，完成后让 reviewer 检查你的更改。」OpenCode 自动通过 AX 将请求路由到 Claude Code（api），收到回复后继续执行，再将结果发送给 Grok（reviewer）审查。

步骤四：查看通信状态

在任意终端运行 ax status 查看当前所有已注册 Agent 的在线状态和消息队列深度；运行 ax logs 查看实时消息流转日志。

适用人群

• 正在使用多个 AI 编码 Agent（Claude Code + OpenCode 等）协同开发复杂项目的开发者。
• 希望将大型任务拆分为「后端 Agent + 前端 Agent + 审查 Agent」分工协作的工程团队。
• 需要在多个代码仓库之间协调 AI 工作的全栈开发者。
• 研究和评估多 Agent 协作系统、关注本地数据隐私的 AI 研究者。

官方链接

• 官网：https://useax.dev
• 安装文档：https://useax.dev/docs/installation
• 快速入门：https://useax.dev/docs
• Agent 指南：https://useax.dev/agents.md