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.