Généré le 14/10/2026 10:01

🔍 Diagnostic Technique Approfondi : Blocages et Dysfonctionnements de Claude Code

Date : Jeudi 8 octobre 2026
Auteur : Antigravity
Destinataire : Raphaël
Contexte : Analyse exhaustive des récents blocages, échecs de routage et lenteurs constatés lors de l'utilisation de Claude Code en direct, en mode headless, ou via les ponts de secours (Jarvis Live Voice & Remoat).


🎯 Synthèse Exécutive

L'analyse des incidents récents (septembre - octobre 2026), des configurations locales et des journaux d'erreurs démontre que les dysfonctionnements de Claude Code ne proviennent pas d'une cause unique, mais de trois facteurs techniques distincts qui se sont cumulés :

  1. Un conflit de proxy réseau critique (UnsupportedProxyProtocol) : L'injection globale de variables de proxy SOCKS5 (socks5h://127.0.0.1:1081), conçues pour le binaire Python d'Antigravity, fait planter le moteur Node.js de Claude Code, incapable de traiter ce protocole et incapable de joindre les serveurs locaux ou distants.
  2. Des choix et configurations de modèles inadaptés :
    - Modèle Fable 5 par défaut : Tentative historique d'utiliser un modèle headless exigeant des crédits séparés inexistants (11 échecs consécutifs le 06/09/2026).
    - Modèles de secours OpenRouter "free" (Nemotron, Ling, Gemma) : Épuisement instantané des quotas journaliers (50 req/j) et incapacité à gérer 30 schémas d'outils.
    - Modèle Gemini 3.5 Flash-Lite via proxy : Saturation du quota de tokens d'entrée (250 000 tokens/min dépassés en 3 tours de prompt en raison du volume de contexte injecté par Claude Code).
  3. Des frictions d'exécution système (Windows & I/O) : Blocage de 3 secondes sur stdin non redirigé, pipes orphelins sous Windows maintenant les sous-processus gelés, et écrasement silencieux du choix de cerveau lors des auto-reconnexions WebSocket de Jarvis.

1. Le Facteur Réseau & Configuration de Proxy (Bloqueur #1)

A. L'erreur UnsupportedProxyProtocol

B. Le piège du rebond localhost (Boucle de Proxy Local)


2. Le Facteur Modèle Choisi & Quotas (Bloqueur #2)

A. L'incident historique "Fable 5" (06/09/2026)

B. L'échec des modèles gratuits OpenRouter via Proxy (06-07/10/2026)

Les tests d'intégration d'un "filet de secours gratuit" (Nemotron, Ling-3.1, Gemma 4, Poolside) branché sous l'enveloppe Claude Code ont montré deux limites rédhibitoires :
1. Plafonds de requêtes journaliers : OpenRouter applique une limite stricte de 50 requêtes/jour sur le niveau gratuit. Le proxy s'est retrouvé bloqué en erreur 429 Too Many Requests au bout de quelques tests.
2. Incompatibilité avec le format agentique complexe : Claude Code injecte une trentaine d'outils (MCP, système de fichiers, exécution shell) et des prompts système volumineux. Les petits modèles gratuits génèrent des boucles d'appels d'outils mal formatés ou subissent des coupures d'inférence en amont (upstream_provider_shared_pool rate-limited).

C. La saturation éclair du Free Tier Gemini (07/10/2026)


3. Autres Facteurs Techniques & Environnement Windows

Facteur Technique Symptôme Concret Cause Racine Solution Validée
Blocage STDIN (3s) Avertissement "Warning: no stdin data received in 3s..." dans les logs spawn() Node.js crée un tube stdin: 'pipe' par défaut. Claude Code attend 3s de données potentielles. Configurer stdin: 'ignore' sous Node.js ou stdin=subprocess.DEVNULL sous Python.
Pipes Windows Orphelins Session suspendue indéfiniment (9+ minutes sans réponse) Les sous-processus lancés par --dangerously-skip-permissions gardent les pipes stdout ouverts même si le process principal termine. Résoudre sur l'événement exit plutôt que d'attendre la fermeture totale des flux (close).
Perte de Cerveau au Reconnect Claude Code saute et Jarvis repasse sur Antigravity sans avertir Lors d'une micro-coupure réseau mobile, le handshake WebSocket réinitialisait brain à sa valeur par défaut agy. Restauration de brain depuis session_record et persistance du choix utilisateur dans server.py.
Relais Telegram Manqué Réponses complexes de Claude Code invisibles sur Telegram Lors d'enchaînements d'outils volumineux, le hook de capture automatique omettait le message final. Application de la Règle #9 du CLAUDE.md : envoi direct de secours via l'API Telegram (curl).

4. Recommandations et Plan d'Action

  1. Purge stricte des variables de proxy pour Claude :
    Veiller à ce qu'aucun appel à claude.exe n'hérite de HTTP_PROXY, HTTPS_PROXY ou ALL_PROXY contenant socks5h. Si un proxy local HTTP est ciblé, définir impérativement NO_PROXY=localhost,127.0.0.1.
  2. Stabilisation sur Claude Sonnet 5 officiel :
    Pour les missions critiques touchant aux systèmes réels (Shopify, Meta, Product Tracker), conserver le moteur officiel claude-sonnet-5 avec un effort medium. Les modèles alternatifs gratuits ne possèdent ni la fidélité de schéma d'outil ni les quotas de tokens nécessaires pour faire tourner l'enveloppe Claude Code.
  3. Cadrage du moteur de secours :
    Si un 3ᵉ moteur de secours est activé en cas de quota épuisé, le basculer sur une clé Gemini payante (Pay-as-you-go, pour lever le verrou des 250k tokens/min) ou sur un modèle Ollama local sans restriction de débit, et restreindre ses prérogatives aux tâches d'analyse textuelle sans manipulation critique de bases de données.