Skip to main content
按你看到的提示往下對。還是不行，把復現步驟發到 GitHub Issues。

​
安裝和開啟

搜尋 CC GUI 或 Claude or Codex。完整顯示名是 CC GUI (Claude or Codex)，外掛 ID 是 com.github.idea-claude-code-gui。也可以開啟 Marketplace 頁面 再點安裝。
先開啟一個專案。沒有專案根目錄時，檔案引用、會話和工作目錄都缺少上下文。然後點右側 CCG 工具視窗。

​
Node.js 和 SDK

CC GUI JetBrains 端需要 Node.js 18+，而且只用外掛自己的路徑，不改專案終端。
  1. 另裝一份 Node 18+
  2. 執行 node -p "process.execPath"
  3. 把完整路徑填到 設定 → 基礎配置 → 環境
  4. Windows 必須指向 node.exe
開啟 設定 → SDK 依賴，安裝 Claude Agent SDK 或 Codex SDK。對話區的 前往安裝 會跳到這一頁。
GUI 啟動的程序有時讀不到終端裡的 PATH。把安裝目錄寫進系統環境變數，再重啟 IDE。

​
供應商和登入

開啟 設定 → 供應商管理 → Claude Code，任選一種：
  • 新增帶 API Key 的供應商
  • 授權讀取 ~/.claude/settings.json
  • 授權使用已有的 CLI 登入
取消本地 settings.json 授權後，必須再啟用另一份供應商。
對 Claude：終端登入成功 → env 保持為空 → 重啟 IDE。對 Codex：先 codex login，再授權讀取 ~/.codex/，然後重啟 IDE。
外掛不會代裝 Grok / Kimi / OpenCode / Pi。先在系統終端確認 xxx --version 能跑，再回到 設定 → 供應商管理 → CLI 點 重新檢測。詳見 檢測與安裝。

​
對話過程

依次檢查：
  1. 當前供應商是否已啟用
  2. SDK 或 CLI 是否就緒
  3. 是否卡在許可權 / 提問對話方塊
  4. IDE 日誌有沒有報錯
外掛對 JCEF OSR 中文輸入法做了修復。若仍異常，可對比 -Dccg.disable.osr.ime.fix=true，並把復現步驟發到 Issue。
許可權 watcher 重啟時只會清理 2 小時前的 IPC 檔案。若仍丟失，升級到最新版並附上覆現步驟。

​
除錯

透過 Find Action 執行 Open DevTools。需要時結合 IDE 日誌與外掛輸出一起看。