---
title: "“Unable to connect to API: SSL certificate verification failed” no Mac · Guias do Kilobat"
url: "https://kilobat.app/pt/guides/claude-code-ssl-certificate-verification-failed"
description: "O Claude Code no seu Mac informa SSL certificate verification failed. Um proxy ou uma CA privada assina o tráfego. Adicione a CA dela com NODE_EXTRA_CA_CERTS."
---

# “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 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 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](https://kilobat.app/pt/guides/recipes/why-cant-it-connect).

## 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

- [Claude Code: referência de erros](https://code.claude.com/docs/en/errors.md)
- [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

- [“Unable to connect to API” no Claude Code do Mac](https://kilobat.app/pt/guides/claude-code-unable-to-connect-to-api): O Claude Code exibe Unable to connect to API quando uma solicitação não chega a api.anthropic.com.
- [“UNABLE_TO_GET_ISSUER_CERT_LOCALLY” no Mac](https://kilobat.app/pt/guides/npm-unable-to-get-issuer-cert-locally): UNABLE_TO_GET_ISSUER_CERT_LOCALLY significa que o Node.js não encontra a autoridade que assinou um certificado.
- [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.
