“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.
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.
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
Leia o emissor.
curl -v -o /dev/null https://api.anthropic.com 2>&1 | grep -i issuerMostre a variável.
echo $NODE_EXTRA_CA_CERTSInicie o Claude Code com registro de depuração e depois leia as linhas de CA no log.
claude --debugVerifique a data.
date
Como corrigir
Peça o pacote de CA ao administrador, em formato PEM.
Aponte o Claude Code para ele antes de iniciar.
export NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pemOu adicione a CA ao armazenamento de certificados do sistema do macOS, como diz a documentação.
Não defina
NODE_TLS_REJECT_UNAUTHORIZED=0. Isso desativa a validação.
Com o Kilobat
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.comEssas verificações do Kilobat são gratuitas. Agentes de IA as executam pelo MCP com
diagnose_connectionediagnose_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.