Các nhà phát triển sử dụng Claude Code — công cụ mã hóa agentic của Anthropic — thường gặp phải các giới hạn: "Đã đạt đến giới hạn sử dụng Claude. Giới hạn của bạn sẽ được đặt lại lúc 7 giờ tối (Châu Á/Tokyo)." Thông báo này đặt ra câu hỏi: việc đặt lại chính xác là gì, khi nào sẽ diễn ra, và bạn nên thay đổi mã hoặc cơ sở hạ tầng của mình như thế nào để tránh những bất ngờ?
Nếu sản phẩm hoặc quy trình CI của bạn dựa vào Claude Code để định dạng, tạo thử nghiệm hoặc đánh giá mã theo yêu cầu, các giới hạn bất ngờ có thể làm gián đoạn quy trình làm việc. Việc biết giới hạn là 429 ngắn hạn (giây–phút), đặt lại phiên (giờ) hay giới hạn hàng tuần (ngày) cho phép bạn quyết định nên thử lại, giảm dần hoặc lên lịch công việc sau.
Claude Code là gì?
Mã Claude là sản phẩm mã hóa tập trung vào nhà phát triển của Anthropic, tích hợp trực tiếp vào quy trình làm việc của nhà phát triển: terminal, CI, kiểm soát phiên bản và IDE. Nó được xây dựng để thực hiện chỉnh sửa nhiều tệp, phân loại sự cố, chạy thử nghiệm và tự động hóa các tác vụ mã — về cơ bản là một cộng tác viên đại diện nằm trong CLI và công cụ của bạn. Sản phẩm này có sẵn như một phần của dòng sản phẩm Claude (web, API và Code), được thiết kế để tăng tốc các tác vụ lập trình (tạo mã, tái cấu trúc, giải thích, tạo thử nghiệm, gỡ lỗi) bằng cách cho phép nhà phát triển gọi các mô hình Claude trực tiếp từ trình soạn thảo hoặc terminal, thường có các phím tắt và hành vi được thiết lập sẵn cho mô hình để tối ưu hóa cho các lời nhắc nặng về mã. Nó cũng cung cấp cả các lệnh CLI tương tác (như /config, /status) và API quản trị cho các tổ chức.
Sự khác biệt chính so với API Claude chung:
- Claude Code hướng đến quy trình làm việc của nhà phát triển (ngữ nghĩa phiên/tác nhân, dòng trạng thái, cài đặt cấp dự án), trong khi API Messages/Completions là điểm cuối suy luận theo chương trình có mục đích chung.
- Các tổ chức có thể sử dụng API Quản trị/Sử dụng để truy xuất báo cáo sử dụng Claude Code hàng ngày (hữu ích cho bảng thông tin và phân bổ chi phí).
Danh sách kiểm tra tính năng nhanh
- Tích hợp Terminal / VS Code cho quy trình làm việc theo hướng code-first.
- Chuyển đổi mô hình tự động hoặc thủ công (Opus ↔ Sonnet) để cân bằng giữa chi phí/thông lượng.
- Kế toán sử dụng và giới hạn theo phiên để ngăn chặn bất kỳ người dùng nào độc quyền dung lượng.
- Sự khác biệt giữa các gói (Miễn phí / Chuyên nghiệp / Tối đa / Nhóm / Doanh nghiệp) làm thay đổi cách phân bổ và hành vi.
Khi nào thì việc sử dụng Mã Claude được thiết lập lại?
Câu trả lời ngắn gọn: tùy thuộc vào kế hoạch của bạn — nhưng quy tắc thực tế và quan trọng nhất cần nhớ ngày nay là việc sử dụng dựa trên phiên trong Claude Code được điều chỉnh bởi một khung thời gian năm giờ liên tục bắt đầu khi bạn bắt đầu sử dụng phiênvà các mức trần hàng tuần rộng hơn được theo dõi riêng biệt.
Cả gói Pro và Max đều có giới hạn sử dụng cho Claude Code. Số lượng tin nhắn bạn có thể gửi phụ thuộc vào độ dài tin nhắn, độ dài cuộc trò chuyện và số lượng tệp đính kèm, trong khi mức sử dụng Claude Code phụ thuộc vào độ phức tạp của dự án, kích thước cơ sở mã và cài đặt tự động chấp nhận. Sử dụng mô hình tính toán chuyên sâu sẽ giúp bạn đạt đến giới hạn sử dụng nhanh hơn.
Cách thức hoạt động của buổi học kéo dài năm giờ (quy tắc quan trọng)
Đối với các gói trả phí (Pro và Max), Claude Code theo dõi giới hạn sử dụng dựa trên phiên "Đặt lại sau mỗi năm giờ". Thực tế, điều đó có nghĩa là đồng hồ cho thời gian phân bổ 5 giờ của bạn sẽ bắt đầu khi bạn gửi yêu cầu đầu tiên trong một phiên — không phải lúc nửa đêm, và không được đồng bộ hóa với ranh giới lịch. Khi đạt đến giới hạn phiên, bạn sẽ thấy thông báo "đã đạt giới hạn sử dụng" và thời gian bắt đầu phiên tiếp theo.
Giới hạn cấp độ API và tổ chức: bổ sung liên tục
Đối với người tiêu dùng API và các nhà tích hợp trên toàn tổ chức, Anthropic triển khai giới hạn tỷ lệ token-bucket và giới hạn chi tiêu. Các giới hạn tỷ lệ này là được bổ sung liên tục (không chỉ ở ranh giới năm giờ riêng biệt) và được báo cáo thông qua các tiêu đề phản hồi như anthropic-ratelimit-requests-remaining, anthropic-ratelimit-tokens-remaining, và tương ứng -reset dấu thời gian. Đối với các máy khách API, các tiêu đề này là nguồn đáng tin cậy để biết khi nào bạn có thể tiếp tục hoạt động nặng.
Giới hạn cứng hàng tuần và thay đổi "người dùng có quyền lực"
Vào giữa năm 2025, Anthropic đã giới thiệu thêm giới hạn sử dụng hàng tuần (khung thời gian 7 ngày) để hạn chế việc người dùng Claude Code lạm dụng tài nguyên nền liên tục. Các giới hạn hàng tuần này khác với hành vi phiên 5 giờ và hành vi nhóm mã thông báo: nếu bạn sử dụng hết giới hạn hàng tuần, việc chờ 5 giờ ngắn ngủi sẽ không khôi phục khả năng sử dụng một số tính năng hoặc mô hình nhất định cho đến khi khung thời gian 7 ngày được đặt lại (hoặc bạn mua thêm dung lượng nếu được cung cấp).
Nhân loại thực thi giới hạn sử dụng hàng tuần (phân bổ luân phiên 7 ngày) cho Claude Code trên các gói trả phí. Các giới hạn hàng tuần này được thể hiện như sau: giờ ước tính của việc sử dụng Mã Claude theo từng mô hình (Sonnet so với Opus) và thay đổi tùy theo gói và cấp độ.
Pro vs Max (dành cho người tiêu dùng): Sự khác biệt thực tế là gì?
Người dùng Opus có khối lượng mã lớn hoặc chạy nhiều phiên bản Claude Code song song sẽ nhanh chóng gặp phải tình trạng tắc nghẽn hiệu suất hơn.
Gói chuyên nghiệp ($20/tháng):
- Phiên: ~45 tin nhắn cứ năm giờ hoặc ~10–40 lời nhắc Claude Code cứ năm giờ.
- Hàng tuần: ~ 40–80 giờ of Sonnet 4 (Kế hoạch chuyên nghiệp nói chung không hỗ trợ Opus trong Claude Code).
Tối đa 5× (100 đô la/tháng):
- Phiên: ~225 tin nhắn cứ năm giờ hoặc ~50–200 lời nhắc Claude Code cứ năm giờ.
- Hàng tuần: ~ 140–280 giờ of Sonnet 4 và ~ 15–35 giờ of Opus 4 (Opus có sẵn trên Max).
Tối đa 20× (200 đô la/tháng):
- Phiên: ~900 tin nhắn cứ năm giờ hoặc ~200–800 lời nhắc Claude Code cứ năm giờ.
- Hàng tuần: ~ 240–480 giờ of Sonnet 4 và ~ 24–40 giờ of Opus 4.
Các tình huống cụ thể và ý nghĩa thông thường của "thiết lập lại"
1. Bạn nhận được một 429 với retry-after
- Chuyện gì đã xảy ra: bạn đã đạt đến giới hạn tỷ lệ yêu cầu/mã thông báo.
- Những gì mong đợi:
retry-aftertiêu đề cho bạn biết phải đợi bao nhiêu giây; phản hồi của Anthropic cũng thiết lậpanthropic-ratelimit-*-resetTiêu đề chứa dấu thời gian RFC3339 để bổ sung chính xác. Sử dụng các tiêu đề này để lên lịch chính xác các lần thử lại.
2. Phiên Claude Code tương tác hiển thị “Đang đến giới hạn 5 giờ / đặt lại lúc 7 giờ tối”
- Điều gì đã xảy ra: phiên tương tác của bạn đã sử dụng hết dung lượng phân bổ ngắn hạn. Trước đây, các phiên có hành vi cửa sổ thực tế "5 giờ" và giao diện người dùng (UI) thường làm tròn thời gian đặt lại thành thời gian đồng hồ gọn gàng. Thời gian hiển thị có thể là thời gian cục bộ của tài khoản hoặc giao diện người dùng, và người dùng đã báo cáo rằng thời gian này chỉ là gần đúng (không phải lúc nào cũng chính xác theo dấu thời gian RFC3339). Hãy coi thời gian giao diện người dùng như vậy là tham khảo; hãy sử dụng các phương pháp lập trình để đảm bảo độ chính xác nếu có thể.
3. Bạn đạt đến giới hạn Opus/model hàng tuần
- Điều gì đã xảy ra: bạn hoặc tổ chức của bạn đã sử dụng hết hạn mức hàng tuần cho một mô hình cụ thể (ví dụ: Opus 4).
- Điều cần lưu ý: giới hạn lưu lượng hàng tuần sẽ chỉ được bổ sung sau khi khung thời gian bảy ngày kết thúc. Việc chờ đợi thiết lập lại hàng giờ hoặc hàng phút sẽ không khôi phục lại dung lượng hàng tuần. Anthropic đã công bố giới hạn lưu lượng hàng tuần cho một số thuê bao bắt đầu từ ngày 28 tháng 8 năm 2025; thuê bao Max có thể mua thêm dung lượng nếu cần.
4. Bạn đã đạt đến giới hạn chi tiêu hàng tháng của mình
- Chuyện gì đã xảy ra: tổ chức của bạn đã đạt đến giới hạn chi tiêu theo tháng đã đặt ra.
- Điều cần lưu ý: quyền truy cập bị giới hạn cho đến tháng dương lịch tiếp theo (hoặc cho đến khi bạn tăng giới hạn chi tiêu/tiền gửi). Điều này được áp dụng để ngăn ngừa tình trạng chi tiêu quá mức ngoài dự kiến.
Lưu ý về hiện tượng bất thường trong thế giới thực: Có những báo cáo lỗi đang mở mô tả các trường hợp giao diện người dùng (UI) báo cáo thời gian đặt lại nhưng hạn ngạch thực tế không làm mới vào thời điểm được chỉ định — đôi khi ảnh hưởng đến trải nghiệm web so với CLI theo cách khác nhau. Nếu tự động hóa của bạn phụ thuộc vào việc đặt lại, hãy tính đến khả năng đối chiếu bị trì hoãn.
Cách phát hiện trạng thái thiết lập lại theo chương trình — ví dụ mã
Các nhà phát triển có thể cần phải lập trình để phát hiện theo thời gian thực liệu có nên đặt lại hay không và khi nào cần đặt lại để tránh gián đoạn công việc. Dưới đây là các mẫu mã thực dụng mà bạn có thể đưa vào các công cụ sản xuất để phát hiện việc đặt lại, phản ứng an toàn và duy trì số liệu.
1) Sử dụng tiêu đề phản hồi từ Messages API để lên lịch thử lại
Khi bạn đánh một 429, Anthropic bao gồm các tiêu đề hiển thị dung lượng còn lại và dấu thời gian đặt lại chính xác. Ví dụ Python này minh họa cách đọc anthropic-ratelimit-requests-reset và quay trở lại Retry-After khi có mặt:
import requests
from datetime import datetime, timezone
import time
API_URL = "https://api.anthropic.com/v1/complete" # example inference endpoint
API_KEY = "sk-...YOUR_KEY..."
HEADERS = {
"x-api-key": API_KEY,
"anthropic-version": "2023-06-01",
"content-type": "application/json",
}
payload = {
"model": "claude-opus-4",
"messages": ,
}
resp = requests.post(API_URL, headers=HEADERS, json=payload)
if resp.status_code == 429:
# Prefer exact RFC3339 reset timestamp header if present
reset_time = resp.headers.get("anthropic-ratelimit-requests-reset")
retry_after = resp.headers.get("retry-after")
if reset_time:
# parse RFC3339-style timestamp to epoch
try:
reset_dt = datetime.fromisoformat(reset_time.replace("Z", "+00:00"))
wait_seconds = (reset_dt - datetime.now(timezone.utc)).total_seconds()
except Exception:
wait_seconds = int(retry_after or 60)
elif retry_after:
wait_seconds = int(retry_after)
else:
wait_seconds = 60 # conservative default
wait_seconds = max(0, wait_seconds)
print(f"Rate limited. Waiting {wait_seconds:.1f}s before retry.")
time.sleep(wait_seconds + 1)
# Retry logic here...
else:
print("Response OK:", resp.status_code)
print(resp.text)
Tại sao điều này có ích: đọc anthropic-ratelimit-*-reset cung cấp cho bạn dấu thời gian RFC3339 về thời điểm dự kiến thùng chứa sẽ được bổ sung; retry-after có thẩm quyền để lùi lại ngay lập tức.
2) Kiểm tra mức sử dụng theo chương trình (cấp độ tổ chức) — Báo cáo sử dụng của quản trị viên (cURL)
Anthropic hiển thị điểm cuối "Báo cáo sử dụng" của Quản trị viên, trả về số liệu Mã Claude mỗi ngày cho các tổ chức. Lưu ý: Khóa API quản trị là bắt buộc và API này dành cho các tổ chức (không phải tài khoản cá nhân). Ví dụ (đã chỉnh sửa để rõ ràng hơn):
# Replace $ANTHROPIC_ADMIN_KEY and starting_at with your values
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?starting_at=2025-08-08&limit=20" \
--header "anthropic-version: 2023-06-01" \
--header "content-type: application/json" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY"
Điều này trả về các bản ghi tổng hợp hàng ngày (cam kết, dòng mã, mã thông báo, chi phí ước tính, v.v.) — hữu ích cho bảng thông tin và đối chiếu hóa đơn.
3) Sử dụng CLI của Claude Code /status và tích hợp dòng trạng thái cho công cụ cục bộ
CLI của Claude Code hiển thị các lệnh slash và /status (hoặc lệnh liên quan) để xem phân bổ tương tác còn lại; bạn cũng có thể cấu hình dòng trạng thái tùy chỉnh (/statusline) hoặc sử dụng .claude/settings.json để hiển thị số liệu thống kê sử dụng trong dấu nhắc shell của bạn.
Những chiến thuật thực tế nào giúp giảm thiểu xung đột hạn ngạch?
1. Bắt đầu các buổi học một cách thông minh
Bắt đầu một bước lập kế hoạch hoặc tạo ra năng lượng tích cực ngay sau khi thiết lập lại. Nếu bạn mong đợi một phiên làm việc dài, hãy biến đó thành "yêu cầu đầu tiên" để neo giữ một khoảng thời gian năm giờ mới.
2. Sử dụng chuyển đổi mô hình một cách chiến lược
Opus mạnh mẽ nhưng đắt tiền về mặt phân bổ; Sonnet rẻ hơn. Sử dụng /model khi bắt đầu phiên hoặc dựa vào tính năng chuyển đổi tự động để kéo dài thời gian sử dụng trong một khoảng thời gian. Nhiều người dùng gói Max cấu hình ngưỡng chuyển đổi tự động để tối đa hóa thời gian hoạt động.
3. Phối hợp giữa các đồng đội
Nếu nhiều đồng đội đạt cùng mức giới hạn hàng tuần trong một nhóm hoặc tổ chức, hãy phối hợp các đợt chạy lớn (ví dụ: thử nghiệm hiệu suất, cải tiến quy mô lớn) để tránh tình trạng tiêu thụ chồng chéo.
4. Sử dụng API hoặc trả tiền khi sử dụng cho các đợt bùng phát
Nếu Claude Code đạt đến hạn ngạch UI cục bộ, hãy cân nhắc sử dụng API/bảng điều khiển Claude với tín dụng trả tiền khi sử dụng cho các đợt phát hành gấp (kiểm tra gói của bạn để xem liệu gói này có khả dụng và tiết kiệm chi phí hay không).
Các nhà phát triển có thể truy cập Claude Sonnet 4.5 API và Claude Opus 4.1 API v.v. thông qua CometAPI, phiên bản mẫu mới nhất luôn được cập nhật trên trang web chính thức. Để bắt đầu, hãy khám phá các khả năng của mô hình trong Sân chơi và tham khảo ý kiến Hướng dẫn API để biết hướng dẫn chi tiết. Trước khi truy cập, vui lòng đảm bảo bạn đã đăng nhập vào CometAPI và lấy được khóa API. Sao chổiAPI cung cấp mức giá thấp hơn nhiều so với giá chính thức để giúp bạn tích hợp.
Sẵn sàng chưa?→ Đăng ký CometAPI ngay hôm nay !
Nếu bạn muốn biết thêm mẹo, hướng dẫn và tin tức về AI, hãy theo dõi chúng tôi trên VK, X và Discord!
Kết luận
Việc hiểu rõ thời điểm mã Claude Code được thiết lập lại là rất quan trọng — nó ảnh hưởng đến cách bạn lập kế hoạch cho các buổi lập trình, cách bạn lập ngân sách cho các tài nguyên đăng ký và cách bạn phản ứng với các gián đoạn. Mô hình tư duy hiện tại, có thể áp dụng rộng rãi, rất đơn giản và dễ thực hiện: một khung thời gian phiên họp kéo dài năm giờ cộng với các giới hạn hàng tuần riêng biệt. Sử dụng các tập lệnh trợ giúp nhỏ để tính toán thời gian thiết lập lại và tích hợp trình giám sát mức sử dụng vào quy trình làm việc của bạn để các giới hạn trở thành một phần có thể dự đoán được trong nhịp độ kỹ thuật của bạn thay vì là điều bất ngờ.
