Connessioni interrotte e timeout degli strumenti agentici

Se il tuo strumento chiude la connessione prima che esca la risposta, il modello ha comunque elaborato il tuo prompt. Queste richieste appaiono come «Interrotta dalla tua app» nella cronologia di utilizzo.

Perché viene addebitato?

Modelli a richiesta: il fornitore addebita l’intero importo appena il prompt viene elaborato → costo fisso.
Modelli a token: solo quanto il fornitore addebita davvero; la differenza viene rimborsata automaticamente.
Interruzione per un problema da parte di Geraikita: rimborso completo automatico.

Impostazioni consigliate

Claude Code

API_TIMEOUT_MS=600000

Il valore predefinito è 10 minuti — non abbassarlo. Impostalo in env di ~/.claude/settings.json o come variabile d’ambiente.

OpenCode

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

In millisecondi. Se imposti anche headerTimeout / chunkTimeout, usa almeno 300000.

Kilo Code · Roo Code · Cline

Impostazioni del provider → timeout della richiesta API ≥ 300 s; disattiva il riprova automatico. Il nome dell’opzione può cambiare tra le versioni.

SDK OpenAI / Anthropic

timeout=600, max_retries=1, stream=True

timeout in secondi (Python) o millisecondi (Node.js: 600 * 1000). Usa lo streaming per vedere subito il primo token.

Python requests / httpx

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

Primo numero = timeout di connessione, secondo = timeout di lettura. Lettura di almeno 300 secondi.

Script / proxy personale

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

Timeout di lettura ≥ 300 s, attiva lo streaming e metti il nome del tuo strumento nello User-Agent così possiamo aiutarti a verificare.

Controlla i tuoi numeri

Apri la Dashboard → Utilizzo recente → filtro «Interrotte dalla tua app». Tocca una riga per vedere la sequenza e il motivo del costo.

Guida completa per strumento (streaming, tentativi, dimensione del contesto, esempi di codice): Impostazioni degli strumenti agentici.