Skip to main content
CC Switch manages local provider configurations for AI command-line tools. Add NexusAPI manually, select that provider in CC Switch, then start the corresponding CLI in a new terminal.

​
Before you start

Prepare an enabled NexusAPI key, the exact model ID available to its group, and the correct endpoint. The API and model capability matrix explains why a model visible on the site may still not fit a given protocol.

​
Install CC Switch

  • macOS: brew install --cask cc-switch
  • Windows / Linux: download the package for your system from official releases.
Only download CC Switch from its official repository or its release page. Do not use pages that request payment or NexusAPI credentials.

​
Add a provider

Open Provider management → Add provider, select the target app, enter the fields below, save, switch to the new provider, and restart the CLI. Interface labels can change between CC Switch releases; the endpoint, key, model, and protocol remain the important values.

​
Claude Code provider

Do not append /v1 to the Claude endpoint. After switching the provider, run claude, use /status, and send a short message.

​
Codex provider

After switching the provider, run codex and make one read-only test request.

​
Confirm the current model list

Use the selected key to see only models it can access:
Copy an ID from data[].id; do not guess from a provider name or copied screenshot.

​
If it does not work

  1. Confirm the active provider actually changed in CC Switch.
  2. Restart the terminal or app after switching.
  3. Check the Base URL rule: Claude has no /v1; Codex does.
  4. Confirm the token group and exact model ID.
  5. Keep the Request ID and follow self-check for a persistent error.