Claude Code

Claude Code hết hạn mức: session limit, weekly limit và cách chạy tiếp

Claude Code báo “You've hit your session limit” giữa lúc đang làm việc? Bài giải thích hai loại hạn mức của gói Claude (theo phiên 5 giờ và theo tuần), cách xem mức đã dùng và giờ đặt lại, những thói quen làm hạn mức cạn nhanh, và các cách chạy tiếp ngay, kể cả bằng API key tính theo token.

Biên soạn: đội ngũ STEYG One7 phút

Thông báo hết hạn mức trông thế nào?

Khi dùng Claude Code bằng tài khoản Claude có gói thuê bao, lúc chạm hạn mức theo phiên bạn sẽ thấy một thông báo kèm giờ đặt lại, ví dụ:

Claude Code dừng nhận yêu cầu mới cho tới giờ đó. Đây không phải lỗi của máy hay của mạng, mà là hạn mức của gói đang dùng.

Thông báo của Claude Code
You've hit your session limit · resets 3:45pm

Hai loại hạn mức của gói Claude

Theo trang giá và trung tâm hỗ trợ của Anthropic tại thời điểm cập nhật bài, mọi gói đều có hạn mức theo phiên: số lượt dùng được tính trong một cửa sổ 5 giờ. Các gói trả phí có thêm hạn mức theo tuần, tính chung cho mọi model; riêng model Fable trong gói Max có hạn mức tuần riêng.

Ứng dụng Claude trên web, điện thoại và Claude Code dùng chung một hạn mức. Một buổi chiều chạy Claude Code liên tục có thể làm phần trò chuyện còn lại trong tuần ít đi, và ngược lại.

  • Pro: mỗi phiên dùng được tối thiểu gấp 5 lần gói Free.
  • Max 5x và Max 20x: gấp 5 hoặc 20 lần Pro.
  • Team: ghế Standard khoảng 1,25 lần Pro, ghế Premium khoảng 6,25 lần Pro.

Xem đã dùng bao nhiêu và khi nào đặt lại

Trong Claude Code, lệnh /usage cho biết mức đã dùng của phiên hiện tại và của tuần, cùng giờ đặt lại. Lệnh /status cho biết phiên đang đăng nhập bằng gì: gói thuê bao, key của Claude Console hay key của một gateway. Nếu /status báo đang dùng API key mà bạn không định dùng, có một biến môi trường như ANTHROPIC_API_KEY đang ghi đè phiên đăng nhập.

Vì sao hạn mức cạn nhanh?

Hạn mức đo theo khối lượng xử lý, không theo số câu bạn gõ. Mỗi bước của Claude Code gửi lại gần hết ngữ cảnh của phiên, nên các thói quen sau làm hạn mức cạn rất nhanh:

  • Kéo dài một phiên qua nhiều việc khác nhau, để ngữ cảnh cũ đi theo mọi bước mới.
  • Cho agent đọc cả thư mục lớn thay vì chỉ những file liên quan.
  • Dùng model tầng cao cho cả những việc lặp lại, như đổi tên biến hay sửa định dạng.
  • Để agent chạy lệnh in ra rất nhiều log, vì toàn bộ log đi vào ngữ cảnh.

Kéo dài hạn mức mà không đổi gói

Một vài thói quen giúp cùng hạn mức làm được nhiều việc hơn:

  • Dùng /clear khi chuyển sang việc mới, /compact khi phiên đã dài mà vẫn cần mạch cũ.
  • Chỉ định đúng file cần đọc trong yêu cầu, và ghi quy ước của repo vào CLAUDE.md ngắn gọn.
  • Chọn model nhẹ hơn bằng /model cho việc đơn giản, để model tầng cao cho bước khó.
  • Lọc bớt output của lệnh dài, ví dụ chỉ in phần lỗi của bộ test.
  • Rút gọn CLAUDE.md, tắt MCP server thừa và hạ mức suy luận; chi tiết ở bài tiết kiệm token khi dùng Claude Code.

Chạy tiếp ngay khi đã chạm hạn mức

Khi việc không chờ được tới giờ đặt lại, có bốn lựa chọn:

  • Chờ phiên 5 giờ hoặc tuần mới đặt lại, theo giờ mà /usage cho biết.
  • Bật usage credits trong tài khoản Claude: phần dùng thêm tính theo giá API.
  • Nâng gói, ví dụ từ Pro lên Max, nếu bạn chạm giới hạn tuần thường xuyên.
  • Chạy Claude Code bằng API key: tính theo token, không có giới hạn theo phiên hay theo tuần mà chỉ giới hạn bởi ngân sách bạn nạp.

Chuyển Claude Code sang API key trong vài phút

Claude Code ưu tiên API key trong biến môi trường hơn phiên đăng nhập, nên đặt biến là đủ để chuyển; muốn quay lại gói thuê bao thì bỏ biến đi. Với STEYG Code, ngân sách trả bằng VND qua chuyển khoản, tiêu hết thì tự dừng, không bao giờ bị tính quá số tiền đã trả.

Làm theo bài dùng Claude Code với API key riêng để đặt ANTHROPIC_BASE_URL, key và model cho ba alias. Tài khoản mới có hạn mức dùng thử 10.000đ trong 7 ngày, không cần thẻ, đủ để chạy tiếp phần việc đang dở.

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

Hạn mức Claude Code đặt lại khi nào?

Hạn mức theo phiên đặt lại sau cửa sổ 5 giờ, hạn mức theo tuần đặt lại sau mỗi tuần. Thông báo hết hạn mức ghi sẵn giờ đặt lại, và lệnh /usage trong Claude Code cho biết chi tiết.

Claude Code và ứng dụng Claude có dùng chung hạn mức không?

Có. Theo Anthropic, ứng dụng Claude trên web, điện thoại và Claude Code dùng chung một hạn mức của gói, nên dùng nhiều ở chỗ này thì chỗ kia còn ít.

Gói Max có hết hạn mức không?

Có, chỉ là lớn hơn: Max 5x và Max 20x gấp 5 và 20 lần Pro, và vẫn có giới hạn theo phiên lẫn theo tuần. Người chạy Claude Code cả ngày vẫn có thể chạm giới hạn tuần.

Dùng API key thì có giới hạn gì?

Không có hạn mức theo phiên hay theo tuần như gói thuê bao; chi phí tính theo token thật và chỉ dừng khi hết ngân sách. Nhà cung cấp vẫn có thể giới hạn tốc độ gọi khi quá tải, khi đó API trả lỗi 429 kèm thời gian chờ.

Tạo API key miễn phí

Tài khoản mới có hạn mức dùng thử 10.000đ trong 7 ngày, không cần thẻ. Một key cho mọi coding agent.

Tạo API key miễn phí

Đọc tiếp

Bài do Hộ kinh doanh Truyền thông & Công nghệ STEYG biên soạn, cập nhật lần cuối 25/10/2026; người chịu trách nhiệm nội dung: Đường Hào Minh. Xem thêm tài liệu API.