> ## 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 20+、Claude / Codex SDK，以及可選的本機 CLI。

安裝擴充功能後還不能直接對話。CC GUI 透過本機 Node.js 拉起 AI 執行時：Claude 和 Codex 走 SDK，Grok / Kimi / OpenCode / Pi 走你已經裝好的 CLI。

<Tip>
  第一次開啟時，命令面板執行 **CC GUI: Run Setup Wizard**。嚮導會檢查 Node、提示安裝缺失 SDK，並引導你開啟側欄去配供應商。
</Tip>

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/vscode/setup-wizard.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=2f5437ae84d0c9fa81b5ce31f2e28bd6" alt="安裝嚮導歡迎彈窗" width="100%" data-path="images/vscode/setup-wizard.png" />

## 1. 準備 Node.js 20+

CC GUI 要求 **Node.js 主版本 ≥ 20**。這條路徑只給擴充功能自己用，不會改你專案終端裡的 Node。

專案可以繼續用 Node 16 或 18。單獨裝一份 Node 20+，再把可執行檔案路徑填進 CC GUI。

<Steps>
  <Step title="安裝一份獨立的 Node 20+">
    用官網安裝包、nvm、fnm 或系統包管理器都可以。裝完後在對應環境裡執行：

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

    把輸出的完整路徑記下來。Windows 必須指向 `node.exe`。
  </Step>

  <Step title="填到 CC GUI">
    開啟 CC GUI → **設定** → **基礎配置** → **環境**，把路徑貼到 **擴充功能專用 Node.js 路徑**，點 **儲存**。

    也可以在 VS Code 設定裡搜尋 `ccGui.nodePath`。留空時，擴充功能會嘗試自動檢測 PATH 上的 `node`。
  </Step>
</Steps>

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/vscode/settings-environment.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=7f40026f538fcd4cd7f072dec615bcdb" alt="設定裡的 Node 路徑" width="100%" data-path="images/vscode/settings-environment.png" />

常見情況：

| 現象           | 處理                       |
| ------------ | ------------------------ |
| 未檢測到 Node    | 安裝 Node 20+，填寫完整路徑       |
| 檢測到的版本過低     | 另裝 Node 20+，不要改專案預設 Node |
| Windows 路徑無效 | 必須指向 `node.exe`，不能是目錄    |

## 2. 安裝 Claude / Codex SDK

Claude Code 和 Codex 需要對應 SDK。擴充功能把它們裝到使用者目錄：

```text theme={null}
~/.codemoss/dependencies/claude-sdk
~/.codemoss/dependencies/codex-sdk
```

對應 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/vscode/settings-dependencies.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=7f8c066c65c87eea02e80b1c672c748f" alt="SDK 依賴頁" width="100%" data-path="images/vscode/settings-dependencies.png" />

<Note>
  對話區如果提示「SDK 尚未安裝」，點 **前往安裝** 會跳到這一頁。
</Note>

## 3. 按需安裝本機 CLI

Grok、Kimi、OpenCode、Pi **不會**被擴充功能自動安裝。你要先在系統終端裝好，並確認命令可用，再回到 **設定 → 供應商管理 → CLI** 點 **重新檢測**。

各引擎的安裝命令寫在對應頁面：

| 引擎       | 安裝說明                                                              |
| -------- | ----------------------------------------------------------------- |
| Kimi     | [安裝](/zh-Hant/vscode/providers/kimi#安裝)                           |
| Grok     | [安裝](/zh-Hant/vscode/providers/grok#安裝)（Windows 用 WSL 或 Git Bash） |
| OpenCode | [安裝](/zh-Hant/vscode/providers/opencode#安裝)                       |
| Pi       | [安裝](/zh-Hant/vscode/providers/pi#安裝)                             |

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

## 4. 回到嚮導的最後一步

嚮導結束時會提示：到側欄裡配置 Claude 或 Codex 供應商。點 **Open Side Panel**，或自己開啟 CC GUI。

下一步：[發出第一條訊息](/zh-Hant/vscode/start/first-task)。