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 日志与插件输出一起看。