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

# 准备环境

> 为 CC GUI 准备 Node.js 18+、Claude / Codex SDK，以及可选的本机 CLI。

安装插件后还不能直接对话。CC GUI 通过本机 Node.js 拉起 AI 运行时：Claude 和 Codex 走 SDK，Grok / Kimi / OpenCode / Pi 走你已经装好的 CLI。

JetBrains 端**没有**单独的安装向导命令。打开右侧 **CC GUI** 工具窗口后，在设置里完成 Node、SDK 和供应商配置。

<Tip>
  打开 **设置 → SDK 依赖** 可以检查 Node 与 SDK 状态。缺什么就装什么，再回到供应商页配凭证。
</Tip>

## 1. 准备 Node.js 18+

<Note>
  VS Code 端文档要求 Node 20+。JetBrains 端以本仓库代码检测为准，当前是 **18+**。
</Note>

CC GUI JetBrains 端要求 **Node.js 主版本 ≥ 18**（代码检测阈值）。这条路径只给插件自己用，不会改你项目终端里的 Node。

项目可以继续用更低版本的 Node。单独装一份 Node 18+（推荐 LTS），再把可执行文件路径填进 CC GUI。

<Steps>
  <Step title="安装一份独立的 Node 18+">
    用官网安装包、nvm、fnm 或系统包管理器都可以。装完后在对应环境里运行：

    ```bash theme={null}
    node -p "process.execPath"
    ```

    把输出的完整路径记下来。Windows 必须指向 `node.exe`。
  </Step>

  <Step title="填到 CC GUI">
    打开 CC GUI → **设置** → **基础配置** → **环境**，把路径贴到插件专用 Node.js 路径，点 **保存**。

    留空时，插件会尝试自动检测 PATH 上的 `node`。
  </Step>
</Steps>

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/jetbrains/settings-environment.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=1bb2ac574ec26b368b3b5a704fbbcffd" alt="设置里的 Node 路径" width="100%" data-path="images/jetbrains/settings-environment.png" />

常见情况：

| 现象                            | 处理                       |
| ----------------------------- | ------------------------ |
| 未检测到 Node                     | 安装 Node 18+，填写完整路径       |
| 检测到的版本过低                      | 另装 Node 18+，不要改项目默认 Node |
| Windows 路径无效                  | 必须指向 `node.exe`，不能是目录    |
| 从 Dock / 开始菜单启动的 IDE 找不到 Node | 把 Node 写进系统环境变量后重启 IDE   |

## 2. 安装 Claude / Codex SDK

Claude Code 和 Codex 需要对应 SDK。插件把它们装到用户目录（与 VS Code 端共用 `~/.codemoss/dependencies/` 一类路径）。

对应 npm 包：

* Claude：`@anthropic-ai/claude-agent-sdk`
* Codex：`@openai/codex-sdk`

<Steps>
  <Step title="打开 SDK 依赖">
    在 CC GUI 点 **设置** → **SDK 依赖**。
  </Step>

  <Step title="安装缺失项">
    对未安装的 SDK 点 **安装**。
  </Step>

  <Step title="确认版本">
    安装完成后应能看到当前版本。Codex 还会检查 CLI 完整性；不完整时状态会显示为未安装。
  </Step>
</Steps>

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/jetbrains/settings-dependencies.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=717470f5c6e5e14a52974726d7149fd5" alt="SDK 依赖页" width="100%" data-path="images/jetbrains/settings-dependencies.png" />

<Note>
  对话区如果提示「SDK 尚未安装」，点 **前往安装** 会跳到这一页。
</Note>

## 3. 按需安装本机 CLI

Grok、Kimi、OpenCode、Pi **不会**被插件自动安装。你要先在系统终端装好，并确认命令可用，再回到 **设置 → 供应商管理 → CLI** 点 **重新检测**。

各引擎的安装命令写在对应页面：

| 引擎       | 安装说明                                                         |
| -------- | ------------------------------------------------------------ |
| Kimi     | [安装](/jetbrains/providers/kimi#安装)                           |
| Grok     | [安装](/jetbrains/providers/grok#安装)（Windows 用 WSL 或 Git Bash） |
| OpenCode | [安装](/jetbrains/providers/opencode#安装)                       |
| Pi       | [安装](/jetbrains/providers/pi#安装)                             |

只想先跑通 Claude 或 Codex 时，可以跳过这一步。检测与 PATH 排障见 [检测与安装](/jetbrains/providers/cli)。

## 4. 配供应商

环境就绪后，到侧栏配置 Claude 或 Codex 供应商。下一步：[发出第一条消息](/jetbrains/start/first-task)。