API key status is expired
hoặc "Key đã hết hạn" |
Gói đã hết hạn theo thời gian hoặc đã đạt hạn mức token tối đa. |
Mở mục Lịch sử thanh toán, bấm Gia hạn trên đơn cũ hoặc mua gói mới ngoài trang chủ. |
Lỗi 402: Key API (nguồn) đã hết tiền |
Tài khoản gốc cung cấp model đã hết hạn mức/quota. Đây là lỗi phía hệ thống, không phải lỗi key của bạn. |
Chờ 5–10 phút để hệ thống chuyển sang key nguồn khác. Nếu vẫn lặp lại, gửi mã đơn (ORD-xxx) qua nhóm Zalo hỗ trợ. |
API key is locked to another IP address |
Bạn đang dùng key trên IP khác với IP đã đăng ký. Mỗi gói chỉ cho phép số IP cố định. |
Đợi 30 phút để khóa IP cũ tự nhả, rồi chạy lại lệnh trên IP mới. Hoặc dừng dùng key ở máy cũ trước khi sang máy mới. |
Hệ thống AI đang bận hoặc phản hồi không ổn định
429 / 503 / overloaded / timeout |
Nhà cung cấp model đang quá tải hoặc nghẽn mạng tạm thời. |
Thử lại sau 1–3 phút. Nếu trùng lúc cao điểm, đổi sang model khác trong gói (vd Sonnet ↔ Opus) để giảm tải. |
Đã đạt hạn mức 50 triệu token |
Gói combo Claude Code đã dùng hết quota tổng (input + output) cho phép. |
Mua gói mới để tiếp tục. Quota không cộng dồn giữa các gói. |
Yêu cầu chưa được xử lý vì hạn chế nhà cung cấp model |
Model bạn yêu cầu không nằm trong combo của gói (vd gọi Opus trong gói chỉ có Sonnet). |
Đặt biến môi trường ANTHROPIC_MODEL sang một trong các model gói cho phép. Xem mục Lựa chọn model trong hướng dẫn cài đặt. |
IP đang mở quá nhiều kết nối đồng thời |
Quá nhiều tiến trình chạy song song trên cùng IP, hệ thống tự chặn để bảo vệ. |
Đóng các phiên Claude/agent dư thừa. Đợi 5–10 phút để giải phóng kết nối, rồi chạy lại. |
Cảnh báo burst cao / Tạm khóa do burst |
Tốc độ gọi API tăng đột biến vượt ngưỡng cho phép trong thời gian ngắn. |
Giảm tải (giảm số worker, ngắn hóa prompt) trong vài phút. Tạm khóa sẽ tự gỡ sau 5–60 phút tùy mức độ. |
| Claude Code không nhận key, không chạy được sau khi cài |
Cấu hình Claude Code cũ trên máy ghi đè key mới, hoặc Node.js cũ hơn 18. |
Mở terminal mới (Windows: Command Prompt; macOS: Terminal). Chạy claude logout cho mọi tài khoản cũ. Đảm bảo Node 18+ (node -v). Chạy lại lệnh cài đặt trong tab Hướng dẫn sử dụng. |
The system cannot find the file specified khi dùng tool/agent |
Tool chạy lệnh shell không tồn tại trên máy (vd bash trên Windows, systemctl trên môi trường không phải Linux). |
Dùng đúng lệnh phù hợp với hệ điều hành: Windows dùng cmd/PowerShell (tasklist, schtasks), Linux dùng bash/systemctl. |
| Quét/cài bằng PowerShell báo "không cho phép chạy script" |
Execution policy của Windows đang chặn script chưa ký. |
Chạy Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass trước, rồi paste lại lệnh cài đặt. |
Thanh toán đã chuyển khoản nhưng đơn vẫn chưa kích hoạt |
Ngân hàng/ví trễ webhook, hoặc nội dung chuyển khoản sai mã đơn. |
Đợi tối đa 5 phút. Nếu vẫn chưa kích hoạt, gửi ảnh sao kê + mã đơn qua nhóm Zalo hỗ trợ để admin đối soát thủ công. |
API returned an empty or malformed response (HTTP 200)
hoặc "Hệ thống AI phản hồi trống" |
Server proxy tạm thời bị quá tải hoặc gián đoạn kết nối giữa các lớp (router ↔ gateway). Không phải lỗi key của bạn. |
Thử lại sau 1–2 phút. Nếu lỗi lặp liên tục quá 5 phút, gửi mã đơn (ORD-xxx) qua nhóm Zalo hỗ trợ để admin kiểm tra trạng thái server. |
check for a proxy or gateway intercepting the request
hoặc "malformed response — proxy intercepting" |
Có proxy/firewall cục bộ trên máy bạn (VPN, tường lửa công ty, phần mềm bảo mật) đang chặn hoặc can thiệp vào kết nối tới server. |
Tắt VPN hoặc proxy cục bộ, tắt tạm phần mềm diệt virus/tường lửa nếu có, rồi thử lại. Nếu dùng mạng công ty/trường học, thử đổi sang mạng di động (4G/5G). |
