CC Switch

Ba trường và hai danh sách thả xuống. https://api.kunavo.com làm điểm cuối, khóa sk-kn-… của bạn và — phần mà hầu hết hướng dẫn bỏ qua — để API Format ở Anthropic Messages (Native) và Auth Field ở ANTHROPIC_AUTH_TOKEN. Kunavo hỗ trợ API Messages nguyên bản, vì vậy phía Claude Code không cần định tuyến cục bộ.

Provider Name   Kunavo
API Key         sk-kn-...
API Endpoint    https://api.kunavo.com      <- service root, no /v1, no trailing slash

Advanced Options
  API Format    Anthropic Messages (Native) <- the default; do NOT switch
  Auth Field    ANTHROPIC_AUTH_TOKEN (Default)

Từng bước (thẻ Claude Code)

1. Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
2. Mở CC Switch ở thẻ cấp cao nhất Claude Code rồi nhấp nút dấu cộng. Giữ nguyên Custom Configuration mặc định thay vì chọn cấu hình có sẵn.
3. Điền Provider Name, API Key và đặt API Endpoint = https://api.kunavo.com.
4. Mở rộng Advanced Options và xác nhận API Format là Anthropic Messages (Native) và Auth Field là ANTHROPIC_AUTH_TOKEN (Default). Cả hai đều là mặc định; mục đích là kiểm tra, không phải thay đổi.
5. Lưu, rồi Activate. Thẻ này không nên hiển thị dấu Needs Routing — dấu đó chỉ xuất hiện ở những nhà cung cấp cần chuyển đổi giao thức.

Vì sao không có dấu “Cần định tuyến”

Tuyến cục bộ của CC Switch được dùng để kết nối các giao thức. Claude Code gửi yêu cầu Anthropic Messages đến /v1/messages; một cổng chỉ cung cấp OpenAI Chat Completions hoặc Responses API không thể phản hồi yêu cầu đó, nên tuyến này chuyển đổi yêu cầu khi gửi đi và chuyển đổi phản hồi khi nhận về. Quá trình chuyển đổi định dạng lại các sự kiện truyền trực tuyến, lệnh gọi công cụ và cấu hình suy luận — cách này hoạt động, nhưng tạo thêm một thành phần giữa trình soạn thảo và mô hình.

Kunavo cung cấp trực tiếp POST /v1/messages, vì vậy phía Claude Code không cần chuyển đổi: nhà cung cấp vẫn là Anthropic Messages (Native) và tuyến hoàn toàn không tham gia. Kunavo cũng cung cấp POST /v1/chat/completions và POST /v1/responses bằng cùng một khóa, nhờ đó có thể thực hiện chiều Codex bên dưới.

Chạy các mô hình Claude bên trong Codex

Đây là chiều mà các hướng dẫn dành cho nhà cung cấp khác không đề cập. Codex sử dụng OpenAI Responses API, vì vậy nếu trỏ trực tiếp vào điểm cuối /v1/messages sẽ nhận lỗi 404 — CC Switch xử lý việc này bằng cách giữ Codex trên tuyến cục bộ và chuyển đổi giao thức. Trong thẻ Codex không có cấu hình Anthropic có sẵn, vì vậy đây cũng là một Custom Configuration:

Provider Name      Kunavo
API Key            sk-kn-...
API Request URL    https://api.kunavo.com
Default Model      claude-sonnet-5

Advanced Options
  Upstream Format  Anthropic Messages (routing required)

Ánh xạ mô hình

CC Switch ánh xạ ba cấp của Claude Code sang các ID mô hình thực tế. Điền cả ba cấp cùng Default fallback model — nếu không khớp, yêu cầu sẽ được chuyển tiếp với tên Claude ban đầu và gặp lỗi ở dịch vụ thượng nguồn. Mức giá tính bằng USD cho mỗi 1M token, đầu vào / đầu ra, được đọc trực tiếp từ danh mục.

Xác minh trước khi gỡ lỗi ứng dụng

Một cặp yêu cầu là đủ để xác định lỗi nằm ở khóa, điểm cuối hay CC Switch. Nếu cả hai đều trả về 200, mọi lỗi còn lại đều do một trường trong biểu mẫu — gần như luôn là Auth Field hoặc /v1 không nên có trong điểm cuối.

# Settles whether a failure is the key, the endpoint, or CC Switch.
# 200 + a JSON list of model ids means the same key works in the app.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

# The Anthropic face, which is the one the Claude Code tab actually calls.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":16,
       "messages":[{"role":"user","content":"ping"}]}'

Tài liệu tham khảo

CC Switch là phần mềm mã nguồn mở tại github.com/farion1231/cc-switch. Tên trường và cách hoạt động ở trên lấy từ hướng dẫn chính thức của ứng dụng — hướng dẫn định tuyến Claude Code và hướng dẫn định tuyến Codex; cả hai đều nêu áp dụng cho phiên bản 3.17.0 trở lên. Biểu mẫu ở các phiên bản cũ khác đôi chút; hãy kiểm tra mục Giới thiệu của ứng dụng nếu thiếu trường được nêu ở đây. Phía Kunavo được mô tả trong API Messages, chat completions và trang tích hợp.