Gặp lỗi mất kết nối hoặc timeout API khi dùng Claude? Bài viết này dành cho người dùng Claude Pro và bản miễn phí, cung cấp hướng dẫn từ chẩn đoán đến sửa lỗi cho các tình huống thường gặp, giúp bạn nhanh chóng khôi phục dịch vụ trò chuyện.
Lỗi kết nối mạng: Kiểm tra sự cố từ thiết bị và máy chủ
Nếu Claude thường xuyên báo "Mất kết nối mạng" hoặc "Không thể truy cập máy chủ", trước tiên hãy kiểm tra kết nối mạng cục bộ có ổn định không, thử chuyển qua Wi-Fi hoặc dữ liệu di động. Nếu các trang web khác vẫn hoạt động bình thường, có thể máy chủ Claude đang tạm thời dao động, hãy chờ 5-10 phút rồi thử lại.
Nếu gặp vấn đề kéo dài, hãy chạy lệnh ping api.anthropic.com trên dòng lệnh để kiểm tra kết nối. Nếu tỷ lệ mất gói vượt quá 10%, cần liên hệ nhà mạng hoặc dùng công cụ kiểm tra DNS hijacking. Ngoài ra, tường lửa mạng doanh nghiệp có thể chặn tên miền của Claude, cần thêm vào danh sách trắng.
Sửa lỗi timeout và giới hạn tốc độ gọi API
Nhà phát triển khi gọi API Claude gặp lỗi "429 Too Many Requests" hoặc "504 Gateway Timeout". Lỗi đầu tiên do vượt quá hạn mức yêu cầu mỗi phút, nên thêm logic retry dạng exponential backoff trong code, hoặc nâng cấp lên Claude Pro để có hạn mức cao hơn. Lỗi thứ hai thường do tải máy chủ quá cao, hãy tăng thời gian chờ lên trên 30 giây.
Nếu dùng SDK chính thức báo lỗi "connection reset by peer", hãy kiểm tra phiên bản thư viện có quá cũ không, chạy pip install --upgrade anthropic để cập nhật. Đồng thời đảm bảo khóa API chưa hết hạn, có thể tạo lại trong phần cài đặt tài khoản.


