--- title: "Khắc phục lỗi Claude overloaded 529 và lỗi rate limit 429" description: "Lỗi 529 overloaded_error nghĩa là Claude API đang quá tải với mọi người. Lỗi 429 rate_limit_error nghĩa là tổ chức của bạn đã chạm một giới hạn. Hãy thử lại cả 2 với backoff." canonical: "https://logbrew.co/vi/guides/claude-overloaded-rate-limit-error" last_updated: "2026-11-10" --- # Khắc phục lỗi Claude overloaded 529 và lỗi rate limit 429 Lỗi 529 `overloaded_error` nghĩa là Claude API đang quá tải với mọi người. Lỗi 429 `rate_limit_error` nghĩa là tổ chức của bạn đã chạm một giới hạn. Hãy thử lại cả 2 với backoff. Đã thử nghiệm ngày 10 tháng 11, 2026 với Claude Code 2.1.319 và @anthropic-ai/sdk 1.7.0 Tác giả [Furkan Erday](https://github.com/furkanerday). Furkan Erday là nhà sáng lập LogBrew. Anh xây dựng LogBrew bằng Claude Code và Codex mỗi ngày. Canonical: https://logbrew.co/vi/guides/claude-overloaded-rate-limit-error ## Mỗi client chờ bao lâu trước khi thử lại | | Số giây trước mỗi lần thử lại | Số lần thử lại | Tổng thời gian | | --- | --- | --- | --- | | Claude Code, mọi phản hồi là 529 | 0,6 · 1,1 | 2 | 2,4 giây | | Claude Code, mọi phản hồi là 429 | 0,5 · 1,2 · 2,5 · 4,1 · 8,8 · 18,8 · 34,2 · 35,4 · 36 · 39,9 | 10 | 182 giây | | TypeScript SDK với `maxRetries: 5`, mọi phản hồi là 529 | 0,4 · 1 · 1,9 · 3,5 · 7,4 | 5 | 14,3 giây | ## Khắc phục trong Claude Code ### Xem trang trạng thái của Claude Nếu status.claude.com có thông báo về năng lực xử lý, vấn đề nằm ở phía Anthropic và bạn chỉ có thể chờ. ### Chờ rồi thử lại `API Error: Repeated 529 Overloaded errors` nghĩa là Claude Code đã tự thử lại rồi. Lỗi 529 không tính vào giới hạn sử dụng của bạn. ### Chuyển sang model khác Anthropic theo dõi năng lực xử lý theo từng model. Hãy chọn model khác, ví dụ Sonnet khi Opus đang quá tải. ```bash /model ``` ### Đặt model dự phòng cho script Ở chế độ print, `--fallback-model` chuyển sang model thứ 2 sau nhiều lỗi 529 liên tiếp. Trong lần thử của chúng tôi, nó chuyển sau 3 request. ```bash claude -p "Run the tests" --fallback-model sonnet ``` ### Giữ cho lượt chạy tự động không dừng Trong CI và các lượt chạy khác không có ai theo dõi, cài đặt này thử lại lỗi 529 và 429 cho đến khi năng lực xử lý trở lại. ```bash export CLAUDE_CODE_RETRY_WATCHDOG=1 ``` ## Khắc phục trong ứng dụng của bạn ### Thử lại với backoff Các SDK chính thức của Claude mặc định thử lại lỗi 429, 529 và các lỗi 5xx khác 2 lần với exponential backoff, và tuân theo header `retry-after`. Tăng `maxRetries` khi ứng dụng của bạn có thể chờ lâu hơn. ```bash import Anthropic from "@anthropic-ai/sdk"; const client = new Anthropic({ maxRetries: 5 }); ``` ### Ghi log lỗi và request ID Khi hết lượt thử lại, SDK ném ra `OverloadedError` hoặc `RateLimitError`. Lưu `error.requestID` để bộ phận hỗ trợ của Anthropic tìm được request đó. ```bash try { await client.messages.create(request); } catch (error) { if ( error instanceof Anthropic.OverloadedError || error instanceof Anthropic.RateLimitError ) { console.warn("Claude API busy", error.status, error.requestID); } throw error; } ``` ### Tăng lưu lượng từ từ Lưu lượng của bạn tăng vọt có thể kích hoạt giới hạn tăng tốc 429. Hãy tăng lưu lượng từng bước và giữ cho nó ổn định. ## Kết quả khi chúng tôi thử nghiệm Không ai có thể tạo ra lỗi 529 thật, nên chúng tôi trỏ Claude Code và TypeScript SDK tới một máy chủ thử nghiệm cục bộ trả về 529 hoặc 429 cho mọi request. Claude Code coi máy chủ như vậy là gateway, nên một phiên trên API thật có thể khác. Claude Code gửi 3 request nhận lỗi 529, rồi dừng sau 2,4 giây với `Repeated 529 Overloaded errors`. Với `--fallback-model sonnet`, nó chuyển sang Sonnet sau 3 request đó và thử lại thêm 10 lần trong khoảng 3 phút. Một lỗi 429 được thử lại 10 lần trong 182 giây, với thời gian chờ tăng từ 0,5 lên 40 giây, trước khi hiện `Request rejected (429)`. Với `CLAUDE_CODE_RETRY_WATCHDOG=1`, Claude Code vẫn đang thử lại lỗi 529 khi chúng tôi dừng lượt chạy sau 150 giây. Với cài đặt mặc định, SDK gửi 3 request, gồm request đầu và 2 lần thử lại, rồi ném ra `OverloadedError` sau 1,3 giây. Với `maxRetries: 5`, SDK gửi 6 request trong 14,3 giây. Khi lỗi 429 có `retry-after: 3`, SDK chờ 3 giây trước mỗi lần thử lại, còn Claude Code chờ 3 giây trước mỗi lần trong 3 lần thử lại đầu tiên. ## 529 và 429 là 2 lỗi khác nhau Lỗi 529 `overloaded_error` nghĩa là API đang quá tải với mọi người dùng. Đây không phải giới hạn của bạn, và nó không tính vào hạn mức của bạn. Lỗi 429 `rate_limit_error` thuộc về tổ chức của bạn. Bạn đã chạm rate limit, mức chi tiêu tối đa hằng tháng của bậc sử dụng, hoặc giới hạn chi tiêu của không gian làm việc Claude Code. Lỗi 429 do chạm mức chi tiêu tối đa không có header `retry-after` và vẫn lỗi cho đến khi quyền truy cập trở lại, nên thử lại không giúp được gì. ## Giới hạn gói Claude Code không phải lỗi API `You've hit your session limit` và `You've hit your weekly limit` đến từ gói Claude của bạn. Giới hạn phiên là khung thời gian trượt mà mọi người gọi là giới hạn 5 giờ. Chạy `/usage` để xem cả 2 giới hạn và thời điểm chúng được đặt lại. `Server is temporarily limiting requests (not your usage limit)` là cơ chế điều tiết ngắn hạn trên máy chủ, và Claude Code tự thử lại cho bạn. `Request rejected (429)` nghĩa là một khóa API, dự án Amazon Bedrock hoặc dự án Google Cloud đã chạm rate limit riêng của nó. Biến `ANTHROPIC_API_KEY` trong shell được ưu tiên hơn gói của bạn, nên Claude Code có thể chạm giới hạn thấp hơn của khóa đó. Chạy `/status` để xem phương thức đăng nhập nào đang được dùng. #16157, với 1.499 bình luận, ghi nhận người dùng Max chạm giới hạn gần như ngay lập tức. Tháng 1 năm 2026, một kỹ sư Anthropic viết rằng nhóm chưa có lời giải thích thỏa đáng. #29579 ghi nhận `Rate limit reached` ở mức sử dụng 16%, và #6457 ghi nhận giới hạn 5 giờ bị chạm sau chưa đầy 90 phút. Cả 3 báo cáo vẫn đang mở. ## Câu hỏi thường gặp ### Lỗi 529 có tính vào giới hạn sử dụng Claude của tôi không? Không. Tài liệu Claude Code nói lỗi 529 không phải giới hạn sử dụng của bạn và không tính vào hạn mức. ### Lỗi Claude overloaded kéo dài bao lâu? Anthropic cho biết lỗi này thường chỉ tạm thời. Xem status.claude.com để biết có sự cố nào đang diễn ra và các cập nhật mới nhất. ### Vì sao Claude Code báo rate limit reached? Giới hạn gói của bạn đã hết, máy chủ tạm điều tiết request trong thời gian ngắn, hoặc một khóa API đã chạm rate limit. `/usage` và `/status` cho biết đó là trường hợp nào. ### Khi nào giới hạn của Claude Code được đặt lại? Thông báo ghi rõ thời điểm, ví dụ `resets 3:45pm`. `/usage` cũng hiện thời điểm này. ### Ứng dụng của tôi có nên thử lại lỗi 529 không? Có, với exponential backoff. Các SDK chính thức mặc định thử lại 2 lần, và trong lần thử của chúng tôi, TypeScript SDK chờ đúng bằng thời gian mà `retry-after` yêu cầu. ## Xem mọi lỗi Claude API trong ứng dụng của bạn Nếu ứng dụng của bạn gọi Claude API, LogBrew gom các lỗi 529 và 429 lặp lại thành 1 vấn đề và cho biết mỗi lỗi xảy ra thường xuyên đến mức nào. Bắt đầu với gói miễn phí rộng rãi, không cần thẻ. [Bắt đầu miễn phí](https://logbrew.co/vi) ## Nguồn - [Claude API docs, Errors](https://platform.claude.com/docs/en/api/errors) - [Claude API docs, Rate limits](https://platform.claude.com/docs/en/api/rate-limits) - [Claude Code docs, Error reference](https://code.claude.com/docs/en/errors) - [anthropics/claude-code#16157](https://github.com/anthropics/claude-code/issues/16157) - [anthropics/claude-code#29579](https://github.com/anthropics/claude-code/issues/29579) - [anthropics/claude-code#6457](https://github.com/anthropics/claude-code/issues/6457) ## Thêm hướng dẫn cho AI agent lập trình - [Thêm máy chủ MCP vào Claude Code và Codex](https://logbrew.co/vi/guides/mcp-server-claude-code-codex) - [Dùng AGENTS.md trong Claude Code và Codex](https://logbrew.co/vi/guides/agents-md) - [Cách sửa lỗi trong Claude Code, Codex và JavaScript trên trình duyệt](https://logbrew.co/vi/guides)