Conexiones cortadas y timeouts de herramientas agénticas
Si tu herramienta cierra la conexión antes de que salga la respuesta, el modelo ya procesó tu prompt. Estas solicitudes aparecen como «Cortada por tu app» en tu historial de uso.
¿Por qué se cobra igual?
- Modelos por solicitud: el proveedor cobra completo en cuanto procesa el prompt → coste fijo.
- Modelos por token: solo lo que el proveedor factura realmente; la diferencia se reembolsa automáticamente.
- Cortes por fallos del lado de Geraikita: reembolso completo automático.
Ajustes recomendados
Claude Code
API_TIMEOUT_MS=600000El valor por defecto es 10 minutos — no lo bajes. Ponlo en env de ~/.claude/settings.json o como variable de entorno.
OpenCode
opencode.json → provider.<id>.options.timeout: 600000En milisegundos. Si también defines headerTimeout / chunkTimeout, usa al menos 300000.
Kilo Code · Roo Code · Cline
Ajustes del proveedor → timeout de la solicitud API ≥ 300 s; desactiva el reintento automático. El nombre de la opción puede variar según la versión.
SDK de OpenAI / Anthropic
timeout=600, max_retries=1, stream=Truetimeout en segundos (Python) o milisegundos (Node.js: 600 * 1000). Usa streaming para ver pronto el primer token.
Python requests / httpx
requests: timeout=(10, 600)httpx: httpx.Timeout(600, connect=10)Primer número = timeout de conexión, segundo = timeout de lectura. Lectura de al menos 300 segundos.
Script / proxy propio
stream: trueUser-Agent: "nama-alatmu/1.0"Timeout de lectura ≥ 300 s, activa streaming y pon el nombre de tu herramienta en el User-Agent para que podamos ayudarte a revisar.
Revisa tus propias cifras
Abre el Dashboard → Uso reciente → filtro «Cortadas por tu app». Toca una fila para ver la secuencia y el motivo del cobro.
Guía completa por herramienta (streaming, reintentos, tamaño de contexto, ejemplos de código): Configuración de herramientas agénticas.