# API Error: Connection refused - a firewall or proxy may be blocking it (ECONNREFUSED) - RESOLVIDO/2006

> E por que a própria mensagem de erro me mandou procurar no lugar errado

Publicado em 2026-09-24. Por [Paulo Sabbanelli](https://paulosabbanelli.com.br/sobre/), especialista em comunicação digital para aquisição de clientes.
URL: https://blog.paulosabbanelli.com.br/inteligencia-artificial/claude-code/claude-code-avancado/api-error-connection-refused-a-firewall-or-proxy-may-be-blocking-it-econnrefused-resolvido-em-setembro-de-2026/

## Como resolvi o erro “Connection refused” do Claude no VS Code

_E por que a própria mensagem de erro me mandou procurar no lugar errado_

_Por Paulo Sabbanelli_

Estou desenvolvendo um sistema integrado ao Mercado Livre, uma plataforma que transforma a loja do Mercado Livre em loja própria, com a ajuda do Claude. Uso o app do Claude no projeto principal e o VS Code nos outros projetos. Um dia, o Claude no VS Code parou de responder e mostrou esta mensagem:

> API Error: Connection refused - a firewall or proxy may be blocking it (ECONNREFUSED)

O estranho é que, no app do Claude, no mesmo computador, tudo continuava funcionando.

### A mensagem apontava para o lugar errado

O erro falava em firewall e proxy, então comecei por aí. Procurei proxy nas configurações do VS Code e não achei nada. Depois abri no VS Code o mesmo projeto que funcionava no app, e o erro apareceu de novo. Então o problema não era o projeto: estava em alguma coisa entre o VS Code e o meu computador. Chegei até a desconfiar do Git, mas preferi deixar para investigar depois. Confesso que nessa hora fiquei bem confuso. Foi quando lembrei de um detalhe: o problema tinha começado depois que instalei o Claude pelo cmd, seguindo um passo a passo da internet, que nem lembro de onde foi a fonte.

### O diagnóstico: um comando, dois nomes

Pedi ajuda ao próprio Claude e fui um passo de cada vez. O passo decisivo foi um comando no PowerShell que lista só os nomes das configurações do Windows ligadas ao Claude. Ele não mostra nenhum valor secreto:

```
Get-ChildItem Env: | Where-Object Name -Match 'PROXY|ANTHROPIC|CLAUDE' | Select-Object -ExpandProperty Name
```

Apareceram dois nomes:

```
ANTHROPIC_AUTH_TOKEN
ANTHROPIC_BASE_URL
```

Essas duas configurações mandam o Claude usar outro endereço no lugar do oficial da Anthropic, com outra chave. Tudo indica que foram criadas naquela instalação. O VS Code tentava esse endereço, ninguém atendia, e aparecia o “connection refused”.

E por que o app funcionava? Essas configurações só valem para programas abertos depois delas. O app já estava aberto antes; o VS Code, não.

### A solução: dois comandos e reabrir o VS Code

Apaguei as duas configurações:

```
[Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', $null, 'User')
```

```
[Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', $null, 'User')
```

Depois abri um PowerShell novo e rodei o primeiro comando outra vez: não apareceu nada. Fechei todas as janelas do VS Code, abri de novo pelo menu Iniciar, e o Claude voltou a funcionar.

### O que aprendi

1. **A mensagem de erro diz onde o problema aparece, não onde ele está.** Ela falava em firewall e proxy, e o culpado era uma configuração esquecida.
2. **Comparar onde funciona e onde não funciona economiza tempo.** A diferença entre o app e o VS Code foi a pista principal.
3. **Cuidado com tutoriais que mandam rodar `setx ANTHROPIC_...`.** Esse comando grava a configuração de forma permanente, para todos os programas do computador.
4. **Dá para investigar sem expor segredos.** Olhe só os nomes, nunca os valores. E nunca cole uma chave (algo que começa com `sk-`) em chat ou print.
5. **Um passo de cada vez.** Quando fiquei confuso, parei, voltei ao começo e segui um comando por vez.

### Se você encontrar o mesmo erro

- Rode o comando que lista os nomes. Se aparecer `ANTHROPIC_BASE_URL`, `ANTHROPIC_AUTH_TOKEN`, `HTTP_PROXY` ou `HTTPS_PROXY` e você não usa isso de propósito, apague.
- Feche todas as janelas do programa e abra de novo pelo menu Iniciar.
- Se o Claude pedir login, entre com a sua conta.
- Se o comando não mostrar nada, teste a rede com `Test-NetConnection api.anthropic.com -Port 443`. Se a linha `TcpTestSucceeded` vier `False`, algo está bloqueando: pode ser o antivírus, a VPN, o DNS ou o arquivo hosts.

Se isso te ajudou, compartilhe com quem está começando a programar com IA. E se você já passou por um erro parecido, me conta nos comentários como resolveu.

Um forte abraço!