Skip to main content
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: Kiểm tra cặp mô hình/giao thức trong ma trận khả năng.

​
Cài CC Switch

​
macOS

Sau khi cài, mở CC Switch từ Applications.

​
Windows

Tải .msi hoặc .zip portable từ releases chính thức.

​
Linux

Tải .deb hoặc .AppImage từ releases chính thức. Người dùng Arch Linux có thể dùng gói AUR do cộng đồng duy trì:
Chỉ dùng kho CC Switch chính thức 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.

​
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 đó.
Màn hình thêm provider chính thức của CC Switch; chọn custom configuration cho NexusAPI Ví dụ biểu mẫu Provider CC Switch chính thức, key đã được che
Hình lấy từ kho CC Switch chính thức. URL, model và gateway name ở ví dụ thứ hai không phải giá trị của NexusAPI.

​
Claude Code

Các trường Haiku, Sonnet và Opus tùy chọn có thể để trống hoặc điền model sẵn có. Cấu hình tối thiểu:
Trong bản CC Switch mới, chọn Claude Code; UI cũ có thể ghi Claude. Hãy chọn Provider cho Claude Code, không chọn Claude Desktop, và không thêm /v1. Sau khi đổi provider, mở terminal mới:
Kiểm tra bằng /status và một yêu cầu ngắn.

​
Codex

Cấu hình tối thiểu:
Codex dùng giao thức Responses nên endpoint phải có /v1. Sau khi chuyển provider, chạy:
Trước hết hãy thử một tác vụ chỉ đọc.

​
Xác nhận mô hình của key hiện tại

Kiểm tra danh sách mô hình thực tế:
data[].id là model ID thực sự dùng được với key này; không đoán theo tên provider hoặc ảnh chụp cũ.

​
Quy tắc endpoint theo công cụ

​
Khắc phục sự cố

​
Đã đổi provider nhưng vẫn gọi địa chỉ chính thức

Xác nhận provider NexusAPI đang được chọn trong CC Switch, mở lại terminal và kiểm tra cấu hình cục bộ của CLI đích có ghi đè thiết lập CC Switch hay không.

​
API Key không hợp lệ

Kiểm tra key được tạo trong NexusAPI Token Management, đang bật, chưa hết hạn, đủ credit và không bị giới hạn model chặn. Sao chép nguyên key, không tự thêm hoặc đoán tiền tố.

​
Model không khả dụng

Kiểm tra nhóm, giới hạn model và phản hồi /v1/models của cùng key. Nếu không thấy model trong phản hồi, đừng sửa CC Switch lặp lại; dùng model hiển thị hoặc liên hệ hỗ trợ với tên model và Request ID.

​
Claude Code yêu cầu /login

Khi dùng provider NexusAPI, không đăng nhập tài khoản Claude chính thức. Quay lại provider NexusAPI trong CC Switch và mở lại terminal.

​
Quy trình khuyến nghị

  1. Thêm provider thủ công trong CC Switch.
  2. Dùng /v1/models với key đã chọn để xem model khả dụng.
  3. Kiểm tra bằng yêu cầu ngắn trước khi làm tác vụ phức tạp.