An API for everyoneUser guide
Website ↗
User guideTool setup

CC Switch

CC Switch manages configurations. It does not answer prompts itself: after enabling a provider, run the agent it manages.

Have these three details ready

With your app already installed, open Self-service on this website and sign in. Create or view your own API key, copy the API address shown there, and copy an exact model ID from Models and pricing. A website homepage, account password or marketing name is not a substitute. Check both account balance and key allowance.

API_HOST, YOUR_API_KEY and YOUR_MODEL_ID below are placeholders: replace each before use. Follow this article on whether to keep /v1; do not append /chat/completions or /responses. Examples do not connect automatically or contain your key.

1. Choose the target client

Select Codex or Claude Code in the sidebar, then + / Add provider. These tabs write different client configurations. Follow only the branch for your client below.

2. Create a custom provider

Choose custom configuration, name it My API and enter your own API Key. Do not retain a different API platform’s preset address. Check the target client before saving.

3. Codex branch: Responses

Choose Responses, use https://API_HOST/v1 and an available Responses model ID. Check wire_api = "responses" in the configuration preview. Select only effort levels supported by that model.

Field diagram · not an app screenshot
Codex
Responses · https://API_HOST/v1
Claude Code
Messages · https://API_HOST
API Key
YOUR_API_KEY
Provider name
My API

4. Claude Code branch: Messages

Choose Anthropic Messages, use the supplied Messages root (https://API_HOST here) and ANTHROPIC_AUTH_TOKEN. Sonnet/Opus/Haiku mappings are client slots: map them only to available, confirmed-compatible models.

5. Enable and verify in the actual agent

Save, click Enable on the provider card and confirm it is active. Reopen the target client or terminal. Start with direct connection; local routing and aggregation are unnecessary for this setup. Perform the two checks below inside Codex or Claude Code. An enabled card alone does not prove connectivity.

Check 1: receive a reply

Create an empty test folder, choose it as the workspace and start a new chat. Confirm the new provider and model are selected, then send the prompt below. A normal reply without an error confirms basic connectivity, not every agent feature. Tests incur normal API usage.

Reply only: Connection successful.

Expected: the app displays “Connection successful.” If you see a login page, an error or endless loading, use the checks below before sending again.

Check 2: read a real file

In that test folder, use a text editor to create hello.txt containing “API connection test 27”. Save it, then send the prompt below. If permission is requested, allow reading only this test folder.

Use the file-reading tool to open hello.txt in the current workspace and tell me its contents. Do not change any files.

Expected: a visible tool execution reading hello.txt, followed by an answer containing API connection test 27. A text answer alone is not evidence of a tool call. You may remove the test folder afterwards.

Troubleshoot by symptom

401 / Invalid API key

Check that the address and complete key belong to the same service and that the key is active. Never send support a full key.

404 / model not found

Check /v1, the exact model ID and the API format. A listed model is not a guarantee of support for every format.

429 / quota / balance

Check balance, key allowance and request rate; follow the returned error. More thinking effort cannot fix a quota problem.

Chat works but files cannot be read

Check model tool support, workspace permissions and the tool execution error.

No effort selector

Check capability declarations, the model and client version. Thinking support does not necessarily include adjustable effort.

Official references and scope

Configuration checked on 2026-11-08. Menus may change with updates; use these official references to verify details. Use the current connection information provided by this platform.