“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.
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.
Sintomas
- O Claude Code exibe
Request timed outdepois 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
Teste o host da API no mesmo shell.
curl -I https://api.anthropic.comVerifique sua versão.
claude --versionMostre as variáveis de proxy.
env | grep -i proxyExecute as verificações de configuração dentro do Claude Code.
/doctor
Como corrigir
Tente a solicitação de novo.
Em uma rede ou um proxy lento, aumente o tempo limite.
export API_TIMEOUT_MS=900000Atualize o Claude Code se você definiu o tempo limite como 0.
Se os tempos limite forem frequentes, teste outra rede e a VPN.
Com o Kilobat
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.comEssas verificações do Kilobat são gratuitas. Agentes de IA as executam pelo MCP com
diagnose_connectionediagnose_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.