---
title: "npm error code ETIMEDOUT en el Mac: soluciona los tiempos de espera de red de npm · Guías de Kilobat"
url: "https://kilobat.app/es/guides/npm-etimedout.html"
description: "npm install se detiene en tu Mac con npm error code ETIMEDOUT. Comprueba el registro, el proxy y la conexión, y luego cambia los ajustes de npm."
---

Mensajes de error

# «npm error code ETIMEDOUT» en el Mac

ETIMEDOUT significa que el otro extremo no respondió a tiempo. La documentación de Node.js dice: «the connected party did not properly respond after a period of time» (la otra parte no respondió correctamente tras un tiempo).

Se aplica a: npm 10 y posterior muestran «npm error». Las versiones anteriores muestran «npm ERR!». Todas las versiones actuales de macOS. · Revisado: 29 de octubre de 2026

## Síntomas

- `npm install` se detiene con `npm error code ETIMEDOUT`.
- npm añade que es un problema relacionado con la conectividad de red.
- Falla en una red concreta, como una red de empresa o un punto de acceso.

## Causas probables

- **Un proxy que npm no conoce.** En una red que necesita un proxy, npm necesita sus ajustes `proxy` y `https-proxy`.
- **Un registro al que no puedes llegar.** Un ajuste `registry` antiguo puede apuntar a un servidor privado.
- **Una conexión lenta o con pérdidas.** Los paquetes grandes agotan el tiempo de espera en un Wi-Fi débil o en un punto de acceso.
- **Una ruta IPv6 rota.** El registro tiene una dirección IPv6 y el IPv6 no funciona en tu red.

## Cómo comprobarlo

1. Muestra los ajustes de registro y de proxy de npm.

   ```
   npm config get registry
   npm config get proxy
   npm config get https-proxy
   ```
2. Pide una respuesta al registro.

   ```
   npm ping
   ```
3. Prueba el registro con curl, solo por IPv4.

   ```
   curl -4 -I https://registry.npmjs.org/
   ```
4. Mide la conexión.

   ```
   networkQuality
   ```

## Cómo solucionarlo

1. Si la red necesita un proxy, configúralo para npm.

   ```
   npm config set https-proxy http://proxy.example.com:8080
   ```
2. Elimina un ajuste de registro antiguo para que npm use el predeterminado.

   ```
   npm config delete registry
   ```
3. Dale a npm más reintentos en una conexión lenta.

   ```
   npm config set fetch-retries 5
   ```
4. Vuelve a ejecutar la instalación en una red más rápida, si puedes.

## Con Kilobat

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

   ```
   kilobat why https://registry.npmjs.org/
   ```
2. Antes de una instalación grande, comprueba si la red tiene límite, si pasa por una VPN o si va lenta.

   ```
   kilobat conditions
   ```
3. 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.html).

## Preguntas

**¿Cuánto espera npm?**

La documentación de npm indica un `fetch-timeout` predeterminado de 300000 ms, cinco minutos, y 2 `fetch-retries`.

## Fuentes

- [Documentación de Node.js: Common system errors](https://nodejs.org/api/errors.html#common-system-errors)
- [npm Docs: config](https://docs.npmjs.com/cli/v11/using-npm/config)
- curl(1) y networkQuality(8), página man instalada con macOS 27.2

Fuentes revisadas el 29 de octubre de 2026. Las páginas man son las que se instalan con macOS; abre una con `man <name>` en Terminal.

## Guías relacionadas

- [«npm error code ECONNRESET» en el Mac](https://kilobat.app/es/guides/npm-econnreset.html): ECONNRESET significa que el otro extremo cerró la conexión a la fuerza.
- [Las descargas de Homebrew o npm fallan en un Mac](https://kilobat.app/es/guides/homebrew-npm-download-fails.html): Homebrew descarga con curl y Git.
- [Los ajustes de proxy impiden que las apps se conecten en un Mac](https://kilobat.app/es/guides/proxy-settings-breaking-apps.html): Un ajuste de proxy envía el tráfico a través de otro servidor.
- [Los certificados de un proxy corporativo rompen las herramientas de Terminal en un Mac](https://kilobat.app/es/guides/corporate-proxy-certificates.html): Algunas redes de empresa inspeccionan el tráfico HTTPS.
- [Comprobar la red antes de una descarga grande en un agente](https://kilobat.app/es/guides/recipes/check-network-before-download.html): Un agente puede preguntar a Kilobat si ahora es buen momento para una transferencia grande.