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=600000

La 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: 600000

En 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=True

timeout 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.