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

# FAQ

> Fix common issues with Node, SDKs, CLIs, provider auth, Chinese input, and debug logs.

Match the message you see below. If it still fails, send reproduction steps to [GitHub Issues](https://github.com/zhukunpenglinyutong/jetbrains-cc-gui/issues).

## Install and open

<AccordionGroup>
  <Accordion title="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](https://plugins.jetbrains.com/plugin/29342-cc-gui-claude-or-codex-) and click install.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Node.js and SDKs

<AccordionGroup>
  <Accordion title="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.

    1. Install a separate Node 18+
    2. Run `node -p "process.execPath"`
    3. Paste the full path into **Settings → General → Environment**
    4. On Windows it must point to `node.exe`
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="An IDE launched from the Dock / Start menu cannot find the CLI or Node">
    A GUI-launched process sometimes cannot read the terminal `PATH`. Add the install directory to system environment variables, then restart the IDE.
  </Accordion>
</AccordionGroup>

## Providers and login

<AccordionGroup>
  <Accordion title="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

    After you revoke local settings.json access, you must enable another provider.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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](/en/jetbrains/providers/cli).
  </Accordion>
</AccordionGroup>

## During chat

<AccordionGroup>
  <Accordion title="Nothing happens after I click send">
    Check in order:

    1. Whether the current provider is enabled
    2. Whether the SDK or CLI is ready
    3. Whether a permission / question dialog is waiting
    4. Whether the IDE log shows an error
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Debugging

<AccordionGroup>
  <Accordion title="How do I open developer tools">
    Run **Open DevTools** from **Find Action**. Combine it with the IDE log and plugin output when needed.
  </Accordion>
</AccordionGroup>