> ## Documentation Index
> Fetch the complete documentation index at: https://apione.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect CC-Switch to APIONE

> Save APIONE configurations and switch providers for your coding tools.

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](https://github.com/farion1231/cc-switch/releases). On macOS, you can also run:

```bash theme={null}
brew tap farion1231/ccswitch
brew install --cask cc-switch
```

Create a key in the [APIONE console](https://apione.ai/en/app/api-keys). Check the model ID and supported protocol in the [model directory](https://apione.ai/en/models).

![Select Codex in CC Switch and click Add Provider.](https://mintcdn.com/apione/wJ0JhoJruUbhan4J/images/integrations/screenshots/cc-switch-codex-add-provider-en.png?fit=max\&auto=format\&n=wJ0JhoJruUbhan4J\&q=85\&s=a500b21751d0c0dd1b41019edb85c297)

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.

| Tool | Protocol | Address |
| - | - | - |
| Claude Code | Anthropic Messages | [https://api.apione.ai](https://api.apione.ai) |
| Codex | OpenAI Responses | [https://api.apione.ai/v1](https://api.apione.ai/v1) |
| OpenCode | OpenAI Chat Completions | [https://api.apione.ai/v1](https://api.apione.ai/v1) |
| Gemini CLI | Gemini API Key | Follow [Gemini CLI](https://apione.ai/docs/en/guides/gemini-cli.md) for its URL rules |

![APIONE provider settings for Codex using the Responses protocol.](https://mintcdn.com/apione/wJ0JhoJruUbhan4J/images/integrations/screenshots/cc-switch-codex-provider-config-en.png?fit=max\&auto=format\&n=wJ0JhoJruUbhan4J\&q=85\&s=be071c81b80b810a94f65a2f10478e89)

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.](https://mintcdn.com/apione/wJ0JhoJruUbhan4J/images/integrations/screenshots/cc-switch-codex-routing-confirm-en.png?fit=max\&auto=format\&n=wJ0JhoJruUbhan4J\&q=85\&s=e32aea0fde27fcf8ff8c0d50b3e42275)

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.

```json theme={null}
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apione.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_APIONE_KEY",
    "ANTHROPIC_MODEL": "YOUR_APIONE_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](https://apione.ai/docs/en/guides/clients.md) · [Choose a model](https://apione.ai/docs/en/models/catalog.md) · [Troubleshooting](https://apione.ai/docs/en/support/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.