“Unable to connect to API: SSL certificate verification failed” no Mac

O Claude Code exibe isso quando um certificado vem de uma autoridade em que ele não confia. A documentação cita um proxy corporativo que inspeciona TLS ou um gateway com uma CA privada.

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: “Unable to connect to API: SSL certificate verification failed” no Mac. Leia https://kilobat.app/pt/guides/claude-code-ssl-certificate-verification-failed.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 Claude Code em um terminal em todas as versões atuais do macOS.Verificado: 29 de outubro de 2026

Sintomas

  • O Claude Code exibe Unable to connect to API: SSL certificate verification failed.
  • O código diz UNABLE_TO_GET_ISSUER_CERT_LOCALLY, ou o texto diz self-signed certificate.
  • Começa em uma rede de trabalho.

Possíveis causas

  • Um proxy que inspeciona TLS. Um proxy ou appliance de segurança intercepta o tráfego TLS com um certificado próprio.
  • Um gateway com uma CA privada. Um gateway de LLM pode usar um certificado de uma autoridade privada.
  • Um arquivo de CA que não carrega. O Claude Code avisa quando não consegue ler o arquivo NODE_EXTRA_CA_CERTS.
  • Um relógio errado. Uma data muito distante quebra as verificações de certificado.

Como verificar

  1. Leia o emissor.

    curl -v -o /dev/null https://api.anthropic.com 2>&1 | grep -i issuer
  2. Mostre a variável.

    echo $NODE_EXTRA_CA_CERTS
  3. Inicie o Claude Code com registro de depuração e depois leia as linhas de CA no log.

    claude --debug
  4. Verifique a data.

    date

Como corrigir

  1. Peça o pacote de CA ao administrador, em formato PEM.

  2. Aponte o Claude Code para ele antes de iniciar.

    export NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem
  3. Ou adicione a CA ao armazenamento de certificados do sistema do macOS, como diz a documentação.

  4. Não defina NODE_TLS_REJECT_UNAUTHORIZED=0. Isso desativa a validação.

Com o Kilobat

  1. O diagnóstico de conexão do Kilobat testa o host da API camada por camada. A camada TLS mostra quem assinou o certificado.

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

O Claude Code usa o armazenamento de certificados do macOS?

Por padrão ele confia nas CAs da Mozilla incluídas nele e no armazenamento do sistema operacional. As instalações nativas sempre leem o armazenamento do sistema.

Posso desativar a validação?

A documentação diz para não definir NODE_TLS_REJECT_UNAUTHORIZED=0.

Fontes

Verificado em 29 de outubro de 2026.