CC Switch

CC Switch setup guide for configuring Routescope and switching Claude Code, Codex, and other CLIs

Keep these values handy

CC Switch is a desktop tool for managing and switching CLI configurations. The most common Routescope difference is endpoint shape:

Claude Code: https://api.routescope.ai
Codex: https://api.routescope.ai/v1
API Key: the full sk-... secret copied from the console

Step 1: Install CC Switch

Open the CC Switch project page, download the installer for your system, and complete installation.

CC Switch supports Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw, and more. This guide focuses on Routescope values for Claude Code and Codex.

Step 2: Create a Key in Routescope

Follow Get Base URL and API Key to create a token and copy the full sk-... secret.

Important

Use the full secret directly. Do not remove the sk- prefix.

Step 3: Add a Provider

In the CC Switch main window, click + in the upper-right corner to open Add New Provider.

Choose the tool type at the top:

Choose Claude when configuring Claude Code.
Choose Codex when configuring Codex.

Then choose Custom Configuration in preset providers.

Step 4: Configure Claude Code

Field	Value	Notes
Provider Name	`routescope`	Only affects CC Switch display
Website	`https://www.routescope.ai`	Provider reference
API Key	`sk-...`	Use the full secret
Request URL	`https://api.routescope.ai`	Claude Code uses the root address; do not add `/v1`
API Input Format	`Anthropic Messages (Native)`	Choose the Claude option in CC Switch
Auth Field	`ANTHROPIC_AUTH_TOKEN (default)`	The default is usually correct
Primary Model	For example `claude-sonnet-4-6`	Replace with an available model
Thinking Model	For example `claude-sonnet-4-6`	Can match the primary model
Default Haiku Model	For example `claude-sonnet-4-6`	Use an available model
Default Sonnet Model	For example `claude-sonnet-4-6`	Use an available model
Default Opus Model	For example `claude-opus-4-7`	Use an available model

If CC Switch shows a configuration JSON area, use the full structure below and make sure CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS is included (it disables Claude Code experimental betas to avoid validation errors in some versions):

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_BASE_URL": "https://api.routescope.ai",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  },
  "includeCoAuthoredBy": false
}

Step 5: Configure Codex

Field	Value	Notes
Provider Name	`routescope`	Only affects CC Switch display
API Key	`sk-...`	Use the full secret
Request URL / Base URL	`https://api.routescope.ai/v1`	Codex requires `/v1`
Model	For example `gpt-5.4`	Replace with an available model

Codex request URL must include /v1

Codex uses an OpenAI-compatible endpoint. In CC Switch, use https://api.routescope.ai/v1 for Codex.

Step 6: Save and Switch

Select the tool at the top, such as Claude or Codex.
Select the routescope provider you just added.
Click switch or save so CC Switch writes the local configuration.
Close the current terminal, reopen it, and start the corresponding CLI.

Step 7: Verify the Setup

For Claude Code:

Reply with "Claude Code is connected to Routescope", then list the top-level files in the current project.

For Codex:

Reply with "Codex is connected to Routescope", then tell me the current model name.

FAQ

Why do Claude Code and Codex use different endpoints?

Claude Code uses Anthropic-style configuration and should use https://api.routescope.ai. Codex uses an OpenAI-compatible endpoint and should use https://api.routescope.ai/v1.

What if Codex returns 404?

Check that the Codex request URL in CC Switch is https://api.routescope.ai/v1.

What should I do for 401 / 403?

Check whether the API Key is complete, whether the token is disabled, expired, or out of quota, whether the model is allowed, and whether IP restrictions are blocking the request.