How to add CCSub to CC Switch (preset or custom provider)

CC Switch is an open-source desktop app for people who use more than one API provider. Instead of editing environment variables or config files by hand, you keep a card per provider and click Switch; CC Switch writes the endpoint and key into the tool's configuration for you. It manages Claude Code, Codex, OpenCode and a handful of other agents.

CCSub ships as a built-in preset, so for most people setup is three clicks: choose the tool, choose CCSub, paste the key.

Install

Grab a build from the CC Switch releases page:

Option 1: the CCSub preset (recommended)

1. Open CC Switch and pick the tool in the sidebar — for example Claude Code.
2. Click + to add a provider.
3. Search for or select CCSub in the preset list. The endpoint is pre-filled; for Claude Code it is https://www.ccsub.net.
4. Paste the key you created on the API Keys page of the CCSub dashboard (it starts with sk-) into API Key and click Add.
5. Click Switch on the CCSub card (older builds label it Enable). Once the card is marked as in use, you are done.

Codex and OpenCode work the same way: select the tool in the sidebar, then add CCSub from its presets. The Codex preset points at https://www.ccsub.net/v1 with the Responses wire format; that is the same endpoint as the https://www.ccsub.net/api/v1 used in our docs, so leave it as is.

Option 2: a custom configuration

If your build predates the preset or you want to control every field, add the provider by hand:

1. Click + and choose the custom configuration option.
2. Fill in:

3. Click Add, then Switch on the new card.

The model field takes IDs such as claude-sonnet-5; all available IDs are on the models page. The Full URL toggle only takes effect when CC Switch's local routing is on, so leave it off when connecting directly to CCSub.

Checking that it worked

• The card's connectivity check only tests whether the address answers. It does not validate the key or the model.
• The endpoint management panel includes a speed test that shows latency to the endpoint.
• The definitive test is a real message. Claude Code picks up the switch in a new session; Codex has to be quit and relaunched. Then look for the request on the Usage page of your CCSub dashboard.

What CC Switch changes on disk

Knowing where it writes makes troubleshooting much easier:

• Claude Code: the env block of ~/.claude/settings.json (ANTHROPIC_BASE_URL and ANTHROPIC_AUTH_TOKEN).
• Codex: ~/.codex/config.toml. Your existing ~/.codex/auth.json is stashed to ~/.cc-switch/codex-login-stash.json first.

Prefer not to install another app? Configure the tools directly with the Claude Code guide and the Codex CLI guide.