> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexusapi.link/llms.txt
> Use this file to discover all available pages before exploring further.

# CC Switch 安裝與設定

> 在 CC Switch 中新增 NexusAPI 的 Claude Code 與 Codex Provider。

CC Switch 可管理本機 AI CLI 的 Provider 設定。手動新增 NexusAPI Provider、切換至它後，再於新終端開啟對應 CLI。

## 事前準備

準備已啟用的 NexusAPI Key、該 Key 群組可用的準確模型 ID，以及正確端點：

| 用途          | 端點                         |
| ----------- | -------------------------- |
| Claude Code | `https://nexusapi.link`    |
| Codex       | `https://nexusapi.link/v1` |

請以[能力矩陣](/zh-TW/developer/capability-matrix)確認模型與協定，而不是只看全站模型名稱。

## 安裝 CC Switch

* macOS：`brew install --cask cc-switch`
* Windows／Linux：從 [官方 Releases](https://github.com/farion1231/cc-switch/releases) 下載對應套件。

<Warning>
  僅使用 [CC Switch 官方儲存庫](https://github.com/farion1231/cc-switch)或 Releases。不要從要求付款、帳號或 NexusAPI 憑證的第三方頁面下載。
</Warning>

## 新增 Provider

開啟 **Provider 管理 → 新增 Provider**，選擇目標應用、填入端點、API Key 與模型 ID，儲存後切換到此 Provider。

### Claude Code

| 欄位            | 建議值                      |
| ------------- | ------------------------ |
| App           | `Claude`                 |
| Name          | `NexusAPI Claude`        |
| Endpoint      | `https://nexusapi.link`  |
| API Key       | 你的 NexusAPI Key          |
| Primary model | Key 群組可用的 Claude 相容模型 ID |

**Claude 不要加 `/v1`**。切換後執行 `claude`、使用 `/status`，再送一條短訊息。

### Codex

| 欄位            | 建議值                          |
| ------------- | ---------------------------- |
| App           | `Codex`                      |
| Name          | `NexusAPI Codex`             |
| Endpoint      | `https://nexusapi.link/v1`   |
| API Key       | 你的 NexusAPI Key              |
| Primary model | Key 群組可用、適合 Responses 的模型 ID |

切換後執行 `codex`，以唯讀任務驗證。

可使用下列方式確認目前 Key 可用模型：

```bash theme={"system"}
curl 'https://nexusapi.link/v1/models' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

若失敗，先確認 CC Switch 確實切換、重開程式，並檢查 Claude／Codex 的 `/v1` 差異、群組和模型 ID。持續錯誤請保留 Request ID 並依[問題自查](/zh-TW/faq/self-check)處理。