Source: https://aiprimetech.io/pt/claude-code/errors/connection-lost/

[Início](/pt/) › [Claude Code](/pt/claude-code/) › [Erros](/pt/claude-code/errors/) › Erros de conexão

[Visão geral](/pt/claude-code/)[Instalação](/pt/claude-code/install/)[referência da CLI](/pt/claude-code/cli/)[Preços e limites](/pt/claude-code/pricing/)[Agent SDK](/pt/claude-code/sdk/)[Skills e plugins](/pt/claude-code/skills/)[GitHub](/pt/claude-code/github/)[Web, desktop e IDE](/pt/claude-code/web-and-desktop/)[Modelos](/pt/claude-code/models/)[Erros](/pt/claude-code/errors/)[Código aberto?](/pt/claude-code/open-source/)[Tutorial](/pt/claude-code/tutorial/)[Para estudantes](/pt/claude-code/for-students/)[Automação de QA](/pt/claude-code/qa-automation/)[vs Cursor](/pt/claude-code/vs-cursor/)[vs Codex e OpenCode](/pt/claude-code/vs-codex/)[Subagentes](/pt/claude-code/subagents/)[Hooks](/pt/claude-code/hooks/)[MCP](/pt/claude-code/mcp/)[Ecossistema](/pt/claude-code/ecosystem/)[VS Code](/pt/claude-code/vscode/)[OpenRouter](/pt/claude-code/openrouter/)[Limites de requisições](/pt/claude-code/rate-limits/)[Guia em chinês](/claude-code/zh/)

Última atualização: 11 de outubro de 2026

# Erros de conexão no Claude Code: ECONNRESET, conexão perdida durante a resposta, "Aguardando resposta da API", "Não foi possível conectar à API", erros de certificado SSL

Esses erros significam que a requisição nunca foi concluída: a conexão TCP foi reiniciada, o handshake TLS falhou, um proxy recusou o host ou o fluxo simplesmente parou de enviar dados. O Claude Code tenta novamente por conta própria; é isso que indicam as linhas *Tentando novamente em Ns · tentativa x/y* e *Aguardando resposta da API*. O rastreador de problemas mostra dois grupos muito diferentes, e é importante saber em qual você está: problemas de rede local que uma configuração de proxy ou CA resolve, e incidentes na Anthropic em que a única solução é esperar.

## TLDR
- Retrying in 0s · attempt 1/10 / Waiting for API response · will retry in … — nova tentativa automática em andamento; a espera aumenta a cada tentativa.
- Connection dropped (ECONNRESET) / Connection lost mid-response — a conexão foi interrompida; se uma chamada direta com curl funciona e não há proxy, o problema geralmente está no provedor.
- Unable to connect to API / fetch failed / ConnectionRefused — nada chegou ao endpoint: DNS, VPN, proxy, firewall.
- unable to get local issuer certificate / CERT_HAS_EXPIRED — um proxy que inspeciona TLS ou um repositório de CAs desatualizado; aponte NODE_EXTRA_CA_CERTS para o certificado raiz corporativo.

## As mensagens 

```
API Error: Connection dropped (ECONNRESET)
API Error: Connection lost mid-response
API Error: fetch failed
Unable to connect to API (ConnectionRefused)
Retrying in 0s · attempt 1/10
Waiting for API response · will retry in 2m 35s · check your network
API Error: Socket is closed
SSL certificate verification failed: unable to get local issuer certificate
Error: certificate has expired (CERT_HAS_EXPIRED)
```

## O problema é seu ou deles? Uma verificação de dois minutos 

```
curl -sS -o /dev/null -w "%{http_code} %{time_total}s\n" https://api.anthropic.com/v1/models -H "x-api-key: x" -H "anthropic-version: 2023-06-01"
# 401 in under a second = network path is fine, the problem is upstream or in Claude Code
# timeout / SSL error / 000 = the problem is on your side of the wire
env | grep -i -E "proxy|anthropic|node_extra|ssl"
claude --debug     # per-request timing and retry reasons in the log
```

Se o curl recebe um 401 rapidamente e não há variáveis de proxy, é quase certo que se trata de um incidente no provedor. Esse é o grupo descrito em [#87424](https://github.com/anthropics/claude-code/issues/87424) (aberto: ECONNRESET intermitente no aplicativo para desktop e na CLI, sem VPN, sem proxy, desde agosto de 13, confirmado por várias pessoas até agosto de 21) e [#86473](https://github.com/anthropics/claude-code/issues/86473) (ECONNRESET persistente em todas as interfaces, enquanto uma chamada direta com HTTP à API funciona). Nenhuma ação local resolve esses casos; novas tentativas e tempo resolvem. Consulte status.claude.com e, se várias pessoas relatarem o problema na mesma hora no rastreador, pare de depurar. 

## "Aguardando resposta da API · verifique sua rede" 

A mensagem culpa sua rede, e muitas vezes está errada. [#82155](https://github.com/anthropics/claude-code/issues/82155) (aberto, 15 reações): esperas de vários minutos durante todo o dia, com o intervalo entre novas tentativas ultrapassando dois minutos em uma rede que comprovadamente funcionava bem. [#76555](https://github.com/anthropics/claude-code/issues/76555) (aberto): a espera ocorre em todas as respostas, em diferentes modelos. [#72059](https://github.com/anthropics/claude-code/issues/72059) e [#70534](https://github.com/anthropics/claude-code/issues/70534): a mesma espera especificamente quando o modelo consultor é consultado, seguida de uma resposta normal após o temporizador. O intervalo entre novas tentativas cresce exponencialmente, então o impacto visível é a espera, não a falha; as variáveis abaixo a reduzem. 

## Variáveis de novas tentativas e tempo limite 

```
export CLAUDE_CODE_MAX_RETRIES=15               # default 10, capped at 15
export CLAUDE_CODE_RETRY_WATCHDOG=1              # keep retrying instead of giving up (unattended runs)
export API_TIMEOUT_MS=600000                     # per-request timeout, default 10 minutes
export CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS=60000 # give up on a silent stream sooner and retry
export CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=2    # fewer parallel streams on a flaky link
```

Reduzir o tempo limite para o primeiro byte é o que muda a experiência de uma conexão instável: em vez de esperar os dez minutos completos por um fluxo que nunca responderá, o cliente o abandona e tenta novamente. Reduzir a concorrência no uso de ferramentas ajuda em conexões que caem quando vários fluxos são executados ao mesmo tempo (pontos de acesso móveis, algumas VPNs). 

## Proxies, VPNs e redes corporativas 
- Defina as variáveis de proxy que o Claude Code lê: HTTPS_PROXY (e HTTP_PROXY, NO_PROXY). Um proxy que existe apenas no navegador ou na configuração do npm é invisível para a CLI.
- Proxies que inspecionam TLS substituem o certificado da Anthropic pelo próprio: isso é unable to get local issuer certificate. Exporte o certificado da CA raiz corporativa para um arquivo PEM e defina NODE_EXTRA_CA_CERTS=/path/to/corp-root.pem. Não desative a verificação.
- `CERT_HAS_EXPIRED` na versão nativa ([#71727](https://github.com/anthropics/claude-code/issues/71727), 2.1.19x): o repositório de certificados confiáveis incluído, não o seu relógio. claude update; se o problema persistir, a versão npm usa o repositório do sistema.
- `ConnectionRefused` no macOS após uma reinstalação ([#75897](https://github.com/anthropics/claude-code/issues/75897)) — um proxy local ou cliente VPN que está desligado, mas continua configurado no ambiente; limpe as variáveis de proxy e as configurações de proxy do sistema e tente novamente.
- Mudanças no ponto de saída da VPN durante a sessão reiniciam todos os fluxos abertos: espere um ECONNRESET a cada reconexão. 

## Por meio de um gateway 

Aponte o Claude Code para um gateway (ANTHROPIC_BASE_URL=https://aiprimetech.io) e o caminho de rede muda: o cliente se comunica com o gateway, e o gateway mantém as conexões com o serviço de origem e repete em outra conta uma solicitação feita a uma conta saturada. Isso não faz uma rede local com problemas funcionar, mas, para os casos de *conexão interrompida pelo serviço de origem* acima, elimina a dependência de uma única conta, e a mesma chave continua funcionando durante um incidente na assinatura. Execute a verificação com curl no host do gateway para confirmar o caminho antes de mudar. 

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude
```

## Cansado de lidar com esse problema?

Execute o Claude Code pelo gateway da AI Prime Tech: os mesmos modelos Claude nas contas upstream do próprio gateway, duas variáveis de ambiente para fazer a mudança, e novas contas recebem $5 em crédito gratuito para a API com o código FIXIT — sem cartão.

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key
```

[Crie uma conta com o código FIXIT](/register?promo=FIXIT)

## Perguntas frequentes

Como corrigir 'Erro de API: conexão interrompida (ECONNRESET)' no Claude Code?

Execute curl contra a API: se ela responder rapidamente e você não usar um proxy, a interrupção vem do serviço de origem; deixe as novas tentativas ocorrerem e verifique status.claude.com. Se curl também falhar, corrija as variáveis de proxy, a VPN ou o certificado de CA.O que significa 'Aguardando resposta da API · nova tentativa em … · verifique sua rede'?

O Claude Code não recebeu uma resposta da API dentro do tempo limite e está aguardando antes de tentar novamente. Apesar da mensagem, muitas vezes o problema não é sua rede; reduza CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS para que o cliente abandone mais cedo os fluxos sem resposta.Como corrigir 'não foi possível obter o certificado do emissor local' no Claude Code?

Um proxy está reassinando o TLS. Exporte o certificado raiz corporativo como PEM e defina NODE_EXTRA_CA_CERTS com o caminho desse arquivo. Nunca desative a verificação de certificados.O que significa 'Nova tentativa em 0s · tentativa 1/10'?

Uma solicitação falhou e o Claude Code está tentando novamente; o padrão é 10 tentativas com intervalos crescentes, CLAUDE_CODE_MAX_RETRIES aumenta esse valor para 15 e CLAUDE_CODE_RETRY_WATCHDOG=1 mantém as novas tentativas em execuções sem supervisão.

## Execute o Claude Code no gateway

Os mesmos modelos, duas variáveis de ambiente, créditos com 7.69231× o valor nominal — ou um plano ilimitado com preço fixo. Novas contas: $5 em crédito gratuito para a API com o código FIXIT.[Obter uma chave de API](/register?promo=FIXIT) [Ver planos ilimitados](/pt/plans/)

A AI Prime Tech é um gateway de API independente e não é afiliada, endossada nem patrocinada pela Anthropic. “Claude” e “Claude Code” são marcas comerciais da Anthropic. Os recursos do Claude Code descritos aqui seguem a documentação pública da Anthropic no momento da redação e mudam com frequência; os preços e as listas de modelos nesta página são obtidos das configurações atuais deste gateway.

## Mais guias do Claude Code

[Erros do Claude Code e como corrigi-los](/pt/claude-code/errors/)["Erro de API: 500" no Claude Code: o que significa e o que realmente resolve](/pt/claude-code/errors/api-error-500/)[Erro "Sobrecarregado" no Claude (erro 529 de API): o que significa e o que fazer](/pt/claude-code/errors/overloaded-529/)[Erro 400 da API do Claude Code: prompt longo demais, concorrência no uso de ferramentas e os demais](/pt/claude-code/errors/api-error-400/)[Erros de OAuth no Claude Code: tempo limite de 15000ms excedido e código de status 500](/pt/claude-code/errors/oauth-error/)["O processo do Claude Code foi encerrado com o código 1": como encontrar o erro real e corrigi-lo](/pt/claude-code/errors/process-exited-code-1/)["O prompt é longo demais", "A entrada é longa demais para o modelo solicitado" e "Limite de contexto atingido" no Claude: o que preenche a janela e como liberar espaço](/pt/claude-code/errors/prompt-too-long/)[Limite de uso do Claude atingido: limites de sessão, semanais e do Opus, "limites especificados de uso da API", "o saldo de créditos é insuficiente" — e o que fazer](/pt/claude-code/errors/usage-limit-reached/)[Erros 401 e 403 no Claude Code: credenciais de autenticação inválidas, chave de API inválida, "Você não está conectado", host_not_allowed](/pt/claude-code/errors/auth-401-403/)[O Claude Code trava, fica preso ou para de responder: como descobrir onde travou e sair dessa situação](/pt/claude-code/errors/claude-code-hangs/)[Claude.ai não funciona: "Algo deu errado", restrições de capacidade, "limite de 5 horas atingido", "erro ao fazer login" e os demais](/pt/claude-code/errors/claude-ai-not-working/)