---
title: "“UNABLE_TO_GET_ISSUER_CERT_LOCALLY” no Mac · Guias do Kilobat"
url: "https://kilobat.app/pt/guides/npm-unable-to-get-issuer-cert-locally"
description: "O Node.js ou o npm no seu Mac para com UNABLE_TO_GET_ISSUER_CERT_LOCALLY. O emissor de um certificado é desconhecido. Adicione o arquivo de CA certo, não desative as verificações."
---

# “UNABLE_TO_GET_ISSUER_CERT_LOCALLY” no Mac

UNABLE_TO_GET_ISSUER_CERT_LOCALLY significa que o Node.js não encontra a autoridade que assinou um certificado. A causa usual é um proxy que inspeciona TLS ou uma autoridade privada.

**Resolva com seu agente**Copia um prompt para o Claude Code, o Codex ou qualquer agente que possa usar o Terminal.

Meu Mac está com este problema: “UNABLE_TO_GET_ISSUER_CERT_LOCALLY” no Mac. Leia https://kilobat.app/pt/guides/npm-unable-to-get-issuer-cert-locally.md e resolva comigo. Instale a CLI do Kilobat se ela estiver faltando: brew install seifip/kilobat/kilobat. Execute você mesmo as verificações do Terminal e do kilobat do guia e me diga o que encontrar. Liste os passos que só eu posso fazer. Pergunte antes de alterar qualquer ajuste.

Vale para: Node.js, npm e ferramentas baseadas em Node.js, em todas as versões atuais do macOS. · Verificado: 29 de outubro de 2026

## Sintomas

- Uma ferramenta Node.js para com `UNABLE_TO_GET_ISSUER_CERT_LOCALLY`.
- A mensagem pode dizer `unable to get local issuer certificate`.
- Os navegadores podem abrir o mesmo site.

## Possíveis causas

- **Um proxy que inspeciona TLS.** Um proxy de trabalho assina o tráfego com um certificado próprio. Veja [Certificados de proxy corporativo quebram ferramentas do Terminal no Mac](https://kilobat.app/pt/guides/corporate-proxy-certificates).
- **Uma autoridade privada.** Um registro ou gateway da empresa usa um certificado de uma autoridade que o Node.js não conhece.
- **Um app de segurança que examina HTTPS.** Ele adiciona a própria raiz, que o Node.js não usa por padrão.
- **Um certificado intermediário ausente.** Um servidor pode omitir parte da cadeia de certificados.

## Como verificar

1. Leia o emissor.

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

   ```
   npm config get cafile
   ```
3. Mostre a variável de CA do Node.js.

   ```
   echo $NODE_EXTRA_CA_CERTS
   ```
4. Teste com o acesso pessoal de um celular.

## Como corrigir

1. Peça o certificado da CA ao administrador da rede, em formato PEM.
2. Diga ao Node.js para confiar nele neste shell.

   ```
   export NODE_EXTRA_CA_CERTS=/path/to/ca.pem
   ```
3. Para o npm, defina o mesmo arquivo.

   ```
   npm config set cafile /path/to/ca.pem
   ```
4. Não defina `NODE_TLS_REJECT_UNAUTHORIZED=0`. Isso desativa todas as verificações.

## Com o Kilobat

1. O diagnóstico de conexão do Kilobat testa o host camada por camada. A camada TLS mostra um certificado em que este Mac não confia.

   ```
   kilobat why https://registry.npmjs.org/
   ```
2. Essas verificações do Kilobat são gratuitas. Agentes de IA as executam pelo MCP com `diagnose_connection` e `diagnose_network`. Consulte [Descubra por que um site ou API não conecta](https://kilobat.app/pt/guides/recipes/why-cant-it-connect).

## Perguntas

**Por que o navegador funciona?**

O macOS confia em certificados que um administrador instala. O Node.js usa a própria lista, a menos que você adicione um arquivo.

**Definir NODE_TLS_REJECT_UNAUTHORIZED=0 resolve?**

Não. Isso desativa a validação de certificados para todas as conexões. Adicione a CA.

## Fontes

- [Documentação do npm: erros comuns](https://docs.npmjs.com/common-errors)
- [Claude Code: configuração de rede corporativa](https://code.claude.com/docs/en/network-config.md)

Verificado em 29 de outubro de 2026.

## Guias relacionados

- [“SELF_SIGNED_CERT_IN_CHAIN” no npm do Mac](https://kilobat.app/pt/guides/npm-self-signed-cert-in-chain): SELF_SIGNED_CERT_IN_CHAIN significa que a cadeia de certificados tem um certificado que nenhuma autoridade conhecida assinou.
- [Certificados de proxy empresarial interferem em ferramentas do Terminal no Mac](https://kilobat.app/pt/guides/corporate-proxy-certificates): Algumas redes empresariais inspecionam o tráfego HTTPS.
- [“curl: (60) SSL certificate problem” no Mac](https://kilobat.app/pt/guides/curl-60-ssl-certificate-problem): O código de saída 60 do curl indica uma etapa que falhou.
- [“npm error code ECONNRESET” no Mac](https://kilobat.app/pt/guides/npm-econnreset): ECONNRESET informa uma conexão encerrada à força.
