CC Switch Setup

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-spark"
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:

Shared Quota¶

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