# CC Switch

Source: https://docs.aicentos.com/en/clients/cc-switch

Language: en

> One-click import from the aicentos console into CC Switch to manage Claude Code / Codex / Gemini CLI

CC Switch is a cross-platform AI CLI configuration manager that centrally manages model Provider configurations for tools such as Claude Code, Codex and Gemini CLI, letting you switch between CLI tools or configuration sets in one click instead of editing environment variables over and over.

The aicentos console has **CC Switch one-click import** built in: no need to copy the Base URL and key by hand — a few clicks write the configuration into CC Switch.

## Prerequisites

1. Sign in to the [aicentos console](https://aicentos.com/)
2. Make sure the account has a balance (new accounts get ¥1 in trial credit; top up under **Wallet** when it runs out)
3. Install CC Switch (see below)

## Install CC Switch

CC Switch is an open-source project hosted on GitHub: [farion1231/cc-switch](https://github.com/farion1231/cc-switch).

Open the [Releases page](https://github.com/farion1231/cc-switch/releases) and, in the latest release's asset list, pick the installer for your operating system:

* macOS: `.dmg`
* Windows: `.msi`
* Linux: `.AppImage` / `.deb`

After downloading, install it the normal way for your system and **open CC Switch at least once**, so the console's import link can detect the local installation.

## One-click import (recommended)

### Step 1: Start the import in the console

Open **API Keys** in the console's left sidebar, click **⋯** on the row of the key you want to use, and choose **CC Switch** in the menu:

Choosing CC Switch in the API key list

### Step 2: Choose the app and models

In the **Fill into CC Switch** dialog, choose the target app (Claude / Codex / Gemini) and confirm the models to use:

Filling in the CC Switch configuration

| Field                 | Description                                                                                                                                                       |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| App                   | Which CLI's configuration to write. **Claude** uses the Anthropic protocol, **Codex** uses the OpenAI-compatible format, **Gemini** uses the native Gemini format |
| Name                  | The configuration name shown in CC Switch after the import; customizable                                                                                          |
| Main model            | The default model for this configuration; required                                                                                                                |
| Haiku / Sonnet models | Tiered models under the Claude app; set as needed                                                                                                                 |

For model names, see [Supported models](https://docs.aicentos.com/en/billing/models-list), e.g. `claude-opus-4-8`, `claude-sonnet-5`, `claude-haiku-4-5`.

When done, click **Open CC Switch**.

### Step 3: Confirm the launch in the browser

The browser asks whether to open CC Switch; click **Open CC Switch.app**:

Browser asking to open CC Switch

> If you check "Always allow aicentos.com to open links of this type in the associated app", this confirmation dialog will not appear again on future imports.

### Step 4: Confirm the import in CC Switch

CC Switch pops up **Confirm provider import**; verify the information and click **Import**:

CC Switch confirming the import

The dialog lists the endpoint, key and tiered models that will be written; after verifying, click **Import**.

Once the import completes, `aicentos Claude` appears in CC Switch's configuration list; click it to switch:

Import complete

## Manual configuration

If you would rather not use one-click import, click **Add new provider** in CC Switch and fill in manually:

CC Switch adding a new provider

| Field         | What to enter                                                                         |
| ------------- | ------------------------------------------------------------------------------------- |
| Provider name | `aicentos` (custom, anything recognizable)                                            |
| API Key       | The key created on the console's **API Keys** page, shaped like `sk-xxxxxxxx`         |
| Request URL   | Enter `https://aicentos.com` for Claude / Gemini; `https://aicentos.com/v1` for Codex |

> **For the Anthropic protocol, enter the root address only** — do not manually append `/v1/messages`; the client concatenates it automatically.

## Next steps

* [Model status monitoring](https://docs.aicentos.com/status) — real-time availability of each model
* [Supported models](https://docs.aicentos.com/en/billing/models-list) — the full model list and IDs
* [Billing](https://docs.aicentos.com/en/billing/pricing) — top-ups and pay-as-you-go pricing