---
title: "«npm error code ENOTFOUND» en el Mac · Guías de Kilobat"
url: "https://kilobat.app/es/guides/npm-enotfound"
description: "npm install en tu Mac se detiene con «npm error code ENOTFOUND». El nombre del registro no se resolvió. Revisa el DNS, el ajuste del registro, una VPN y un proxy."
---

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

## Preguntas

**¿ENOTFOUND es lo mismo que EAI_AGAIN?**

No. EAI_AGAIN indica un fallo temporal de búsqueda. Consulta [EAI_AGAIN en Mac](https://kilobat.app/es/guides/eai-again).

**¿Es incorrecto el nombre de mi paquete?**

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

## Fuentes

- [Documentación de Node.js: Common system errors](https://nodejs.org/api/errors.html#common-system-errors)
- [Documentación de npm: Errores comunes](https://docs.npmjs.com/common-errors)

Comprobado el 29 de octubre de 2026.

## Guías relacionadas

- [«npm error code ECONNRESET» en el Mac](https://kilobat.app/es/guides/npm-econnreset): ECONNRESET indica que una conexión se reinició de forma forzada.
- [«npm error code ETIMEDOUT» en el Mac](https://kilobat.app/es/guides/npm-etimedout): ETIMEDOUT significa que el otro extremo no respondió a tiempo.
- [EAI_AGAIN en Mac](https://kilobat.app/es/guides/eai-again): EAI_AGAIN indica que no se pudo resolver un nombre en ese momento.
- [«curl: (6) Could not resolve host» en el Mac](https://kilobat.app/es/guides/curl-could-not-resolve-host): El código de salida 6 de curl significa que curl no pudo obtener una dirección para el nombre de host.
