Claude Code поддерживает различные корпоративные сетевые конфигурации и конфигурации безопасности через переменные окружения. Это включает маршрутизацию трафика через корпоративные прокси-серверы, доверие к пользовательским центрам сертификации (CA) и аутентификацию с помощью взаимных сертификатов Transport Layer Security (mTLS) для повышенной безопасности.
Все переменные окружения, показанные на этой странице, также могут быть настроены в settings.json.

Конфигурация прокси

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

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

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

# Обход прокси для конкретных запросов - формат с разделением пробелами
export NO_PROXY="localhost 192.168.1.1 example.com .example.com"
# Обход прокси для конкретных запросов - формат с разделением запятыми
export NO_PROXY="localhost,192.168.1.1,example.com,.example.com"
# Обход прокси для всех запросов
export NO_PROXY="*"
Claude Code не поддерживает SOCKS прокси.

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

Если ваш прокси требует базовую аутентификацию, включите учетные данные в URL прокси:
export HTTPS_PROXY=http://username:password@proxy.example.com:8080
Избегайте жесткого кодирования паролей в скриптах. Используйте переменные окружения или безопасное хранение учетных данных вместо этого.
Для прокси, требующих расширенную аутентификацию (NTLM, Kerberos и т.д.), рассмотрите использование сервиса LLM Gateway, который поддерживает ваш метод аутентификации.

Пользовательские CA сертификаты

Если ваша корпоративная среда использует пользовательские CA для HTTPS соединений (будь то через прокси или прямой доступ к API), настройте Claude Code для доверия к ним:
export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem

mTLS аутентификация

Для корпоративных сред, требующих аутентификацию клиентского сертификата:
# Клиентский сертификат для аутентификации
export CLAUDE_CODE_CLIENT_CERT=/path/to/client-cert.pem

# Клиентский приватный ключ
export CLAUDE_CODE_CLIENT_KEY=/path/to/client-key.pem

# Опционально: Парольная фраза для зашифрованного приватного ключа
export CLAUDE_CODE_CLIENT_KEY_PASSPHRASE="your-passphrase"

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

Claude Code требует доступ к следующим URL:
  • api.anthropic.com - конечные точки Claude API
  • claude.ai - защитные меры WebFetch
  • statsig.anthropic.com - телеметрия и метрики
  • sentry.io - отчеты об ошибках
Убедитесь, что эти URL включены в белый список в конфигурации вашего прокси и правилах брандмауэра. Это особенно важно при использовании Claude Code в контейнеризованных или ограниченных сетевых средах.

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