外部 Agent

除了内置 Aichat CLI，客户端也可以显示本机支持的外部 Agent。已经安装并检测到的 Agent 可以直接开始会话；未检测到的 Agent 会展示安装或修复入口。

当前文档中的外部 Agent 指 Claude Code、Codex / ChatGPT CLI、Gemini CLI、Qwen、Goose、OpenCode、OpenClaw、Cursor、Copilot、Kimi、Hermes、Kiro、Snow、Vibe、Droid、Qoder、CodeBuddy、Auggie 等本地运行时。

什么时候会显示

外部 Agent 通常需要满足这些条件才会显示：

1. 已经安装。
2. 命令能被系统找到。
3. 已经完成登录或初始化。
4. 版本能被客户端识别。
5. 当前系统环境允许客户端启动它。

如果不满足条件，客户端可能显示为“安装”或“修复”，也可能启动时提示失败。

安装、修复和智能识别

如果某个 Agent 没有安装，入口会更偏向“安装”。如果你已经安装，但客户端没有识别到，通常属于路径、命令名、登录状态或版本兼容问题，这时可以使用修复或智能识别入口。

智能识别会尝试查找常见安装路径，适合下面这些情况：

1. 终端里能运行 CLI，但桌面客户端识别不到。
2. GUI 应用启动时没有继承终端 PATH。
3. Windows、macOS 上 CLI 被安装到了非默认路径。
4. CLI 升级后命令名或路径发生变化。

是否会修改全局配置

Aichat 会尽量在客户端会话内完成模型通道和环境配置，不应该为了使用 Aichat 模型而修改你全局的 Claude、Codex、Gemini 或其他 CLI 配置。

这意味着你在 Aichat 里使用外部 Agent，不应影响你在终端里单独使用这些 CLI 的原始配置。

统一模型渠道

开启“统一模型渠道”后，支持的外部 Agent 会优先使用 Aichat 的模型与额度配置。关闭后，外部 CLI 会尽量回到自己的原生账号和模型配置。

Codex / ChatGPT CLI 会使用 Aichat 隔离出来的运行目录，避免直接改写你的全局 Codex 配置。

Codex / ChatGPT CLI

如果你安装了 Codex / ChatGPT CLI，但 Aichat 没有识别到，可以检查：

1. 在终端里运行 codex --version 是否有输出。
2. 是否已经完成 Codex 登录。
3. 启动 Aichat 的环境是否能读取到同一个 PATH。
4. 重启 Aichat 后是否出现。

如果你使用的是新版 ChatGPT CLI，并且它已经合并或替代旧 Codex CLI，建议更新到最新版 Aichat 后重新检测。

Claude Code

如果 Claude Code 不可用，可以检查：

1. 在终端里运行对应命令是否正常。
2. 是否已经登录。
3. 是否能在当前系统用户下启动。
4. 客户端是否提示权限或路径问题。

Cursor

Cursor 相关能力取决于本机 Cursor 安装情况和客户端支持范围。如果不可用，优先使用 Aichat CLI 完成任务。

其他 Agent

Gemini、Qwen、Goose、OpenCode、OpenClaw、Copilot、Kimi、Hermes、Kiro、Snow、Vibe、Droid、Qoder、CodeBuddy、Auggie 等 Agent 的可用性取决于本机安装方式和当前客户端适配情况。如果页面显示“安装”，说明当前没有检测到可用命令；如果显示“修复”，说明可能需要刷新路径、登录或升级 CLI。

不确定时怎么选

外部 Agent 不显示不影响你使用 Aichat 的核心能力。你可以先使用 Aichat CLI，等需要某个外部 Agent 的特定工作流时再排查。