> ## 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     | [安裝](/zh-Hant/jetbrains/providers/kimi#安裝)                           |
| Grok     | [安裝](/zh-Hant/jetbrains/providers/grok#安裝)（Windows 用 WSL 或 Git Bash） |
| OpenCode | [安裝](/zh-Hant/jetbrains/providers/opencode#安裝)                       |
| Pi       | [安裝](/zh-Hant/jetbrains/providers/pi#安裝)                             |

只想先跑通 Claude 或 Codex 時，可以跳過這一步。檢測與 PATH 排障見 [檢測與安裝](/zh-Hant/jetbrains/providers/cli)。

## 4. 配供應商

環境就緒後，到側欄配置 Claude 或 Codex 供應商。下一步：[發出第一條訊息](/zh-Hant/jetbrains/start/first-task)。