ANTHROPIC_AUTH_TOKEN so với ANTHROPIC_API_KEY — Claude Code thực sự đọc biến nào

Xem môi trường của bạn thực sự đang giữ gì

Kiểm tra cả hai biến trong shell khởi chạy công cụ trước khi thay đổi bất cứ điều gì. Một tỷ lệ đáng ngạc nhiên các phiên này có cả hai biến — thường một biến đến từ chỉnh sửa cấu hình cách đây nhiều tháng mà không ai còn nhớ.

for v in ANTHROPIC_API_KEY ANTHROPIC_AUTH_TOKEN ANTHROPIC_BASE_URL; do
  printf '%-22s %s\n' "$v" "$(printenv "$v" | cut -c1-12)"
done

# Prefixes tell you the provider at a glance:
#   sk-ant-  Anthropic direct
#   sk-kn-   Kunavo

Thiết lập cặp biến phù hợp với máy chủ và bỏ thiết lập biến còn lại

Hãy coi máy chủ và thông tin xác thực là một đơn vị. Với base URL của bên thứ ba, thông thường đó là bearer token cùng base URL, đồng thời bỏ thiết lập rõ ràng API key trực tiếp để nó không bị tự động sử dụng.

unset ANTHROPIC_API_KEY

export ANTHROPIC_AUTH_TOKEN="sk-kn-..."
export ANTHROPIC_BASE_URL="https://api.kunavo.com"

# On Kunavo, pin served models too: Claude Code's default and its opus and
# sonnet aliases follow Anthropic's newest models, and the sonnet alias asks
# for Sonnet 5.5, which Kunavo does not serve — unpinned, that request 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

Xác nhận trên đường truyền, không chỉ trong suy nghĩ

Nếu xác thực vẫn thất bại, hãy loại môi trường khỏi phạm vi nghi vấn: tự gửi yêu cầu bằng header mà bạn cho rằng đang được gửi. Nếu ở đây trả về 200 nhưng công cụ vẫn thất bại, nghĩa là công cụ không đọc biến bạn đã thiết lập — thường nhất là do shell khác hoặc tệp cấu hình ghi đè.

curl -s -o /dev/null -w '%{http_code}\n' \
  "$ANTHROPIC_BASE_URL/v1/models" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"

Nếu cả hai biến đều được thiết lập thì biến nào được ưu tiên?

Đừng dựa vào câu trả lời — đây là quy tắc ưu tiên đã thay đổi giữa các phiên bản và khác nhau giữa các SDK. Hãy thiết lập chính xác một biến và bỏ thiết lập biến còn lại; đó là cấu hình duy nhất hoạt động nhất quán ở mọi nơi.

Tôi có thể dùng ANTHROPIC_AUTH_TOKEN trực tiếp với Anthropic không?

API riêng của Anthropic xác thực bằng x-api-key, vì vậy key Anthropic trực tiếp phải được đặt vào ANTHROPIC_API_KEY. Biến token tồn tại cho các máy chủ yêu cầu thông tin xác thực dạng bearer.

SDK có dùng cùng các biến này không?

Các SDK Python và TypeScript đọc ANTHROPIC_API_KEY và gửi x-api-key. Nếu trỏ SDK tới gateway xác thực bằng bearer, hãy truyền thông tin xác thực một cách rõ ràng thay vì dựa vào môi trường.