“npm error code ENOTFOUND” no Mac

ENOTFOUND indica uma consulta de DNS que falhou. A documentação do Node.js a chama de “DNS lookup failed”, uma falha de EAI_NODATA ou de EAI_NONAME.

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 ENOTFOUND” no Mac. Leia https://kilobat.app/pt/guides/npm-enotfound.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 para com npm error code ENOTFOUND.
  • A linha seguinte indica um host, como registry.npmjs.org.
  • Os navegadores podem funcionar.

Possíveis causas

  • Sem conexão ou DNS. O Mac não consegue alcançar um servidor DNS.
  • Um registro incorreto. O ajuste de registro do npm indica um host que não existe ou que exige uma VPN.
  • Uma VPN com DNS próprio. Registros da empresa só são resolvidos enquanto a VPN está ligada.
  • Um proxy que o npm não usa. Em redes que só funcionam por proxy, o npm precisa dos ajustes de proxy.

Como verificar

  1. Mostre o registro que o npm usa.

    npm config get registry
  2. Resolva o nome do host pelo macOS.

    dscacheutil -q host -a name registry.npmjs.org
  3. Consulte o registro diretamente.

    npm ping
  4. Mostre os ajustes de proxy.

    npm config get https-proxy

Como corrigir

  1. Se a consulta do macOS falhar, corrija o DNS. Veja DNS não resolve no Mac.

  2. Corrija o registro.

    npm config set registry https://registry.npmjs.org/
  3. Conecte a VPN para um registro da empresa.

  4. Limpe o cache DNS. Consulte Limpe o cache DNS no Mac.

Com o Kilobat

  1. O diagnóstico de conexão do Kilobat testa o endereço camada por camada: rede, proxy, DNS, regras, IPv4, IPv6, TLS e o servidor. Ele aponta a camada que falhou.

    kilobat why https://registry.npmjs.org/
  2. Essas verificações do Kilobat são gratuitas. Agentes de IA as executam pelo MCP com diagnose_connection e diagnose_network. Consulte Descubra por que um site ou API não conecta.

Perguntas

ENOTFOUND é o mesmo que EAI_AGAIN?

Não. EAI_AGAIN indica uma falha temporária de consulta. Veja EAI_AGAIN no Mac.

O nome do meu pacote está errado?

Raramente. ENOTFOUND diz respeito a um nome de host, não a um nome de pacote.

Fontes

Verificado em 29 de outubro de 2026.