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

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 (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 (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 (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 (aberto): a espera ocorre em todas as respostas, em diferentes modelos. #72059 e #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, 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) — 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

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

Perguntas frequentes

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.