Các thông báo chính xác và ý nghĩa của từng thông báo
API Error: 429 {"type":"rate_limit_error", ...}/ "đã đạt giới hạn tốc độ" — bạn đã vượt giới hạn yêu cầu, token hoặc mức đồng thời trong khoảng thời gian đó. Hãy chờ theoretry-after.rate limit reached for <model>kèm ghi chú theo từng mô hình — giới hạn áp dụng riêng cho từng mô hình; chuyển dòng mô hình bằng/modelthường có tác dụng ngay.- "Bạn đã đạt giới hạn sử dụng" / "giới hạn được đặt lại lúc …" — đây không phải giới hạn tốc độ: đó là hạn mức sử dụng theo cửa sổ trượt của gói thuê bao Pro/Max. Hãy chờ đến khi hạn mức được đặt lại hoặc dùng khóa API.
529 overloaded_error— do công suất phục vụ, không phải do bạn. Thử lại với thời gian chờ tăng dần; hướng dẫn về lỗi có đề cập đến vấn đề này.400 … tool use concurrency— có quá nhiều lệnh gọi công cụ song song trong một lượt; không phải 429 nhưng xuất hiện trong cùng các phiên.
Giới hạn tốc độ Claude: ba mức trần
Anthropic áp dụng giới hạn số yêu cầu mỗi phút (RPM), số token đầu vào và đầu ra mỗi phút (ITPM/OTPM) và số yêu cầu đang xử lý đồng thời, theo từng mô hình và từng tổ chức, được điều chỉnh theo bậc sử dụng — bậc này tự động tăng khi tổng chi tiêu tích lũy của bạn tăng. Các gateway áp dụng giới hạn tương đương riêng cho từng tài khoản. Các con số được công bố trong tài liệu Anthropic và hiển thị trong bảng điều khiển của bạn; những giới hạn quan trọng với Claude Code là mức đồng thời và OTPM, vì một phiên tác tử gồm hàng loạt yêu cầu dài, chạy song song và có lượng đầu ra lớn.
Vì sao Claude Code chạm giới hạn trong khi ứng dụng chat thì không
Ứng dụng chat gửi từng yêu cầu một. Claude Code truyền dữ liệu dạng luồng ở mỗi lượt (giữ một suất đồng thời trong suốt thời gian đó), chạy các tác tử phụ song song (mỗi tác tử chiếm thêm một suất) và gửi lại toàn bộ cuộc hội thoại ở mỗi lượt (số token mỗi phút tăng theo độ dài phiên). Mười tác tử phụ trên một kho mã lớn đồng nghĩa với mười luồng đồng thời và hàng trăm nghìn token mỗi phút — đó chính là 429.
Các cách khắc phục, theo thứ tự mức độ thường có hiệu quả
- 1. Để công cụ thử lại. Claude Code tuân thủ
retry-after; phần lớn lỗi 429 tự hết trong vài giây. - 2. Chạy ít tác tử phụ song song hơn; thực hiện tuần tự các tác vụ nặng thay vì phân tán chúng chạy đồng thời.
- 3.
/compact— ngữ cảnh nhỏ hơn đồng nghĩa với ít token hơn mỗi lượt, đây là cách tác động đến TPM. - 4. Chuyển dòng mô hình bằng
/modelcho tác vụ hiện tại; giới hạn áp dụng riêng cho từng mô hình. - 5. Chuyển công việc nền sang Haiku; giữ Sonnet/Opus cho vòng lặp chính.
- 6. Yêu cầu tăng giới hạn: trên Anthropic, tăng bậc chi tiêu hoặc gửi yêu cầu đến bộ phận kinh doanh; trên gateway này, gửi email cho bộ phận hỗ trợ kèm tài khoản và khối lượng công việc của bạn — tài khoản mới bắt đầu với giới hạn đồng thời thận trọng chính là để một tác tử hoạt động mất kiểm soát không thể làm cạn kiệt nguồn tài nguyên dùng chung, và giới hạn được tăng theo yêu cầu.
/compact focus on the current task
/model claude-sonnet-5
# in scripts: cap the loop and let retries happen
claude -p "..." --max-turns 20Giới hạn tốc độ trên gateway này
Các yêu cầu được tính phí vào số dư hoặc gói phí cố định của bạn; giới hạn tốc độ áp dụng theo tài khoản và độc lập với giá. Gateway gộp nhiều tài khoản thượng nguồn, nên khi một tài khoản gặp 429 theo mô hình, yêu cầu sẽ được chuyển sang tài khoản khác còn công suất thay vì hiển thị lỗi — đây là một lý do khiến các phiên ở đây gặp ít lỗi 429 hơn so với khi dùng một khóa từ bảng điều khiển. Mức đồng thời là giới hạn bạn có khả năng chạm nhất; hãy viết cho bộ phận hỗ trợ, nêu số tác tử bạn chạy song song để được điều chỉnh.
| Kế hoạch | Thời hạn | Giá |
|---|---|---|
| Không giới hạn trong 1 giờ | 1 giờ | $1 |
| Không giới hạn trong 24 giờ | 24 giờ | $10 |
| Không giới hạn trong 1 tuần | 1 tuần | $49 |
| Không giới hạn trong 15 ngày | 15 ngày | $89 |
Tất cả các gói không giới hạn →
Dùng thử miễn phí trước
Tài khoản mới nhận được $5 tín dụng API miễn phí với mã CLAUDECODE — đủ cho một buổi tối dùng Claude Code với Sonnet — sau đó là tín dụng có giá trị sử dụng gấp 7.69231× mệnh giá.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyCâu hỏi thường gặp
'Lỗi API: đã đạt giới hạn tốc độ' trong Claude Code có nghĩa là gì?
Đó là HTTP 429: bạn đã vượt giới hạn yêu cầu, token hoặc yêu cầu đồng thời mỗi phút của mô hình đó. Claude Code chờ theo retry-after rồi thử lại; nếu tình trạng kéo dài, hãy giảm số tác tử phụ chạy song song và dùng /compact.
Claude có những giới hạn tốc độ nào?
Số yêu cầu mỗi phút, số token đầu vào/đầu ra mỗi phút và số yêu cầu đồng thời, theo từng mô hình, được điều chỉnh theo bậc sử dụng trên Anthropic và theo từng tài khoản trên gateway. Các phiên tác tử thường chạm giới hạn đồng thời và token đầu ra.
Làm thế nào để tăng giới hạn tốc độ Claude?
Trên Anthropic: tăng chi tiêu (các bậc tự động tăng) hoặc liên hệ bộ phận kinh doanh. Trên gateway này: gửi email cho bộ phận hỗ trợ kèm khối lượng công việc của bạn; giới hạn đồng thời được tăng theo yêu cầu.
'Đã đạt giới hạn sử dụng' có giống giới hạn tốc độ không?
Không. Đó là hạn mức theo cửa sổ trượt của gói thuê bao Pro/Max. Giới hạn tốc độ áp dụng theo phút và tự hết; hạn mức sử dụng được đặt lại theo lịch.
Chạy Claude Code trên cổng API
Vẫn các mô hình đó, hai biến môi trường, tín dụng có giá trị sử dụng gấp 7.69231× mệnh giá — hoặc gói không giới hạn với phí cố định. Tài khoản mới: $5 tín dụng API miễn phí với mã CLAUDECODE.
Lấy khóa API Xem các gói không giới hạnAI Prime Tech là một cổng API độc lập, không có quan hệ liên kết với Anthropic và không được Anthropic chứng thực hay tài trợ. “Claude” và “Claude Code” là các nhãn hiệu của Anthropic. Các tính năng Claude Code được mô tả ở đây dựa trên tài liệu công khai của Anthropic tại thời điểm viết và thường xuyên thay đổi; giá và danh sách mô hình trên trang này được đọc từ cấu hình hiện hành của cổng API này.