Agent 选择

Agent 是实际执行任务的本地运行时。你可以把它理解为“负责对话和操作工具的执行者”。Aichat 默认提供内置 Aichat CLI，也会识别和展示支持的本地 Agent。

推荐选择

情况	推荐 Agent
第一次使用，不想额外配置	Aichat CLI
电脑上没有安装外部 CLI	Aichat CLI
已经习惯 Claude Code	Claude Code
已经习惯 Codex 或新版 ChatGPT CLI	Codex / ChatGPT CLI
已经习惯 Gemini、Qwen、Goose 等 CLI	对应的本地 Agent
想和 Cursor 工作流配合	Cursor

如果你不确定，选择 Aichat CLI。

Aichat CLI

Aichat CLI 是客户端内置的默认 Agent。它的目标是让用户不安装额外 CLI 也能使用 Aichat。

适合：

1. 首次使用。
2. 普通对话。
3. 代码理解和修改。
4. 文件与工作区任务。
5. 使用 Aichat 模型与技能能力。

外部 Agent

如果你本机已经安装并登录了 Claude Code、Codex / ChatGPT CLI、Gemini CLI、Qwen、Goose、OpenCode、OpenClaw、Cursor、Copilot、Kimi、Hermes、Kiro、Snow、Vibe、Droid、Qoder、CodeBuddy、Auggie 等工具，Aichat 会尽量识别它们。

本地 Agent 页面通常会分成两类：

1. 已检测到：可以直接开始会话。
2. 未检测到：显示安装或修复入口，帮助你补齐命令、路径或登录状态。

外部 Agent 是否可用取决于：

1. 是否安装。
2. 是否能在当前系统路径中找到。
3. 是否已经登录或完成初始化。
4. 版本是否兼容。
5. 客户端是否支持当前 Agent 的启动方式。
6. 是否需要使用“智能识别”刷新本机路径。

统一模型渠道

如果开启“统一模型渠道”，支持的本地 Agent 会优先使用 Aichat 的模型与额度。这样你只需要在 Aichat 里维护一个 License 和模型列表。

如果关闭“统一模型渠道”，外部 CLI 会尽量保持自己的账号、模型和配置。Aichat 不会为了接入模型去改写你的全局 Claude、Codex、Gemini 等 CLI 配置。

为什么有些 Agent 没显示

常见原因包括：

1. CLI 没有安装。
2. CLI 安装了，但不在系统 PATH 中。
3. CLI 第一次运行还没有完成登录或初始化。
4. 当前客户端版本还没有适配该 Agent。
5. Agent 名称或命令路径和客户端识别规则不匹配。

如果你只是想立即使用，不需要先修复外部 Agent，直接选择 Aichat CLI 即可。