llm-gateway.md +0 −96 deleted
File Deleted View Diff
1> ## Documentation Index
2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
3> Use this file to discover all available pages before exploring further.
4
5# Gateways LLM
6
7> Rotear Claude Code através de um gateway LLM para autenticação centralizada, rastreamento de uso e controles de custo. Abrange conectar Claude Code a um gateway, implantar um para sua organização, o que Claude Code envia a um gateway e como gateways interagem com assinaturas claude.ai.
8
9Um gateway LLM é um proxy que sua organização executa entre Claude Code e um provedor de modelo. Claude Code envia tráfego de API para o gateway, e o gateway o encaminha para o provedor usando uma credencial que sua organização controla.
10
11<Note>
12 * Se você é um desenvolvedor conectando a um gateway existente: [conectar Claude Code ao seu gateway](/pt/llm-gateway-connect)
13 * Se você é um administrador implantando um gateway para sua organização: [implantar e distribuir um gateway](/pt/llm-gateway-rollout)
14 * Se você está configurando um produto gateway: a [referência de protocolo de gateway](/pt/llm-gateway-protocol)
15</Note>
16
17<h2 id="what-a-gateway-provides">
18 O que um gateway fornece
19</h2>
20
21Um gateway oferece à sua organização um único lugar para gerenciar:
22
23* **Credenciais**: a chave do provedor fica no lado do servidor; desenvolvedores mantêm credenciais de gateway em vez disso
24* **Rastreamento de uso**: atribua uso por desenvolvedor ou equipe, independentemente de qual provedor atende a solicitação
25* **Controles de custo**: aplique orçamentos e limites de taxa em um único lugar
26* **Registro de auditoria**: registre cada solicitação de modelo para conformidade
27* **Alternância de provedor**: altere o provedor na configuração do gateway, sem tocar nas máquinas dos desenvolvedores
28
29Todos esses, exceto alternância de provedor, se aplicam se o upstream é a API da Anthropic ou um [provedor de nuvem](/pt/third-party-integrations).
30
31O tradeoff é que o gateway se torna infraestrutura que sua organização opera. Claude Code adiciona capacidades com cada lançamento, e um gateway que não as encaminha quebra os recursos correspondentes, então o produto gateway precisa ser mantido atualizado conforme Claude Code evolui. A [referência de protocolo de gateway](/pt/llm-gateway-protocol) aborda o que encaminhar.
32
33<h2 id="how-a-gateway-works">
34 Como um gateway funciona
35</h2>
36
37Por padrão, Claude Code envia solicitações diretamente para a API da Anthropic em `api.anthropic.com`. Para rotear através de um gateway, defina `ANTHROPIC_BASE_URL` para o endereço do gateway; Claude Code envia as mesmas solicitações lá em vez disso. O gateway autentica o desenvolvedor, anexa a credencial do provedor de sua organização e encaminha cada solicitação para qualquer provedor para o qual esteja configurado.
38
39`ANTHROPIC_BASE_URL` é a variável de endereço para a maioria dos gateways. Um gateway que fronts um provedor de nuvem específico, como Bedrock, Vertex, Foundry ou Claude Platform on AWS, usa a variável de URL base desse provedor em vez disso; [Formatos de API](/pt/llm-gateway-protocol#api-formats) lista qual variável vai com cada configuração.
40
41<Frame>
42 <img src="https://mintcdn.com/claude-code/-uq-4JE0W_JO5Er5/images/llm-gateway-flow.svg?fit=max&auto=format&n=-uq-4JE0W_JO5Er5&q=85&s=1c1a8dcc0cfcc3a58652cc8e28cd3e20" alt="Diagrama mostrando Claude Code roteando através de um gateway LLM. Em uma zona de máquinas de desenvolvedor, o CLI Claude Code, extensão VS Code e clientes SDK de CI ou Agent enviam solicitações para o gateway, com a variável de URL base para o formato de API do gateway apontando para ele e cada desenvolvedor mantendo uma credencial por desenvolvedor, e o aplicativo desktop alcança o mesmo gateway através de configuração distribuída pela organização. Em uma zona rotulada sua infraestrutura, o gateway LLM lida com autenticação, rastreamento de uso, orçamentos e roteamento, e encaminha solicitações com a credencial de sua organização. Em uma zona de provedores de modelo, uma seta sólida leva ao provedor que você configura, mostrado como a API Anthropic, e setas tracejadas levam a outras opções de provedor, ilustradas com Amazon Bedrock, Google Vertex AI e Microsoft Foundry como exemplos." width="780" height="322" data-path="images/llm-gateway-flow.svg" />
43</Frame>
44
45Dois tipos de credencial estão envolvidos:
46
47* **Credenciais de desenvolvedor**: cada desenvolvedor mantém a sua própria, emitida pelo gateway. Ela os autentica no gateway e os identifica no rastreamento de uso
48* **Credencial do provedor**: o gateway mantém uma credencial para sua conta de provedor, compartilhada por todo o tráfego encaminhado. Você não provisiona chaves de provedor por desenvolvedor
49
50O gateway encaminha cada solicitação para o provedor que você configura, como a API Anthropic, [Amazon Bedrock](/pt/amazon-bedrock), [Google Vertex AI](/pt/google-vertex-ai), [Microsoft Foundry](/pt/microsoft-foundry) ou [Claude Platform on AWS](/pt/claude-platform-on-aws). Como Claude Code fala apenas com o gateway, a escolha do provedor é a configuração do gateway, não a do cliente.
51
52<h2 id="roll-out-a-gateway">
53 Implantar um gateway
54</h2>
55
56Quando você estiver pronto para implantar um gateway LLM para sua organização, a sequência é a mesma qualquer que seja o produto gateway que você escolha:
57
581. Implante o gateway e dê a ele sua credencial de provedor, para que ele possa autenticar as solicitações que encaminha.
592. Emita a cada desenvolvedor uma credencial de gateway, para que o uso seja atribuído ao desenvolvedor e o offboarding revogue uma credencial.
603. Distribua a configuração através de um [arquivo de configurações gerenciadas](/pt/settings#settings-files) e sua ferramenta de segredos, para que cada máquina receba a URL base e uma credencial. Quando ambos forem distribuídos, os desenvolvedores não configuram nada. Se você não tiver distribuição de configurações em vigor, os desenvolvedores seguem a [página de conexão](/pt/llm-gateway-connect) para definir as variáveis eles mesmos.
614. Faça cada desenvolvedor [verificar a configuração no Claude Code](/pt/llm-gateway-connect#check-for-an-existing-configuration), para que problemas de distribuição apareçam antes de dependerem do gateway.
62
63[Implantar um gateway LLM para sua organização](/pt/llm-gateway-rollout) percorre cada passo e mostra os arquivos de configuração para distribuir em cada um. O gateway é uma parte da configuração da organização; para aplicação de política, visibilidade de uso e decisões de tratamento de dados, veja [Configurar Claude Code para sua organização](/pt/admin-setup).
64
65<h2 id="third-party-gateways">
66 Gateways de terceiros
67</h2>
68
69Qualquer gateway que exponha um [formato de API suportado](/pt/llm-gateway-protocol#api-formats) funciona. Anthropic não endossa, mantém ou audita produtos gateway de terceiros. Implante-os seguindo sua própria documentação, então complete o lado Claude Code do rollout com os [passos de rollout](/pt/llm-gateway-rollout).
70
71<h2 id="subscriptions-and-gateways">
72 Assinaturas e gateways
73</h2>
74
75Enquanto uma [variável de credencial de gateway](/pt/llm-gateway-connect#set-the-credential-variable) ou `apiKeyHelper` está ativa, a assinatura claude.ai de um desenvolvedor não é usada: a credencial substitui o login da assinatura para essa sessão, e os limites de uso da assinatura não se aplicam. Esse tráfego é cobrado por token para quem quer que possua a credencial que o gateway encaminha, como sua conta Anthropic Console da organização, ou sua conta Bedrock, Vertex ou Foundry quando o gateway roteia para lá.
76
77Definir apenas `ANTHROPIC_BASE_URL`, sem uma credencial de gateway, não substitui a assinatura. As solicitações ainda roteiam através do gateway, mas um login claude.ai salvo permanece como a credencial ativa, então seus limites de uso e cobrança se aplicam. Gateways que passam esse tráfego para Anthropic devem encaminhar a capacidade OAuth em `anthropic-beta`; veja a [referência de cabeçalhos de solicitação](/pt/llm-gateway-protocol#request-headers).
78
79<h2 id="configure-separately-from-the-gateway">
80 Configurar separadamente do gateway
81</h2>
82
83Um gateway determina para onde as solicitações de API de modelo são enviadas. Seleção de modelo, o resto do tráfego de rede do Claude Code e proxies corporativos são configurados separadamente:
84
85* **Seleção de modelo**: a URL base decide para onde as solicitações vão, não qual modelo as responde. Escolha o modelo com o comando `/model` ou as variáveis de ambiente de modelo; veja [como definir seu modelo](/pt/model-config#setting-your-model)
86* **Tráfego do lado do cliente**: verificações de versão e telemetria de cliente opcional, ambas desabilitadas com [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/pt/env-vars), e tráfego de login quando um login claude.ai ou Console está em uso, vão para os endpoints de atualização e autenticação da Anthropic em vez do gateway. Veja [requisitos de acesso à rede](/pt/network-config#network-access-requirements) para os domínios
87* **Proxies corporativos**: um proxy definido com `HTTPS_PROXY` fica entre Claude Code e cada servidor com o qual ele fala, incluindo o gateway. Se sua rede requer um proxy, configure ambos; veja [configuração de proxy](/pt/network-config#proxy-configuration)
88
89<h2 id="related-pages">
90 Páginas relacionadas
91</h2>
92
93* [Conectar Claude Code a um gateway LLM](/pt/llm-gateway-connect): defina a URL base e credencial em sua própria máquina, com configuração por superfície e uma tabela de solução de problemas
94* [Implantar um gateway LLM para sua organização](/pt/llm-gateway-rollout): a lista de verificação do administrador para implantar um gateway, emitir credenciais de desenvolvedor e distribuir configurações gerenciadas
95* [Referência de protocolo de gateway](/pt/llm-gateway-protocol): o que Claude Code envia a um gateway, para operadores configurando um, abrangendo endpoints, cabeçalhos para encaminhar e passagem de recursos
96* [Configurar Claude Code para sua organização](/pt/admin-setup): as decisões de rollout mais amplas das quais um gateway é uma parte, incluindo aplicação de política e visibilidade de uso