Hướng dẫn khắc phục lỗi tài khoản và API Claude: Từ đăng nhập thất bại đến timeout yêu cầu

Khi sử dụng Claude, dù là đăng nhập qua Web hay gọi API, bạn đều có thể gặp nhiều lỗi khác nhau. Bài viết này tổng hợp các lỗi phổ biến nhất và cách khắc phục thủ công dựa trên tình huống thực tế, giúp bạn nhanh chóng khôi phục cuộc trò chuyện hoặc dịch vụ API.

Đăng nhập thất bại: "Invalid credentials" hoặc "Account locked"

Sau khi nhập đúng email và mật khẩu nhưng vẫn nhận thông báo "Invalid credentials", nguyên nhân thường là do nhập sai mật khẩu nhiều lần khiến tài khoản bị khóa tạm thời. Lúc này bạn nên chờ 15–30 phút rồi thử lại, hoặc sử dụng "Forgot password" để đặt lại mật khẩu.

Nếu gặp thông báo "Account locked" và tài khoản mới đăng ký, có thể bạn chưa xác minh email. Hãy kiểm tra hộp thư đến (bao gồm cả thư rác) để tìm email xác thực từ Claude và nhấp vào liên kết kích hoạt. Một số email doanh nghiệp có thể chặn thư xác thực, bạn nên chuyển sang dùng Gmail hoặc Outlook.

API trả về "401 Unauthorized"

Lỗi này hầu như luôn do API Key không hợp lệ hoặc không được truyền đúng cách. Trước tiên hãy kiểm tra xem bạn đã thêm Authorization: Bearer YOUR_API_KEY vào header yêu cầu chưa. Nếu Key vừa được tạo, có thể cần đợi vài phút để đồng bộ.

Ngoài ra, API Key của Claude có hai loại: cấp dự án và cấp người dùng. Sử dụng nhầm sẽ gây lỗi 401. Hãy kiểm tra phạm vi quyền của Key và gọi đúng endpoint. Ví dụ: endpoint chat/completions yêu cầu quyền cụ thể.

Thường xuyên gặp "429 Too Many Requests"

Đây là lỗi giới hạn tần suất phổ biến nhất. Tài khoản miễn phí thường chỉ cho phép 30 yêu cầu mỗi phút, vượt quá sẽ nhận mã 429. Giải pháp là trước tiên xem bảng giới hạn tốc độ trong tài liệu chính thức, sau đó điều chỉnh khoảng cách giữa các yêu cầu theo gói của bạn.

Nếu bạn đang sử dụng gói Pro hoặc Team trả phí, có thể bật tự động thử lại bằng cách đọc giá trị "Retry-After" trong header. Trong code nên áp dụng chiến lược exponential backoff: bắt đầu chờ 1 giây, sau mỗi lần thất bại tăng gấp đôi.

Gián đoạn phiên: "Session expired" hoặc "Connection reset"

Trên Web, nếu không thao tác trong thời gian dài, hệ thống sẽ tự động đăng xuất vì lý do bảo mật. Chỉ cần đăng nhập lại. Nếu thường xuyên gặp "Connection reset", có thể do mạng không ổn định hoặc cấu hình proxy. Hãy thử tắt VPN hoặc đổi node.

Một nguyên nhân phổ biến khác là xung đột bộ nhớ đệm trình duyệt. Xóa cookies và cache (đặc biệt liên quan đến claude.ai), sau đó khởi động lại trình duyệt. Nếu vẫn không được, hãy thử chế độ ẩn danh hoặc trình duyệt Edge/Firefox.

Gặp các lỗi trên, hãy kiểm tra theo từng bước, hầu hết đều có thể tự khắc phục. Nếu vẫn báo lỗi, bạn có thể chụp ảnh màn hình gửi cho bộ phận hỗ trợ chính thức của Claude, kèm theo timestamp và request ID, họ thường phản hồi trong vòng 1 ngày làm việc.