Claude Code поддерживает стандартные конфигурации HTTP/HTTPS прокси через переменные окружения. Это позволяет направлять весь трафик Claude Code через прокси-серверы вашей организации для обеспечения безопасности, соответствия требованиям и мониторинга.

​
Базовая настройка прокси

​
Переменные окружения

Claude Code учитывает стандартные переменные окружения прокси:

# HTTPS прокси (рекомендуется)
export HTTPS_PROXY=https://proxy.example.com:8080

# HTTP прокси (если HTTPS недоступен)
export HTTP_PROXY=http://proxy.example.com:8080

Claude Code в настоящее время не поддерживает переменную окружения NO_PROXY. Весь трафик будет направляться через настроенный прокси.

Claude Code не поддерживает SOCKS прокси.

​
Аутентификация

​
Базовая аутентификация

Если ваш прокси требует базовую аутентификацию, включите учетные данные в URL прокси:

export HTTPS_PROXY=http://username:password@proxy.example.com:8080

Избегайте жесткого кодирования паролей в скриптах. Вместо этого используйте переменные окружения или безопасное хранение учетных данных.

Для прокси, требующих расширенную аутентификацию (NTLM, Kerberos и т.д.), рассмотрите использование сервиса LLM Gateway, который поддерживает ваш метод аутентификации.

​
Проблемы с SSL сертификатами

Если ваш прокси использует пользовательские SSL сертификаты, вы можете столкнуться с ошибками сертификатов.

Убедитесь, что вы установили правильный путь к пакету сертификатов:

export SSL_CERT_FILE=/path/to/certificate-bundle.crt
export NODE_EXTRA_CA_CERTS=/path/to/certificate-bundle.crt

​
Требования к сетевому доступу

Claude Code требует доступа к следующим URL:

  • api.anthropic.com - конечные точки Claude API
  • statsig.anthropic.com - телеметрия и метрики
  • sentry.io - отчеты об ошибках

Убедитесь, что эти URL включены в белый список в конфигурации вашего прокси и правилах брандмауэра. Это особенно важно при использовании Claude Code в контейнеризованных или ограниченных сетевых средах.

​
Дополнительные ресурсы