> ## 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.

# 常見問題

> 處理 Node、SDK、CLI、供應商授權、中文輸入和除錯日誌等常見問題。

按你看到的提示往下對。還是不行，把復現步驟發到 [GitHub Issues](https://github.com/zhukunpenglinyutong/jetbrains-cc-gui/issues)。

## 安裝和開啟

<AccordionGroup>
  <Accordion title="Marketplace 搜不到 CC GUI">
    搜尋 `CC GUI` 或 `Claude or Codex`。完整顯示名是 **CC GUI (Claude or Codex)**，外掛 ID 是 `com.github.idea-claude-code-gui`。

    也可以開啟 [Marketplace 頁面](https://plugins.jetbrains.com/plugin/29342-cc-gui-claude-or-codex-) 再點安裝。
  </Accordion>

  <Accordion title="安裝後工具視窗是空的">
    先開啟一個專案。沒有專案根目錄時，檔案引用、會話和工作目錄都缺少上下文。

    然後點右側 **CCG** 工具視窗。
  </Accordion>
</AccordionGroup>

## Node.js 和 SDK

<AccordionGroup>
  <Accordion title="提示 Node.js 未找到或版本過低">
    CC GUI JetBrains 端需要 Node.js 18+，而且只用外掛自己的路徑，不改專案終端。

    1. 另裝一份 Node 18+
    2. 執行 `node -p "process.execPath"`
    3. 把完整路徑填到 **設定 → 基礎配置 → 環境**
    4. Windows 必須指向 `node.exe`
  </Accordion>

  <Accordion title="提示 SDK 尚未安裝">
    開啟 **設定 → SDK 依賴**，安裝 Claude Agent SDK 或 Codex SDK。對話區的 **前往安裝** 會跳到這一頁。
  </Accordion>

  <Accordion title="從 Dock / 開始選單啟動的 IDE 找不到 CLI 或 Node">
    GUI 啟動的程序有時讀不到終端裡的 `PATH`。把安裝目錄寫進系統環境變數，再重啟 IDE。
  </Accordion>
</AccordionGroup>

## 供應商和登入

<AccordionGroup>
  <Accordion title="Claude 提示未配置供應商">
    開啟 **設定 → 供應商管理 → Claude Code**，任選一種：

    * 新增帶 API Key 的供應商
    * 授權讀取 `~/.claude/settings.json`
    * 授權使用已有的 CLI 登入

    取消本地 settings.json 授權後，必須再啟用另一份供應商。
  </Accordion>

  <Accordion title="訂閱制賬號在終端能用、外掛不能用">
    對 Claude：終端登入成功 → `env` 保持為空 → 重啟 IDE。

    對 Codex：先 `codex login`，再授權讀取 `~/.codex/`，然後重啟 IDE。
  </Accordion>

  <Accordion title="CLI 一直顯示未安裝">
    外掛不會代裝 Grok / Kimi / OpenCode / Pi。先在系統終端確認 `xxx --version` 能跑，再回到 **設定 → 供應商管理 → CLI** 點 **重新檢測**。詳見 [檢測與安裝](/zh-Hant/jetbrains/providers/cli)。
  </Accordion>
</AccordionGroup>

## 對話過程

<AccordionGroup>
  <Accordion title="點了傳送沒有回覆">
    依次檢查：

    1. 當前供應商是否已啟用
    2. SDK 或 CLI 是否就緒
    3. 是否卡在許可權 / 提問對話方塊
    4. IDE 日誌有沒有報錯
  </Accordion>

  <Accordion title="中文輸入法組合態異常">
    外掛對 JCEF OSR 中文輸入法做了修復。若仍異常，可對比 `-Dccg.disable.osr.ime.fix=true`，並把復現步驟發到 Issue。
  </Accordion>

  <Accordion title="許可權 / 提問彈窗突然消失">
    許可權 watcher 重啟時只會清理 2 小時前的 IPC 檔案。若仍丟失，升級到最新版並附上覆現步驟。
  </Accordion>
</AccordionGroup>

## 除錯

<AccordionGroup>
  <Accordion title="怎麼開啟開發者工具">
    透過 **Find Action** 執行 **Open DevTools**。需要時結合 IDE 日誌與外掛輸出一起看。
  </Accordion>
</AccordionGroup>