Ошибки подключения Claude Code: ECONNRESET, потеря соединения во время ответа, «Ожидание ответа API», «Не удалось подключиться к API», ошибки SSL-сертификатов

Сообщения

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)

Проблема у вас или у них? Проверка за две минуты

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

Если curl быстро возвращает 401 и переменные прокси не заданы, почти наверняка это инцидент на стороне провайдера. Именно такие случаи описаны в #87424 (открыта: периодический ECONNRESET в настольном приложении и CLI, без VPN и прокси, с августа 13, подтверждено несколькими пользователями вплоть до августа 21) и #86473 (постоянный ECONNRESET во всех интерфейсах, хотя прямой HTTP к API работает). Локально это не исправить; помогают повторные попытки и время. Проверьте status.claude.com, и если несколько пользователей сообщают в трекере о проблеме в тот же час, прекратите отладку.

«Ожидание ответа API · проверьте сеть»

Сообщение указывает на вашу сеть, но часто ошибается. #82155 (открыта, 15 реакций): многоминутные задержки в течение всего дня с интервалом между повторными попытками более двух минут при заведомо исправной сети. #76555 (открыта): ожидание каждого ответа на разных моделях. #72059 и #70534: такое же зависание именно при обращении к модели-консультанту, затем обычный ответ после окончания отсчёта. Интервал между попытками растёт экспоненциально, поэтому заметная проблема — ожидание, а не ошибка; переменные ниже сокращают его.

Переменные повторных попыток и времени ожидания

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

Сокращение времени ожидания первого байта меняет ощущения от нестабильного соединения: вместо ожидания полных десяти минут в потоке, который никогда не ответит, клиент прекращает запрос и повторяет попытку. Снижение числа параллельных вызовов инструментов помогает на соединениях, которые обрываются при одновременной работе нескольких потоков (мобильные точки доступа, некоторые VPN).

Прокси, VPN и корпоративные сети

• Задайте переменные прокси, которые читает Claude Code: HTTPS_PROXY (и HTTP_PROXY, NO_PROXY). Прокси, настроенный только в браузере или конфигурации npm, для CLI невидим.
• Прокси с проверкой TLS заменяют сертификат Anthropic своим: это и есть unable to get local issuer certificate. Экспортируйте корпоративный корневой сертификат CA в файл PEM и задайте NODE_EXTRA_CA_CERTS=/path/to/corp-root.pem. Не отключайте проверку.
• `CERT_HAS_EXPIRED` в нативной сборке (#71727, 2.1.19x): причина во встроенном хранилище доверенных сертификатов, а не в ваших часах. claude update; если проблема сохраняется, сборка npm использует системное хранилище.
• `ConnectionRefused` на macOS после переустановки (#75897) — локальный прокси или клиент VPN выключен, но по-прежнему настроен в окружении; очистите переменные прокси и системные настройки прокси, затем повторите попытку.
• Смена выходного узла VPN во время сессии сбрасывает все открытые потоки: ожидайте один ECONNRESET при каждом переподключении.

Через шлюз

Направьте Claude Code на шлюз (ANTHROPIC_BASE_URL=https://aiprimetech.io) — и сетевой маршрут изменится: клиент обращается к шлюзу, а шлюз поддерживает соединения с вышестоящим сервисом и повторяет запросы через другой аккаунт, если текущий перегружен. Это не исправит неисправную локальную сеть, но для описанных выше случаев *сброса соединения на стороне вышестоящего сервиса* устраняет зависимость от одного аккаунта, а тот же ключ продолжает работать при сбое подписки. Перед переключением выполните проверку curl для хоста шлюза, чтобы убедиться, что маршрут работает.

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

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

Часто задаваемые вопросы

AI Prime Tech — независимый API-шлюз, который не связан с Anthropic, не одобрен и не спонсируется этой компанией. «Claude» и «Claude Code» — товарные знаки Anthropic. Описанные здесь возможности Claude Code соответствуют публичной документации Anthropic на момент написания и часто меняются; цены и списки моделей на этой странице берутся из текущих настроек шлюза.