Khi Claude Code hiển thị « đã đạt giới hạn », hãy bắt đầu bằng việc xác định loại giới hạn: gói đăng ký, tốc độ API, trần chi tiêu hay vấn đề tài khoản. Cách khắc phục đúng có thể là chờ đặt lại, kích hoạt tín dụng chính thức, giảm số lệnh gọi đồng thời hoặc sửa khóa. Mua một gói khác trước khi chẩn đoán có thể khiến vấn đề vẫn còn nguyên.
Bạn thấy thông báo nào?
| Triệu chứng | Kiểm tra | Hành động phù hợp |
|---|---|---|
| Đã đạt quota gói, hiển thị thời điểm tiếp tục | Tài khoản Claude và trang sử dụng | Chờ, so sánh gói khác hoặc tín dụng sử dụng |
| API 429 kèm chỉ báo tốc độ | Thông báo, yêu cầu đồng thời và header thời điểm thử lại | Giảm tốc độ và tuân thủ thời gian chờ được thông báo |
| Trần chi tiêu hoặc thanh toán bị từ chối | Số dư, giới hạn tài khoản và thanh toán | Sửa giới hạn hoặc vấn đề thanh toán liên quan |
| API 401 hoặc 403 | Khóa, miền đích và quyền hạn | Sửa thông tin nhận dạng hoặc quyền cấp phép |
| Cuộc trò chuyện quá dài | Kích thước ngữ cảnh và thông báo chính xác | Tóm tắt công việc và giảm ngữ cảnh hữu ích |
Các mã dưới đây mô tả API Anthropic. Nếu Claude Code đi qua nhà cung cấp khác, hãy xem thêm tài liệu của nhà cung cấp đó: trung gian có thể hiển thị thông báo và hạn mức riêng.
1. Nếu bạn sử dụng gói đăng ký Claude
Mở phần cài đặt sử dụng của tài khoản đã kết nối. Ghi lại quota liên quan và thời điểm được nêu, thay vì suy ra một khoảng thời gian chung từ một thông báo tìm thấy ở nơi khác. Đồng thời xác minh rằng Claude Code đang sử dụng đúng tài khoản mong muốn.
Anthropic phân biệt giới hạn sử dụng và giới hạn độ dài. Việc sử dụng Claude và Claude Code có thể dùng chung hạn mức của tài khoản. Vì vậy, mở cửa sổ mới hoặc cuộc trò chuyện mới không tạo thêm quota. Tuy nhiên, giảm bớt một ngữ cảnh đã trở nên lớn có thể làm giảm lượng công việc model cần xử lý trong các lần gọi tiếp theo.
Để tiếp tục sau khi dùng hết hạn mức đi kèm, các gói cá nhân đủ điều kiện có tín dụng sử dụng chính thức. Tín dụng được tính phí riêng theo mức giá API tiêu chuẩn. Trong phần cài đặt sử dụng, hãy kiểm tra việc kích hoạt, số tiền khả dụng và trần chi tiêu. Đây là một lựa chọn cần so sánh với việc chờ, đổi gói hoặc dùng một tài khoản API riêng.
2. Nếu API trả về 429
Kiểm tra nội dung lỗi và giới hạn API. Với giới hạn tốc độ, giảm số tác vụ đồng thời và tuân thủ thời gian chờ retry-after khi có. Việc lập tức khởi chạy lại nhiều agent có thể duy trì cùng một trạng thái bị chặn.
429 cũng có thể tương ứng với trần hằng tháng của cấp API hoặc một số giới hạn chi tiêu của không gian Claude Code. Trần hằng tháng có thể không cung cấp thời điểm thử lại. Khi đó, hãy kiểm tra thanh toán và trần liên quan đến tài khoản; vòng lặp thử lại không làm tăng chúng. Chỉ riêng việc thiếu một header chưa đủ để kết luận: hãy đọc cả thông báo.
3. Nếu vấn đề liên quan đến số dư hoặc xác thực
Tài liệu tham chiếu lỗi Anthropic phân biệt, trong số các mã khác, 401 cho xác thực, 403 cho quyền hạn và 402 cho thanh toán. Một số giới hạn chi tiêu cũng có thể xuất hiện với mã 400. Vì vậy, riêng mã HTTP không thể thay thế chi tiết lỗi.
Kiểm tra miền mà yêu cầu được gửi đến và tài khoản đã tạo khóa. Gói đăng ký Claude, số dư Console và số dư tại nhà cung cấp bên thứ ba không thể dùng thay thế cho nhau. Việc nạp tiền tại một nhà cung cấp không tự động tài trợ cho các nhà cung cấp khác. Sau khi sửa, hãy dùng một yêu cầu nhỏ để xác nhận tài khoản bị tính phí trước khi tiếp tục tác vụ quan trọng.
4. Tiếp tục với thanh toán API riêng
Tài liệu gateway nêu rõ rằng một định danh gateway đang hoạt động sẽ thay thế danh tính gói đăng ký trong phiên. Chỉ đặt base URL không thực hiện thay đổi này: kết nối đã lưu có thể vẫn hoạt động. Vì vậy, hãy cấu hình đồng thời địa chỉ, định danh và model mong muốn.
Hướng dẫn giá và cấu hình Claude Code giải thích cách sử dụng Kunavo bằng tiếng Pháp. Danh mục hiện hiển thị Claude Sonnet 4.6 với giá $2,10 cho đầu vào và $10,50 cho đầu ra trên mỗi triệu token. Hướng dẫn giá API Claude trình bày chi tiết các đơn vị cần so sánh. Một tác vụ có thể bao gồm nhiều lệnh gọi; chi phí của tác vụ cũng phụ thuộc vào ngữ cảnh, bộ nhớ đệm và các lần thử lại.
Nếu cách tách biệt này phù hợp với bạn, hãy tạo tài khoản Kunavo, cấu hình một khóa, rồi kiểm tra lệnh gọi đầu tiên trong lịch sử sử dụng của bạn. Tài khoản này có các ràng buộc riêng; nó không biến Claude Code thành dịch vụ không giới hạn.
Chuẩn bị một yêu cầu hỗ trợ hữu ích
Nếu tình trạng bị chặn vẫn tiếp diễn, hãy lưu lại các thông tin sau. Chúng giúp phân biệt vấn đề cấu hình với giới hạn được áp dụng đúng tài khoản mà không công khai khóa bí mật của bạn:
Interface et version de Claude Code :
Compte utilisé : abonnement / Console / fournisseur tiers
Modèle et nom de domaine de l'API :
Message exact et code HTTP éventuel :
Heure de réinitialisation affichée :
En-tête retry-after, s'il existe :
Identifiant de requête, s'il existe :Đồng thời, hãy giữ lại công việc cục bộ và trạng thái của tác vụ. Sau khi quyền truy cập được khôi phục, yêu cầu agent kiểm tra các file đã sửa trước khi bắt đầu lại để tránh lặp lại các bước đã hoàn thành hoặc làm mất ngữ cảnh của bản sửa.
Câu hỏi thường gặp
Phải làm gì khi Claude Code hiển thị « đã đạt giới hạn »?
Trước tiên, xác định tài khoản cung cấp các phản hồi. Với gói đăng ký, kiểm tra thời điểm đặt lại và các tùy chọn tín dụng sử dụng. Với API, đọc toàn bộ thông báo: tốc độ, giới hạn chi tiêu, thanh toán và xác thực cần những cách khắc phục khác nhau.
Mã 429 có phải lúc nào cũng có nghĩa là cần chờ không?
Không. API Claude cũng dùng 429 cho một số giới hạn chi tiêu. Vượt giới hạn tốc độ có thể cần chờ và giảm số yêu cầu đồng thời; giới hạn tài chính yêu cầu kiểm tra giới hạn và thanh toán của tài khoản. Thông báo và các header giúp chọn đúng nhánh xử lý.
Cuộc trò chuyện mới có đặt lại quota không?
Không. Cuộc trò chuyện mới có thể giảm ngữ cảnh được truyền, nhưng không đặt lại hạn mức của tài khoản. Giới hạn độ dài cuộc trò chuyện và giới hạn sử dụng của gói đăng ký là hai ràng buộc riêng biệt.
Khóa Kunavo có xóa bỏ mọi giới hạn không?
Không. Cấu hình API bằng khóa Kunavo sử dụng tài khoản và thanh toán tách biệt với gói đăng ký Claude. Cấu hình này vẫn chịu giới hạn số dư, hạn mức và các model có sẵn tại Kunavo. Chỉ thay đổi base URL mà không cấu hình đúng định danh là chưa đủ để thay đổi thanh toán.
Các nguồn chính thức được kiểm tra ngày 17 tháng 9 năm 2026.