“npm error code ECONNREFUSED” no Mac

ECONNREFUSED indica uma conexão recusada. A documentação do Node.js diz: “No connection could be made because the target machine actively refused it.”

Resolva com seu agenteCopia um prompt para o Claude Code, o Codex ou qualquer agente que possa usar o Terminal.

Meu Mac está com este problema: “npm error code ECONNREFUSED” no Mac. Leia https://kilobat.app/pt/guides/npm-econnrefused.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 npm 10 e posteriores imprimem “npm error”. Versões mais antigas imprimem “npm ERR!”. Node.js em todas as versões atuais do macOS.Verificado: 29 de outubro de 2026

Sintomas

  • npm install ou um script para com npm error code ECONNREFUSED.
  • A linha seguinte indica um endereço e uma porta, como 127.0.0.1:8080.
  • Costuma vir depois de um ajuste de proxy ou de registro.

Possíveis causas

  • Um ajuste de proxy que aponta para o nada. Um proxy em 127.0.0.1 ou em outro host está definido, mas nenhum proxy roda lá.
  • Um registro local desligado. Um espelho ou cache local está fora do ar.
  • Um serviço inativo. A documentação do Node.js diz que isso geralmente resulta de um serviço inativo no host remoto.
  • Um script que chama um servidor local. Uma etapa de teste ou de build pode chamar um servidor que não foi iniciado.

Como verificar

  1. Leia o endereço e a porta no erro.

  2. Mostre o proxy e o registro do npm.

    npm config get proxy
    npm config get https-proxy
    npm config get registry
  3. Teste essa porta.

    nc -vz 127.0.0.1 8080
  4. Mostre as variáveis de proxy.

    env | grep -i proxy

Como corrigir

  1. Apague um ajuste de proxy de que você não precisa.

    npm config delete proxy
    npm config delete https-proxy
  2. Inicie o registro ou servidor local que o endereço indica.

  3. Remova variáveis de proxy incorretas.

    unset https_proxy http_proxy
  4. Tente a instalação de novo.

Perguntas

ECONNREFUSED é o mesmo que ECONNRESET?

Não. ECONNREFUSED é uma recusa no início. ECONNRESET encerra uma conexão aberta. Veja “npm error code ECONNRESET” no Mac.

Por que ele indica 127.0.0.1?

O npm tentou um endereço local, geralmente por causa de um ajuste de proxy ou de registro.

Fontes

Verificado em 29 de outubro de 2026.