Get started with CC Switch

Use CC Switch to manage a client provider: import a key, select the target application, then verify the connection.

Create an API key

Sign in to ReverixAI and open API Keys. Create a key with a recognizable name, then copy it for the client configuration.

Download CC Switch

Download the macOS, Windows, or Linux installer that matches your device from the CC Switch website, then complete the installation.

Open CC Switch

Open CC Switch from Applications on macOS, the Start menu on Windows, or the application list on Linux. Keep it open for the import step.

Import the key from ReverixAI

In API Keys, open the key menu and select CC Switch. The import dialog lists the models available to that key.

Choose the application

Select the application you actually use, enter a provider name, and select an available model before opening CC Switch.

Turn on the provider

Enable the imported provider for the target application in CC Switch, then save the configuration.

Restart the client

Restart the target client completely, select a model available to your API key, and send a short request. A normal reply confirms the connection.

If the request fails

Read the error message before changing the configuration. A 401 can indicate a missing, expired, disabled, or incorrectly loaded key. For a 404, check the endpoint and model ID. An empty model list may indicate key-group restrictions.

Codex 0.149.0: check an upgrade-related 401

After upgrading to Codex 0.149.0, a previously working custom provider may report `API_KEY_REQUIRED` or `401 Unauthorized`. If it relies on an API key saved in `auth.json` and has `requires_openai_auth = false`, check the authentication setting below.

Back up and open the configuration file

Quit the client and make a backup of `config.toml` before editing it in a plain-text editor. The default locations are listed below. If you set `CODEX_HOME`, use the file in that directory.

macOS: `~/.codex/config.toml`

Windows: `%USERPROFILE%\.codex\config.toml`

Update the active provider only

Find the provider ID selected by `model_provider`, then find its matching `[model_providers.<id>]` section. Change the existing `requires_openai_auth = false` line in that section to the value below. Keep the provider ID, Base URL, model, and other settings unchanged.

requires_openai_auth = true

Save, restart, and verify

Save the file, fully quit and reopen the ChatGPT client, then test a new conversation. If CC Switch manages the configuration, also check its saved provider settings so a later switch does not restore the old value.

If the error continues

Confirm that the active provider points to `https://reverix.ai/v1` and that its saved credential is a valid ReverixAI API key. Check key status, expiration, and the current client configuration. A 401 can have several causes, so this setting is not a universal fix.