Conexões interrompidas e timeouts de ferramentas agênticas
Se sua ferramenta fechar a conexão antes de a resposta sair, o modelo já processou seu prompt. Essas solicitações aparecem como “Interrompida pelo seu app” no histórico de uso.
Por que ainda é cobrado?
- Modelos por solicitação: o fornecedor cobra integralmente assim que o prompt é processado → custo fixo.
- Modelos por token: só o que o fornecedor realmente cobra; a diferença é reembolsada automaticamente.
- Queda por falha do lado da Geraikita: reembolso integral automático.
Configurações recomendadas
Claude Code
API_TIMEOUT_MS=600000O padrão é 10 minutos — não diminua. Defina em env no ~/.claude/settings.json ou como variável de ambiente.
OpenCode
opencode.json → provider.<id>.options.timeout: 600000Em milissegundos. Se também definir headerTimeout / chunkTimeout, use no mínimo 300000.
Kilo Code · Roo Code · Cline
Configurações do provedor → timeout da solicitação de API ≥ 300 s; desative a repetição automática. O nome da opção pode mudar entre versões.
SDK OpenAI / Anthropic
timeout=600, max_retries=1, stream=Truetimeout em segundos (Python) ou milissegundos (Node.js: 600 * 1000). Use streaming para ver logo o primeiro token.
Python requests / httpx
requests: timeout=(10, 600)httpx: httpx.Timeout(600, connect=10)Primeiro número = timeout de conexão, segundo = timeout de leitura. Leitura de pelo menos 300 segundos.
Script / proxy próprio
stream: trueUser-Agent: "nama-alatmu/1.0"Timeout de leitura ≥ 300 s, ative streaming e coloque o nome da sua ferramenta no User-Agent para podermos ajudar a verificar.
Confira seus próprios números
Abra o Dashboard → Uso recente → filtro “Interrompidas pelo seu app”. Toque numa linha para ver a sequência e o motivo da cobrança.
Guia completo por ferramenta (streaming, novas tentativas, tamanho do contexto, exemplos de código): Configurações de ferramentas agênticas.