Claude Code ECONNRESET, "Mất kết nối", "Đang chờ phản hồi API · Kiểm tra mạng của bạn", "Không thể kết nối tới API" và lỗi chứng chỉ

Các thông báo

API Error: Connection dropped (ECONNRESET)
API Error: Connection lost mid-response
API Error: fetch failed
Unable to connect to API (ConnectionRefused)
Retrying in 0s · attempt 1/10
Waiting for API response · will retry in 2m 35s · check your network
API Error: Socket is closed
SSL certificate verification failed: unable to get local issuer certificate
Error: certificate has expired (CERT_HAS_EXPIRED)

Vấn đề ở phía bạn hay phía họ? Kiểm tra trong hai phút

curl -sS -o /dev/null -w "%{http_code} %{time_total}s\n" https://api.anthropic.com/v1/models -H "x-api-key: x" -H "anthropic-version: 2023-06-01"
# 401 in under a second = network path is fine, the problem is upstream or in Claude Code
# timeout / SSL error / 000 = the problem is on your side of the wire
env | grep -i -E "proxy|anthropic|node_extra|ssl"
claude --debug     # per-request timing and retry reasons in the log

Nếu curl nhanh chóng nhận được 401 và không có biến proxy nào, gần như chắc chắn bạn đang gặp sự cố phía thượng nguồn. Đó là nhóm trong #87424 (đang mở: ECONNRESET xuất hiện gián đoạn trên ứng dụng máy tính và CLI, không VPN, không proxy, từ tháng Tám 13, được nhiều người xác nhận đến tháng Tám 21) và #86473 (ECONNRESET xuất hiện liên tục trên mọi giao diện trong khi lệnh HTTP trực tiếp tới API vẫn hoạt động). Không có biện pháp cục bộ nào khắc phục được những trường hợp đó; cần thử lại và chờ. Kiểm tra status.claude.com, và nếu nhiều người báo cáo cùng thời điểm trên hệ thống theo dõi vấn đề, hãy ngừng gỡ lỗi.

"Đang chờ phản hồi API · kiểm tra mạng của bạn"

Thông báo quy lỗi cho mạng của bạn, nhưng thường nhận định đó không đúng. #82155 (đang mở, 15 lượt phản hồi): liên tục bị chờ nhiều phút suốt cả ngày, với thời gian chờ giữa các lần thử lại tăng lên hơn hai phút trên một mạng đã được chứng minh là hoạt động tốt. #76555 (đang mở): phải chờ ở mọi phản hồi trên các mô hình khác nhau. #72059 và #70534: cùng tình trạng chờ đó xảy ra cụ thể khi mô hình cố vấn được tham vấn, rồi có câu trả lời bình thường sau khi bộ đếm kết thúc. Thời gian chờ tăng theo cấp số nhân, nên tác động dễ thấy là thời gian chờ, không phải lỗi; các biến bên dưới giúp rút ngắn thời gian này.

Các biến thử lại và thời gian chờ

export CLAUDE_CODE_MAX_RETRIES=15               # default 10, capped at 15
export CLAUDE_CODE_RETRY_WATCHDOG=1              # keep retrying instead of giving up (unattended runs)
export API_TIMEOUT_MS=600000                     # per-request timeout, default 10 minutes
export CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS=60000 # give up on a silent stream sooner and retry
export CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=2    # fewer parallel streams on a flaky link

Giảm thời gian chờ byte đầu tiên là thay đổi giúp cải thiện cảm nhận khi kết nối chập chờn: thay vì chờ đủ mười phút trên một luồng sẽ không bao giờ trả lời, ứng dụng khách bỏ luồng đó và thử lại. Giảm số thao tác dùng công cụ đồng thời giúp ích trên các đường truyền bị ngắt khi nhiều luồng chạy cùng lúc (điểm phát sóng di động, một số VPN).

Proxy, VPN và mạng doanh nghiệp

Thiết lập các biến proxy mà Claude Code đọc: HTTPS_PROXY (và HTTP_PROXY, NO_PROXY). CLI không nhận biết được proxy chỉ tồn tại trong trình duyệt hoặc cấu hình npm.
Các proxy kiểm tra TLS thay chứng chỉ của Anthropic bằng chứng chỉ của riêng chúng: đó là unable to get local issuer certificate. Xuất CA gốc của doanh nghiệp ra tệp PEM và thiết lập NODE_EXTRA_CA_CERTS=/path/to/corp-root.pem. Không tắt xác minh.
`CERT_HAS_EXPIRED` trên bản dựng gốc (#71727, 2.1.19x): nguyên nhân là kho chứng chỉ tin cậy đi kèm, không phải đồng hồ của bạn. claude update; nếu vẫn bị kẹt, bản dựng npm sử dụng kho chứng chỉ hệ thống.
`ConnectionRefused` trên macOS sau khi cài đặt lại (#75897) — proxy cục bộ hoặc ứng dụng VPN đã tắt nhưng vẫn được cấu hình trong môi trường; xóa các biến proxy và thiết lập proxy hệ thống, rồi thử lại.
Thay đổi điểm thoát VPN giữa phiên sẽ đặt lại mọi luồng đang mở: có thể gặp một lỗi ECONNRESET sau mỗi lần kết nối lại.

Qua cổng trung gian

Trỏ Claude Code tới một cổng trung gian (ANTHROPIC_BASE_URL=https://aiprimetech.io) và đường truyền mạng sẽ thay đổi: máy khách giao tiếp với cổng trung gian, còn cổng trung gian duy trì các kết nối tới dịch vụ phía trên và thử lại trên tài khoản khác khi một tài khoản đã quá tải. Cách này không khắc phục được mạng cục bộ bị lỗi, nhưng với nhóm gặp *lỗi đặt lại kết nối từ phía dịch vụ* nêu trên, nó loại bỏ sự phụ thuộc vào một tài khoản duy nhất, và cùng một khóa vẫn tiếp tục hoạt động khi dịch vụ đăng ký gặp sự cố. Chạy kiểm tra bằng curl với máy chủ của cổng trung gian để xác nhận đường truyền trước khi chuyển đổi.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude

Bạn đã mệt mỏi vì phải xử lý lỗi này?

Hãy chạy Claude Code qua gateway AI Prime Tech: vẫn là các mô hình Claude đó, sử dụng tài khoản upstream riêng của gateway, chỉ cần hai biến môi trường để chuyển đổi, và tài khoản mới nhận được $5 tín dụng API miễn phí với mã FIXIT — không cần thẻ.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Tạo tài khoản với mã FIXIT

Câu hỏi thường gặp

Làm cách nào để khắc phục 'Lỗi API: Kết nối bị ngắt (ECONNRESET)' trong Claude Code?

Chạy curl để gọi API: nếu API phản hồi nhanh và bạn không dùng proxy, lỗi đặt lại kết nối nằm ở phía dịch vụ; hãy để quá trình thử lại tiếp tục, kiểm tra status.claude.com. Nếu curl cũng thất bại, hãy sửa các biến proxy, VPN hoặc chứng chỉ CA.

'Đang chờ phản hồi API · sẽ thử lại sau … · kiểm tra mạng của bạn' có nghĩa là gì?

Claude Code không nhận được phản hồi từ API trong thời gian chờ và đang tạm dừng trước khi thử lại. Dù thông báo nói vậy, nguyên nhân thường không nằm ở mạng của bạn; hãy giảm CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS để máy khách ngừng chờ các luồng không phản hồi sớm hơn.

Làm cách nào để khắc phục 'không thể lấy chứng chỉ của tổ chức phát hành cục bộ' trong Claude Code?

Một proxy đang ký lại TLS. Xuất chứng chỉ gốc của công ty ở định dạng PEM và đặt NODE_EXTRA_CA_CERTS trỏ tới tệp đó. Tuyệt đối không tắt xác minh chứng chỉ.

'Thử lại sau 0 giây · lần thử 1/10' có nghĩa là gì?

Một yêu cầu đã thất bại và Claude Code đang thử lại; mặc định là 10 lần thử với thời gian chờ tăng dần, CLAUDE_CODE_MAX_RETRIES nâng số lần thử lên 15, còn CLAUDE_CODE_RETRY_WATCHDOG=1 duy trì việc thử lại cho các lần chạy không có người giám sát.

Chạy Claude Code trên cổng API

Vẫn các mô hình đó, hai biến môi trường, tín dụng có giá trị sử dụng gấp 7.69231× mệnh giá — hoặc gói không giới hạn với phí cố định. Tài khoản mới: $5 tín dụng API miễn phí với mã FIXIT.

Lấy khóa API Xem các gói không giới hạn

AI Prime Tech là một cổng API độc lập, không có quan hệ liên kết với Anthropic và không được Anthropic chứng thực hay tài trợ. “Claude” và “Claude Code” là các nhãn hiệu của Anthropic. Các tính năng Claude Code được mô tả ở đây dựa trên tài liệu công khai của Anthropic tại thời điểm viết và thường xuyên thay đổi; giá và danh sách mô hình trên trang này được đọc từ cấu hình hiện hành của cổng API này.

Lỗi kết nối Claude Code: ECONNRESET, mất kết nối giữa chừng khi đang nhận phản hồi, "Đang chờ phản hồi API", "Không thể kết nối với API", lỗi chứng chỉ SSL

TLDR