Guide de stabilité réseau pour Claude Code

Claude Code fonctionne sur une connexion résidentielle, un réseau d'entreprise, un proxy maîtrisé ou une passerelle d'entreprise conforme. Pour un compte ordinaire, un réseau stable sur la durée et dont le titulaire est clairement identifié vaut généralement mieux qu'un VPN public, un pool de proxys à utilisation partagée ou des IP de sortie VPS qui changent souvent. Avant la configuration, vérifiez le type et le score de risque de votre IP actuelle avec une vérification de pureté.

Le changement d'IP dû à une reconnexion naturelle chez le FAI n'a généralement rien à voir avec un compte qui saute d'un pays à l'autre. Ce qui compte davantage, ce sont les allers-retours fréquents entre plusieurs pays, ASN et appareils en peu de temps : ils augmentent les chances de déclencher un examen de sécurité du compte.

QUIC (UDP 443) est plus sujet à la perte de paquets, aux expirations de délai ou à un transfert inattendu derrière certains proxys ou pare-feu d'entreprise. En cas de déconnexions intermittentes, essayez de désactiver QUIC ou de forcer le trafic lié à Claude en TCP uniquement, puis refaites le test.

"network": "tcp"
# ou désactivez QUIC au niveau du client

Les clients n'ont pas tous les mêmes caractéristiques de négociation TLS. Si une chaîne de proxys modifie le comportement TLS, injecte des certificats ou présente une empreinte client trop inhabituelle, cela peut provoquer des échecs de connexion ou des vérifications supplémentaires. Privilégiez des clients éprouvés et des configurations TLS standard.

"tls": {
  "fingerprint": "chrome"
}

Le résolveur DNS, la sortie HTTP et la sortie du navigateur doivent idéalement passer par le même chemin réseau. Si le DNS est résolu localement alors que le HTTP passe par un proxy, la région de résolution et la région d'accès peuvent ne pas correspondre. Un DoH/DoT de confiance peut être utilisé, mais l'essentiel est de vérifier que vos règles de routage couvrent réellement le trafic DNS.

"dns": {
  "servers": ["https://1.1.1.1/dns-query"]
}

Si un proxy ou une règle de routage ne couvre que l'IPv4, le trafic IPv6 peut emprunter un autre chemin, si bien que HTTP / DNS / WebRTC voient une sortie incohérente. Il n'est pas toujours nécessaire de désactiver l'IPv6, mais mieux vaut d'abord vérifier la cohérence de la double pile. Voir les risques de la double pile IPv6 pour plus de détails.

ipv6 = false
# ou, côté proxy, domainStrategy: "UseIPv4"

La documentation officielle indique que l'accès réseau de Claude Code comprend au moins api.anthropic.com, claude.ai, statsig.anthropic.com et sentry.io. Il est recommandé de créer des règles de routage dédiées pour ces domaines afin de faciliter le diagnostic et l'audit. Voir les règles de routage pour Claude Code.

Claude Web, la connexion, la documentation et les ressources statiques peuvent utiliser différents CDN ou services tiers selon les versions. Ne codez pas en dur un seul domaine principal : prenez les domaines officiellement requis comme base, puis ajoutez les domaines de ressources statiques réellement consultés, relevés par une capture de paquets locale ou dans les journaux.

Des cycles fréquents de déconnexion et reconnexion ajoutent de la latence et rendent la chaîne de proxys plus difficile à diagnostiquer. Les clients proxy peuvent activer un keep-alive TCP raisonnable ; activer ou non le multiplexage des connexions (mux) dépend de la qualité de la ligne : en cas de blocages du multiplexage ou de bridage par connexion, désactivez-le et comparez.

N'encapsulez pas les appels à Claude Code dans un grand nombre de workers concurrents. Une concurrence excessive peut déclencher des limitations de fréquence (rate limits), des files d'attente de connexion ou un bridage par la passerelle d'entreprise ; le seuil réel dépend de l'offre de votre compte, de la politique de votre organisation et des réponses de l'API.

Privilégiez une sortie avec peu de perte de paquets, une faible gigue et un chemin stable vers l'API Anthropic, plutôt que de regarder seulement la distance géographique. Pour en juger, combinez un test de fuite et la latence réelle des requêtes Claude Code.