Connexions coupées et timeouts des outils agentiques
Si ton outil ferme la connexion avant que la réponse ne sorte, le modèle a quand même traité ton prompt. Ces requêtes sont marquées « Coupée par ton app » dans ton historique d’utilisation.
Pourquoi est-ce facturé ?
- Modèles à la requête : le fournisseur facture en entier dès que le prompt est traité → coût fixe.
- Modèles au token : uniquement ce que le fournisseur facture réellement ; la différence est remboursée automatiquement.
- Coupure due à un incident côté Geraikita : remboursement intégral automatique.
Réglages recommandés
Claude Code
API_TIMEOUT_MS=600000La valeur par défaut est de 10 minutes — ne la baisse pas. À mettre dans env de ~/.claude/settings.json ou en variable d’environnement.
OpenCode
opencode.json → provider.<id>.options.timeout: 600000En millisecondes. Si tu définis aussi headerTimeout / chunkTimeout, mets au moins 300000.
Kilo Code · Roo Code · Cline
Réglages du fournisseur → timeout de requête API ≥ 300 s ; désactive la relance automatique. Le nom de l’option peut varier selon la version.
SDK OpenAI / Anthropic
timeout=600, max_retries=1, stream=Truetimeout en secondes (Python) ou millisecondes (Node.js : 600 * 1000). Utilise le streaming pour voir vite le premier token.
Python requests / httpx
requests: timeout=(10, 600)httpx: httpx.Timeout(600, connect=10)Premier nombre = timeout de connexion, second = timeout de lecture. Lecture d’au moins 300 secondes.
Script / proxy maison
stream: trueUser-Agent: "nama-alatmu/1.0"Timeout de lecture ≥ 300 s, active le streaming et mets le nom de ton outil dans le User-Agent pour que nous puissions aider à vérifier.
Vérifie tes propres chiffres
Ouvre le Dashboard → Utilisation récente → filtre « Coupées par ton app ». Touche une ligne pour voir le déroulé et la raison du coût.
Guide complet par outil (streaming, relances, taille du contexte, exemples de code) : Réglages des outils agentiques.