“Request timed out” no Claude Code do Mac

O Claude Code exibe Request timed out quando a API não responde antes do limite de tempo da conexão. O tempo limite padrão da solicitação é de 10 minutos.

Resolva com seu agenteCopia um prompt para o Claude Code, o Codex ou qualquer agente que possa usar o Terminal.

Meu Mac está com este problema: “Request timed out” no Claude Code do Mac. Leia https://kilobat.app/pt/guides/claude-code-request-timed-out.md e resolva comigo. Instale a CLI do Kilobat se ela estiver faltando: brew install seifip/kilobat/kilobat. Execute você mesmo as verificações do Terminal e do kilobat do guia e me diga o que encontrar. Liste os passos que só eu posso fazer. Pergunte antes de alterar qualquer ajuste.

Vale para: o Claude Code em um terminal em todas as versões atuais do macOS.Verificado: 29 de outubro de 2026

Sintomas

  • O Claude Code exibe Request timed out depois de uma longa espera.
  • Acontece em redes lentas, por meio de proxies ou em solicitações grandes.
  • Algumas novas tentativas funcionam.

Possíveis causas

  • Uma rede ou um proxy lento. A documentação diz que uma rede ou um proxy lento pode causar isso.
  • Uma conexão travada. Uma VPN ou um firewall pode reter pacotes, e aí nenhuma resposta chega.
  • Uma solicitação grande. Uma solicitação sem streaming mantém um limite de 300 segundos em uma sessão local.
  • Um tempo limite igual a zero em uma versão antiga. Em versões anteriores à v2.1.305, definir API_TIMEOUT_MS como 0 pode fazer todas as solicitações falharem.

Como verificar

  1. Teste o host da API no mesmo shell.

    curl -I https://api.anthropic.com
  2. Verifique sua versão.

    claude --version
  3. Mostre as variáveis de proxy.

    env | grep -i proxy
  4. Execute as verificações de configuração dentro do Claude Code.

    /doctor

Como corrigir

  1. Tente a solicitação de novo.

  2. Em uma rede ou um proxy lento, aumente o tempo limite.

    export API_TIMEOUT_MS=900000
  3. Atualize o Claude Code se você definiu o tempo limite como 0.

  4. Se os tempos limite forem frequentes, teste outra rede e a VPN.

Com o Kilobat

  1. O diagnóstico de conexão do Kilobat testa o host da API camada por camada. Ele aponta a camada que falha ou fica lenta.

    kilobat why https://api.anthropic.com
  2. Essas verificações do Kilobat são gratuitas. Agentes de IA as executam pelo MCP com diagnose_connection e diagnose_network. Consulte Descubra por que um site ou API não conecta.

Perguntas

Qual é o tempo limite padrão?

A documentação do Claude Code indica 10 minutos para o tempo limite da solicitação.

API_TIMEOUT_MS=0 desativa todos os limites de tempo?

Não. O limite do primeiro byte e o tempo limite de inatividade do corpo continuam ativos.

Fontes

Verificado em 29 de outubro de 2026.