---
title: "“npm error code ENOTFOUND” no Mac · Guias do Kilobat"
url: "https://kilobat.app/pt/guides/npm-enotfound"
description: "O npm install no seu Mac para com npm error code ENOTFOUND. O nome do registro não foi resolvido. Verifique o DNS, o ajuste de registro, uma VPN e um proxy."
---

# “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 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 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](https://kilobat.app/pt/guides/dns-server-not-found).
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](https://kilobat.app/pt/guides/flush-dns-cache-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](https://kilobat.app/pt/guides/recipes/why-cant-it-connect).

## Perguntas

**ENOTFOUND é o mesmo que EAI_AGAIN?**

Não. EAI_AGAIN indica uma falha temporária de consulta. Veja [EAI_AGAIN no Mac](https://kilobat.app/pt/guides/eai-again).

**O nome do meu pacote está errado?**

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

## 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 ETIMEDOUT” no Mac](https://kilobat.app/pt/guides/npm-etimedout): ETIMEDOUT significa que o outro lado não respondeu a tempo.
- [EAI_AGAIN no Mac](https://kilobat.app/pt/guides/eai-again): EAI_AGAIN indica que um nome não pôde ser resolvido naquele momento.
- [“curl: (6) Could not resolve host” no Mac](https://kilobat.app/pt/guides/curl-could-not-resolve-host): O código de saída 6 do curl significa que ele não conseguiu obter um endereço para o nome do host.
