Skip to main content
安裝外掛後還不能直接對話。CC GUI 透過本機 Node.js 拉起 AI 執行時：Claude 和 Codex 走 SDK，Grok / Kimi / OpenCode / Pi 走你已經裝好的 CLI。 JetBrains 端沒有單獨的安裝嚮導命令。開啟右側 CC GUI 工具視窗後，在設定裡完成 Node、SDK 和供應商配置。
開啟 設定 → SDK 依賴 可以檢查 Node 與 SDK 狀態。缺什麼就裝什麼，再回到供應商頁配憑證。

​
1. 準備 Node.js 18+

VS Code 端文件要求 Node 20+。JetBrains 端以本倉庫程式碼檢測為準，當前是 18+。
CC GUI JetBrains 端要求 Node.js 主版本 ≥ 18（程式碼檢測閾值）。這條路徑只給外掛自己用，不會改你專案終端裡的 Node。 專案可以繼續用更低版本的 Node。單獨裝一份 Node 18+（推薦 LTS），再把可執行檔案路徑填進 CC GUI。
1

安裝一份獨立的 Node 18+

用官網安裝包、nvm、fnm 或系統包管理器都可以。裝完後在對應環境裡執行：
把輸出的完整路徑記下來。Windows 必須指向 node.exe。
2

填到 CC GUI

開啟 CC GUI → 設定 → 基礎配置 → 環境，把路徑貼到外掛專用 Node.js 路徑，點 儲存。留空時，外掛會嘗試自動檢測 PATH 上的 node。
設定裡的 Node 路徑 常見情況：

​
2. 安裝 Claude / Codex SDK

Claude Code 和 Codex 需要對應 SDK。外掛把它們裝到使用者目錄（與 VS Code 端共用 ~/.codemoss/dependencies/ 一類路徑）。 對應 npm 包：
  • Claude：@anthropic-ai/claude-agent-sdk
  • Codex：@openai/codex-sdk
1

開啟 SDK 依賴

在 CC GUI 點 設定 → SDK 依賴。
2

安裝缺失項

對未安裝的 SDK 點 安裝。
3

確認版本

安裝完成後應能看到當前版本。Codex 還會檢查 CLI 完整性；不完整時狀態會顯示為未安裝。
SDK 依賴頁
對話區如果提示「SDK 尚未安裝」，點 前往安裝 會跳到這一頁。

​
3. 按需安裝本機 CLI

Grok、Kimi、OpenCode、Pi 不會被外掛自動安裝。你要先在系統終端裝好，並確認命令可用，再回到 設定 → 供應商管理 → CLI 點 重新檢測。 各引擎的安裝命令寫在對應頁面： 只想先跑通 Claude 或 Codex 時，可以跳過這一步。檢測與 PATH 排障見 檢測與安裝。

​
4. 配供應商

環境就緒後，到側欄配置 Claude 或 Codex 供應商。下一步：發出第一條訊息。