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

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!