Skip to main content
Claude Code is the most complete mainline runtime in the desktop app: permission dialogs, plan, MCP, Skills, and rewind / fork all go through it.

​
How to connect

Open Settings → CLI configuration → Claude Code CLI:
  1. Add provider: name, API key, base URL, model mapping. Hosted config lives in ~/.ccgui/config.json and does not change ~/.claude/settings.json
  2. Use local settings.json: with no third-party provider, the default is ~/.claude/settings.json
  3. CLI login: for a subscription account, log in to Claude CLI in a terminal first, then let the app reuse that login
  4. Third-party / proxy presets: Zhipu, Kimi, DeepSeek, MiniMax, OpenRouter, Bailian, LongCat, OpenCode Go, and others
Official direct traffic goes to Anthropic. Third-party presets immediately route to the matching endpoint and label the routing in the UI. If claude is not installed, click Install on that page. You can override the Claude CLI path.

​
Install

macOS / Linux:
Windows PowerShell:
Docs: Claude Code CLI Claude provider configuration
Config stays on this computer. The app does not upload keys to a CC GUI server.

​
Models and usage

The model picker lists models for the current profile. You can pin common models and add prices so usage stats can estimate cost.

​
Working directory and grants

  • The default working directory is the current workspace root
  • Reads and writes outside that root may trigger a Directory Grant
  • You can override the Claude CLI path in Settings (advanced)

​
Next steps