Claude API “credit balance is too low” / 402 insufficient_quota — cách khắc phục

Xác nhận đây là vấn đề số dư, không phải xác thực

401 = vấn đề về khóa; 400 "credit balance too low" / 402 insufficient_quota = vấn đề về tiền. Đừng xoay vòng khóa vì lỗi thanh toán — khóa mới vẫn đọc cùng một chiếc ví trống.

Nạp tiền, sau đó xác minh bằng một cuộc gọi rẻ

Số dư được áp dụng ngay lập tức trên cả Anthropic và Kunavo — không cần triển khai lại. Hãy xác minh bằng một yêu cầu tối thiểu trước khi bỏ tạm dừng các worker của bạn:

curl -s https://api.kunavo.com/v1/chat/completions \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":8,"messages":[{"role":"user","content":"ok?"}]}'

Bạn thấy thông báo này trong Claude Code?

Claude Code hiển thị thông báo này khi chạy bằng khóa API Anthropic có số dư Console bằng 0 — tài khoản đăng nhập Pro hoặc Max thay vào đó sẽ gặp giới hạn sử dụng và không bao giờ hiển thị thông báo này. Hãy nạp tiền vào Console hoặc tiếp tục làm việc trên một endpoint tính phí theo mức sử dụng: Claude Code đọc ANTHROPIC_BASE_URL trực tiếp, nên việc chuyển đổi chỉ cần thay đổi vài biến môi trường. Giữ nguyên bốn dòng mô hình — mô hình mặc định của Claude Code cùng các bí danh opus và sonnet của nó đi theo những mô hình mới nhất của Anthropic, còn bí danh sonnet yêu cầu Sonnet 5.5, mô hình mà Kunavo không cung cấp.

export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
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

Khiến lần tiếp theo trở nên nhàm chán

Thiết lập cảnh báo số dư thấp (email) và, nếu nhà cung cấp hỗ trợ, tự động nạp lại với hạn mức hàng tháng hợp lý. Việc thanh toán đóng khi hết số dư là đúng — bạn chỉ muốn nhận cảnh báo trước khi chạm tường, không phải sau đó.

Trên Kunavo: đọc phản hồi 402, hoặc để ví tự nạp tiền

Phản hồi 402 từ ví Kunavo cho biết lý do ở dạng máy đọc được: error.code là insufficient_balance, error.balance_usd và error.needed_usd cho biết khoản thiếu, còn error.topup_url và error.auto_recharge_url mở trang thanh toán với cách khắc phục đã được chọn sẵn — cả hai liên kết đều không trừ tiền. Khi tính năng tự động nạp tiền (tùy chọn) đang bật, ví sẽ được nạp số tiền bạn chọn (tối thiểu $10) từ thẻ đã lưu khi số dư (chưa trừ các khoản đang được tạm giữ cho những yêu cầu và tác vụ đang chạy) thấp hơn ngưỡng bạn đặt và việc nạp tiền vẫn nằm trong các giới hạn nạp tiền, trong đó có hạn mức hằng tháng do bạn đặt. Khi số dư ví không đủ cho một yêu cầu, Kunavo sẽ thực hiện lần nạp như vậy rồi thử lại yêu cầu thêm một lần trước khi phản hồi; nếu không có lần nạp nào, hoặc sau khi nạp vẫn không đủ, yêu cầu vẫn bị từ chối, vì vậy bạn vẫn có thể nhận 402 ngay cả khi tính năng tự động nạp tiền đang bật. Trong lúc lần nạp đó vẫn đang được xử lý, 402 sẽ kèm theo Retry-After: hãy thử lại sau khoảng thời gian đó, và ngừng thử lại khi 402 không kèm theo Retry-After.

Tôi đã nạp tiền — tại sao vẫn nhận được lỗi?

Hãy kiểm tra rằng bạn đã cấp tiền cho đúng tài khoản/workspace đã tạo khóa và rằng hạn mức chi tiêu hàng tháng không phải là nguyên nhân thực sự. Việc áp dụng số dư là tức thì trên cả Anthropic và Kunavo.

API của Claude có gói miễn phí không?

Không — Anthropic tính phí mọi cuộc gọi API từ token đầu tiên (các gói dành cho người dùng Claude.ai tách biệt với tín dụng API). Các gateway cũng trả theo mức sử dụng; Kunavo bắt đầu từ lần nạp $10 với mức giá thấp hơn giá niêm yết.

“Credit balance is too low” trong Claude Code — nhưng tôi trả phí Pro. Tại sao?

Vì Claude Code đang sử dụng khóa API, không phải gói đăng ký của bạn. Khi ANTHROPIC_API_KEY hoặc ANTHROPIC_AUTH_TOKEN được thiết lập, Claude Code tính phí vào khóa và tạm dừng đăng nhập Pro hoặc Max, còn khóa đó sử dụng một số dư Console trả trước riêng. Chạy /status để xem thông tin xác thực nào đang hoạt động; bỏ thiết lập biến này để quay lại gói, hoặc nạp tiền vào số dư của khóa.

OpenClaw báo “API provider returned a billing error” — có phải cùng một vấn đề không?

Đúng. Đây là cách diễn đạt của OpenClaw cho việc nhà cung cấp model từ chối thanh toán: khóa API đã hết tín dụng hoặc có số dư không đủ. Hãy nạp tiền cho nhà cung cấp đó hoặc chuyển OpenClaw sang một nhà cung cấp khác — các hướng dẫn liên quan bên dưới so sánh các lựa chọn.