Tài liệu

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

claude
ANTHROPIC_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.
Chỉ định cố định các mô hình. Mặc định tích hợp sẵn của Claude Code là Opus mới nhất (Opus 5.5 tính đến tháng 9 năm 2026, theo tài liệu cấu hình mô hình của Anthropic), và yêu cầu đầu tiên sẽ trả về 404 nếu mô hình đó chưa được Kunavo cung cấp. Bí danh 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.
Dùng 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.
Bạn không muốn tự chỉnh sửa biến môi trường? CC Switch có thể lưu Kunavo làm nhà cung cấp Claude Code — dùng cùng gốc dịch vụ và cùng khóa bearer như trên; hướng dẫn thiết lập từng trường có trên trang CC Switch.
Chưa có khóa? Tạo tài khoản Kunavo, tạo khóa (bắt đầu bằ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

  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. 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 env củ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.json của dự án — tệp đó sẽ được đưa vào kho mã nguồn.
  3. Chạy claude rồi mở thẻ Status. Dòng ghi tên Auth token xác nhận thông tin xác thực của cổng chuyển tiếp đang hoạt động; dòng Login method ghi tên tài khoản claude.ai nghĩa là biến chưa được nhận.
  4. Đối với tiện ích mở rộng VS Code, hãy đặt các biến trong claudeCode.environmentVariables thuộ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.

Đây là phiên bản ngắn. Hướng dẫn đầy đủ — lựa chọn mô hình, chi phí của một phiên thực tế và các trường hợp lỗi — nằm trong hướng dẫn khóa API Claude Code.

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ìnhKunavo vào / raPhù hợp ở đâu trong Claude Code
claude-sonnet-5$1.40 / $7.00mô hình mặc định để làm việc — đặt bằng /model hoặc ANTHROPIC_MODEL
claude-opus-5-5$2.80 / $14.00lập kế hoạch và chỉnh sửa ở cấp kiến trúc
claude-haiku-4-5$0.70 / $3.50bí 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_DEFAULT_HAIKU_MODEL
claude-fable-5$7.00 / $35.00bậc tiên tiến nhất, dành cho những kế hoạch xứng đáng với mức giá đó
Thanh toán theo token từ số dư trả trước, không có phí hàng tháng — xem trang Thanh toán. Với ngữ cảnh lặp lại — chiếm phần lớn dữ liệu mà trình chỉnh sửa hoặc ứng dụng trò chuyện gửi đi — bộ nhớ đệm prompt ảnh hưởng đến hóa đơn nhiều hơn lựa chọn mô hình.

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.