Skip to content

Setting Up CC Switch

When to Use It

CC Switch is convenient if you switch between multiple profiles for Claude Code and Codex.

For Nexus, it is convenient to create two separate profiles:

  • a profile for Claude Code;
  • a profile for Codex.

Installing CC Switch

CC Switch is installed as a separate desktop application. Before configuring profiles, make sure the CLI tool you want to use is already installed: Claude Code, Codex, or another supported tool.

Official repository: https://github.com/farion1231/cc-switch

Create a custom entry

  1. Click + in the main window.
  2. Choose App-specific Provider, then Claude Code or Codex.
  3. Enter the API Key and Endpoint URL; do not import a ready-made link with a key.
  4. Save and activate the entry. Restart the CLI after switching if it does not pick up the change.

Claude Code entry

Use Endpoint URL https://api.nexus-hub.ru. The official CC Switch manual uses this custom JSON:

{
  "env": {
    "ANTHROPIC_API_KEY": "YOUR_NEXUS_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.nexus-hub.ru"
  }
}

Nexus also accepts a Claude Code key set through ANTHROPIC_AUTH_TOKEN. Select only a model from GET /v1/models.

Codex entry

Use Endpoint URL https://api.nexus-hub.ru/v1 and a model from GET /v1/models. In CC Switch, you can select Fetch Models; the official manual says that it calls OpenAI-compatible /v1/models. If you create the entry manually, the Codex configuration must use Responses:

model = "MODEL_FROM_V1_MODELS"
model_provider = "nexus"

[model_providers.nexus]
name = "Nexus"
base_url = "https://api.nexus-hub.ru/v1"
env_key = "NEXUS_API_KEY"
wire_api = "responses"

If CC Switch saves the key only in its own storage rather than through an environment variable, use the direct Codex setup for tighter key control.

After Setup

  1. Save the entry.
  2. Activate it in CC Switch.
  3. Choose a model that appears in GET /v1/models for your key.
  4. Restart the CLI tool if it did not pick up the changes automatically.

Troubleshooting and key hygiene

  • Use https://api.nexus-hub.ru for Claude Code and https://api.nexus-hub.ru/v1 for Codex.
  • In each profile, choose a model from GET /v1/models.
  • If switching did not take effect, restart the CLI and check the active profile.
  • Do not export a profile with the key, paste it into a screenshot, or attach it to support. Send only x-request-id and the error code.

Official sources: CC Switch user manual and releases.