«SELF_SIGNED_CERT_IN_CHAIN» en npm en el Mac

SELF_SIGNED_CERT_IN_CHAIN significa que la cadena de certificados contiene un certificado que no firmó ninguna autoridad conocida. En una red de trabajo, la fuente habitual es un proxy que inspecciona TLS.

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

Mi Mac tiene este problema: «SELF_SIGNED_CERT_IN_CHAIN» en npm en el Mac. Lee https://kilobat.app/es/guides/npm-self-signed-cert-in-chain.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 en todas las versiones actuales de macOS. El error también aparece en otras herramientas de Node.js.Revisado: 29 de octubre de 2026

Síntomas

  • npm install se detiene con npm error code SELF_SIGNED_CERT_IN_CHAIN.
  • El mensaje dice self-signed certificate in certificate chain.
  • Empieza en una red de empresa, o después de instalar una app de seguridad.

Causas probables

  • Un proxy que inspecciona TLS. El proxy sustituye el certificado del registro por el suyo. Consulta Los certificados de un proxy corporativo rompen las herramientas de Terminal en un Mac.
  • Una app de seguridad que analiza HTTPS. Puede añadir su propia raíz al tráfico.
  • Un npm antiguo. La página de errores comunes de npm dice que npm ya no admite sus antiguos certificados autofirmados.
  • Un registro privado. Un registro con una autoridad privada necesita el certificado de esa autoridad.

Cómo comprobarlo

  1. Lee el emisor del certificado del registro.

    curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer
  2. Muestra el archivo de CA que usa npm.

    npm config get cafile
  3. Comprueba la versión de npm.

    npm --version
  4. Prueba con el punto de acceso del teléfono. Si funciona, la primera red inspecciona TLS.

Cómo solucionarlo

  1. Pide al administrador de la red el certificado raíz, en formato PEM.

  2. Apunta npm hacia él.

    npm config set cafile /path/to/ca.pem
  3. Actualiza npm si es antiguo.

    npm install npm -g
  4. No pongas strict-ssl en false. La documentación de npm lo desaconseja.

Con Kilobat

  1. El doctor de conexión de Kilobat prueba el registro capa por capa. La capa TLS muestra un certificado en el que este Mac no confía.

    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

¿Es seguro npm config set strict-ssl false?

Desactiva la comprobación de certificados. La documentación de npm lo desaconseja para errores de proxy. Añade en su lugar la CA del proxy.

¿Por qué el error aparece solo en el trabajo?

Un proxy que inspecciona TLS firma el tráfico con su propio certificado. Tu Mac no confía en él.

Fuentes

Comprobado el 29 de octubre de 2026.