Connect CC Switch to RunAPI
Install CC Switch, add a RunAPI Claude Code Provider, choose a model, and verify the connection.
CC Switch is a desktop application for managing coding-tool Providers. This guide connects its Claude Code Provider to RunAPI without editing your shell profile or project files by hand.
Before you begin
- Install Claude Code and sign in to your RunAPI account.
- Create a standard API key in the Authentication Guide. Keep it in CC Switch; do not add it to source control.
- Use a RunAPI model identifier available through this connection. You can select one from CC Switch or copy it from the Model Catalog.
Install CC Switch
Download CC Switch from its official releases for Windows, macOS, or Linux. On macOS with Homebrew, install it with:
brew install --cask cc-switch
Open CC Switch after installation and select Claude Code in the app switcher.
Add a RunAPI Provider
- Select Add Provider, then choose the Custom preset.
- Name the Provider
RunAPIand enter your API key and Base URL in its configuration editor:
{
"env": {
"ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
"ANTHROPIC_BASE_URL": "https://runapi.ai"
}
}
- Use Fetch Models only to discover candidates. If the model is not listed, copy its identifier from the Model Catalog. Fetching does not assign models to Claude Code request roles.
- Set the chosen identifier as the Default fallback model, then select Quick Set. This applies the identifier to every Actual Request Model row: Sonnet, Opus, Fable, Haiku, and Subagent.
- Before saving, confirm that every row shows the intended RunAPI identifier. CC Switch persists this mapping as
ANTHROPIC_MODEL,ANTHROPIC_DEFAULT_SONNET_MODEL,ANTHROPIC_DEFAULT_OPUS_MODEL,ANTHROPIC_DEFAULT_FABLE_MODEL,ANTHROPIC_DEFAULT_HAIKU_MODEL, andCLAUDE_CODE_SUBAGENT_MODEL. - Save the Provider, select it in the Provider list, and activate it.
The API key above is a placeholder. Create and rotate your actual key through the Authentication Guide.
Verify the connection
Open a new terminal in a project directory and start Claude Code:
claude
Run /status to inspect the active model, then send a short prompt such as Describe this repository in one sentence. A normal response confirms that CC Switch is using the active RunAPI Provider.
Troubleshoot
- Authentication fails: verify the API key in the active CC Switch Provider, then create a new key from the Authentication Guide if needed.
- The expected model is unavailable: refresh the model selector or copy a supported model identifier from the Model Catalog, then set it as the Default fallback model and select Quick Set again.
- Claude Code still uses another Provider: activate the RunAPI Provider in CC Switch, then open a fresh terminal session. Check CC Switch’s provider documentation for environment conflicts.
For protocol selection and request behavior, use the LLM API quickstart. For request and response fields, use the API Reference.