Claude Code soporta configuraciones estándar de proxy HTTP/HTTPS a través de variables de entorno. Esto te permite enrutar todo el tráfico de Claude Code a través de los servidores proxy de tu organización para propósitos de seguridad, cumplimiento y monitoreo.

Configuración básica de proxy

Variables de entorno

Claude Code respeta las variables de entorno estándar de proxy:

# 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

Claude Code actualmente no soporta la variable de entorno NO_PROXY. Todo el tráfico será enrutado a través del proxy configurado.

Claude Code no soporta proxies SOCKS.

Autenticación

Autenticación básica

Si tu proxy requiere autenticación básica, incluye las credenciales en la URL del proxy:

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

Evita codificar contraseñas directamente en scripts. Usa variables de entorno o almacenamiento seguro de credenciales en su lugar.

Para proxies que requieren autenticación avanzada (NTLM, Kerberos, etc.), considera usar un servicio LLM Gateway que soporte tu método de autenticación.

Problemas de certificados SSL

Si tu proxy usa certificados SSL personalizados, puedes encontrar errores de certificado.

Asegúrate de establecer la ruta correcta del paquete de certificados:

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

Requisitos de acceso a la red

Claude Code requiere acceso a las siguientes URLs:

  • api.anthropic.com - Endpoints de la API de Claude
  • statsig.anthropic.com - Telemetría y métricas
  • sentry.io - Reporte de errores

Asegúrate de que estas URLs estén en la lista de permitidas en tu configuración de proxy y reglas de firewall. Esto es especialmente importante cuando uses Claude Code en entornos de red contenedorizados o restringidos.

Recursos adicionales