---
title: "“Unable to connect to API” no Claude Code do Mac · Guias do Kilobat"
url: "https://kilobat.app/pt/guides/claude-code-unable-to-connect-to-api"
description: "O Claude Code no seu Mac exibe Unable to connect to API. Verifique sua conexão, uma VPN que bloqueia o host da API e um proxy que você precisa definir."
---

# “Unable to connect to API” no Claude Code do Mac

O Claude Code exibe Unable to connect to API quando uma solicitação não chega a api.anthropic.com. A documentação do Claude Code cita como causas comuns a falta de acesso à internet, uma VPN que bloqueia o host ou um proxy corporativo não definido.

**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” no Claude Code do Mac. Leia https://kilobat.app/pt/guides/claude-code-unable-to-connect-to-api.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. Check your internet connection`.
- A mensagem pode terminar com um código, como ENOTFOUND, EHOSTUNREACH ou ECONNRESET.
- As solicitações falham, mas outros apps podem funcionar.

## Possíveis causas

- **Sem acesso à internet.** O Mac está offline ou sem DNS.
- **Uma VPN que bloqueia o host da API.** A documentação do Claude Code lista isso como uma causa comum.
- **Um proxy não definido.** Um proxy corporativo obrigatório precisa de `HTTPS_PROXY` antes de iniciar.
- **Um proxy que recusa o túnel.** ERR_PROXY_TUNNEL significa que o proxy recusou o túnel. Verifique as credenciais dele e se ele permite este host.

## Como verificar

1. Teste o host da API no mesmo shell.

   ```
   curl -I https://api.anthropic.com
   ```
2. Mostre as variáveis de proxy.

   ```
   env | grep -i proxy
   ```
3. Execute as verificações dentro do Claude Code.

   ```
   /doctor
   ```
4. Teste o nome do host pelo macOS.

   ```
   dscacheutil -q host -a name api.anthropic.com
   ```

## Como corrigir

1. Se o DNS falhar, corrija-o. Veja [DNS não resolve no Mac](https://kilobat.app/pt/guides/dns-server-not-found).
2. Atrás de um proxy corporativo, defina-o antes de iniciar.

   ```
   export HTTPS_PROXY=http://proxy.example.com:8080
   ```
3. Se você usa um gateway, defina `ANTHROPIC_BASE_URL` com o endereço dele.
4. Desative a VPN para um teste rápido. Ative de novo depois.

## Com o Kilobat

1. O diagnóstico de conexão do Kilobat testa o host da API camada por camada: rede, proxy, DNS, regras, IPv4, IPv6, TLS e o servidor.

   ```
   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 código entre parênteses é importante?**

Sim. ENOTFOUND aponta para DNS, EHOSTUNREACH para uma rota, ECONNRESET para uma reinicialização da conexão e ERR_PROXY_TUNNEL para um proxy.

**Preciso reiniciar o Claude Code depois de definir uma variável?**

Sim. A página de configuração de rede diz que uma sessão em execução não recebe mudanças feitas depois no shell.

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

- [“Request timed out” no Claude Code do Mac](https://kilobat.app/pt/guides/claude-code-request-timed-out): O Claude Code exibe Request timed out quando a API não responde antes do limite de tempo da conexão.
- [“Unable to connect to API: SSL certificate verification failed” no Mac](https://kilobat.app/pt/guides/claude-code-ssl-certificate-verification-failed): O Claude Code exibe isso quando um certificado vem de uma autoridade em que ele não confia.
- [“curl: (6) Could not resolve host” no Mac](https://kilobat.app/pt/guides/curl-could-not-resolve-host): O código de saída 6 do curl significa que ele não conseguiu obter um endereço para o nome do host.
- [Ajustes de proxy impedem apps de se conectar no Mac](https://kilobat.app/pt/guides/proxy-settings-breaking-apps): Um ajuste de proxy envia tráfego por outro servidor.
