«npm error code ENOTFOUND» en el Mac

ENOTFOUND indica una búsqueda DNS fallida. La documentación de Node.js la llama «DNS lookup failed», un fallo de EAI_NODATA o de EAI_NONAME.

Arréglalo con tu agenteCopia un prompt para Claude Code, Codex o cualquier agente que pueda usar Terminal.

Mi Mac tiene este problema: «npm error code ENOTFOUND» en el Mac. Lee https://kilobat.app/es/guides/npm-enotfound.md y resuélvelo conmigo. Instala la CLI de Kilobat si falta: brew install seifip/kilobat/kilobat. Ejecuta tú mismo las comprobaciones de Terminal y de kilobat de la guía y dime qué encuentras. Enumera los pasos que solo yo puedo hacer. Pregunta antes de cambiar cualquier ajuste.

Se aplica a: npm 10 y posteriores muestran «npm error». Las versiones anteriores muestran «npm ERR!». Node.js en todas las versiones actuales de macOS.Revisado: 29 de octubre de 2026

Síntomas

  • npm install se detiene con npm error code ENOTFOUND.
  • La línea siguiente nombra un host, como registry.npmjs.org.
  • Los navegadores pueden funcionar.

Causas probables

  • Sin conexión o sin DNS. El Mac no puede llegar a un servidor DNS.
  • Un registro incorrecto. El ajuste del registro de npm nombra un host que no existe o que necesita una VPN.
  • Una VPN con su propio DNS. Los registros de empresa solo se resuelven mientras la VPN está activada.
  • Un proxy que npm no usa. En redes solo con proxy, npm necesita los ajustes de proxy.

Cómo comprobarlo

  1. Muestra el registro que usa npm.

    npm config get registry
  2. Resuelve el nombre del host a través de macOS.

    dscacheutil -q host -a name registry.npmjs.org
  3. Pregunta directamente al registro.

    npm ping
  4. Muestra los ajustes de proxy.

    npm config get https-proxy

Cómo solucionarlo

  1. Si falla la búsqueda de macOS, arregla el DNS. Consulta El DNS no resuelve en un Mac.

  2. Corrige el registro.

    npm config set registry https://registry.npmjs.org/
  3. Conecta la VPN para un registro de empresa.

  4. Vacía la caché DNS. Consulta Vaciar la caché DNS en un Mac.

Con Kilobat

  1. El doctor de conexión de Kilobat prueba la dirección capa por capa: red, proxy, DNS, reglas, IPv4, IPv6, TLS y servidor. Indica la capa que falló.

    kilobat why https://registry.npmjs.org/
  2. Estas comprobaciones de Kilobat son gratuitas. Los agentes de IA las ejecutan por MCP con diagnose_connection y diagnose_network. Consulta Averiguar por qué no conecta un sitio o una API.

Preguntas

¿ENOTFOUND es lo mismo que EAI_AGAIN?

No. EAI_AGAIN indica un fallo temporal de búsqueda. Consulta EAI_AGAIN en Mac.

¿Es incorrecto el nombre de mi paquete?

Rara vez. ENOTFOUND se refiere al nombre de un host, no al de un paquete.

Fuentes

Comprobado el 29 de octubre de 2026.