Xử lý giới hạn Claude Code, lỗi 500, quá tải 529 và vấn đề khóa API
Hướng dẫn về khóa API, sự khác biệt giữa Pro hoặc Max và 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.
Cần hỏi gì khi chẩn đoán lỗi
Thảo luận cộng đồng giúp định hướng điều tra. Xác minh giới hạn thực tế, trạng thái tài khoản và ý nghĩa lỗi bằng tài liệu chính thức cùng nhật ký yêu cầu.
Chạm giới hạn trong phiên lập trình
Giới hạn đến từ tài khoản, không gian làm việc, tuyến mô hình hay cổng?
Kiểm tra hạn mức tài khoản, giảm số tác vụ đồng thời và ngữ cảnh rồi thử lại.Khóa API hay gói Pro hoặc Max
Cách xác thực đang dùng quyền thuê bao hay thanh toán API?
Kiểm tra thuê bao và thanh toán API riêng, trừ khi nhà cung cấp liên kết rõ ràng.500 hoặc 529 trong vòng lặp tác tử
Lỗi do nhà cung cấp quá tải, tuyến cổng hay vòng lặp thử lại?
Ghi trạng thái, ID yêu cầu, tuyến, mô hình, số token và số lần thử lại trước khi sửa mã.Bắt đầu từ mã trạng thái
Tách vấn đề khóa và quyền truy cập, hạn ngạch, lỗi máy chủ và quá tải trước khi chọn cách xử lý.
Đã đạt giới hạn tốc độ
Tài khoản, không gian làm việc, mô hình hoặc tuyến vượt giới hạn yêu cầu hay token.
- Giảm tác tử chạy song song
- Rút ngắn ngữ cảnh
- Thử lại với thời gian chờ tăng dần
- Kiểm tra hạn ngạch và giới hạn mô hình
Lỗi máy chủ API
Nhà cung cấp hoặc tuyến trả về lỗi phía máy chủ. Lỗi lặp lại cần bằng chứng định tuyến.
- Lưu ID yêu cầu
- Chờ rồi thử lại một lần
- So sánh tuyến khác nếu lặp lại
- Không bắt đầu bằng việc viết lại lời nhắc
Quá tải
Dịch vụ thượng nguồn đang chịu tải cao. Đổi khóa API thường không giải quyết được quá tải.
- Chờ và giãn khoảng thử lại
- Thử mô hình dự phòng
- Giảm kích thước yêu cầu
- Xem trạng thái và kênh hỗ trợ
Khóa API hoặc quyền truy cập
Khóa đang dùng có thể sai hoặc không được phép truy cập mô hình hay endpoint.
- Xác nhận ANTHROPIC_API_KEY
- Kiểm tra URL cơ sở
- Xác minh quyền dùng mô hình
- Kiểm tra nguồn thanh toán thực tế
Thu thập thông tin trước khi sửa mã
- Ghi lỗi chính xác, trạng thái HTTP, mô hình, endpoint và thời gian.
- Xác nhận đang dùng khóa Anthropic trực tiếp hay cổng tương thích.
- Kiểm tra thanh toán và hạn ngạch API riêng với trạng thái Pro hoặc Max.
- Với 429, trước hết giảm tác vụ đồng thời và kích thước ngữ cảnh.
- Với 500 hoặc 529, chờ rồi thử lại một lần, sau đó so sánh tuyến hoặc mô hình dự phòng.
- Với cổng, kiểm tra endpoint Messages, tuyến mô hình, hành vi bộ nhớ đệm và hướng dẫn hỗ trợ.
Quyền Pro hoặc Max khác với thanh toán API
Kiểm tra khóa, URL cơ sở và nguồn thanh toán đang dùng. Không mặc định thuê bao và số dư API dùng chung tài khoản số dư.
Đăng ký truy cập APIDùng cổng? Kiểm tra endpoint Messages
Ứng dụng tương thích Claude cần endpoint Messages phù hợp, khóa hợp lệ và tuyến mô hình hỗ trợ đúng tác vụ.
Xem tài liệuLỗi API Claude Code
Vì sao Claude Code báo đã đạt giới hạn tốc độ?
Đã vượt giới hạn yêu cầu, token hoặc tuyến. Kiểm tra khóa đang dùng, không gian làm việc, tuyến, ngữ cảnh và các tác tử chạy song song.
Pro hoặc Max có kèm khóa API không?
Xem thuê bao và thanh toán API là riêng biệt trừ khi trang tài khoản chính thức nói khác. Xác minh cách xác thực và nguồn thanh toán đang dùng.
Làm gì khi gặp API Error 500?
Lưu ID yêu cầu, chờ rồi thử lại một lần. Nếu lỗi lặp lại, so sánh tuyến hoặc gửi thời gian, mô hình và ID cho hỗ trợ.
529 overloaded nghĩa là gì?
Dịch vụ thượng nguồn quá tải. Chờ, tăng khoảng thử lại, giảm yêu cầu hoặc dùng tuyến dự phòng. Đổi khóa thường không xử lý được bản thân tình trạng quá tải.
Nơi xác minh quy tắc hiện tại
Tài liệu chính thức là căn cứ về giới hạn và ý nghĩa lỗi. Thảo luận cộng đồng là đầu mối chẩn đoán, không thay thế thông tin đã xác minh.