Claude Code prend en charge les configurations de proxy HTTP/HTTPS standard via les variables d’environnement. Cela vous permet de router tout le trafic Claude Code à travers les serveurs proxy de votre organisation à des fins de sécurité, de conformité et de surveillance.

Configuration de base du proxy

Variables d’environnement

Claude Code respecte les variables d’environnement proxy standard :

# Proxy HTTPS (recommandé)
export HTTPS_PROXY=https://proxy.example.com:8080

# Proxy HTTP (si HTTPS n'est pas disponible)
export HTTP_PROXY=http://proxy.example.com:8080

Claude Code ne prend actuellement pas en charge la variable d’environnement NO_PROXY. Tout le trafic sera routé à travers le proxy configuré.

Claude Code ne prend pas en charge les proxies SOCKS.

Authentification

Authentification de base

Si votre proxy nécessite une authentification de base, incluez les identifiants dans l’URL du proxy :

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

Évitez de coder en dur les mots de passe dans les scripts. Utilisez plutôt des variables d’environnement ou un stockage sécurisé des identifiants.

Pour les proxies nécessitant une authentification avancée (NTLM, Kerberos, etc.), envisagez d’utiliser un service LLM Gateway qui prend en charge votre méthode d’authentification.

Problèmes de certificat SSL

Si votre proxy utilise des certificats SSL personnalisés, vous pourriez rencontrer des erreurs de certificat.

Assurez-vous de définir le chemin correct du bundle de certificats :

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

Exigences d’accès réseau

Claude Code nécessite l’accès aux URL suivantes :

  • api.anthropic.com - Points de terminaison de l’API Claude
  • statsig.anthropic.com - Télémétrie et métriques
  • sentry.io - Rapport d’erreurs

Assurez-vous que ces URL sont autorisées dans votre configuration de proxy et vos règles de pare-feu. Ceci est particulièrement important lors de l’utilisation de Claude Code dans des environnements réseau conteneurisés ou restreints.

Ressources supplémentaires