Skip to main content
CC-Switch helps you switch between API configurations. Create a separate configuration for each tool, enable APIONE, and keep your previous provider available for switching back.

Install and prepare

Download the Windows, macOS, or Linux installer from CC-Switch Releases. On macOS, you can also run:
Create a key in the APIONE console. Check the model ID and supported protocol in the model directory.
Select Codex in CC Switch and click Add Provider.

Select Codex in CC Switch and click Add Provider.

Add a provider

  1. Open CC-Switch and select the target tool at the top.
  2. Click Add Provider, choose a custom configuration, and name it APIONE.
  3. Enter your APIONE API Key and the appropriate address below.
  4. Set the model and save. For Codex, use Select models or Add manually to maintain the model list, then restart Codex if prompted.
APIONE provider settings for Codex using the Responses protocol.

APIONE provider settings for Codex using the Responses protocol.

Codex routing mode

After saving the provider, select Routing on the Codex page and click Start routing. Choose APIONE as the destination and confirm. Requests pass through the local CC Switch process, so keep CC Switch running while routing is active.
Choose APIONE as the destination in the Codex routing confirmation.

Choose APIONE as the destination in the Codex routing confirmation.

Map Claude Code models

Haiku, Sonnet, and Opus are client selection tiers. Map each tier to an APIONE model that supports Messages and tool calls. Do not reuse another provider’s prefixes or aliases without checking the actual model ID.
Replace the placeholders. Remove conflicting Anthropic credentials from the environment so a request does not carry multiple authentication headers.

Verify and switch back

Start a new session and send a short message. Confirm the request in APIONE. If the old configuration is still used, restart the tool and check whether shell variables override CC-Switch settings. To switch back, enable the previous provider in the list. When sharing configurations across applications, check each protocol, address, and model. Configure Proxy & Failover only when needed, and verify the proxy separately.
Integration directory · Choose a model · Troubleshooting