Claude Code “API Error: bad_response_status_code” — đọc mã trạng thái bên dưới

Biến lớp bọc thành lỗi thực sự

Đầu ra debug của Claude Code in ra yêu cầu và phản hồi thượng nguồn. Chạy một lệnh gọi lỗi với debug bật và đọc dòng trạng thái — mọi bước sau đó đều phụ thuộc vào nội dung dòng này.

claude --debug 2>&1 | tee claude-debug.log

grep -iE 'status|http/|error' claude-debug.log | head -20

Tái hiện cùng lệnh gọi bằng curl

Lấy base URL và thông tin xác thực ra khỏi công cụ rồi gửi yêu cầu trực tiếp. Cách này phân biệt “máy chủ từ chối chúng ta” với “client bị định dạng sai” chỉ trong một bước — và phần thân thô thường nêu vấn đề bằng ngôn ngữ rõ ràng mà lớp bọc đã loại bỏ.

curl -i "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,
       "messages":[{"role":"user","content":"ping"}]}'

Kiểm tra base URL không có đường dẫn ở cuối

Claude Code tự thêm đường dẫn `/v1/...`. Base URL vốn đã kết thúc bằng `/v1` sẽ tạo thành `/v1/v1/messages`, khiến mọi máy chủ trả về 404 — một lần nữa được bọc thành bad_response_status_code. Chỉ đặt origin.

# Wrong — doubles the version segment
export ANTHROPIC_BASE_URL="https://api.kunavo.com/v1"

# Right — origin only
export ANTHROPIC_BASE_URL="https://api.kunavo.com"

Lỗi này có bao giờ là lỗi của chính Claude Code không?

Hiếm khi. Đây là lớp bọc ở cấp truyền tải: có thứ gì đó đã trả lời, nhưng câu trả lời không phải là thành công. Tái hiện bằng curl sẽ xác định rõ — nếu curl cũng thất bại thì vấn đề không nằm ở ứng dụng khách.

Nó hoạt động với API chính thức nhưng không hoạt động với gateway của tôi.

Khi đó khác biệt nằm ở thông tin xác thực hoặc base URL, không phải công cụ. Hãy kiểm tra header xác thực mà gateway yêu cầu và xem base URL của bạn đã chứa /v1 hay chưa.

Tôi có nên tự động thử lại không?

Chỉ sau khi bạn biết trạng thái. Thử lại 401 hoặc 404 là vô ích; thử lại 429 hoặc 529 với thời gian chờ tăng dần là đúng.