«Unable to connect to API: SSL certificate verification failed» на Mac

Claude Code выводит это, когда сертификат выдан центром, которому он не доверяет. В документации названы корпоративный прокси с проверкой TLS или шлюз с частным центром сертификации.

Решите это с помощью агентаКопирует промпт для Claude Code, Codex или любого агента, который умеет работать с Терминалом.

У моего Mac такая проблема: «Unable to connect to API: SSL certificate verification failed» на Mac. Прочитай https://kilobat.app/ru/guides/claude-code-ssl-certificate-verification-failed.md и разберись с ней вместе со мной. Если Kilobat CLI не установлен, установи его: brew install seifip/kilobat/kilobat. Проверки в Терминале и через kilobat из руководства выполни сам и расскажи, что нашёл. Составь список шагов, которые могу сделать только я. Перед изменением любой настройки спрашивай меня.

Относится к: Claude Code в терминале во всех актуальных версиях macOS.Проверено: 29 октября 2026 г.

Симптомы

  • Claude Code выводит Unable to connect to API: SSL certificate verification failed.
  • В коде написано UNABLE_TO_GET_ISSUER_CERT_LOCALLY, или в тексте говорится о самоподписанном сертификате.
  • Это начинается в рабочей сети.

Вероятные причины

  • Прокси с проверкой TLS. Прокси или защитное устройство перехватывает трафик TLS и подставляет свой сертификат.
  • Шлюз с частным центром сертификации. Шлюз LLM может использовать сертификат от частного центра.
  • Файл CA не загружается. Claude Code предупреждает, если не может прочитать файл NODE_EXTRA_CA_CERTS.
  • Неверные часы. Дата, сильно отличающаяся от настоящей, нарушает проверку сертификатов.

Как проверить

  1. Прочитайте издателя.

    curl -v -o /dev/null https://api.anthropic.com 2>&1 | grep -i issuer
  2. Покажите переменную.

    echo $NODE_EXTRA_CA_CERTS
  3. Запустите Claude Code с отладочным журналом и найдите в журнале строки о CA.

    claude --debug
  4. Проверьте дату.

    date

Как исправить

  1. Получите у администратора пакет CA в формате PEM.

  2. Укажите его Claude Code перед запуском.

    export NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem
  3. Или добавьте CA в системное хранилище сертификатов macOS, как сказано в документации.

  4. Не задавайте NODE_TLS_REJECT_UNAUTHORIZED=0. Это отключает проверку.

С Kilobat

  1. Диагностика подключения в Kilobat проверяет хост API уровень за уровнем. На уровне TLS видно, кто подписал сертификат.

    kilobat why https://api.anthropic.com
  2. Эти проверки Kilobat бесплатны. ИИ-агенты запускают их через MCP с помощью diagnose_connection и diagnose_network. См. Почему не подключается один сайт или API.

Вопросы

Использует ли Claude Code хранилище сертификатов macOS?

По умолчанию он доверяет встроенным центрам Mozilla и хранилищу операционной системы. Нативные установки всегда читают системное хранилище.

Можно ли отключить проверку?

В документации сказано не задавать NODE_TLS_REJECT_UNAUTHORIZED=0.

Источники

Проверено 29 октября 2026 года.