---
title: "“Request timed out” no Claude Code do Mac · Guias do Kilobat"
url: "https://kilobat.app/pt/guides/claude-code-request-timed-out"
description: "O Claude Code no seu Mac exibe Request timed out. A API não respondeu antes do limite de tempo. Verifique a rede, um proxy e o ajuste de tempo limite."
---

# “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 agente**Copia 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](https://kilobat.app/pt/guides/recipes/why-cant-it-connect).

## 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

- [Claude Code: referência de erros](https://code.claude.com/docs/en/errors.md)
- [Claude Code: configuração de rede corporativa](https://code.claude.com/docs/en/network-config.md)

Verificado em 29 de outubro de 2026.

## Guias relacionados

- [“Unable to connect to API” no Claude Code do Mac](https://kilobat.app/pt/guides/claude-code-unable-to-connect-to-api): O Claude Code exibe Unable to connect to API quando uma solicitação não chega a api.anthropic.com.
- [ERR_CONNECTION_TIMED_OUT no Chrome no Mac](https://kilobat.app/pt/guides/err-connection-timed-out): O Chromium descreve esse erro como “O tempo limite de uma tentativa de conexão foi esgotado”. O Chrome encontrou o endereço, mas o servidor não respondeu a tempo.
- [Bufferbloat: chamadas atrasam quando a rede está ocupada](https://kilobat.app/pt/guides/bufferbloat-mac): Bufferbloat é a latência adicionada por dispositivos de rede quando retêm dados demais em seus buffers.
- [Teste a perda de pacotes no Mac com ping](https://kilobat.app/pt/guides/packet-loss-mac): A perda de pacotes causa falhas nas chamadas e interrupções no carregamento de páginas.
