«Unable to connect to API: SSL certificate verification failed» en el Mac

Claude Code muestra esto cuando un certificado procede de una autoridad en la que no confía. La documentación menciona un proxy corporativo que inspecciona TLS o una pasarela con una CA privada.

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

Mi Mac tiene este problema: «Unable to connect to API: SSL certificate verification failed» en el Mac. Lee https://kilobat.app/es/guides/claude-code-ssl-certificate-verification-failed.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: Claude Code en un terminal, en todas las versiones actuales de macOS.Revisado: 29 de octubre de 2026

Síntomas

  • Claude Code muestra Unable to connect to API: SSL certificate verification failed.
  • El código es UNABLE_TO_GET_ISSUER_CERT_LOCALLY, o el texto dice «self-signed certificate».
  • Empieza en una red de trabajo.

Causas probables

  • Un proxy que inspecciona TLS. Un proxy o un dispositivo de seguridad intercepta el tráfico TLS con su propio certificado.
  • Una pasarela con una CA privada. Una pasarela de LLM puede usar un certificado de una autoridad privada.
  • Un archivo de CA que no se carga. Claude Code avisa cuando no puede leer el archivo de NODE_EXTRA_CA_CERTS.
  • Un reloj incorrecto. Una fecha muy desviada rompe la verificación de certificados.

Cómo comprobarlo

  1. Lee el emisor.

    curl -v -o /dev/null https://api.anthropic.com 2>&1 | grep -i issuer
  2. Muestra la variable.

    echo $NODE_EXTRA_CA_CERTS
  3. Inicia Claude Code con el registro de depuración y lee las líneas de CA del registro.

    claude --debug
  4. Comprueba la fecha.

    date

Cómo solucionarlo

  1. Pide al administrador el paquete de CA, en formato PEM.

  2. Apunta Claude Code hacia él antes de iniciarlo.

    export NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem
  3. O añade la CA al almacén de certificados del sistema de macOS, como indica la documentación.

  4. No definas NODE_TLS_REJECT_UNAUTHORIZED=0. Desactiva la validación.

Con Kilobat

  1. El doctor de conexión de Kilobat prueba el host de la API capa por capa. La capa TLS muestra quién firmó el certificado.

    kilobat why https://api.anthropic.com
  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

¿Claude Code usa el almacén de certificados de macOS?

De forma predeterminada confía en sus CA de Mozilla incluidas y en el almacén del sistema operativo. Las instalaciones nativas siempre leen el almacén del sistema.

¿Puedo desactivar la validación?

La documentación dice que no se defina NODE_TLS_REJECT_UNAUTHORIZED=0.

Fuentes

Comprobado el 29 de octubre de 2026.