> ## 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.

# 检测与安装

> 检测本机 Grok、Kimi、OpenCode、Pi，以及 PATH 排障。插件不会代你安装。

Grok、Kimi、OpenCode、Pi 走本机二进制。打开 **设置 → 供应商管理 → CLI**，插件只检测命令在不在、版本是多少。**不会在你电脑上执行安装脚本。**

凭证、登录和能力差异写在各引擎页。Claude / Codex 走 SDK，见对应页面。

<Columns cols={2}>
  <Card title="Claude Code" href="/jetbrains/providers/claude">
    SDK、API Key、本地配置和登录。
  </Card>

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

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

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

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

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

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/jetbrains/provider-cli.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=eab9bf7003e5c4031402aa29cfb17c5a" alt="CLI 检测页" width="100%" data-path="images/jetbrains/provider-cli.png" />

界面文案里可能出现 Gemini，但独立运行时尚未交付。本文不写安装步骤。

## 使用流程

<Steps>
  <Step title="在系统终端安装">
    打开 Terminal、iTerm 或 PowerShell，按对应引擎页的官方命令安装。
  </Step>

  <Step title="确认命令可用">
    新开终端执行 `grok --version`、`kimi --version`、`opencode --version` 或 `pi --version`。
  </Step>

  <Step title="回到 CC GUI 检测">
    打开 **设置 → 供应商管理 → CLI**，点 **重新检测**。
  </Step>

  <Step title="在输入框切换供应商">
    状态变为已安装后，到对话底部选择对应供应商即可提问。
  </Step>
</Steps>

只想先跑通 Claude 或 Codex 时，可以跳过本机 CLI。

## 检测失败时

1. 新开一个终端，确认二进制在 `PATH` 上
2. 从 Dock / 开始菜单启动的 IDE 有时读不到终端里的 `PATH`，把安装目录写进系统环境变量后重启 IDE
3. 用环境变量指定二进制：`GROK_BIN`、`KIMI_BIN`、`OPENCODE_BIN`、`PI_BIN`（也认 `*_PATH` / `*_CLI_PATH`）
4. 回到 CLI 页点 **重新检测**
5. 打开调试相关开关，查看插件日志