Đã đạt giới hạn sử dụng Claude: giới hạn phiên, hàng tuần và Opus, "giới hạn sử dụng API được chỉ định", "số dư tín dụng quá thấp" — và cách xử lý

Các thông báo, được phân loại theo bộ đếm tương ứng

You've hit your session limit · resets 3pm
You've hit your weekly limit · resets Thu 9am
You've hit your Opus limit · resets Thu 9am
Usage credits are required for this model
Usage credits required for 1M context · run /usage-credits to purchase or /model to switch
You have reached your specified API usage limits. You will regain access on 2026-10-01 at 00:00 UTC.
Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits.
API Error: Server is temporarily limiting requests (not your usage limit) · Rate limited

Cửa sổ sử dụng của gói thuê bao (Pro / Max)

Ba thông báo đầu tiên là các cửa sổ sử dụng luân phiên của gói: một cửa sổ theo phiên đặt lại vài giờ sau khi bắt đầu, một cửa sổ hằng tuần, và một cửa sổ hằng tuần riêng cho mô hình cao cấp nhất. Mức sử dụng được tính theo token, không phải tin nhắn, nên một phiên tác tử dài với nhiều tác tử con tiêu hao hạn mức nhanh hơn trò chuyện rất nhiều. /usage cho biết mức sử dụng hiện tại của từng cửa sổ; /stats cho biết những gì đã tiêu hao hạn mức. Không có gì cần sửa hay khởi động lại: thông báo có ghi thời điểm đặt lại.

Hai vấn đề về các cửa sổ này tạo ra phần lớn hoạt động trên hệ thống theo dõi lỗi. Mốc đặt lại được cố định theo tài khoản và không thể thay đổi (#76272, 30 lượt phản ứng, người dùng cùng gói có ngày đặt lại khác nhau). Và bộ đếm có thể tăng dù không thấy công việc nào diễn ra: #54750 và #82506 báo cáo giới hạn phiên đạt 100% dù mức sử dụng cục bộ rất ít, và #62466 (24 lượt phản ứng) cho thấy một vòng lặp image couldn't be processed lỗi API tiêu hao toàn bộ hạn mức mà không tạo ra kết quả nào. Nếu mức sử dụng tăng khi bạn không làm gì, hãy kiểm tra các phiên chạy nền, tác vụ đã lên lịch và vòng lặp thử lại trước khi cho rằng bộ đếm sai.

"Cần tín dụng sử dụng cho mô hình này"

Đây là thông báo khiến người dùng gói thuê bao bối rối nhất, vì nó xuất hiện khi gói vẫn còn hạn mức. Nó có nghĩa là mô hình hoặc cửa sổ bạn đã chọn nằm ngoài gói và phải được thanh toán bằng tín dụng sử dụng bổ sung.

Nguyên nhân phổ biến nhất là một mô hình có cửa sổ mặc định là 1M token: #62052 ghi nhận cách diễn đạt *Đã đạt giới hạn sử dụng* cho một trường hợp thực chất là rào cản cấp ngữ cảnh 1M, và cách khắc phục là chọn biến thể không phải 1M trong /model (hoặc đặt CLAUDE_CODE_DISABLE_1M_CONTEXT=1). #78610 (đang mở, 49 lượt phản ứng) tổng hợp các báo cáo về việc thông báo xuất hiện với những mô hình *có* nằm trong gói, đôi khi cùng lúc trình theo dõi mức sử dụng biến mất; các trường hợp đó trùng với sự cố dịch vụ, nên hãy kiểm tra status.claude.com và thử lại trước khi mua bất cứ thứ gì.

Thanh toán trên console: "giới hạn sử dụng API đã chỉ định" và "số dư tín dụng quá thấp"

Các thông báo này xuất phát từ khóa API, không phải gói đăng ký. *Bạn đã đạt giới hạn sử dụng API đã thiết lập* là giới hạn chi tiêu hằng tháng được cấu hình cho tổ chức trong bảng điều khiển Anthropic (Cài đặt → Giới hạn); quyền truy cập được khôi phục vào ngày ghi trong thông báo hoặc khi quản trị viên tăng giới hạn. *Số dư tín dụng của bạn quá thấp* nghĩa là số dư trả trước đã hết; API hoạt động theo hình thức trả trước, nên không có tác vụ nào chạy cho đến khi bạn nạp thêm. Cả hai đều không phải lỗi và đều không bị ảnh hưởng bởi /compact, việc khởi động lại hay cài đặt lại.

Nếu bạn dùng cả khóa API và gói đăng ký trên cùng một máy, hãy nhớ rằng khóa được ưu tiên: khi có ANTHROPIC_API_KEY trong môi trường, Claude Code tính phí vào khóa ngay cả khi bạn nghĩ mình đang dùng Max, đó là lý do nhiều người chạm giới hạn trong bảng điều khiển mà họ chưa từng biết là có. /status cho biết phương thức nào đang được sử dụng.

"Máy chủ đang tạm thời giới hạn yêu cầu (không phải giới hạn sử dụng của bạn)"

Phần trong ngoặc giải thích toàn bộ vấn đề: Anthropic đang hạn chế tốc độ ở phía họ khi tải cao, còn hạn mức của bạn không bị ảnh hưởng. #53915 (đang mở, 68 bình luận) là chủ đề thảo luận chính; người dùng ở đó phàn nàn ít về việc hạn chế tốc độ hơn là việc Claude Code dừng lại thay vì thử lại, khiến các phiên không có người giám sát bị kết thúc. Chờ một phút rồi tiếp tục bằng claude -c; với các lần chạy dài, hãy đặt CLAUDE_CODE_RETRY_WATCHDOG=1 để ứng dụng khách tiếp tục thử lại, và xem đây là một 529 quá tải thay vì một giới hạn.

Tiếp tục làm việc: dùng API không có khung thời gian giới hạn theo phiên

Gói đăng ký cho bạn một khung thời gian sử dụng; khóa API cho bạn token. Khi khung thời gian đó gây trở ngại — hết hạn mức tuần ngay vào thứ Ba, chạm giới hạn Opus giữa chừng khi làm tác vụ — cách thiết thực là trỏ chính Claude Code đó đến một điểm cuối API để dùng trong phần còn lại của tuần. Qua cổng này, khóa được trả trước theo từng token với hệ số trên trang giá, không có chu kỳ đặt lại theo phiên hay theo tuần, và lần nạp đầu tiên bằng tiền mã hóa của bạn được nhân đôi (+50%). Bỏ thiết lập khóa để quay lại gói đăng ký khi hạn mức được đặt lại.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude          # billed per token, no session or weekly window

Giới hạn tốc độ theo phút (429) lại là một cơ chế khác và được trình bày trên trang giới hạn tốc độ.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Câu hỏi thường gặp

AI 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.