> ## 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** 点 **重新检测**。详见 [检测与安装](/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>