> ## 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.

# Thiết lập CC Switch

> Thêm provider NexusAPI cho Claude Code và Codex trong CC Switch.

CC Switch quản lý cấu hình provider AI CLI trên máy. Hãy thêm NexusAPI thủ công, chọn provider đó, rồi mở CLI tương ứng trong terminal mới.

## Chuẩn bị

Cần có key đang hoạt động, model ID chính xác trong nhóm của key và các endpoint:

| Mục đích    | Endpoint                   |
| ----------- | -------------------------- |
| Claude Code | `https://nexusapi.link`    |
| Codex       | `https://nexusapi.link/v1` |

Kiểm tra cặp mô hình/giao thức trong [ma trận khả năng](/vi/developer/capability-matrix).

## Cài CC Switch

* macOS: `brew install --cask cc-switch`
* Windows / Linux: tải gói phù hợp từ [releases chính thức](https://github.com/farion1231/cc-switch/releases).

<Warning>
  Chỉ dùng [kho CC Switch chính thức](https://github.com/farion1231/cc-switch) và releases chính thức. Không dùng trang bên thứ ba yêu cầu thanh toán hoặc thông tin xác thực NexusAPI.
</Warning>

## Thêm provider

Trong **Quản lý provider → Thêm**, chọn ứng dụng, nhập endpoint, key và model, lưu rồi chuyển sang provider đó.

### Claude Code

| Trường        | Giá trị                                 |
| ------------- | --------------------------------------- |
| App           | `Claude`                                |
| Name          | `NexusAPI Claude`                       |
| Endpoint      | `https://nexusapi.link`                 |
| Primary model | Model Claude tương thích trong nhóm key |

Không thêm `/v1`. Chạy `claude`, kiểm tra `/status`, sau đó gửi câu hỏi ngắn.

### Codex

| Trường        | Giá trị                        |
| ------------- | ------------------------------ |
| App           | `Codex`                        |
| Name          | `NexusAPI Codex`               |
| Endpoint      | `https://nexusapi.link/v1`     |
| Primary model | Model Responses trong nhóm key |

Chạy `codex` với yêu cầu chỉ đọc. Kiểm tra danh sách mô hình thực tế:

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

Nếu lỗi, xác nhận provider đã đổi thật, ứng dụng đã được khởi động lại, khác biệt `/v1` giữa Claude/Codex, nhóm và model ID. Lưu Request ID.