Claude Code Router

CCR hiện là ứng dụng desktop, không còn là config.json: thêm Kunavo làm endpoint API tùy chỉnh, sau đó để quy tắc định tuyến gửi từng loại request tới một model khác nhau.

Providers → Add provider
  Preset provider   Other / custom API endpoint
  Name              Kunavo
  API endpoint      https://api.kunavo.com
  API key           sk-kn-...
  Models            claude-sonnet-5, claude-opus-5, claude-haiku-4-5

Agent Config → Add profile → Claude Code
  Model         Kunavo/claude-sonnet-5
  Opus model    Kunavo/claude-opus-5
  Haiku model   Kunavo/claude-haiku-4-5

Từng bước

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. Trong CCR Desktop, mở Providers → Add provider, chọn cấu hình sẵn Other / custom API endpoint, rồi điền Name, API endpoint và API key.
3. Thêm ID mô hình trong Models — dùng Search models để tải danh mục, hoặc Custom models để nhập ID.
4. Chạy Check Connection với hai hoặc ba mô hình. Thao tác này gửi yêu cầu thực, vì vậy chỉ chọn những gì bạn cần xác minh thay vì toàn bộ danh sách.
5. Mở Agent Config → Add profile → Claude Code, đặt Model và các giá trị ghi đè theo từng bậc Opus / Sonnet / Haiku, lưu lại rồi khởi chạy Claude Code từ CCR.

Đã kiểm tra đối chiếu với trang cấu hình nhà cung cấp của CCR vào 6 tháng 9, 2026. Cài đặt của bên thứ ba có thể thay đổi; nếu tên trường ở đây không còn khớp với những gì bạn thấy, trang đó là nguồn có thẩm quyền, không phải trang này.

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

Một yêu cầu sẽ xác định liệu lỗi nằm ở endpoint, khóa hay tệp cấu hình. Nếu lệnh này trả về JSON, cùng base URL và khóa sẽ hoạt động trong Claude Code Router.

# Settles whether a failure is the endpoint, the key, or the client.
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-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

Đặt model id nào vào trường

Mọi mô hình văn bản đều có thể truy cập bằng model id — danh sách đang hoạt động là GET /v1/models, còn danh mục kèm giá nằm trên trang mô hình. Mức giá tính bằng USD trên mỗi 1M token, đầu vào / đầu ra.

Vì sao ánh xạ theo từng bậc là điểm mấu chốt

Claude Code chọn mô hình theo từng bậc chứ không theo từng yêu cầu: vòng lặp chính yêu cầu bậc Sonnet hoặc Opus, còn công việc nền — tác tử con, tìm kiếm, tóm tắt — yêu cầu bậc nhỏ/nhanh. Agent Config của CCR cung cấp các bậc này dưới dạng những trường riêng, vì vậy mô hình đắt tiền chỉ xử lý những yêu cầu cần đến nó, còn bậc có khối lượng cao được chuyển đến một ID giá rẻ. Đó là toàn bộ lý do để đặt một bộ định tuyến trước Claude Code, và thiết lập riêng của Claude Code không hiển thị cách phân chia này.