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 в контейнеризованных или ограниченных сетевых средах.
Дополнительные ресурсы