Khắc phục Claude Code API

Sửa lỗi giới hạn, 500, quá tải 529 và nhầm lẫn API Key

Một quy trình chung cho cấu hình API Key, Pro hoặc Max so với thanh toán API, endpoint tương thích Messages, giới hạn tốc độ, lỗi máy chủ và tuyến quá tải.

Chọn tuyến Claude Code APIĐọc tài liệu endpoint
claude-code-diagnostics
$ claude-code run --model claude-sonnetLỗi API: đã đạt giới hạn tốc độstatus=429 route=messages tokens=128k retries=3tiếp theo: giảm đồng thời, kiểm tra key, thử lại có backoff
4 nhóm lỗi1 quy trình0 trang nội dung mỏng
Tín hiệu cộng đồng

Những điều lập trình viên liên tục hỏi trên diễn đàn công khai

Các mẫu lặp lại trên Reddit và X được chuyển thành gợi ý khắc phục ổn định, có thể kiểm chứng.

Reddit

Đạt giới hạn khi đang lập trình

Tài khoản, workspace, mô hình hoặc tuyến đang gửi nhiều yêu cầu hay token hơn mức cho phép.

Giảm agent chạy song song · Rút ngắn ngữ cảnh
Reddit

API Key so với thuê bao Pro hoặc Max

Kiểm tra key đang dùng, Base URL và nguồn thanh toán. Đừng giả định thuê bao và tín dụng API dùng chung số dư.

Kiểm tra quyền mô hình · Tách đăng nhập thuê bao khỏi thanh toán API
X / Reddit

Lỗi 500 hoặc 529 trong vòng lặp agent

Nhà cung cấp hoặc tuyến trả về lỗi phía máy chủ. Một lần thử lại có thể được; lỗi lặp lại cần bằng chứng định tuyến. Dịch vụ thượng nguồn đang chịu tải cao; đổi API Key thường không giải quyết được.

Ghi lại request id · Lùi thời gian thử lại
Bản đồ lỗi

Bắt đầu từ mã trạng thái, không phải lời đồn

Cách nhanh nhất là tách vấn đề key, hạn mức, lỗi máy chủ và quá tải.

429

Đã đạt giới hạn tốc độ

Tài khoản, workspace, mô hình hoặc tuyến đang gửi nhiều yêu cầu hay token hơn mức cho phép.

  • Giảm agent chạy song song
  • Rút ngắn ngữ cảnh
  • Thử lại có backoff
  • Kiểm tra hạn mức và giới hạn mô hình
500

Lỗi máy chủ API

Nhà cung cấp hoặc tuyến trả về lỗi phía máy chủ. Một lần thử lại có thể được; lỗi lặp lại cần bằng chứng định tuyến.

  • Ghi lại request id
  • Thử lại một lần
  • Đổi tuyến nếu lặp lại
  • Không sửa prompt trước tiên
529

Quá tải

Dịch vụ thượng nguồn đang chịu tải cao; đổi API Key thường không giải quyết được.

  • Lùi thời gian thử lại
  • Dùng mô hình dự phòng
  • Giảm kích thước yêu cầu
  • Kiểm tra kênh hỗ trợ/trạng thái
401/403

Lỗi API Key hoặc quyền

Claude Code không dùng key mong đợi hoặc key không có quyền truy cập mô hình hay endpoint.

  • Xác nhận ANTHROPIC_API_KEY
  • Kiểm tra Base URL
  • Kiểm tra quyền mô hình
  • Tách đăng nhập thuê bao khỏi thanh toán API
Quy trình

Trước khi sửa mã, hãy thu thập các dữ kiện này

  1. Ghi lại chính xác thông báo lỗi, trạng thái HTTP, mô hình, endpoint và thời gian.
  2. Xác nhận Claude Code dùng key Anthropic trực tiếp hay Base URL của gateway tương thích.
  3. Kiểm tra thanh toán và hạn mức API Key tách biệt với trạng thái Claude Pro hoặc Max.
  4. Với lỗi 429, giảm đồng thời và kích thước ngữ cảnh trước khi đổi nhà cung cấp.
  5. Với lỗi 500 hoặc 529, thử lại một lần có backoff rồi so sánh tuyến khác hoặc mô hình dự phòng.
  6. Nếu dùng gateway, kiểm tra endpoint tương thích Messages, tuyến mô hình, cache và trang hỗ trợ.

Pro hoặc Max không đồng nghĩa với thanh toán API

Kiểm tra key đang dùng, Base URL và nguồn thanh toán. Đừng giả định thuê bao và tín dụng API dùng chung số dư.

Nhận quyền truy cập API

Dùng gateway? Hãy kiểm tra endpoint Messages

Client kiểu Claude Code thường cần endpoint tương thích Messages, API Key hợp lệ và tuyến mô hình hỗ trợ khối lượng công việc.

Xem tài liệu
Câu hỏi thường gặp

Lỗi Claude Code API

Tại sao Claude Code báo đã đạt giới hạn?

Tài khoản, workspace, mô hình hoặc tuyến đang gửi nhiều yêu cầu hay token hơn mức cho phép. Giảm agent chạy song song · Rút ngắn ngữ cảnh · Thử lại có backoff · Kiểm tra hạn mức và giới hạn mô hình

Claude Pro hoặc Max có bao gồm API Key không?

Kiểm tra key đang dùng, Base URL và nguồn thanh toán. Đừng giả định thuê bao và tín dụng API dùng chung số dư.

Nên làm gì khi gặp lỗi API 500?

Nhà cung cấp hoặc tuyến trả về lỗi phía máy chủ. Một lần thử lại có thể được; lỗi lặp lại cần bằng chứng định tuyến. Ghi lại request id · Thử lại một lần · Đổi tuyến nếu lặp lại · Không sửa prompt trước tiên

Quá tải 529 nghĩa là gì?

Dịch vụ thượng nguồn đang chịu tải cao; đổi API Key thường không giải quyết được. Lùi thời gian thử lại · Dùng mô hình dự phòng · Giảm kích thước yêu cầu · Kiểm tra kênh hỗ trợ/trạng thái

Nguồn

Nơi kiểm tra quy tắc hiện hành

Dùng tài liệu chính thức cho giới hạn và ý nghĩa lỗi. Thảo luận cộng đồng chỉ phản ánh nhu cầu, không phải nguồn sự thật.

Xác thực Claude CodeLỗi Anthropic APIGiới hạn Anthropic APIThảo luận giới hạn Claude Code trên RedditTìm kiếm giới hạn Claude Code trên X