> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mossx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 多供应商总览

> 在 Claude Code、Codex、Kimi、Grok、OpenCode 和 Pi 之间选择，并理解它们的依赖差异。

CC GUI 不是单一模型的壳。输入框底部的供应商选择器决定这次请求走哪条运行时。

## 一张表看差异

| 供应商                                     | 类型     | 依赖                               | 规划模式 | 凭证放哪                                          |
| --------------------------------------- | ------ | -------------------------------- | ---- | --------------------------------------------- |
| [Claude Code](/vscode/providers/claude) | SDK    | `@anthropic-ai/claude-agent-sdk` | 有    | 扩展内供应商，或授权 `~/.claude/settings.json` / CLI 登录 |
| [Codex](/vscode/providers/codex)        | SDK    | `@openai/codex-sdk`              | 无    | 写入 `~/.codex/`，或授权读取本地配置                      |
| [Kimi](/vscode/providers/kimi)          | 本机 CLI | `kimi`                           | 无    | Kimi 自己的配置（通常 `~/.kimi-code/`）                |
| [Grok](/vscode/providers/grok)          | 本机 CLI | `grok`                           | 无    | Grok 自己的配置（通常 `~/.grok/`）                     |
| [OpenCode](/vscode/providers/opencode)  | 本机 CLI | `opencode`                       | 无    | OpenCode 自己的配置                                |
| [Pi](/vscode/providers/pi)              | 本机 CLI | `pi`                             | 无    | `~/.pi/`                                      |

<Note>
  界面文案里可能出现 Gemini，但独立运行时尚未交付。本文档不写 Gemini。
</Note>

检测和 PATH 排障见 [检测与安装](/vscode/providers/cli)。

## 怎么选

* 要完整的权限弹窗、规划模式、MCP 和 Skills：用 **Claude Code**
* 要走 OpenAI / Codex 生态：用 **Codex**
* 终端里已经在用 Grok、Kimi、OpenCode 或 Pi：切到对应引擎，扩展只负责检测和对话，不替你安装

同一工作区可以来回切供应商。历史按运行时隔离，Grok 的旧会话不会混进 Claude。本地历史索引目前只覆盖 Claude / Codex / Grok；Kimi / OpenCode / Pi 可以对话，但历史视图不会列出这些会话。详见 [会话、标签页与历史](/vscode/chat/sessions)。

## 切换前先检查

1. Node.js 20+ 已填好，见 [准备环境](/vscode/start/setup)
2. Claude / Codex 的 SDK 已安装
3. CLI 供应商在 **设置 → 供应商管理 → CLI** 显示已安装
4. 当前供应商已启用一份凭证

缺 SDK 时，对话区会直接提示并给出 **前往安装**。

## 配置入口

所有供应商都在 **设置 → 供应商管理**，三个子页：

* **Claude Code**：官方直连、第三方预设、本地 settings.json、CLI 登录
* **Codex**：官方直连、本地 `~/.codex/`、自定义模型和环境变量
* **CLI**：检测 Grok / Kimi / OpenCode / Pi，展示安装命令

<Columns cols={3}>
  <Card title="Claude Code" href="/vscode/providers/claude">
    API Key、本地配置和订阅制登录。
  </Card>

  <Card title="Codex" href="/vscode/providers/codex">
    `~/.codex/` 与沙箱。
  </Card>

  <Card title="Kimi" href="/vscode/providers/kimi">
    本机 `kimi`。
  </Card>

  <Card title="Grok" href="/vscode/providers/grok">
    本机 `grok`。
  </Card>

  <Card title="OpenCode" href="/vscode/providers/opencode">
    本机 `opencode`。
  </Card>

  <Card title="Pi" href="/vscode/providers/pi">
    本机 `pi`。
  </Card>

  <Card title="检测与安装" href="/vscode/providers/cli">
    重新检测、PATH 与排障。
  </Card>
</Columns>

## Beta 提示

部分能力仍标 Beta。遇到问题，把复现步骤发到 [GitHub Issues](https://github.com/hpstream/vscode-cc-gui/issues)，或走 [交流与贡献](/vscode/community/contribute)。