Skip to main content
Installing the plugin is not enough to chat. CC GUI starts AI runtimes through local Node.js: Claude and Codex use SDKs, while Grok / Kimi / OpenCode / Pi use CLIs you already installed. The JetBrains plugin has no separate setup-wizard command. Open the CC GUI tool window on the right, then finish Node, SDK, and provider setup in Settings.
Open Settings → SDK dependencies to check Node and SDK status. Install whatever is missing, then go back to the provider page to add credentials.

​
1. Set up Node.js 18+

The VS Code docs require Node 20+. The JetBrains plugin follows this repo’s detection code, which is currently 18+.
CC GUI for JetBrains requires Node.js major version ≥ 18 (the detection threshold). This path is only for the plugin. It does not change the Node version in your project terminal. Your project can keep using an older Node. Install a separate Node 18+ (LTS recommended), then paste the executable path into CC GUI.
1

Install a separate Node 18+

Use the official installer, nvm, fnm, or a system package manager. Then run this in that environment:
Save the full path. On Windows it must point to node.exe.
2

Paste it into CC GUI

Open CC GUI → Settings → General → Environment, paste the path into the plugin-only Node.js field, then click Save.If you leave it empty, the plugin tries to detect node on PATH.
Node path in Settings Common cases:

​
2. Install the Claude / Codex SDKs

Claude Code and Codex need their SDKs. The plugin installs them into your user directory (shared with the VS Code extension under a path such as ~/.codemoss/dependencies/). Matching npm packages:
  • Claude: @anthropic-ai/claude-agent-sdk
  • Codex: @openai/codex-sdk
1

Open SDK dependencies

In CC GUI, click Settings → SDK dependencies.
2

Install what is missing

Click Install for any SDK that is not installed.
3

Confirm the version

After install you should see the current version. Codex also checks CLI integrity. If that check fails, the status stays uninstalled.
SDK dependencies page
If the chat area says the SDK is not installed, Go to install jumps to this page.

​
3. Install local CLIs as needed

The plugin does not install Grok, Kimi, OpenCode, or Pi for you. Install them in a system terminal, confirm the commands work, then go back to Settings → Provider management → CLI and click Detect again. Install commands live on each engine page: Skip this step if you only want Claude or Codex working first. For detection and PATH troubleshooting, see Detect and install.

​
4. Configure a provider

When the environment is ready, configure a Claude or Codex provider in the sidebar. Next: Send the first message.