---
title: "«UNABLE_TO_GET_ISSUER_CERT_LOCALLY» en el Mac · Guías de Kilobat"
url: "https://kilobat.app/es/guides/npm-unable-to-get-issuer-cert-locally"
description: "Node.js o npm en tu Mac se detiene con UNABLE_TO_GET_ISSUER_CERT_LOCALLY. Se desconoce el emisor de un certificado. Añade el archivo de CA correcto, no desactives las comprobaciones."
---

# «UNABLE_TO_GET_ISSUER_CERT_LOCALLY» en el Mac

UNABLE_TO_GET_ISSUER_CERT_LOCALLY significa que Node.js no encuentra la autoridad que firmó un certificado. La causa habitual es un proxy que inspecciona TLS o una autoridad privada.

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

Mi Mac tiene este problema: «UNABLE_TO_GET_ISSUER_CERT_LOCALLY» en el Mac. Lee https://kilobat.app/es/guides/npm-unable-to-get-issuer-cert-locally.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: Node.js, npm y las herramientas basadas en Node.js, en todas las versiones actuales de macOS. · Revisado: 29 de octubre de 2026

## Síntomas

- Una herramienta de Node.js se detiene con `UNABLE_TO_GET_ISSUER_CERT_LOCALLY`.
- El mensaje puede decir `unable to get local issuer certificate`.
- Los navegadores pueden abrir el mismo sitio.

## Causas probables

- **Un proxy que inspecciona TLS.** Un proxy de trabajo firma el tráfico con su propio certificado. Consulta [Los certificados de un proxy corporativo rompen las herramientas de Terminal en un Mac](https://kilobat.app/es/guides/corporate-proxy-certificates).
- **Una autoridad privada.** Un registro o una pasarela de empresa usa un certificado de una autoridad que Node.js no conoce.
- **Una app de seguridad que analiza HTTPS.** Añade su propia raíz, que Node.js no usa de forma predeterminada.
- **Falta un intermedio.** Un servidor puede omitir parte de su cadena de certificados.

## Cómo comprobarlo

1. Lee el emisor.

   ```
   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. Muestra la variable de CA de Node.js.

   ```
   echo $NODE_EXTRA_CA_CERTS
   ```
4. Prueba con el punto de acceso del teléfono.

## Cómo solucionarlo

1. Pide al administrador de la red el certificado de CA, en formato PEM.
2. Indica a Node.js que confíe en él en este shell.

   ```
   export NODE_EXTRA_CA_CERTS=/path/to/ca.pem
   ```
3. Para npm, define el mismo archivo.

   ```
   npm config set cafile /path/to/ca.pem
   ```
4. No definas `NODE_TLS_REJECT_UNAUTHORIZED=0`. Desactiva todas las comprobaciones.

## Con Kilobat

1. El doctor de conexión de Kilobat prueba el host 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](https://kilobat.app/es/guides/recipes/why-cant-it-connect).

## Preguntas

**¿Por qué funciona el navegador?**

macOS confía en los certificados que instala un administrador. Node.js usa su propia lista salvo que añadas un archivo.

**¿Definir NODE_TLS_REJECT_UNAUTHORIZED=0 lo soluciona?**

No. Desactiva la validación de certificados en todas las conexiones. Añade la CA en su lugar.

## Fuentes

- [Documentación de npm: Errores comunes](https://docs.npmjs.com/common-errors)
- [Claude Code: configuración de red empresarial](https://code.claude.com/docs/en/network-config.md)

Comprobado el 29 de octubre de 2026.

## Guías relacionadas

- [«SELF_SIGNED_CERT_IN_CHAIN» en npm en el Mac](https://kilobat.app/es/guides/npm-self-signed-cert-in-chain): SELF_SIGNED_CERT_IN_CHAIN significa que la cadena de certificados contiene un certificado que no firmó ninguna autoridad conocida.
- [Los certificados de un proxy corporativo rompen las herramientas de Terminal en un Mac](https://kilobat.app/es/guides/corporate-proxy-certificates): Algunas redes de empresa inspeccionan el tráfico HTTPS.
- [«curl: (60) SSL certificate problem» en el Mac](https://kilobat.app/es/guides/curl-60-ssl-certificate-problem): El código de salida 60 de curl indica un paso fallido.
- [«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.
