# CC Switch

來源: https://docs.aicentos.com/zh-TW/clients/cc-switch

Language: zh-TW

> 從 aicentos 控制台一鍵匯入設定到 CC Switch，管理 Claude Code / Codex / Gemini CLI

CC Switch 是一個跨平台的 AI CLI 設定管理工具，用於集中管理 Claude Code、Codex、Gemini CLI 等工具的模型供應商（Provider）設定，讓你在多個 CLI 工具或多套設定之間一鍵切換，不必反覆修改環境變數。

aicentos 控制台內建了 **CC Switch 一鍵匯入**：不用手抄 Base URL 和金鑰，點幾下就能把設定寫進 CC Switch。

## 準備工作

1. 登入 [aicentos 控制台](https://aicentos.com/)
2. 確認帳號有餘額（註冊贈送 ¥1 體驗額度，用完後在「**錢包**」儲值）
3. 安裝 CC Switch（見下）

## 安裝 CC Switch

CC Switch 是開源專案，原始碼託管在 GitHub：[farion1231/cc-switch](https://github.com/farion1231/cc-switch)。

打開 [Releases 頁面](https://github.com/farion1231/cc-switch/releases)，在最新版本的資源列表中，依自己的作業系統選擇對應的安裝包：

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

下載完成後依系統正常方式安裝，並**至少打開一次 CC Switch**，這樣控制台的匯入連結才能識別到本機已安裝。

## 一鍵匯入（推薦）

### 第 1 步：在控制台發起匯入

進入控制台左側「**API 金鑰**」，在要使用的金鑰那一行點右側的「**⋯**」，在選單裡選「**CC Switch**」：

在 API 金鑰列表選擇 CC Switch

### 第 2 步：選擇應用與模型

彈出視窗「**填入 CC Switch**」裡選擇目標應用（Claude / Codex / Gemini），並確認要使用的模型：

填入 CC Switch 設定

| 欄位                | 說明                                                                                         |
| ----------------- | ------------------------------------------------------------------------------------------ |
| 應用                | 選擇要寫入哪個 CLI 的設定。**Claude** 走 Anthropic 協定，**Codex** 走 OpenAI 相容格式，**Gemini** 走 Gemini 原生格式 |
| 名稱                | 匯入後在 CC Switch 裡顯示的設定名稱，可自訂                                                                |
| 主模型               | 該設定預設使用的模型，必填                                                                              |
| Haiku / Sonnet 模型 | Claude 應用下的分檔模型，依需指定                                                                       |

模型名稱可參考[支援的模型](https://docs.aicentos.com/zh-TW/billing/models-list)，例如 `claude-opus-4-8`、`claude-sonnet-5`、`claude-haiku-4-5`。

選好後點「**打開 CC Switch**」。

### 第 3 步：瀏覽器確認喚起

瀏覽器會詢問是否打開 CC Switch，點「**打開 CC Switch.app**」：

瀏覽器詢問打開 CC Switch

> 如果勾選「一律允許 aicentos.com 在相關聯的應用程式中開啟此類連結」，之後匯入就不會再彈這個確認框。

### 第 4 步：在 CC Switch 確認匯入

CC Switch 會彈出「**確認匯入供應商設定**」，核對資訊後點「**匯入**」：

CC Switch 確認匯入

彈出視窗裡會列出將寫入的端點、金鑰與分檔模型，核對無誤後點「**匯入**」。

匯入完成後，`aicentos Claude` 會出現在 CC Switch 的設定列表裡，點一下即可切換：

匯入完成

## 手動設定

如果不想用一鍵匯入，也可以在 CC Switch 裡點「**新增供應商**」手動填寫：

CC Switch 新增供應商

| 欄位      | 填什麼                                                                        |
| ------- | -------------------------------------------------------------------------- |
| 供應商名稱   | `aicentos`（自訂，便於識別即可）                                                      |
| API Key | 控制台「**API 金鑰**」頁建立的金鑰，形如 `sk-xxxxxxxx`                                     |
| 請求位址    | Claude / Gemini 填 `https://aicentos.com`；Codex 填 `https://aicentos.com/v1` |

> **Anthropic 協定只填根位址**，不要手動追加 `/v1/messages`，用戶端會自動串接。

## 下一步

* [模型狀態監控](https://docs.aicentos.com/status) — 查看各模型即時可用率
* [支援的模型](https://docs.aicentos.com/zh-TW/billing/models-list) — 查看完整模型清單與 ID
* [計費](https://docs.aicentos.com/zh-TW/billing/pricing) — 瞭解儲值與按量計費