CC Switch Setup

Use the CC Switch desktop app to connect QCode.cc to Claude Code and Codex CLI with one click

title: "CC Switch Setup" description: "Use the CC Switch desktop app to connect QCode.cc to Claude Code and Codex CLI with one click"

CC Switch Setup¶

CC Switch is a cross-platform desktop application (Windows / macOS / Linux) that provides a unified visual interface for managing API provider configurations across five CLI tools: Claude Code, Codex, Gemini CLI, OpenCode, and OpenClaw. This guide shows how to add QCode.cc as a custom provider in CC Switch.

Why Use CC Switch¶

• No manual config editing: Visual forms replace settings.json / config.toml
• One-click provider switching: Switch between qcode.cc, official Anthropic, and local proxies instantly
• Claude + Codex ecosystem: Manage both Claude Code and Codex CLI configurations in a single app
• System tray shortcuts: Switch providers from the tray menu without opening the main window

Prerequisites¶

• Claude Code CLI or Codex CLI installed
• A QCode.cc API Key (starts with cr_), available from the dashboard

Install CC Switch¶

Download the installer for your platform from GitHub Releases:

Configure Claude Provider (for Claude Code)¶

Launch CC Switch → switch to the Claude tab on the left → click Add Provider in the top right → select Custom → fill in the fields as shown:

After saving, click Activate to set it as the current Claude provider. CC Switch will automatically write ANTHROPIC_BASE_URL and ANTHROPIC_AUTH_TOKEN to ~/.claude/settings.json. Run claude in your terminal to verify the connection.

Configure Codex Provider (for Codex CLI)¶

Switch to the Codex tab → Add Provider → Custom → fill in the fields as shown:

CC Switch generates the equivalent ~/.codex/config.toml and ~/.codex/auth.json:

model_provider = "qcode"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.qcode]
name = "qcode"
base_url = "https://api.qcode.cc/openai"
wire_api = "responses"
requires_openai_auth = true

Save and activate, then run codex to verify the connection.

Fallback Endpoints¶

If the primary endpoint is unreachable, switch to an alternative:

The Claude and Codex providers in CC Switch share the same QCode.cc API Key and draw from the same subscription quota (see Billing). Adding two providers does not double-bill you.

FAQ¶

The "Activate" button is grayed out after saving¶

Make sure there is no trailing / at the end of ANTHROPIC_BASE_URL / Base URL. CC Switch is sensitive to trailing slashes.

401 Unauthorized error¶

1. Confirm the API Key starts with cr_ and has no leading or trailing spaces
2. Check that the key is valid at qcode.cc/dashboard
3. If Claude returns 401 but Codex works (or vice versa), the key in one of the providers was entered incorrectly — CC Switch stores keys independently per provider

Codex spins indefinitely on startup¶

Check that base_url in config.toml ends with /openai (not /openai/v1). The wire_api = "responses" field must also be present.

Can I use Claude and Codex at the same time?¶

Yes. CC Switch writes Claude config to ~/.claude/ and Codex config to ~/.codex/. The two configurations are completely independent. Run claude and codex in separate terminals as needed.

Next Steps¶

• Claude Code Tutorial — Master the core Claude Code workflow
• Codex Tutorial — Go deeper with Codex CLI
• VS Code Integration — Use Claude Code directly in your editor
• Billing — Understand plans and quota