Verbroken verbindingen & timeouts van agentic tools

Als je tool de verbinding sluit voordat het antwoord komt, heeft het model je prompt toch al verwerkt. Zulke verzoeken staan als „Verbroken door je app” in je gebruiksgeschiedenis.

Waarom wordt het toch afgerekend?

Modellen per verzoek: de aanbieder rekent volledig af zodra de prompt is verwerkt → vaste kosten.
Modellen per token: alleen wat de aanbieder echt rekent; het verschil wordt automatisch terugbetaald.
Verbroken door een storing aan de kant van Geraikita: automatisch volledig terugbetaald.

Aanbevolen instellingen

Claude Code

API_TIMEOUT_MS=600000

Standaard is 10 minuten — niet verlagen. Zet het in env van ~/.claude/settings.json of als omgevingsvariabele.

OpenCode

opencode.json → provider.<id>.options.timeout: 600000

In milliseconden. Stel je ook headerTimeout / chunkTimeout in, gebruik dan minstens 300000.

Kilo Code · Roo Code · Cline

Providerinstellingen → API-request-timeout ≥ 300 s; zet automatisch opnieuw proberen uit. De naam van de optie kan per versie verschillen.

OpenAI- / Anthropic-SDK

timeout=600, max_retries=1, stream=True

timeout in seconden (Python) of milliseconden (Node.js: 600 * 1000). Gebruik streaming zodat het eerste token snel zichtbaar is.

Python requests / httpx

requests: timeout=(10, 600)httpx: httpx.Timeout(600, connect=10)

Eerste getal = verbindingstimeout, tweede = leestimeout. Leestimeout minstens 300 seconden.

Eigen script / proxy

stream: trueUser-Agent: "nama-alatmu/1.0"

Leestimeout ≥ 300 s, zet streaming aan en vul de User-Agent met de naam van je tool zodat we kunnen helpen controleren.

Controleer je eigen cijfers

Open het Dashboard → Recent gebruik → filter „Verbroken door je app”. Tik op een rij voor het verloop en de reden van de kosten.

Volledige gids per tool (streaming, retries, contextgrootte, codevoorbeelden): Instellingen agentic tools.