SpyBara
Go Premium

network-config.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 44 additions and 44 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Tue 6 23:59 Thu 8 22:58 Sat 10 23:01 Wed 14 22:58 Sat 17 23:57 Mon 19 23:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Sat 24 22:59

Configuração de rede empresarial

Configure Claude Code para ambientes empresariais com servidores proxy, Autoridades de Certificação (CA) personalizadas e autenticação mútua de Transport Layer Security (mTLS).

Claude Code suporta várias configurações de rede e segurança empresariais através de variáveis de ambiente. Isso inclui rotear o tráfego através de servidores proxy corporativos, confiar em Autoridades de Certificação (CA) personalizadas e autenticar com certificados de Transport Layer Security (mTLS) mútuo para segurança aprimorada.

Defina essas variáveis de ambiente antes de iniciar Claude Code. As variáveis exportadas no seu shell são lidas uma vez na inicialização, portanto uma sessão em execução não detecta alterações posteriores no seu ambiente de shell.

[!NOTE]

Todas as variáveis de ambiente mostradas nesta página também podem ser configuradas em settings.json.

Configuração de proxy

Variáveis de ambiente

Claude Code respeita variáveis de ambiente de proxy padrão. Em sessões do Claude Desktop onde o aplicativo gerencia a conexão do provedor, Claude Code as lê apenas de configurações gerenciadas e ~/.claude/settings.json; consulte autenticação mTLS para as regras de escopo.

# Proxy HTTPS (recomendado)
export HTTPS_PROXY=https://proxy.example.com:8080

# Proxy HTTP (se HTTPS não estiver disponível)
export HTTP_PROXY=http://proxy.example.com:8080

# Ignorar proxy para solicitações específicas - formato separado por espaço
export NO_PROXY="localhost 192.168.1.1 example.com .example.com"
# Ignorar proxy para solicitações específicas - formato separado por vírgula
export NO_PROXY="localhost,192.168.1.1,example.com,.example.com"
# Ignorar proxy para todas as solicitações
export NO_PROXY="*"

Variantes em minúsculas também funcionam, e Claude Code usa a primeira que está definida na ordem https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY.

Claude Code nunca envia suas conexões WebSocket para localhost, ::1 ou 127.0.0.0/8 através do proxy, portanto você não precisa de uma entrada de loopback em NO_PROXY para elas.

[!NOTE]

Claude Code não suporta proxies SOCKS.

Autenticação básica

Se seu proxy exigir autenticação básica, inclua credenciais na URL do proxy:

export HTTPS_PROXY=http://username:password@proxy.example.com:8080

[!WARNING]

Evite codificar senhas em scripts. Use variáveis de ambiente ou armazenamento seguro de credenciais.

[!TIP]

Para proxies que exigem autenticação avançada (NTLM, Kerberos, etc.), considere usar um serviço LLM Gateway que suporte seu método de autenticação.

Armazenamento de certificados CA

Por padrão, Claude Code confia tanto em seus certificados CA Mozilla agrupados quanto no armazenamento de certificados do seu sistema operacional. Ler o armazenamento do SO requer um runtime com tls.getCACertificates: o instalador nativo sempre possui, e instalações npm precisam do Node 22.15 ou posterior. Em versões mais antigas do Node, apenas o conjunto agrupado e NODE_EXTRA_CA_CERTS se aplicam. Proxies de inspeção TLS empresariais funcionam sem configuração adicional quando seu certificado raiz é instalado no armazenamento de confiança do SO e o runtime pode lê-lo. Se um proxy desse tipo lidar incorretamente com corpos de requisição compactados com gzip, defina CLAUDE_CODE_GZIP_REQUEST_BODIES=0 para desativar a compactação nas requisições da Claude API, de telemetria e de publicação de artefatos.

CLAUDE_CODE_CERT_STORE aceita uma lista separada por vírgulas de fontes. Os valores reconhecidos são bundled para o conjunto de CA Mozilla enviado com Claude Code e system para o armazenamento de confiança do sistema operacional. O padrão é bundled,system.

Para confiar apenas no conjunto de CA Mozilla agrupado:

export CLAUDE_CODE_CERT_STORE=bundled

Para confiar apenas no armazenamento de certificados do SO:

export CLAUDE_CODE_CERT_STORE=system

[!NOTE]

CLAUDE_CODE_CERT_STORE não possui uma chave de esquema dedicada em settings.json. Defina-a através do bloco env em ~/.claude/settings.json ou diretamente no ambiente do processo.

Certificados CA personalizados

Se seu ambiente empresarial usa uma CA personalizada, configure Claude Code para confiar nela diretamente:

export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem

Autenticação mTLS

Para ambientes corporativos que exigem autenticação por certificado de cliente:

# Certificado de cliente para autenticação
export CLAUDE_CODE_CLIENT_CERT=/path/to/client-cert.pem

# Chave privada do cliente
export CLAUDE_CODE_CLIENT_KEY=/path/to/client-key.pem

# Opcional: Frase de acesso para chave privada criptografada
export CLAUDE_CODE_CLIENT_KEY_PASSPHRASE="your-passphrase"

Claude Code lê os arquivos de certificado e chave na inicialização e os relê cada vez que aplica configurações, como quando sua organização altera o bloco env em configurações gerenciadas no meio da sessão.

Para rotacionar o certificado e a chave, substitua os arquivos nos mesmos caminhos. Claude Code detecta a substituição em uma sessão em execução sem necessidade de reinicialização. Quando uma solicitação de API falha com um erro no nível de conexão, como uma redefinição de conexão ou um erro de handshake TLS, ele relê ambos os arquivos e tenta novamente a solicitação com o novo par. Antes da v2.1.232, Claude Code não relinha em erros de conexão, portanto mantinha o par que já havia carregado até aplicar configurações novamente ou você reiniciar.

Claude Code relê os arquivos em resposta a solicitações com falha, não observando-os para detectar alterações:

  • Tempo: Claude Code não faz nada no momento em que você substitui os arquivos. Ele apresenta o novo par na tentativa após uma falha qualificada, ou na próxima solicitação após aplicar configurações, o que vier primeiro.
  • Rejeições de gateway: Claude Code relê quando seu gateway redefine a conexão ou rejeita o handshake TLS depois de parar de aceitar o par antigo. Ele não relê quando o gateway conclui o handshake e responde com um erro HTTP. Nesse caso, Claude Code carrega o novo par quando aplica configurações novamente ou quando você o reinicia.
  • Rotações parcialmente gravadas: quando Claude Code relê enquanto sua rotação está no meio da gravação, como ler um certificado e chave que não correspondem um ao outro, ele mantém o par anterior e relê na próxima falha.
  • Exportadores de telemetria OTLP: Claude Code mantém o certificado que os exportadores carregaram no primeiro uso, portanto reinicie Claude Code para que um certificado rotacionado alcance seu coletor de telemetria.
  • Desativar o recarregamento: defina CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION=1 para desativar a releitura de erro de conexão. Claude Code então detecta arquivos rotacionados apenas quando aplica configurações novamente ou na próxima inicialização.

Para confirmar que Claude Code detectou uma rotação, inicie a sessão com registro de depuração e procure por Stale connection — reloaded rotated mTLS client material no log. Claude Code não registra essa linha quando detecta a rotação ao aplicar configurações, portanto uma linha ausente sozinha não significa que a rotação falhou.

Substitua os arquivos antes do par atual expirar para que Claude Code não carregue um par já expirado na próxima inicialização.

Em sessões na nuvem, o ambiente de hospedagem gerencia a conexão com a API, portanto Claude Code ignora as seguintes variáveis quando vêm de um bloco env do arquivo de configurações:

  • CLAUDE_CODE_CLIENT_CERT
  • CLAUDE_CODE_CLIENT_KEY
  • CLAUDE_CODE_CLIENT_KEY_PASSPHRASE
  • NODE_EXTRA_CA_CERTS
  • NODE_TLS_REJECT_UNAUTHORIZED
  • CLAUDE_CODE_OAUTH_SCOPES

Claude Code anota cada chave ignorada no log de depuração da sessão.

Em sessões do Claude Desktop onde o aplicativo gerencia a conexão do provedor, como a aba Code em um provedor de terceiros e sessões Cowork, Claude Code lê essas variáveis e as variáveis de proxy HTTP_PROXY, HTTPS_PROXY e NO_PROXY apenas de configurações gerenciadas e ~/.claude/settings.json: ele as ignora nos arquivos de configurações próprios de um repositório, portanto um repositório verificado não pode redirecionar o caminho TLS ou proxy de uma sessão cujas credenciais vêm do aplicativo. Em uma sessão local, SSH ou WSL Code tab conectada através de claude.ai, o aplicativo não gerencia a conexão, e Claude Code lê essas variáveis de cada escopo de configurações, como qualquer sessão de terminal; sessões na nuvem seguem as regras de sessão na nuvem acima onde quer que você as inicie. Antes da v2.1.217, Claude Code ignorava essas variáveis em todos os arquivos de configurações quando o aplicativo gerenciava a conexão.

Verificar sua configuração

Você geralmente descobre um endereço de proxy incorreto ou um caminho de certificado inválido a partir de um erro de conexão ou certificado em uma solicitação posterior, já que Claude Code não valida a maioria dessas configurações quando as lê. A única configuração que verifica na inicialização é a URL do proxy: quando não consegue analisar o valor, como um que está faltando o esquema http://, Claude Code interrompe o lançamento com um erro nomeando a variável a ser corrigida.

Para confirmar que sua configuração foi carregada antes de enviar uma solicitação, inicie Claude Code com registro de depuração:

claude --debug

A saída de depuração vai para ~/.claude/debug/<session-id>.txt em vez do terminal, ou para um caminho que você define com --debug-file <path>. No log, procure pelas linhas que confirmam que cada arquivo foi carregado:

CA certs: Appended extra certificates from NODE_EXTRA_CA_CERTS (/etc/ssl/certs/corp-ca.pem)
mTLS: Loaded client certificate from CLAUDE_CODE_CLIENT_CERT
mTLS: Loaded client key from CLAUDE_CODE_CLIENT_KEY

Se Claude Code não conseguir ler um desses arquivos, o log mostra uma linha Failed to read ou Failed to load com o motivo em vez disso.

Você também pode executar /status em uma sessão interativa e verificar estas linhas:

  • Proxy: mostra a URL do proxy ativo e marca um valor que não consegue analisar como inválido e ignorado.
  • mTLS client cert e mTLS client key: aparecem apenas quando os arquivos foram carregados, portanto uma linha ausente significa que o carregamento falhou e o log de depuração tem o motivo.
  • Additional CA cert(s): mostra o caminho NODE_EXTRA_CA_CERTS sem verificar se o arquivo foi carregado, portanto confirme este no log de depuração.

Aplicar configurações de rede a agentes em segundo plano

Agentes em segundo plano não são executados dentro do terminal que os despacharam. Um processo supervisor por usuário inicia sob demanda, sobrevive ao seu shell e hospeda cada sessão claude agents, --bg e /background. Veja Como as sessões em segundo plano são hospedadas. Isso muda como a configuração nesta página chega a essas sessões.

Defina variáveis de rede em configurações, não no shell

O supervisor é um processo compartilhado por cada terminal. Ele herda o ambiente de qualquer shell que o inicie primeiro. Se você exportar um proxy, caminho de CA ou variável mTLS apenas no seu shell, ele chega aos agentes em segundo plano quando esse shell aconteceu de iniciar a frio o supervisor, e silenciosamente não chega quando um shell diferente fez isso.

Coloque as mesmas variáveis no bloco env de ~/.claude/settings.json ou configurações gerenciadas. Cada variável nesta página pode ser definida lá, e as configurações são a única configuração que chega a cada sessão em segundo plano em cada máquina.

Configure um inicializador corporativo como uma configuração

Algumas organizações exigem que cada processo Claude Code inicie através de um inicializador corporativo que aplica sandboxing, controles de rede ou injeção de credenciais. O supervisor e seus workers iniciam Claude Code de um caminho fixo em vez de procurar claude em PATH, então cada agente em segundo plano ignora um wrapper que você coloca anteriormente em PATH.

Defina a configuração processWrapper para prefixar o supervisor, seus workers e os outros processos em segundo plano listados em O que o inicializador cobre com seu inicializador. A variável de ambiente equivalente CLAUDE_CODE_PROCESS_WRAPPER tem precedência quando ambas são definidas, e está sujeita à mesma regra: entregue-a através de configurações gerenciadas ou ~/.claude/settings.json, não uma exportação de shell. Execute Claude Code atrás de um inicializador corporativo cobre o contrato que o inicializador deve satisfazer, o que faz e não faz, e como implementá-lo.

[!NOTE]

Um supervisor já em execução mantém a configuração de inicialização com a qual foi iniciado. Após implantar a configuração do inicializador, execute claude daemon stop --any para que o próximo claude agents ou --bg inicie um supervisor que a honre.

Watchdogs de inatividade de streaming

Claude Code executa quatro temporizadores independentes que abortam uma resposta de modelo de streaming quando fica silenciosa, para que uma conexão morta falhe e tente novamente em vez de ficar pendurada. Uma requisição que não recebe nenhum cabeçalho de resposta termina de uma de duas maneiras:

  • Onde o prazo de primeiro byte é executado: a primeira tentativa termina no máximo nesse prazo. Para alterá-lo, defina CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS. Para a espera da nova tentativa, veja Nenhuma resposta da API.
  • Nas outras conexões: a requisição termina após 5 a 6 minutos, quando o timeout de inatividade do corpo dispara, a menos que você tenha desativado esse timeout. Para encerrá-la mais cedo, reduza API_TIMEOUT_MS. Em uma sessão do Claude apps gateway, você pode, em vez disso, encerrar a primeira tentativa mais cedo ativando o prazo de primeiro byte.
Timer Aborta quando Executa em Tempo limite padrão
Prazo de primeiro byte Nenhum cabeçalho de resposta chega após Claude Code enviar a requisição API Anthropic direta e Claude Platform on AWS, incluindo através de um proxy HTTPS, mas não quando ANTHROPIC_BASE_URL ou ANTHROPIC_AWS_BASE_URL as roteia através de um gateway. Opt-in para uma sessão do Claude apps gateway e no Amazon Bedrock com CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1; não executa no Agent Platform do Google Cloud ou no Microsoft Foundry 180 segundos na API Anthropic direta e 300 segundos no Claude Platform on AWS ou no Amazon Bedrock, mais um segundo por 32KB de corpo da requisição
Watchdog de nível de evento Nenhum evento de resposta é analisado. Onde o watchdog de nível de byte executa em uma conexão diferente do Amazon Bedrock, bytes chegando, incluindo pings de keep-alive, também redefinem este watchdog, por um tempo limitado sem um evento analisado. Esse tempo é de cerca de cinco minutos quando bytes chegam pelo menos a cada 10 segundos. Com os pings de 15 segundos de um Claude apps gateway, é de cerca de 7,5 minutos, então um stream só com pings termina após cerca de 12,5 minutos com o timeout padrão. Cada provedor 300 segundos
Watchdog de nível de byte Nenhum byte chega no fio, incluindo pings de keep-alive SSE API Anthropic direta, Claude Platform on AWS e conexões de gateway, incluindo um ANTHROPIC_BASE_URL customizado. Opt-in em respostas vnd.amazon.eventstream do Amazon Bedrock com CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1; não executa no Agent Platform do Google Cloud ou no Microsoft Foundry 180 segundos na API Anthropic direta. 300 segundos no Claude Platform on AWS, no Amazon Bedrock, em uma sessão do Claude apps gateway e através de um ANTHROPIC_BASE_URL customizado
Timeout de inatividade do corpo Nenhum byte chega por 5 minutos, contando a espera pelos cabeçalhos de resposta Provedores diferentes da API Anthropic direta, Claude Platform on AWS, e Amazon Bedrock com CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1 definido, a menos que API_FORCE_IDLE_TIMEOUT mude isso 5 minutos

Se você definir CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1, o watchdog de nível de byte substitui o tempo limite de inatividade do corpo no Bedrock em vez de executar junto com ele. CLAUDE_STREAM_IDLE_TIMEOUT_MS então também governa quanto tempo um stream Bedrock pode permanecer silencioso antes de Claude Code tratar a conexão como morta, dentro dos limites listados abaixo. Bytes chegando ainda não redefinem o watchdog de nível de evento no Bedrock. Com logging de debug ativado, cada stream Bedrock então registra uma mensagem de debug que começa com wire-heartbeat: _chunkTimes absent.

Configure os temporizadores com estas variáveis, cada uma detalhada na referência de variáveis de ambiente:

  • CLAUDE_ENABLE_STREAM_WATCHDOG e CLAUDE_ENABLE_BYTE_WATCHDOG forçam o watchdog correspondente ligado com 1 ou desligado com 0, dentro das conexões que a tabela lista; nenhuma variável estende um watchdog para um tipo de conexão que não cobre. CLAUDE_ENABLE_BYTE_WATCHDOG definido como 0 também desativa o prazo de primeiro byte.
  • CLAUDE_STREAM_IDLE_TIMEOUT_MS define o tempo limite de ambos os watchdogs. Claude Code aumenta valores abaixo de 5 minutos para 5 minutos, e limita o valor a 30 minutos para o watchdog de nível de byte.
  • CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS define o tempo limite do watchdog de nível de byte sem alterar o do watchdog de nível de evento, limitado entre 10 segundos e 30 minutos, e tem precedência sobre CLAUDE_STREAM_IDLE_TIMEOUT_MS para esse watchdog.
  • CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS define o prazo de primeiro byte. Em uma sessão do Claude apps gateway, defina esta variável para ativar o prazo. Se você deixar a variável não definida em outra conexão onde o prazo é executado, Claude Code usa o tempo limite do watchdog de nível de byte, então CLAUDE_STREAM_IDLE_TIMEOUT_MS e CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS também alteram o prazo. Para os limites do valor, veja Nenhuma resposta da API.
  • API_TIMEOUT_MS limita a espera pelos cabeçalhos de resposta, não quanto tempo uma resposta é transmitida depois deles. Onde o prazo de primeiro byte não é executado, defina API_TIMEOUT_MS como um valor positivo abaixo de 300000 para tentar novamente uma requisição sem resposta em menos de 5 minutos. Mantenha API_TIMEOUT_MS acima da espera mais longa por cabeçalhos, e da requisição sem streaming mais longa, que você espera: uma requisição que precisa de mais tempo atinge o timeout novamente a cada nova tentativa.
  • API_FORCE_IDLE_TIMEOUT definido como 0 desativa o tempo limite de inatividade do corpo, e definido como 1 o ativa para cada provedor. Os watchdogs executam independentemente dele, então para permitir que um stream pause mais tempo do que seus limites, também aumente ou desative-os.

Quando um watchdog aborta um stream travado, Claude Code trata o aborto como uma falha no meio do stream, e o que você vê depende de quão longe a resposta tinha chegado. Claude Code tenta novamente a solicitação ou encerra a rodada com um erro, mantém a saída concluída e mostra um aviso de resposta incompleta, ou encerra a rodada normalmente. Tentativas automáticas diz onde cada resultado se aplica.

Em uma sessão não interativa, e para a resposta de um subagente em qualquer sessão, Claude Code pode primeiro solicitar ao Claude que continue a resposta cortada; a entrada desse aviso diz quando faz isso e quando você ainda vê o aviso.

Quando o prazo de primeiro byte dispara, nenhuma resposta começou, então não há saída parcial para manter. Para como Claude Code reenvia a solicitação e quando a rodada termina em vez disso, veja Nenhuma resposta da API.

Requisitos de acesso à rede

Claude Code requer acesso aos seguintes URLs. Coloque-os na lista de permissões em sua configuração de proxy e regras de firewall, especialmente em ambientes de rede containerizados ou restritos. A verificação de conectividade de configuração de primeira execução aponta para aqui quando não consegue alcançar api.anthropic.com ou platform.claude.com; consulte Não é possível conectar aos serviços Anthropic para as mensagens da verificação e etapas de recuperação.

URL Necessário para
api.anthropic.com Solicitações da API Claude, incluindo a verificação de segurança de domínio do WebFetch, buscas de sinalizadores de recursos e registro de eventos de telemetria
claude.ai Autenticação de conta claude.ai
claude.com A entrada de conta claude.ai abre uma página claude.com no navegador, que redireciona para claude.ai; as buscas de documentação WebFetch pré-aprovadas também alcançam este host a partir da CLI
platform.claude.com Autenticação de conta do Anthropic Console. A troca, atualização e revogação de tokens OAuth também vão para este host para contas claude.ai, portanto, tanto as entradas do Console quanto do claude.ai o exigem
sso.claude.com Parte do fluxo de entrada pelo navegador para organizações que usam single sign-on (SSO). Se um proxy bloquear este host, essas entradas podem falhar
mcp-proxy.anthropic.com Conectores MCP do claude.ai, incluindo conectores que um administrador da organização configura. O tráfego do conector é roteado através deste proxy; os conectores são ativados por padrão para usuários autenticados no claude.ai. Para impedir que Claude Code os busque, defina ENABLE_CLAUDEAI_MCP_SERVERS=false ou a configuração disableClaudeAiConnectors
downloads.claude.ai Downloads de executáveis de plugins; instalador nativo, atualizador automático nativo e verificações de versão de atualização
storage.googleapis.com Contagens de instalação de plugins e metadados mostrados em /plugin
storage.googleapis.com Instalador nativo e atualizador automático nativo em versões anteriores a 2.1.116
registry.npmjs.org Instalações de plugins (buscando pacotes de plugins de origem npm e instalando dependências de pacotes Node.js de plugins), servidores MCP iniciados com npx e o registro de pacotes para instalações npm e bun do próprio Claude Code
bridge.claudeusercontent.com Ponte WebSocket da extensão Claude no Chrome
*.frame.claudeusercontent.com Leituras de conteúdo de Artifact. A CLI busca os arquivos de um artifact deste host quando Claude abre um, e apenas quando a ferramenta Artifact está disponível para sua conta. Para desativar a ferramenta e remover este requisito, defina "enableArtifact": false ou CLAUDE_CODE_DISABLE_ARTIFACT=1
github.com Clonagem de marketplaces de plugins e plugins hospedados no GitHub, incluindo o marketplace oficial da Anthropic, via HTTPS ou SSH. Para clonar fontes owner/repo do GitHub apenas via HTTPS, defina CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1
raw.githubusercontent.com Feed de changelog para /release-notes. Em sessões interativas, Claude Code também o busca em segundo plano na inicialização quando seu changelog em cache ainda não cobre a versão em execução, como na primeira inicialização após uma atualização; sessões não interativas e em nuvem nunca o buscam
*-review.googlesource.com Pesquisa de alteração Gerrit em checkouts googlesource.com. Quando uma sessão de guia Claude Desktop Code inicia ou retoma em um checkout confiável cujo origin é um host googlesource.com, Claude Code pergunta anonimamente ao servidor -review desse host pela alteração aberta correspondente ao Change-Id do HEAD, uma vez por inicialização ou retomada. Outros tipos de sessão pulam a pesquisa, e nenhum outro host Gerrit é contatado. Opcional: desabilite com CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC
http-intake.logs.us5.datadoghq.com Eventos de telemetria operacional, enviados apenas quando a CLI usa a API Anthropic diretamente, nunca para Amazon Bedrock, Agent Platform do Google Cloud ou Microsoft Foundry. Opcional: desabilite com DISABLE_TELEMETRY ou DO_NOT_TRACK
browser-intake-us5-datadoghq.com Relatórios de erros operacionais, enviados quando a CLI usa a API Anthropic diretamente e um portão de lançamento do lado do servidor os habilita. Opcional: desabilite com DISABLE_ERROR_REPORTING ou DISABLE_TELEMETRY; consulte Serviços de telemetria
formulae.brew.sh Verificações de versão de atualização em instalações do Homebrew. Outros métodos de instalação não contatam este host
code.claude.com Buscas de documentação do Claude Code pelo agente claude-code-guide integrado e solicitações WebFetch pré-aprovadas. Bloquear este host afeta apenas buscas de documentação

Se você instalar Claude Code através de npm ou gerenciar sua própria distribuição binária, os usuários finais não precisam dos usos do instalador nativo e atualizador automático de downloads.claude.ai, mas instalações npm e bun precisam de seu registro de pacotes, registry.npmjs.org, a menos que sua organização o espelhe. Os outros usos na tabela se aplicam independentemente do método de instalação.

Os dois hosts de ingestão do Datadog carregam apenas telemetria operacional opcional, e definir CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC desabilita ambos. Sessões em provedores de terceiros nunca enviam para esses hosts, mesmo quando uma plataforma define CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST e as métricas de telemetria são ativadas por padrão. Consulte Serviços de telemetria para tudo que Claude Code envia e como desabilitá-lo antes de finalizar sua lista de permissões.

Ao usar Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry ou uma sessão de gateway de aplicativos Claude conectada, o tráfego de modelo e autenticação vão para seu provedor ou gateway em vez de api.anthropic.com, claude.ai ou platform.claude.com. A ferramenta WebFetch ainda chama api.anthropic.com para sua verificação de segurança de domínio a menos que você defina skipWebFetchPreflight: true em configurações.

Ao rotear através de um gateway LLM com ANTHROPIC_BASE_URL, a verificação de disponibilidade do modo rápido ainda chama api.anthropic.com em vez da URL base do gateway. A verificação honra um proxy HTTP configurado, portanto, quando um bloqueio de rede é a causa, uma entrada de lista de permissões para api.anthropic.com no proxy é a solução. Um bloqueio de rede falha na verificação apenas quando o host é inacessível mesmo através do proxy, e o modo rápido então relata um erro de conectividade. O mesmo erro de conectividade aparece quando a verificação apresenta uma credencial emitida pelo gateway que Anthropic rejeita; a lista de permissões não ajuda lá, já que nada está bloqueado. Consulte usar modo rápido atrás de proxies e gateways LLM para as variáveis que o restauram.

Listas de permissões de IP da organização e saída de proxy

Se sua organização tiver lista de permissões de IP ativada para Claude, roteia bridge.claudeusercontent.com através da mesma saída de proxy que claude.ai e api.anthropic.com, por exemplo, colocando-o no mesmo segmento de aplicativo Zscaler ou política de direcionamento Netskope. Se você não conseguir roteá-lo dessa forma, adicione o endereço de saída que seu proxy usa para esse host à lista de permissões de IP da sua organização, mas apenas quando esse endereço for dedicado à sua organização: um intervalo de saída de proxy compartilhado também admite outros clientes do fornecedor de proxy.

Anthropic verifica conexões com bridge.claudeusercontent.com contra a lista de permissões de IP da sua organização usando o endereço de onde chegam. Se seu proxy enviar tráfego para esse host através de um endereço que não esteja nessa lista de permissões, Claude Code não conseguirá se conectar à extensão Claude no Chrome mesmo que o resto do Claude Code funcione.

Listas de permissões e firewalls do GitHub

Claude Code na web em ambientes hospedados pela Anthropic e Code Review se conectam aos seus repositórios a partir da infraestrutura gerenciada pela Anthropic; sessões em um ambiente auto-hospedado se conectam de dentro de sua rede, a menos que o executor opte pelo proxy git Anthropic, que busca do lado da Anthropic.

Se sua organização GitHub Enterprise Cloud restringe o acesso por endereço IP, ative herança de lista de permissões de IP para GitHub Apps instalados e também adicione uma entrada de lista de permissões para os endereços IP de saída da Anthropic. A herança cobre apenas as solicitações que o GitHub App Claude faz como uma instalação, não as solicitações que faz em nome de seus usuários. Para outros firewalls, consulte os endereços IP da API Anthropic.

Para instâncias GitHub Enterprise Server auto-hospedadas atrás de um firewall, coloque na lista de permissões os endereços IP de saída da Anthropic para que a infraestrutura Anthropic possa alcançar seu host GHES para clonar repositórios e postar comentários de revisão. Sessões em um ambiente auto-hospedado alcançam seu host GHES de dentro de sua rede, portanto essa exposição se aplica apenas a sessões hospedadas pela Anthropic, a fluxos pré-sessão hospedados, como o seletor de repositório, e a executores auto-hospedados que optam pelo proxy git Anthropic, que busca do lado da Anthropic. O conector SCM não está disponível, portanto os fluxos pré-sessão hospedados não conseguem alcançar um host GHES que é roteável apenas dentro de sua rede.

Desktop e claude.ai

A tabela anterior cobre a CLI autônoma. O aplicativo Claude Desktop e claude.ai em um navegador carregam seu código de aplicativo e conteúdo do usuário de hosts CDN Anthropic adicionais, incluindo assets-proxy.anthropic.com e as outras origens *.claudeusercontent.com que servem artifacts nesses aplicativos. Permitir claude.ai enquanto bloqueia esses hosts produz uma página em branco em vez de um erro. Consulte requisitos de acesso à rede na página Desktop.

Claude Desktop e claude.ai também renderizam alguns resultados de ferramentas dentro de uma conversa como widgets interativos, como os MCP Apps que alguns conectores fornecem. Esses widgets são carregados a partir de subdomínios gerados de claudemcpcontent.com, portanto permita *.claudemcpcontent.com com o curinga intacto. Se você bloqueá-lo, o restante do aplicativo continua funcionando, mas esses widgets não são carregados.

Hosts de terceiros para fontes e bibliotecas de artefatos

Um artifact que carrega uma fonte tipográfica do Google Fonts também solicita fonts.googleapis.com e fonts.gstatic.com. Ambos os hosts são opcionais. Se você bloqueá-los, os artifacts são renderizados em fontes tipográficas de fallback. Bloqueie com uma rejeição rápida em vez de uma queda silenciosa para que a solicitação de fonte falhe imediatamente em vez de atrasar a primeira renderização da página.

Os artifacts também podem carregar bibliotecas JavaScript, como React ou um pacote de gráficos, de cdnjs.cloudflare.com, cdn.jsdelivr.net, cdn.tailwindcss.com, code.jquery.com e unpkg.com, e de nenhum outro host externo. Se você bloquear esses hosts, as partes de um artifact que dependem de uma biblioteca não funcionam, e diferentemente de uma fonte bloqueada, uma biblioteca bloqueada não tem fallback. Bloqueie com uma rejeição rápida aqui também, para que uma solicitação de biblioteca bloqueada falhe imediatamente em vez de ficar pendurada até expirar.

Recursos adicionais