Claude Code admite varias configuraciones de red y seguridad empresarial a través de variables de entorno. Esto incluye enrutar el tráfico a través de servidores proxy corporativos, confiar en Autoridades de Certificación (CA) personalizadas y autenticarse con certificados de Seguridad de la Capa de Transporte mutua (mTLS) para mayor seguridad.
Todas las variables de entorno que se muestran en esta página también se pueden configurar en settings.json.
Configuración de proxy
Variables de entorno
Claude Code respeta las variables de entorno proxy estándar:
# Proxy HTTPS (recomendado)
export HTTPS_PROXY=https://proxy.example.com:8080
# Proxy HTTP (si HTTPS no está disponible)
export HTTP_PROXY=http://proxy.example.com:8080
# Omitir proxy para solicitudes específicas - formato separado por espacios
export NO_PROXY="localhost 192.168.1.1 example.com .example.com"
# Omitir proxy para solicitudes específicas - formato separado por comas
export NO_PROXY="localhost,192.168.1.1,example.com,.example.com"
# Omitir proxy para todas las solicitudes
export NO_PROXY="*"
Claude Code no admite proxies SOCKS.
Autenticación básica
Si su proxy requiere autenticación básica, incluya credenciales en la URL del proxy:
export HTTPS_PROXY=http://username:password@proxy.example.com:8080
Evite codificar contraseñas en scripts. Utilice variables de entorno o almacenamiento seguro de credenciales en su lugar.
Para proxies que requieren autenticación avanzada (NTLM, Kerberos, etc.), considere usar un servicio LLM Gateway que admita su método de autenticación.
Certificados CA personalizados
Si su entorno empresarial utiliza CA personalizadas para conexiones HTTPS (ya sea a través de un proxy o acceso directo a API), configure Claude Code para confiar en ellas:
export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem
Autenticación mTLS
Para entornos empresariales que requieren autenticación de certificado de cliente:
# Certificado de cliente para autenticación
export CLAUDE_CODE_CLIENT_CERT=/path/to/client-cert.pem
# Clave privada del cliente
export CLAUDE_CODE_CLIENT_KEY=/path/to/client-key.pem
# Opcional: Frase de contraseña para clave privada cifrada
export CLAUDE_CODE_CLIENT_KEY_PASSPHRASE="your-passphrase"
Requisitos de acceso a la red
Claude Code requiere acceso a las siguientes URL:
api.anthropic.com - Puntos finales de la API de Claude
claude.ai - Salvaguardas de WebFetch
statsig.anthropic.com - Telemetría y métricas
sentry.io - Informe de errores
Asegúrese de que estas URL estén en la lista blanca en su configuración de proxy y reglas de firewall. Esto es especialmente importante cuando se utiliza Claude Code en entornos de red restringidos o en contenedores.
Recursos adicionales