Install and open
Marketplace does not find CC GUI
Marketplace does not find CC GUI
Search for
CC GUI or Claude or Codex. The full display name is CC GUI (Claude or Codex). The plugin ID is com.github.idea-claude-code-gui.You can also open the Marketplace page and click install.The tool window is empty after install
The tool window is empty after install
Open a project first. Without a project root, file references, sessions, and the working directory have no context.Then click the CCG tool window on the right.
Node.js and SDKs
It says Node.js was not found or the version is too old
It says Node.js was not found or the version is too old
CC GUI for JetBrains needs Node.js 18+. It only uses the plugin’s own path and does not change the project terminal.
- Install a separate Node 18+
- Run
node -p "process.execPath" - Paste the full path into Settings → General → Environment
- On Windows it must point to
node.exe
It says the SDK is not installed
It says the SDK is not installed
Open Settings → SDK dependencies and install the Claude Agent SDK or Codex SDK. Go to install in the chat area jumps to this page.
Providers and login
Claude says no provider is configured
Claude says no provider is configured
Open Settings → Provider management → Claude Code and pick one:
- Add a provider with an API key
- Authorize reading
~/.claude/settings.json - Authorize an existing CLI login
A subscription account works in the terminal but not in the plugin
A subscription account works in the terminal but not in the plugin
For Claude: sign in from the terminal → keep
env empty → restart the IDE.For Codex: run codex login, authorize reading ~/.codex/, then restart the IDE.A CLI stays uninstalled
A CLI stays uninstalled
The plugin does not install Grok / Kimi / OpenCode / Pi for you. Confirm
xxx --version works in a system terminal, then go back to Settings → Provider management → CLI and click Detect again. See Detect and install.During chat
Nothing happens after I click send
Nothing happens after I click send
Check in order:
- Whether the current provider is enabled
- Whether the SDK or CLI is ready
- Whether a permission / question dialog is waiting
- Whether the IDE log shows an error
Chinese IME composition is wrong
Chinese IME composition is wrong
The plugin includes a JCEF OSR Chinese IME fix. If it still fails, compare with
-Dccg.disable.osr.ime.fix=true and file an issue with reproduction steps.A permission / question dialog disappears
A permission / question dialog disappears
When the permission watcher restarts, it only cleans IPC files older than 2 hours. If dialogs still vanish, upgrade to the latest version and include reproduction steps.
Debugging
How do I open developer tools
How do I open developer tools
Run Open DevTools from Find Action. Combine it with the IDE log and plugin output when needed.