#CC Switch

CC Switch manages configuration for several AI coding tools. Because Codex, Claude Code, Gemini CLI, and OpenClaw can use different protocols, create an app-specific provider instead of assuming one universal configuration works everywhere.

#Add GetRouter

1. Open CC Switch and choose the target app.
2. Add a custom provider named GetRouter.
3. Enter a dedicated GetRouter API key.
4. Enter the endpoint required by that target app:
   • Codex / Responses: https://getrouter.ai/v1
   • OpenAI-compatible Chat: https://getrouter.ai/v1
   • Claude Messages gateway root: https://getrouter.ai
5. Enter an exact MODEL_ID where the app/provider form requests a model.
6. Save and activate the provider.
7. Restart the target tool if CC Switch indicates that configuration was written successfully.

#Verify the generated configuration

For Codex, confirm the generated configuration is equivalent to:

model_provider = "getrouter"

[model_providers.getrouter]
base_url = "https://getrouter.ai/v1"
wire_api = "responses"

For other apps, use their dedicated GetRouter integration page and verify the actual operation path.

#Common errors

• Switch succeeded but tool uses old settings: restart the target tool and check whether another profile overrides the file.
• 401: confirm the API key was saved for the selected app/provider.
• 404: the generated Base URL and protocol do not match.
• Universal provider fails in one app: replace it with an app-specific provider.
• Local routing problems: disable optional local routing while testing the direct provider path.