Tài liệu
Claude Code
Claude Code xem mọi điểm cuối định dạng Anthropic như một cổng chuyển tiếp. Hai biến trỏ đến Kunavo, ba biến khác cố định các mô hình Kunavo cung cấp, không cần thay đổi bản cài đặt, và mọi phiên đều tính phí theo token từ số dư thay vì theo gói đăng ký.
Hai biến môi trường — ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN — chuyển Claude Code sang hình thức trả theo mức sử dụng mà không cần thay đổi cài đặt.
# One terminal session
export ANTHROPIC_BASE_URL=https://api.kunavo.com # origin, no /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
# Pin models Kunavo serves. Claude Code's default and its opus/sonnet aliases
# follow Anthropic's newest models; the sonnet alias asks for Sonnet 5.5,
# which Kunavo does not serve — unpinned, /model sonnet 404s.
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
claudeANTHROPIC_BASE_URL là gốc URL. Claude Code tự thêm /v1/messages — đoạn mã xác minh của chính Anthropic là curl "$ANTHROPIC_BASE_URL/v1/messages" — nên giá trị kết thúc bằng /v1 sẽ tạo yêu cầu đến /v1/v1/messages và nhận lỗi 404. Đây là lỗi thiết lập phổ biến nhất; trang ANTHROPIC_BASE_URL trình bày các lỗi còn lại.sonnet yêu cầu Sonnet 5.5, còn bí danh haiku yêu cầu Haiku 5.5 (từ v2.1.293); Kunavo không cung cấp cả hai, vì vậy /model sonnet, /model haiku và các tác tử con được đặt dùng những bí danh này sẽ trả về 404 nếu không được chỉ định cố định. ANTHROPIC_MODEL đặt mô hình cho phiên; ANTHROPIC_DEFAULT_OPUS_MODEL áp dụng cho /model opus (Opus 5.5 cần Claude Code v2.1.280 trở lên), ANTHROPIC_DEFAULT_SONNET_MODEL áp dụng cho /model sonnet, còn ANTHROPIC_DEFAULT_HAIKU_MODEL áp dụng cho /model haiku và các lệnh gọi chạy nền. Dùng được mọi ID từ GET /v1/models.ANTHROPIC_AUTH_TOKEN, không dùng ANTHROPIC_API_KEY. Hai biến này chọn một tiêu đề: AUTH_TOKEN gửi Authorization: Bearer, còn API_KEY gửi x-api-key. Kunavo chấp nhận cả hai, nhưng API_KEY cần một lần xác nhận trong phiên tương tác trước khi có hiệu lực, còn AUTH_TOKEN thì không.sk-kn-) và nạp tín dụng từ $10 — các lệnh gọi được thanh toán từ số dư đó và các lệnh gọi thất bại không bị tính phí. Sau đó, bảng điều khiển mở tại phần thiết lập Claude Code.Từng bước
- Tạo khóa tại
/app/keysrồi sao chép khóa — khóa chỉ hiển thị một lần. - Xuất các biến ở trên cho phiên hiện tại hoặc lưu lâu dài trong khối
envcủa~/.claude/settings.json:{"env":{"ANTHROPIC_BASE_URL":"https://api.kunavo.com","ANTHROPIC_AUTH_TOKEN":"sk-kn-...","ANTHROPIC_MODEL":"claude-sonnet-5","ANTHROPIC_DEFAULT_OPUS_MODEL":"claude-opus-5-5","ANTHROPIC_DEFAULT_SONNET_MODEL":"claude-sonnet-5","ANTHROPIC_DEFAULT_HAIKU_MODEL":"claude-haiku-4-5"}}. Tài liệu của Anthropic nêu rõ thông tin xác thực không được đặt trong.claude/settings.jsoncủa dự án — tệp đó sẽ được đưa vào kho mã nguồn. - Chạy
clauderồi mở thẻ Status. Dòng ghi tênAuth tokenxác nhận thông tin xác thực của cổng chuyển tiếp đang hoạt động; dòngLogin methodghi tên tài khoản claude.ai nghĩa là biến chưa được nhận. - Đối với tiện ích mở rộng VS Code, hãy đặt các biến trong
claudeCode.environmentVariablesthuộc phần cài đặt người dùng của chính VS Code — tiện ích kiểm tra thông tin xác thực trước khi khởi chạy, nên~/.claude/settings.jsonđược truyền đến tiến trình được tạo nhưng không đến bước kiểm tra đó.
Đã kiểm tra đối chiếu với “Kết nối Claude Code với một cổng chuyển tiếp LLM” của Anthropic vào 3 tháng 10, 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.
# 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.
| ID mô hình | Kunavo vào / ra | Phù hợp ở đâu trong Claude Code |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | mô hình mặc định để làm việc — đặt bằng /model hoặc ANTHROPIC_ |
claude-opus-5-5 | $2.80 / $14.00 | lập kế hoạch và chỉnh sửa ở cấp kiến trúc |
claude-haiku-4-5 | $0.70 / $3.50 | bí danh haiku và các lệnh gọi chạy nền riêng của Claude Code — chỉ định cố định bằng ANTHROPIC_ |
claude-fable-5 | $7.00 / $35.00 | bậc tiên tiến nhất, dành cho những kế hoạch xứng đáng với mức giá đó |
Câu hỏi thường gặp
Làm cách nào để dùng Claude Code mà không cần gói đăng ký Claude?
Đặt ANTHROPIC_BASE_URL thành một điểm cuối định dạng Anthropic, ANTHROPIC_AUTH_TOKEN thành khóa của điểm cuối đó, và cố định ANTHROPIC_MODEL ở một mô hình mà điểm cuối cung cấp — mặc định tích hợp của Claude Code có thể không phải mô hình đó. Claude Code sau đó xác thực với điểm cuối thay vì claude.ai; bên sở hữu thông tin xác thực sẽ tính phí theo token thay vì tính vào gói đăng ký. Anthropic gọi đây là chế độ cổng chuyển tiếp; thông tin đăng nhập claude.ai đã lưu vẫn còn trên thiết bị nhưng không được dùng, và sẽ được sử dụng lại ngay khi bỏ các biến này.
ANTHROPIC_BASE_URL có nên bao gồm /v1 không?
Không. Claude Code tự thêm đường dẫn, vì vậy biến này phải chứa gốc URL — https://api.kunavo.com, không phải https://api.kunavo.com/v1. Lệnh xác minh chính Anthropic cung cấp là curl "$ANTHROPIC_BASE_URL/v1/messages", cho thấy rõ cách ghép URL. URL cơ sở đã kết thúc bằng /v1 sẽ gửi yêu cầu đến /v1/v1/messages và nhận lỗi 404.
ANTHROPIC_AUTH_TOKEN và ANTHROPIC_API_KEY khác nhau thế nào?
Chúng đặt thông tin xác thực vào các tiêu đề HTTP khác nhau: ANTHROPIC_AUTH_TOKEN gửi Authorization: Bearer, còn ANTHROPIC_API_KEY gửi x-api-key. Nếu đặt khóa vào sai biến, khóa sẽ được gửi đến điểm cuối trong tiêu đề mà điểm cuối không đọc, khiến yêu cầu thất bại với lỗi 401. Nếu tài liệu của cổng chuyển tiếp ghi "bearer token", hãy dùng ANTHROPIC_AUTH_TOKEN; nếu ghi "API key" hoặc "x-api-key", hãy dùng ANTHROPIC_API_KEY.
Những tính năng Claude Code nào ngừng hoạt động khi dùng URL cơ sở tùy chỉnh?
Remote Control và đọc chính tả bằng giọng nói đều cần danh tính claude.ai và không khả dụng khi đặt thông tin xác thực của cổng chuyển tiếp; Remote Control còn bị tắt bất cứ khi nào ANTHROPIC_BASE_URL trỏ đến một máy chủ không thuộc Anthropic. Kiểm tra khả dụng của chế độ nhanh cũng gọi trực tiếp api.anthropic.com thay vì dùng URL cơ sở. Mọi thứ trong vòng lặp cốt lõi — tác tử, công cụ, tác tử con, máy chủ MCP — đều chạy trên Messages API và không bị ảnh hưởng.