CC Switch one-click setup

Install and open CC Switch

Download the latest build for your system from the official CC Switch Releases page. Open CC Switch once after installation so your system can register the ccswitch:// link protocol.

Also make sure Codex CLI is installed (npm install -g @openai/codex@latest). CC Switch manages the configuration; Codex still sends the requests.

Create an API key

Sign in to BRUCEAI, open API keys, click Create API key and choose the OpenAI, Grok or DeepSeek type depending on the models you want.

The full key is shown only once; copy it before closing the dialog. To use several providers, create one key per provider and import each one.

Build the import link and open CC Switch

Pick the key type and default model, paste the key you just created, and click Open CC Switch import. When the browser asks to open an external application, allow it.

The import link contains the complete API key. Do not copy, forward, or post it in chats, tickets, or public pages. Open it only on your own computer.

If nothing opens, confirm that CC Switch is installed and has been launched, and that the browser is not blocking external-application links. Retry with Chrome, Edge, or your system browser if needed.

Verify the imported fields

The confirmation screen should show the values below; confirm to add or update the provider. The /v1 suffix is required, and the default model depends on the key type you chose.

App: Codex
Provider: BRUCEAI
API endpoint: https://api.bruceai.net/v1
Default model: gpt-5.6-terra

App: Codex
Provider: BRUCEAI Grok
API endpoint: https://api.bruceai.net/v1
Default model: grok-4.6

App: Codex
Provider: BRUCEAI DeepSeek
API endpoint: https://api.bruceai.net/v1
Default model: deepseek-v4.1-flash

Verify balance queries

A provider imported through the link above already includes the usage-query script and refreshes periodically; no manual setup is required. It calls https://api.bruceai.net/v1/usage with the provider API key and returns only your own BRUCEAI available balance.

CC Switch cannot infer this endpoint for an older, migrated, or manually created provider. Re-import it with step 3, or enable a custom usage query in the CC Switch provider and paste the script below. It accepts a Base URL with or without /v1.

({
  request: {
    url: "{{baseUrl}}".replace(/\/+$/, "")
      + ("{{baseUrl}}".replace(/\/+$/, "").endsWith("/v1") ? "" : "/v1")
      + "/usage",
    method: "GET",
    headers: { "Authorization": "Bearer {{apiKey}}" }
  },
  extractor: function(response) {
    return {
      isValid: response?.isValid ?? true,
      remaining: response?.remaining ?? response?.balance,
      unit: response?.unit ?? "USD"
    };
  }
})

The unit field in CC Switch reads USD, but the number is your BRUCEAI credit balance, not dollars.

Add a provider manually (without the import link)

In CC Switch select Add new provider, keep the top tab on Codex providers, then pick Custom configuration in the top-left corner. Do not pick OpenAI Official or any other preset.

Set any provider name you like, for example BRUCEAI, set the homepage to https://bruceai.net, paste your key (it starts with sk-or-v1-) into API Key, and set the API endpoint to https://api.bruceai.net/v1. The /v1 suffix is required.

Set the default model to a model ID that belongs to this key's provider (for example gpt-5.6-terra, grok-4.6 or deepseek-v4.1-flash), expand Advanced options, and set the upstream format to Responses (native). Save when done.

The upstream format must be Responses (native). Chat or Anthropic Messages adds a format conversion layer, which can make Codex receive a 400 or an empty reply.

Activate the provider and verify

Open the Codex section in CC Switch and make BRUCEAI the active provider. A running Codex terminal does not reload the config automatically, so exit it and start it again.

In Codex, use /model to inspect or change the model. Only models of this key's provider are accepted; to change providers, switch to another imported provider in CC Switch.

codex

Troubleshooting

401 / invalid token: remove the old provider, create a new key, and import it again. Make sure the key is complete and has no extra whitespace.

Requests still use the previous provider: fully exit the running Codex session, confirm that BRUCEAI is active in CC Switch, then restart it.

400 / unsupported_model: the model ID does not belong to this key's provider. OpenAI keys only accept GPT models, Grok keys only grok-4.6 / grok-4.5, DeepSeek keys only deepseek-v4.1-flash.

Codex cannot connect: confirm that you imported into the Codex section, the endpoint includes /v1, and the upstream format is Responses (native).

For manual setup or an isolated config that preserves your existing account, use the Codex guide in the sidebar.