“SELF_SIGNED_CERT_IN_CHAIN” no npm do Mac

SELF_SIGNED_CERT_IN_CHAIN significa que a cadeia de certificados tem um certificado que nenhuma autoridade conhecida assinou. Em uma rede de trabalho, a origem usual é um proxy que inspeciona TLS.

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

Meu Mac está com este problema: “SELF_SIGNED_CERT_IN_CHAIN” no npm do Mac. Leia https://kilobat.app/pt/guides/npm-self-signed-cert-in-chain.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: o npm em todas as versões atuais do macOS. O erro também aparece em outras ferramentas Node.js.Verificado: 29 de outubro de 2026

Sintomas

  • npm install para com npm error code SELF_SIGNED_CERT_IN_CHAIN.
  • A mensagem diz self-signed certificate in certificate chain.
  • Começa em uma rede de empresa ou depois que um app de segurança é instalado.

Possíveis causas

  • Um proxy que inspeciona TLS. O proxy substitui o certificado do registro pelo próprio. Veja Certificados de proxy corporativo quebram ferramentas do Terminal no Mac.
  • Um app de segurança que examina HTTPS. Ele pode adicionar a própria raiz ao tráfego.
  • Um npm antigo. A página de erros comuns do npm diz que o npm não aceita mais seus antigos certificados autoassinados.
  • Um registro privado. Um registro com uma autoridade privada precisa do certificado dessa autoridade.

Como verificar

  1. Leia o emissor do certificado do registro.

    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. Verifique a versão do npm.

    npm --version
  4. Tente o acesso pessoal de um celular. Se funcionar, a primeira rede inspeciona TLS.

Como corrigir

  1. Peça o certificado raiz ao administrador da rede, em formato PEM.

  2. Aponte o npm para ele.

    npm config set cafile /path/to/ca.pem
  3. Atualize o npm se ele for antigo.

    npm install npm -g
  4. Não defina strict-ssl como false. A documentação do npm desaconselha.

Com o Kilobat

  1. O diagnóstico de conexão do Kilobat testa o registro 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.

Perguntas

npm config set strict-ssl false é seguro?

Ele desativa a verificação de certificado. A documentação do npm desaconselha isso para erros de proxy. Adicione a CA do proxy.

Por que o erro aparece só no trabalho?

Um proxy que inspeciona TLS assina o tráfego com um certificado próprio. Seu Mac não confia nele.

Fontes

Verificado em 29 de outubro de 2026.