支持的 Agent
AuraManager 的守护进程自动检测 PATH 上的 AI 编码 Agent CLI 并注册为运行时。本页面记录了哪些 Agent 有可用的后端适配器、守护进程能检测到什么、以及已知限制。
AuraManager 的 aura CLI 是一个 Agent 管控工具——它在本地机器上发现、注册并执行 AI 编码 Agent。守护进程扫描 PATH 上已安装的 Agent CLI，运行版本检测（<binary> --version），并将每个有效的 Agent 注册为工作区中的运行时。
并非所有在代码仓库中有适配器的 Agent 当前都能端到端验证通过。 下表区分了已确认完整流程可用的 Agent、守护进程能检测到但尚无法注册的 Agent（已知限制），以及后端适配器存在但未在参考环境中验证的 Agent。
已验证可用
以下 7 种 Agent 已确认通过完整流程：守护进程能检测到二进制、版本检测通过、运行时成功注册。可用于生产环境。
Agent 参考
| Agent | 二进制 | 协议 | 安装方式 | 版本验证 |
|---|---|---|---|---|
| Claude Code | claude | stream-json | npm：npm install -g @anthropic-ai/claude-codeHomebrew： brew install claude-code | claude --version → 2.x.x |
| CodeBuddy | codebuddy | stream-json | 原生：curl -fsSL https://www.codebuddy.cn/cli/install.sh | bashnpm： npm install -g @tencent-ai/codebuddy-code | codebuddy --version → 2.x.x |
| Codex | codex | app-server | npm install -g @openai/codex | codex --version → codex-cli 0.x.x |
| Kimi | kimi | ACP | curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash | kimi --version → kimi, version x.x.x |
| OpenClaw | openclaw | JSON | npm install -g openclaw | openclaw --version → OpenClaw x.x.x |
| Hermes | hermes | ACP | 从 GitHub Releases 下载并添加到 PATH | hermes --version → Hermes Agent vx.x.x |
| OpenCode | opencode | JSON | npm install -g @opencode-ai/opencode | opencode --version → x.x.x |
每个 Agent 使用其原生协议与守护进程通信：stream-json（Claude、CodeBuddy）、app-server（Codex）、ACP（Hermes、Kimi）或 JSON（OpenClaw、OpenCode）。
安装后验证
安装 Agent 后，确认 Aura 完整流程正常工作：
# 1. 确认二进制在 PATH 上且 --version 输出 semver 格式
<binary> --version
# 2. 如果守护进程已在运行，重启以检测新的二进制
aura daemon restart
# 3. 确认守护进程已检测到 Agent
aura daemon status
# 在 "Agents:" 行中查找 Agent 名称
# 4. 确认运行时已注册
aura runtime list
# 查找对应 provider 类型且状态为 "online" 的运行时如果 <binary> --version 正常但 Agent 未出现在 aura daemon status 中，可能是守护进程的 PATH 与当前终端不同。在 macOS/Linux 上，通过 GUI 启动的守护进程可能找不到由版本管理器（fnm、nvm、mise）安装的二进制。通过对应的 AURA_<AGENT>_PATH 环境变量设置显式路径（参见配置），重启守护进程后再次检查。
守护进程可检测但注册失败
以下 Agent 能在 PATH 上找到并出现在 aura daemon status 中，但守护进程无法完成注册。在根本问题解决之前，它们不能用作运行时。
| Agent | 二进制 | 问题 | 解决方案 |
|---|---|---|---|
| OpenClacky | openclacky | openclacky --version 不被支持——该 CLI 返回错误而非版本字符串，导致守护进程版本检测失败，跳过注册。 | 等待 openclacky 未来版本支持 --version 后通过 npm 安装（npm install -g openclacky）；或守护进程可增加回退检测路径。 |
| Gemini | gemini | 二进制存在且 gemini --version 正常输出（0.50.0），但注册仍然失败，原因未明。 | 检查守护进程日志（aura daemon logs）获取具体错误。可能是服务端拒绝或暂时性错误。 |
运行 aura daemon status 查看守护进程检测结果，运行 aura runtime list 查看实际注册情况。Agent 在守护进程列表中但不在运行时列表中意味着注册失败——请检查守护进程日志获取详情。
代码适配器存在——本机未验证
以下 Agent 在代码库中有后端实现（server/pkg/agent/）。如果二进制文件在 PATH 上，守护进程理论上能检测到它们，适配器也能执行。由于本机未安装对应二进制，未做端到端验证。
它们不是"已验证支持"的——而是"已实现但待验证"。
| Agent | 二进制 | 无头模式 | 协议 | 备注 |
|---|---|---|---|---|
| GitHub Copilot CLI | copilot | copilot -p --no-ask-user | JSON 信封 | 独立的 copilot 命令（非已弃用的 gh copilot 扩展）。--output-format json 能力未经确认。 |
| Cursor Agent | cursor-agent | cursor-agent -p --output-format stream-json --trust -f | stream-json | 通过 curl https://cursor.com/install | bash 安装。无头认证需 CURSOR_API_KEY。 |
| Pi | pi | pi -p 或 pi --mode json | JSON / RPC | 支持单次 -p、JSON 事件流和无头 RPC 模式。 |
| Kiro CLI | kiro-cli | kiro-cli chat --no-interactive 或 kiro-cli acp | ACP | 无头模式（v2.0+）需 KIRO_API_KEY。ACP 集成用于编辑器/桌面使用。 |
| Antigravity | agy | agy -p --non-interactive --output-format stream-json --yolo | stream-json | Google 的 CLI。底层模型为 Anthropic 的 Claude（虽然二进制和协议不同）。通过 curl -fsSL https://antigravity.google/cli/install.sh | bash 安装。无头认证需 ANTIGRAVITY_API_KEY。旧版 Gemini CLI 已弃用（2026-06-18 停止服务）。 |
要验证以上任一 Agent：安装二进制文件，确保其在 PATH 上，重启守护进程。守护进程将在下一个注册周期检测到它。如果注册失败，检查 <binary> --version 是否输出了符合 semver 格式的版本字符串——缺少或非标准版本输出是最常见的原因。
已知不支持
以下工具不是基于 CLI 的编码 Agent。它们无法被 Aura 守护进程检测或管理，也没有对应的代码适配器。不要期望它们出现在 aura daemon status 或 aura runtime list 中。
| 工具 | 原因 |
|---|---|
| WorkBuddy | 桌面 IDE（Electron 应用，位于 /Applications/WorkBuddy.app）。没有无头 CLI 二进制，无法通过 PATH 扫描发现。 |
| Cursor IDE | Cursor 桌面应用是 IDE。只有 cursor-agent（CLI）可能被支持——见上方「代码适配器存在」部分。 |
| VS Code / Copilot Chat | IDE 扩展，不是独立 CLI。请改用 copilot（GitHub Copilot CLI）。 |
如果某个工具提供了支持非交互执行和结构化输出的无头 CLI 二进制，则可以被添加到 AuraManager 中。参见 开放平台 页面了解自定义运行时配置文件。
检测和注册原理
PATH 扫描 → exec.LookPath → 版本检测（--version） → 最低版本检查 → 服务端注册- PATH 扫描：守护进程在
PATH（以及 macOS/Linux 上的登录 shellPATH）中探测每个已知二进制名称。 - 版本检测：运行
<binary> --version并从输出中解析符合 semver 格式的字符串（如2.1.98）。如果--version失败或输出中没有 semver 标记，跳过该 Agent。 - 最低版本检查：少数 Agent 有最低 CLI 版本要求（见下方）。大多数 Agent 没有最低版本限制。
- 服务端注册：守护进程将 Agent 名称、版本和设备信息发送到 AuraManager 服务端，服务端创建或更新运行时记录。
Agent 也可以通过自定义运行时配置文件（aura profile）注册，你可以定义 protocol_family（匹配任意支持的 Agent 类型）和自定义 command_name。这是内置列表之外 Agent 的扩展入口。
最低版本要求
| Agent | 最低版本 | 原因 |
|---|---|---|
| Claude Code | 2.0.0 | stream-json 协议支持 |
| Codex | 0.100.0 | app-server --listen stdio:// 支持 |
| GitHub Copilot CLI | 1.0.0 | 稳定的 --output-format json 信封格式 |
配置
Agent 二进制路径
默认情况下，守护进程在 PATH 上发现 Agent CLI。可通过环境变量为任何 Agent 覆盖路径：
| 变量 | Agent |
|---|---|
AURA_CLAUDE_PATH | Claude Code |
AURA_CODEX_PATH | Codex |
AURA_KIMI_PATH | Kimi |
AURA_OPENCLAW_PATH | OpenClaw |
AURA_HERMES_PATH | Hermes |
AURA_OPENCODE_PATH | OpenCode |
AURA_OPENCLACKY_PATH | OpenClacky |
AURA_GEMINI_PATH | Gemini |
AURA_CODEBUDDY_PATH | CodeBuddy |
AURA_COPILOT_PATH | GitHub Copilot CLI |
AURA_CURSOR_PATH | Cursor Agent |
AURA_PI_PATH | Pi |
AURA_KIRO_PATH | Kiro CLI |
AURA_ANTIGRAVITY_PATH | Antigravity |
模型覆盖
每个 Agent 的模型可通过 AURA_<AGENT>_MODEL 覆盖（如 AURA_CLAUDE_MODEL=claude-sonnet-4-6）。该值会传递给 Agent 的 --model 参数。完整变量列表见上表。
默认 CLI 参数
部分 Agent 支持通过 AURA_<AGENT>_ARGS 设置默认额外参数：
| 变量 | Agent |
|---|---|
AURA_CLAUDE_ARGS | Claude Code |
AURA_CODEX_ARGS | Codex |
AURA_CODEBUDDY_ARGS | CodeBuddy |
参数按 POSIX shellword 解析后按以下顺序应用：AuraManager 硬编码默认值 → 守护进程环境默认值 → 任务的 custom_args。
快速开始
- 在你的机器上安装一个或多个 Agent CLI（建议从已验证可用列表开始）。
- 运行
aura setup配置并启动守护进程。 - 通过
aura daemon status确认检测结果，通过aura runtime list确认注册结果。 - 在 AuraManager 工作区中将任务分配给 Agent。
完整的 CLI 安装和守护进程配置详情，请参阅 CLI 和守护进程指南。