Skip to main content
Grok uses local grok. Open Settings → CLI configuration → Grok CLI to detect the version, install, and configure credentials.

​
How to connect

  1. Use local config: read ~/.grok/config.toml directly. Override the config directory with $GROK_HOME
  2. Add provider: name, base URL, API key, model. Enabling it writes that config.toml (backed up first as config.toml.bak)
  3. You can override the grok executable path
  4. If it is not installed, click Install on that page, or install with the terminal commands below
Config stays on this computer. The app does not upload keys to a CC GUI server.

​
Add a provider

Click Add and fill in:
  • Name, base URL, API key, model
  • API backend: Chat Completions / Responses / Messages (Anthropic)
  • Optional: max context length, display name, notes
Quick preset: xAI (official). You can fetch the model list from the remote. The hosted provider catalog is ~/.ccgui/config.json. Click Use local config.toml and that file is left unchanged.

​
Install

Grok has no npm release and no official uninstaller. On Windows, run this command in WSL; in-app Install is not available on Windows. Docs: https://x.ai/cli

​
Capability differences

Compared with Claude Code:
  • No plan mode
  • Does not use desktop MCP
  • Supports reasoning strength, session continue, and image input
  • Stop ends the grok child process
  • History is isolated per runtime

​
When detect fails

See Detect and install.

​
Next steps