Dashboard

Claude Code

Configure Claude Code desktop app with iCreat

Claude Code is Anthropic's official AI coding assistant. It reads your codebase, edits files, runs commands, and integrates with Git, MCP, and other development tools. With iCreat, you can route requests from the desktop Code tab to the iCreat API without an official Anthropic account.

To use the claude command in a terminal, see Claude Code CLI.

Capabilities

  • Read and write code — Understand project structure, edit across files, add tests, fix lint issues
  • Run commands — Execute builds, tests, Git commands, and more in your local terminal
  • Tool integration — Connect to Jira, Slack, Google Drive, and more via MCP
  • Multi-session workflows — Parallel tasks, plan mode, and visual diff review

Before you start

  • An API Key created on iCreat (replace <sk-your-token> below with your key)
  • Network access to https://api.icreat.ai

Install Claude Desktop

Download and install from claude.com/download (macOS / Windows / Linux beta). Sign in with your Anthropic account to open the app. After iCreat is configured, inference in the Code tab goes through the iCreat gateway.

Open the Code tab

Click the Code tab at the top center of the app. On Windows, install Git for Windows on first use, then restart the app.

Enable Developer Mode

  1. Choose Help → Troubleshooting → Enable Developer Mode from the menu bar
  2. After the app restarts, a Developer menu appears

Note

If your organization pushes gateway settings via MDM, local fields may be read-only. Use the configuration provided by your administrator.

Configure the gateway

The desktop app routes API traffic through a third-party inference gateway. It does not read ANTHROPIC_BASE_URL from the CLI config file. Configure it separately in the app.

  1. Open Developer → Configure Third-Party Inference…
  2. Fill in the Connection section:
Setting Value
Inference provider Gateway
Gateway base URL https://api.icreat.ai/v1/llm
Gateway API key Your iCreat API Key (<sk-your-token>)
Credential kind Static API key
Gateway auth scheme Bearer
  1. Save and restart Claude Desktop

Verify the connection

  1. Start a Local session in the Code tab
  2. Send a test message, for example: Reply with "Claude Code desktop is connected to iCreat!"
  3. Confirm the call appears in Usage Logs in the iCreat console

Desktop limitations

  • With a gateway enabled, Remote Control, SSH sessions, and Anthropic-hosted cloud sessions are unavailable. Use Claude Code CLI for remote development
  • Local environment variables can be set via Local → gear icon next to the prompt box, separate from gateway routing
  • MCP settings live in claude_desktop_config.json, independent of the Code tab gateway config

Configuration notes

In the gateway UI, Gateway base URL and Gateway API key are equivalent to CLI ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN (Bearer mode). See Claude Code CLI for CLI variable details.

Optional: CC-Switch

If you use Claude Code, Codex, Gemini CLI, and other tools together, CC-Switch lets you switch iCreat and other providers from a GUI. See the CC-Switch setup guide.

FAQ

Can the desktop app and CLI share the same config?

Some settings (permission rules, MCP, and others) are shared via ~/.claude/settings.json, but the desktop app must configure API routing separately under Developer → Configure Third-Party Inference. It does not automatically read CLI ANTHROPIC_BASE_URL. For CLI setup, see Claude Code CLI.

Login prompts or 401 connection errors?

  • Confirm your API Key is valid and its group includes the models you need
  • Confirm gateway auth scheme is Bearer and base URL is https://api.icreat.ai/v1/llm

"Gateway was unreachable"?

curl -I https://api.icreat.ai
# Should return HTTP 200