curl достаёт до API, а Claude Code пишет Connection refused
Проверьте Задан ли ANTHROPIC_BASE_URL в оболочке или файле настроек?
Решение Удалите его или укажите работающий шлюз, затем запустите Claude Code из нового терминала.
Claude Code не удаётся подключиться к API: ECONNRESET
Что означает каждое сообщение о соединении и в каком порядке проверять.
Сначала прочитайте сообщение
| Пункт | Что означает | Что проверить сначала |
|---|---|---|
| Connection refused (ConnectionRefused, ECONNREFUSED) | Что-то отказало в соединении: брандмауэр, прокси или адрес, который никто не слушает | Остаток ANTHROPIC_BASE_URL, затем брандмауэр и прокси |
| Can't reach the API server (ENOTFOUND) | Имя не разрешилось | Интернет и DNS |
| No internet route (EHOSTUNREACH) | Нет маршрута до хоста | Сеть и VPN |
| Couldn't connect through your proxy (ERR_PROXY_TUNNEL) | Прокси отказал в туннеле | Логин прокси и разрешён ли ему api.anthropic.com |
| Connection dropped (ECONNRESET) | Соединение сброшено после открытия | Прокси или шлюз на пути, VPN, нестабильная сеть |
| Request timed out | Ответа вовремя не было | Интернет и настройки прокси |
| SSL certificate verification failed | Прокси или устройство подписывает трафик сертификатом, которому Claude Code не доверяет | NODE_EXTRA_CA_CERTS |
Источник: справочник ошибок в документации Claude Code, прочитан 15 ноября 2026. В документации таймаут показан как Request timed out; ETIMEDOUT обрабатывайте так же.
Три самые частые причины
1. Сеть не достаёт до api.anthropic.com. Нет интернета, VPN блокирует хост или между вами и ним стоит брандмауэр. Claude Code повторяет временные сбои до 10 раз с экспоненциальной паузой, так что к моменту ошибки он уже пробовал.
2. Обязательный прокси не задан или задан неверно. Claude Code читает HTTPS_PROXY и HTTP_PROXY, логин берёт из URL и не поддерживает SOCKS. Адрес без схемы http:// останавливает запуск с ошибкой, называющей переменную.
3. Остался ANTHROPIC_BASE_URL. Когда он задан, Claude Code отправляет запросы к модели по этому адресу, а не на api.anthropic.com, поэтому значение, указывающее на уже не работающий локальный шлюз, даёт Connection refused, хотя curl достаёт до API.
Проверки по порядку
# 1. Can this shell reach the API host at all? (PowerShell: use curl.exe)
curl -I https://api.anthropic.com
# 2. Through your proxy (replace with your own proxy URL)
curl -x http://LOGIN:PASSWORD@HOST:PORT -I https://api.anthropic.com
# 3. Is a leftover gateway address set? (PowerShell: echo $env:ANTHROPIC_BASE_URL)
echo $ANTHROPIC_BASE_URL
# 4. Set the proxy before you start Claude Code, then check the Proxy row in /status
export HTTPS_PROXY=http://LOGIN:PASSWORD@HOST:PORT
claudeТолько пример: подставьте свои LOGIN, PASSWORD, HOST и PORT и используйте HTTP-прокси, потому что Claude Code не поддерживает SOCKS.
Исправляем за 6 шагов
Шаг 1. Прочитайте точное сообщение
Найдите его в таблице выше. Код в скобках подскажет, это DNS, отказ, сброс, туннель прокси или таймаут.
Шаг 2. Выполните тест curl в той же оболочке
Выполните curl -I https://api.anthropic.com там, где запускаете claude. Если он не проходит, проблема в сети, VPN или брандмауэре, а не в Claude Code.
Ожидаемый результат Строка статуса HTTP от хоста API.
Шаг 3. Если curl работает, смотрите настройки самого Claude Code
Проверьте ANTHROPIC_BASE_URL в оболочке и в блоке env файлов настроек. В Linux и WSL посмотрите /etc/resolv.conf на недоступный сервер имён; в macOS проверьте, не остался ли туннель VPN; закройте Docker и похожие инструменты, чтобы исключить их.
Шаг 4. За прокси задайте его и проверьте
Задайте HTTPS_PROXY=http://USERNAME:PASSWORD@HOST:PORT до запуска claude или в блоке env файла ~/.claude/settings.json, чтобы его получили и фоновые агенты. Выполните /status и посмотрите строку Proxy.
Шаг 5. При ошибке сертификата доверьте нужный CA
Укажите в NODE_EXTRA_CA_CERTS пакет CA вашей организации. Не задавайте NODE_TLS_REJECT_UNAUTHORIZED=0: это отключает проверку сертификатов.
Шаг 6. Если сеть открыта, а сбой остаётся
При первом запуске проверка api.anthropic.com и platform.claude.com даёт каждой пробе 10 секунд. Если сеть открыта, а сбой не уходит, Claude Code может быть недоступен в вашей стране, поэтому сначала прочитайте список поддерживаемых стран.
Типичные ситуации
Couldn't connect through your proxy (ERR_PROXY_TUNNEL)
Проверьте Верен ли логин и разрешён ли прокси api.anthropic.com?
Решение Скопируйте USERNAME и PASSWORD заново из «Мои активы» и проверьте через curl -x до запуска claude.
Когда остановиться Если проверка тоже не проходит, создайте тикет с номером заказа.
Задан адрес SOCKS5, и ничего не подключается
Проверьте URL прокси начинается с socks5://?
Решение Claude Code не поддерживает SOCKS: используйте HTTP-прокси.
В терминале работает, а в фоновых агентах нет
Проверьте Переменная экспортирована только в оболочке?
Решение Добавьте её в блок env файла ~/.claude/settings.json.
ECONNRESET на каждом запросе через шлюз
Проверьте ANTHROPIC_BASE_URL указывает на LLM-шлюз?
Решение Проверьте маршрут через шлюз прямым запросом и посмотрите, что он принимает; в документации в числе проверок названы поля поиска инструментов.
Когда остановиться Если сбой только через шлюз, чинить нужно шлюз.
Как это сделать с Proxy302
Если вашей сети нужен прокси, чтобы достучаться до API, дайте Claude Code HTTP-прокси: откройте страницу ISP для ИИ-подписок для Claude (или страницу статических ISP), выберите протокол HTTP, создайте доступ и скопируйте HOST, PORT, USERNAME и PASSWORD из «Мои активы» в HTTPS_PROXY. Затем выполните /status и тест curl выше.
Прокси меняет только сетевой выход. Правила Anthropic о поддерживаемых странах и регионах продолжают действовать для вас, поэтому выбирайте выход в стране, где Claude доступен. Бесплатного пробного периода нет. Неработающий актив исправляется выдачей заново после тикета с номером заказа.
Частые вопросы
Что означает Unable to connect to API в Claude Code?
TCP-соединение Claude Code с API не удалось или не завершилось. Код в скобках называет тип сбоя, например ECONNREFUSED, ENOTFOUND, ECONNRESET или таймаут.
Что значит ECONNRESET в Claude Code?
В сообщении он показан как Connection dropped: соединение сброшено после открытия. Проверьте прокси или шлюз на пути, VPN и стабильность сети.
Работает ли Claude Code с SOCKS5-прокси?
Нет. В документации сказано, что Claude Code не поддерживает SOCKS-прокси. Используйте HTTP-прокси в HTTPS_PROXY.
curl работает, а Claude Code нет. Почему?
Поищите оставшийся ANTHROPIC_BASE_URL, оставшийся туннель VPN в macOS, недоступный сервер имён в Linux или WSL и переменные, заданные в оболочке, но не в settings.json.
Повторяет ли Claude Code запросы сам?
Да, временные сбои повторяются до 10 раз с экспоненциальной паузой. Ошибки сертификатов не повторяются, потому что повтор их не исправит.
Читайте дальше
Прокси для Claude
Прокси для Claude — это ISP для Claude: выделенный нативный IP в США, Франкфурте, Японии или Лондоне, 15 PTC за 30 дней, HTTP для Claude Code — и правила Anthropic.
Посмотреть параметры и цену
Прокси для Claude Code: настройка
Как запустить Claude Code за HTTP-прокси: HTTPS_PROXY, NO_PROXY, settings.json для фоновых агентов и проверка, что всё работает.
ERR_PROXY_CONNECTION_FAILED: что проверить
Ошибка ERR_PROXY_CONNECTION_FAILED появляется в Chrome и Edge, когда браузер не может установить соединение с прокси-сервером.
Где работают ChatGPT, Claude и Gemini
Сравнили четыре официальных списка: Россия и Беларусь не входят ни в один. Ошибки, проверка IP и наши ежечасные проверки из 7 стран.
ERR_TUNNEL_CONNECTION_FAILED: решение
ERR_TUNNEL_CONNECTION_FAILED (-111): Chrome достучался до прокси, но туннель не создан; три частые причины и тест curl -v со статусом.
Ссылки и источники
3
- Документация Claude Code: справочник ошибок, сетевые ошибки и ошибки соединения
Официальная документация · Проверено:
Прочитано 15 ноября 2026: раздел Unable to connect to API перечисляет сообщения с кодами ConnectionRefused или ECONNREFUSED, ENOTFOUND, EHOSTUNREACH, ERR_PROXY_TUNNEL, ECONNRESET (Connection dropped) и Request timed out; частые причины — нет интернета, VPN блокирует api.anthropic.com и не настроен обязательный корпоративный прокси; проверки: curl -I https://api.anthropic.com из той же оболочки, HTTPS_PROXY, оставшийся ANTHROPIC_BASE_URL от уже не работающего шлюза, недоступный сервер имён в /etc/resolv.conf на Linux и WSL, оставшийся туннель VPN в macOS и контейнерные среды; ошибки сертификатов не повторяются и решаются через NODE_EXTRA_CA_CERTS, а не NODE_TLS_REJECT_UNAUTHORIZED=0; временные сбои повторяются до 10 раз с экспоненциальной паузой; при первом запуске проверяются api.anthropic.com и platform.claude.com, на каждую проверку даётся 10 секунд, а если сеть открыта и всё равно сбой, Claude Code может быть недоступен в вашей стране.
- Документация Claude Code: сетевая конфигурация
Официальная документация · Проверено:
Прочитано 15 ноября 2026: Claude Code читает HTTPS_PROXY, HTTP_PROXY и NO_PROXY; для прокси с базовой аутентификацией логин пишется в URL (http://username:password@host:port); Claude Code не поддерживает SOCKS-прокси; URL прокси, который не удаётся разобрать, например без схемы http://, останавливает запуск с ошибкой, называющей переменную; /status показывает активный прокси; переменные из оболочки читаются один раз при запуске; фоновым агентам переменные нужно давать через блок env в ~/.claude/settings.json; на странице перечислены хосты, которые нужно разрешить, включая api.anthropic.com, claude.ai и platform.claude.com.
- Факты о продуктах и прайс-лист Proxy302
Наблюдение за продуктом · Проверено:
Файл фактов о продуктах сайта, проверен 15 ноября 2026: порты шлюза HTTP 2222 и SOCKS5 3333; у каждого статического IP один протокол, выбранный при покупке; HTTP или SOCKS5 для ISP для ИИ-подписок; неработающий актив выдаётся заново после тикета с номером заказа; бесплатного пробного периода нет.
Готовы попробовать?
Создайте аккаунт, пополните баланс и выберите ротируемый резидентный, статический ISP или дата-центр IP — настроить его в браузере можно за несколько минут.