A2A Code

终端里的 AI 编程助手 — 开源、多模型、社区驱动。

A2A Code 是一个开源的终端 AI 编程助手，支持 Anthropic / OpenAI / Gemini / Grok 多协议，具备远程控制、Langfuse 监控、ACP 协议等企业级特性。

在线文档 | Discord

特性

| 特性 | 说明 | 文档 | |------|------|------| | 多 Provider 配置 | 命名 Profile 切换 Anthropic / OpenAI / Gemini / Grok | Provider Profiles | | ACP 协议 | 接入 Zed、Cursor 等 IDE，支持会话恢复、Skills、权限桥接 | ACP for Zed | | Remote Control | Docker 自托管远程控制面板，Web UI 管理 Agent | Remote Control | | Langfuse 监控 | 企业级 Agent 监控，追踪每次 agent loop 细节 | Langfuse | | Web Search | 内置网页搜索工具 | Web Search | | Voice Mode | 语音输入，支持豆包语音输入 | Voice Mode | | Computer Use | 截图、键鼠控制 | Computer Use | | Chrome Use | 浏览器自动化 | Chrome Use | | Workflow Scripts | 自定义脚本工作流 | Workflow |

安装

方式一：npm 全局安装（推荐）

系统要求： Node.js >= 18

npm install -g a2a-code

安装完成后直接运行：

a2a          # 使用 Node.js 运行
a2a-bun      # 使用 Bun 运行（需先安装 Bun）
a2a update   # 更新到最新版本

国内网络慢？ 使用淘宝镜像加速：

npm install -g a2a-code --registry https://registry.npmmirror.com

方式二：免安装直接运行（npx）

npx a2a-code

方式三：源码构建

环境要求： Bun >= 1.3.11

# 安装 Bun（macOS/Linux）
curl -fsSL https://bun.sh/install | bash

# 克隆仓库
git clone https://github.com/Mtianwai/a2a-code.git
cd a2a-code

# 安装依赖
bun install

# 开发模式（热重载）
bun run dev

# 构建生产版本
bun run build
node dist/cli.js   # 运行构建产物

更新

# npm 全局安装的用户
npm update -g a2a-code

# 或在 A2A Code 内部
a2a update

配置 Provider

首次运行后输入 /login 进入配置向导，或 /provider 管理多个 Profile。

选择 Anthropic Compatible 即可对接任意 Anthropic Messages API 兼容服务。也支持 OpenAI / Gemini / Grok 协议。

| 字段 | 说明 | 示例 | |------|------|------| | Base URL | API 服务地址 | https://api.example.com/v1 | | API Key | 认证密钥 | sk-xxx | | Haiku Model | 快速模型 ID | deepseek-v4-flash | | Sonnet Model | 均衡模型 ID | deepseek-v4-flash | | Opus Model | 高性能模型 ID | deepseek-v4-pro |

配置保存到 ~/.a2a/settings.json，详见 Provider Profiles。

命令速查

/provider         管理 Provider Profile（/api 别名）
/login            引导式登录配置
/help             查看帮助
/dream            整理优化 AI 记忆
/teach-me         问答式学习项目模块
/doctor           诊断环境问题
/poor             切换穷鬼模式（节省 token）

相关链接

• 在线文档
• Discord 社区
• GitHub Issues

许可证

本项目仅供学习研究用途。Claude Code 的所有权利归 Anthropic 所有。