Nếu bạn đang trả tiền cho gói Pro, Max hoặc Ultra, bạn đã có sẵn quyền dùng Claude Code mà không cần mua thêm gì. Bài này hướng dẫn cách gắn Claude Code vào gói cá nhân, cách hạn mức được tính chung với Claude, và những thiết lập cần tránh để không bị tính phí API ngoài ý muốn.
Một gói, hai công cụ
Claude Code đưa các model Claude vào terminal hoặc trình soạn code (IDE) của bạn, để bạn giao những việc lập trình phức tạp mà vẫn theo dõi và kiểm soát được từng bước. Điểm đáng chú ý: chỉ với một gói Pro, Max hoặc Ultra, bạn dùng được cả Claude (bản web, desktop, di động) lẫn Claude Code.
Cách chia việc hợp lý là: dùng Claude để viết, nghiên cứu, phân tích; dùng Claude Code cho việc lập trình trong terminal. Bài này dành cho tài khoản cá nhân. Nếu bạn thuộc tổ chức dùng gói Team hoặc Enterprise, Help Center có một bài hướng dẫn riêng.
Kết nối Claude Code với gói của bạn
- Kiểm tra gói. Bạn cần một gói Pro, Max hoặc Ultra đang hoạt động. Chưa có thì nâng cấp tại claude.ai/upgrade.
- Cài Claude Code. Làm theo trang Quickstart trong tài liệu Claude Code (code.claude.com) cho đúng hệ điều hành của bạn.
- Đăng nhập. Khi được hỏi lúc cài đặt hoặc lần chạy đầu, hãy đăng nhập bằng đúng tài khoản bạn dùng cho Claude.
- Đang dùng Console? Nếu trước đây bạn đăng nhập bằng tài khoản Claude Console trả theo mức dùng, gõ
/loginbên trong Claude Code để chuyển sang gói thuê bao.
Không thấy lựa chọn đăng nhập bằng tài khoản mong muốn? Làm lần lượt:
- Đăng xuất hẳn bằng
/logout. - Chạy
claude updateđể cập nhật. - Tắt hẳn terminal rồi mở lại.
- Chạy
claudevà chọn đúng tài khoản.
Cạm bẫy lớn nhất: biến ANTHROPIC_API_KEY
Claude Code ưu tiên API key trong biến môi trường hơn là gói thuê bao bạn đã đăng nhập. Nếu máy bạn còn sót
biến ANTHROPIC_API_KEY (ví dụ từ một dự án cũ), mọi lượt dùng sẽ bị tính theo giá API trả theo mức dùng, chứ không
trừ vào hạn mức của gói.
Cách kiểm tra:
- Bên trong Claude Code, gõ
/statusđể xem phương thức đăng nhập nào đang được dùng. Nên kiểm tra định kỳ. - Bên ngoài Claude Code, mở terminal và xem biến có tồn tại không:
# macOS / Linux
echo $ANTHROPIC_API_KEY
# Windows PowerShell
echo $env:ANTHROPIC_API_KEYNếu có giá trị mà bạn muốn dùng gói thuê bao, hãy gỡ biến đi:
# macOS / Linux (chỉ phiên hiện tại)
unset ANTHROPIC_API_KEY
# Windows PowerShell (chỉ phiên hiện tại)
Remove-Item Env:ANTHROPIC_API_KEYĐể gỡ vĩnh viễn, xóa dòng khai báo biến trong file cấu hình shell (như ~/.zshrc) hoặc xóa biến trong phần
Environment Variables của Windows. Sau khi đổi biến môi trường, nhớ khởi động lại terminal.
Dùng trong VS Code, Cursor và JetBrains
Gói của bạn cũng áp dụng cho Claude Code trong các IDE được hỗ trợ:
- VS Code
- Cursor và các bản dựng khác từ VS Code
- Các IDE của JetBrains như IntelliJ, PyCharm
Bạn đăng nhập bằng cùng tài khoản Claude như trong terminal. Lượt dùng trong IDE cũng trừ vào chung một hạn mức với Claude. Phiên Claude Code chạy trên đám mây (xem bài Claude Code trên web) cũng vậy.
Hạn mức sử dụng được tính thế nào?
| Gói | Giới hạn |
|---|---|
| Pro, Max | Giới hạn theo phiên 5 giờ và giới hạn theo tuần |
| Ultra | Giới hạn theo tuần; tài khoản Ultra đã xác minh không có giới hạn phiên 5 giờ |
| Max, Ultra | Thêm một giới hạn tuần riêng cho model Fable |
Mọi hoạt động trên Claude và Claude Code đều cộng dồn vào cùng các giới hạn này. Bạn sẽ thấy cảnh báo khi sắp chạm ngưỡng.
Phần “kết thúc dở dang”: nếu chạm giới hạn 5 giờ giữa lúc Claude đang trả lời, Claude Code có thể làm nốt bước đang dở thay vì dừng ngang. Khi đó bạn thấy dòng Usage limit reached · wrapping up. Phần này nhỏ, có trần và vẫn tính vào giới hạn tuần. Với Pro, nó áp dụng tối đa một lần mỗi chu kỳ tuần; với Max, có thể áp dụng mỗi lần chạm giới hạn 5 giờ. Tính năng đang được triển khai dần nên có thể chưa có trên tài khoản của bạn.
Khi chạm giới hạn: các lựa chọn
- Pro: nâng lên Max nếu thường xuyên hết hạn mức hoặc làm với kho mã lớn; bật usage credits để làm tiếp; chuyển sang tài khoản Claude Console và mua API credits cho đợt làm việc dồn dập; hoặc chờ hạn mức được làm mới.
- Max: nâng lên Ultra; bật usage credits; dùng API credits qua Console; hoặc chờ.
- Ultra: bật usage credits sau khi hết giới hạn tuần; dùng API credits qua Console; hoặc chờ.
Lưu ý: API credits hằng tháng đi kèm gói Max và Ultra không dùng được trong Claude Code hay các ứng dụng Claude.
Nếu chọn dùng API credits, lượt dùng sẽ tính theo giá API tiêu chuẩn, khác với giá gói. Tính năng tự nạp tiền (auto-reload) nằm trong phần cài đặt thanh toán của Claude Console, không nằm trong Claude Code.
Tình huống mẫu: Bạn dùng gói Pro, đang sửa lỗi dở thì Claude Code báo đã chạm giới hạn và hỏi có muốn dùng
API credits không. Nếu không muốn phát sinh chi phí, hãy từ chối lựa chọn đó, gõ /status để xem hạn mức còn lại,
rồi ghi chú việc đang làm (ví dụ: “Lưu lại tóm tắt những gì đã sửa và bước tiếp theo vào file NOTES.md”) để khi hạn mức
được làm mới bạn tiếp tục ngay.
Muốn chỉ dùng gói, không bao giờ bị hỏi về API credits
- Chạy
claude logout. - Chạy
claude loginvà chỉ đăng nhập bằng tài khoản Pro, Max hoặc Ultra. - Không thêm thông tin đăng nhập Claude Console trong lúc đăng nhập.
Với thiết lập này, Claude Code chỉ dùng hạn mức của gói và không hiện lời mời mua API credits khi bạn chạm giới hạn.
Những điều bạn học được trong bài này
- Một gói Pro, Max hoặc Ultra dùng được cả Claude lẫn Claude Code, kể cả trong VS Code, Cursor, JetBrains
- Đăng nhập bằng tài khoản Claude; dùng
/loginđể chuyển từ Console sang gói thuê bao - Biến
ANTHROPIC_API_KEYđược ưu tiên hơn gói và khiến bạn bị tính phí API - Pro và Max có giới hạn phiên 5 giờ và giới hạn tuần, dùng chung với Claude
- Khi chạm giới hạn: nâng gói, bật usage credits, dùng API credits hoặc chờ làm mới
- Đăng nhập chỉ bằng tài khoản gói để không bị hỏi về API credits
Cần nhớ: Trước khi bắt đầu một dự án với Claude Code, hãy gõ /status để chắc chắn bạn đang dùng
gói thuê bao chứ không phải một API key còn sót lại. Đây là nguyên nhân phổ biến nhất khiến người dùng gói Pro/Max bất ngờ nhận hóa
đơn API.
Nguồn tham khảo: Use Claude Code with your Pro, Max, or Ultra plan – Claude Help Center · Manage API key environment variables in Claude Code – Claude Help Center
Câu hỏi thường gặp
Gói Pro có dùng được Claude Code không, hay phải lên Max?
Gói Pro dùng được Claude Code. Max và Ultra cho hạn mức cao hơn; Help Center gợi ý nâng lên Max nếu bạn thường xuyên chạm giới hạn hoặc làm việc với kho mã lớn.
Dùng Claude Code có làm giảm hạn mức chat trên claude.ai không?
Có. Claude và Claude Code dùng chung các giới hạn của gói, nên một buổi lập trình dài cũng làm giảm lượng chat còn lại trong cùng chu kỳ.
Tôi dùng API credits hằng tháng của gói Max cho Claude Code được không?
Không. API credits hằng tháng đi kèm Max và Ultra không dùng được trong Claude Code hay các ứng dụng Claude, kể cả để trả cho usage credits.
Làm sao biết Claude Code đang tính tiền vào gói hay vào API?
Gõ /status bên trong Claude Code để xem phương thức đăng nhập đang dùng. Nếu thấy API key, hãy kiểm tra và gỡ biến ANTHROPIC_API_KEY, rồi khởi động lại terminal.
