1. 準備 Node.js 20+
CC GUI 要求 Node.js 主版本 ≥ 20。這條路徑只給擴充功能自己用，不會改你專案終端裡的 Node。 專案可以繼續用 Node 16 或 18。單獨裝一份 Node 20+，再把可執行檔案路徑填進 CC GUI。1
安裝一份獨立的 Node 20+
用官網安裝包、nvm、fnm 或系統包管理器都可以。裝完後在對應環境裡執行：把輸出的完整路徑記下來。Windows 必須指向
node.exe。2
填到 CC GUI
開啟 CC GUI → 設定 → 基礎配置 → 環境，把路徑貼到 擴充功能專用 Node.js 路徑，點 儲存。也可以在 VS Code 設定裡搜尋
ccGui.nodePath。留空時，擴充功能會嘗試自動檢測 PATH 上的 node。
2. 安裝 Claude / Codex SDK
Claude Code 和 Codex 需要對應 SDK。擴充功能把它們裝到使用者目錄：- Claude：
@anthropic-ai/claude-agent-sdk - Codex：
@openai/codex-sdk
1
開啟 SDK 依賴
在 CC GUI 點 設定 → SDK 依賴。
2
安裝缺失項
對未安裝的 SDK 點 安裝。也可以在安裝嚮導裡勾選後讓它代裝。
3
確認版本
安裝完成後應能看到當前版本。Codex 還會檢查 CLI 完整性；不完整時狀態會顯示為未安裝。
對話區如果提示「SDK 尚未安裝」，點 前往安裝 會跳到這一頁。
3. 按需安裝本機 CLI
Grok、Kimi、OpenCode、Pi 不會被擴充功能自動安裝。你要先在系統終端裝好，並確認命令可用，再回到 設定 → 供應商管理 → CLI 點 重新檢測。 各引擎的安裝命令寫在對應頁面：
只想先跑通 Claude 或 Codex 時，可以跳過這一步。檢測與 PATH 排障見 檢測與安裝。