---
title: "“npm error code ECONNREFUSED” no Mac · Guias do Kilobat"
url: "https://kilobat.app/pt/guides/npm-econnrefused"
description: "O npm install no seu Mac para com npm error code ECONNREFUSED. Um host recusou a conexão. Verifique o registro, o proxy e os serviços locais."
---

# “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 agente**Copia 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](https://kilobat.app/pt/guides/npm-econnreset).

**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

- [Documentação do Node.js: erros de sistema comuns](https://nodejs.org/api/errors.html#common-system-errors)
- [Documentação do npm: erros comuns](https://docs.npmjs.com/common-errors)

Verificado em 29 de outubro de 2026.

## Guias relacionados

- [“npm error code ECONNRESET” no Mac](https://kilobat.app/pt/guides/npm-econnreset): ECONNRESET informa uma conexão encerrada à força.
- [“npm error code ENOTFOUND” no Mac](https://kilobat.app/pt/guides/npm-enotfound): ENOTFOUND indica uma consulta de DNS que falhou.
- [ERR_CONNECTION_REFUSED no Chrome do Mac](https://kilobat.app/pt/guides/err-connection-refused): ERR_CONNECTION_REFUSED é um erro de rede do Chrome.
- [Ajustes de proxy impedem apps de se conectar no Mac](https://kilobat.app/pt/guides/proxy-settings-breaking-apps): Um ajuste de proxy envia tráfego por outro servidor.
