Proteja o Claude Code nas vagas do Claude
Faça o Claude Code usado com as vagas Claude Team ou Enterprise da sua empresa passar pelo WASViking AI Gateway, sem chave de API. Cada desenvolvedor mantém o próprio login e a vaga do Claude; as suas políticas, o mascaramento de segredos e o registro de requisições valem para cada requisição.
Desenvolvedores que usam o Claude Code com as vagas Claude Team ou Enterprise da sua empresa podem trabalhar pelo WASViking® AI Gateway sem chave de API. Cada desenvolvedor mantém o próprio login e a vaga do Claude, e o gateway repassa esse login à Anthropic. No caminho, as suas políticas valem para o que o desenvolvedor envia, segredos em arquivos que o Claude Code lê são mascarados, e cada requisição é registrada com a pessoa que a fez.
O gateway nunca guarda o login do Claude do desenvolvedor, nunca o registra e nunca o exibe.
Para experimentar num computador antes de distribuir, faça os Passos 1 a 3 abaixo e depois siga Teste o Claude Code nas vagas do Claude no VS Code.
Este guia usa os nomes do portal em português. As imagens mostram o portal em inglês, onde Proteção é Protection, Cargas de trabalho é Workloads, Novo gateway é New gateway, Políticas é Policies, Integrações é Integrations, Acesso e chaves é Access & Keys e Tráfego é Traffic.
Como funciona
- Cada desenvolvedor faz login no Claude Code com a conta Claude da empresa, como hoje. O gateway repassa esse login à Anthropic, então cada requisição usa a vaga do próprio desenvolvedor.
- O arquivo de configurações gerenciadas que você distribui aponta o Claude Code para o gateway e leva uma chave da organização. A chave diz ao gateway qual carga de trabalho se aplica; ela não é uma credencial da Anthropic.
- A telemetria do próprio Claude Code informa ao gateway quem está em cada sessão e em qual organização do Claude a pessoa fez login. Sessões de qualquer outra organização do Claude são recusadas.
Antes de começar
- Uma organização Claude Team ou Enterprise e o ID da organização.
- Gestão de dispositivos (MDM) ou outra forma de colocar um arquivo nos computadores dos desenvolvedores. Configurações enviadas pelo console de administração do Claude não chegam a sessões que passam por um gateway, então este modo usa um arquivo de configurações gerenciadas.
- O AI Gateway ligado, como em Proteja chamadas a APIs de modelos.
- Claude Code 2.1.273 ou mais recente nos computadores dos desenvolvedores, no VS Code ou no terminal.
Passo 1: crie o gateway
Em AI Guard, Proteção, AI Gateway, abra Cargas de trabalho e selecione Novo gateway. Preencha o formulário como abaixo; a coluna de exemplo corresponde à imagem.
| Campo | O que preencher | Exemplo |
|---|---|---|
| Nome | Um nome que o time reconheça. | Claude Code Engineering |
| Identificador | Nome curto usado nas condições das políticas e no registro de requisições. | claude-code-engineering |
| Ambiente | Onde os desenvolvedores trabalham. | Produção |
| Responsável | A pessoa responsável pelo gateway. | Eu |
| Inspeção da entrada | Inspecionar e aplicar a política, para que as suas políticas decidam. Inspecionar e registrar só registra o que elas fariam, o que serve para uma primeira semana de observação. | Inspecionar e aplicar a política |
| Inspeção da resposta | Transmitir e monitorar. O Claude Code lê as respostas enquanto chegam; este modo já define isso. | Transmitir e monitorar |
| Quando a política não pode ser avaliada | Negar quando a política não pode ser avaliada nunca deixa passar uma requisição sem verificação. Permitir e registrar como degradado mantém os desenvolvedores trabalhando durante um incidente e marca essas requisições. | Negar quando a política não pode ser avaliada |
| Autenticação | Login da assinatura Claude (Claude Code em vagas Team ou Enterprise). | O mesmo |
| IDs da organização no Claude | O ID da sua organização no Claude. Adicione mais de um se a empresa tiver várias. | 7c1e9a42-5b3d-4f8e-a6c2-0d9b4e17f3a5 |
| Assistente de código (Claude Code e similares) | Marcado e travado por esta autenticação. | Marcado |
| Requisições por minuto por chave | Neste modo, conta por sessão do Claude Code. Deixe vazio para não limitar, ou defina um teto. | 60 |
| Limite de tamanho da requisição (KB) | 4096. O Claude Code envia conversas longas, e um limite menor as recusa. |
4096 |
| Orçamento diário (USD), Orçamento mensal (USD) | Deixe vazio. O uso é cobrado por vaga, então orçamentos em dólar não se aplicam. | Vazio |
| Modelos permitidos | claude-* |
claude-* |
| Modelos negados | Modelos que você não quer que sejam usados, por exemplo claude-opus-* para manter o time no Sonnet. Sempre vale sobre a lista de permitidos. |
Vazio |
| Descrição | Opcional. | Claude Code on the engineering team's Claude Enterprise seats |
Selecione Salvar gateway.
AI Gateway, Cargas de trabalho, Novo gateway, preenchido para o Claude Code nas vagas do Claude.
Onde encontrar o ID da organização. Numa organização Claude Team ou
Enterprise, um proprietário ou administrador encontra o ID no claude.ai em
Admin settings, Organization (https://claude.ai/admin-settings/organization).
Para uma conta Claude pessoal, ou se você não tiver o ID em mãos, salve o gateway com qualquer ID e envie uma mensagem do Claude Code por ele: a linha em Cargas de trabalho lista as organizações do Claude cujas sessões chegaram, marcadas como aceitas ou recusadas. Edite o gateway e adicione a sua. O ? ao lado de cada campo do formulário também explica.
Depois da primeira sessão, a linha mostra as organizações do Claude vistas.
Passo 2: escolha as políticas
As políticas decidem o que acontece com o que os desenvolvedores enviam. Na página do AI Gateway, selecione Políticas e depois Modelos de política, e use os modelos do AI Gateway abaixo. Usar este modelo abre o editor já preenchido, em Somente auditoria. Mude para Aplicar quando as ocorrências fizerem sentido e selecione Salvar política. Para limitar uma regra a este gateway, restrinja ao gateway no editor.
| Modelo | O que os desenvolvedores veem | Recomendação |
|---|---|---|
| Bloquear segredos nas perguntas | Uma chave ou senha digitada numa mensagem é recusada com API Error: 400 e a mensagem da regra, "Não envie chaves ou senhas para o modelo." Segredos em arquivos que o Claude Code lê, e em mensagens anteriores, são mascarados pelo gateway, então a sessão continua. |
Aplicar. |
| Ocultar dados pessoais nas perguntas | Dados pessoais como e-mails e CPF chegam à Anthropic como marcadores, por exemplo [REDACTED:CPF]. O Claude Code envia o e-mail do próprio desenvolvedor em toda requisição, então com esta regra toda requisição é reescrita. |
Aplicar para mascarar dados pessoais, ou Somente auditoria para registrar sem mudar as requisições. |
| Barrar injeção de prompt | Tentativas de passar por cima das instruções do modelo são recusadas. | Aplicar. |
| Reter respostas com segredo, Ocultar dados pessoais nas respostas | As respostas chegam ao Claude Code enquanto são transmitidas, então estas regras registram o que encontram sem segurar a resposta. | Opcional, para registro. |
Código-fonte não conta como dado sensível neste gateway, então nenhuma regra é necessária para ele.
Passo 3: gere o arquivo de configurações gerenciadas
Em Integrações, em Claude Code em vagas Claude Team ou Enterprise, selecione Gerar o arquivo de configurações gerenciadas ao lado do gateway. O arquivo é exibido uma única vez: ele leva uma nova chave da organização para este gateway. Selecione Copiar e guarde o arquivo como uma senha até ele estar no lugar.
O arquivo é exibido uma única vez. A chave da imagem é um exemplo.
O que cada entrada faz:
| Entrada | O que faz |
|---|---|
ANTHROPIC_BASE_URL |
Envia as requisições do Claude Code ao gateway. |
ANTHROPIC_CUSTOM_HEADERS |
Leva a chave da organização no cabeçalho x-wasviking-gateway-key. |
CLAUDE_CODE_ENABLE_TELEMETRY e as entradas OTEL_ |
Enviam a telemetria do Claude Code ao gateway, que informa quem está em cada sessão. |
CLAUDE_CODE_GATEWAY_HINT_HEADERS |
Faz o Claude Code indicar quais requisições levam o que o desenvolvedor digitou. Nas requisições próprias do Claude Code, como as verificações de segurança do modo automático e os títulos das conversas, um segredo é mascarado em vez de recusado. |
forceLoginMethod, forceLoginOrgUUID |
O Claude Code só aceita login na sua organização do Claude. |
allowedProviders |
Definido como ["customEndpoint"], para que o Claude Code só funcione pelo gateway. |
Em Acesso e chaves, a chave aparece com o rótulo claude-code- seguido do
identificador do gateway e pertence a Claude Code (organization). Para
cortar um arquivo, revogue a chave ali e gere um arquivo novo.
O mesmo resultado mostra o bloco Para testar no VS Code em um computador, usado em Teste o Claude Code nas vagas do Claude no VS Code.
Passo 4: distribua o arquivo
Salve o arquivo como managed-settings.json no diretório do sistema de cada
computador dos desenvolvedores, com a sua gestão de dispositivos:
| Sistema | Local |
|---|---|
| macOS | /Library/Application Support/ClaudeCode/managed-settings.json |
| Linux e WSL | /etc/claude-code/managed-settings.json |
| Windows | C:\Program Files\ClaudeCode\managed-settings.json |
Se você já entrega outro arquivo de configurações gerenciadas, coloque este
como um arquivo separado no diretório managed-settings.d ao lado dele.
Os desenvolvedores fazem login no Claude Code com a conta Claude da empresa, como hoje. Nada mais muda para eles.
Passo 5: confira
- Um desenvolvedor envia uma mensagem no Claude Code. No terminal,
/statusmostra o endereço do gateway na linha Anthropic base URL. - Em Cargas de trabalho, a linha do gateway lista a sua organização do Claude como aceita.
- Em Tráfego, a requisição mostra o e-mail do desenvolvedor, as marcas stream e assinatura, e pela vaga na coluna de custo. Selecione uma linha para ver a decisão, a regra e o que foi encontrado.
Tráfego do gateway. A linha bloqueada é uma mensagem com uma chave; as linhas seguintes continuaram com a chave mascarada.
Detalhe da requisição. O gateway guarda só metadados, nunca perguntas ou respostas.
O que os desenvolvedores veem
| Situação | No Claude Code | Em Tráfego |
|---|---|---|
| Uma mensagem com chave ou senha | API Error: 400 com a mensagem da regra. Nada chega à Anthropic. O desenvolvedor tira o dado e envia de novo. |
Bloqueado, status 400. |
| Um arquivo com segredo que o Claude Code lê | A resposta mostra um marcador como [REDACTED:AWS_KEYS]. A sessão continua. |
1 segredo mascarado. |
| A mensagem logo depois de uma recusa | O Claude Code reenvia a mensagem recusada junto com a nova, então o Claude pode comentar as duas. Ele só vê o marcador. | Segredos mascarados. |
| Dados pessoais, com a regra de ocultar em Aplicar | Um marcador como [REDACTED:CPF]. Um número com dígitos verificadores inválidos não é CPF e passa como foi digitado. |
Ocultado. |
| Modo automático | Os comandos continuam rodando depois de uma recusa. | As verificações de segurança do próprio Claude Code, quando ele as faz, aparecem como linhas separadas, sem a marca stream. |
| A primeira mensagem de uma conversa | Nada diferente. | Duas linhas: a segunda dá nome à conversa. |
Limites a conhecer
- O app de desktop do Claude, o Remote Control e as sessões do Claude Code na nuvem ou no Slack não passam pelo gateway.
- Uma sessão cuja organização do Claude não está no gateway, ou que não pode ser identificada alguns segundos depois de começar, é recusada.
- Para decidir também cada ação que o Claude Code toma (comandos, leitura de arquivos, ferramentas), adicione o Assistant Guard.
Solução de problemas
| O que você vê | Por quê | O que fazer |
|---|---|---|
| "This Claude Code session is not identified as your organization's Claude account" | A organização do Claude da sessão não está no gateway, ou a telemetria dela não chegou à WASViking. | Confira as Organizações do Claude vistas em Cargas de trabalho; adicione o ID da sua organização; libere o endereço do gateway na sua rede. |
| Recusada como não identificada, embora a organização esteja no gateway | As configurações foram colocadas na pasta .claude do projeto, de onde o Claude Code não aceita a telemetria. |
Use o arquivo de configurações gerenciadas ou, num computador, o bloco do VS Code de Integrações. |
| "Sign in to Claude Code with your company Claude account" | O Claude Code está sem login do Claude ou usa uma chave. | Execute /login com a conta Claude da empresa e remova ANTHROPIC_API_KEY ou ANTHROPIC_AUTH_TOKEN. |
| "This gateway is not set up for Claude subscription sign-in" | O arquivo leva a chave de um gateway que usa chaves do gateway. | Gere o arquivo a partir de um gateway com o login da assinatura Claude. |
/status não mostra o endereço do gateway |
O arquivo não está no diretório do sistema, ou o Claude Code abriu antes de ele chegar. | Confira o local do Passo 4 e abra o Claude Code de novo. |
| "The model ... is not allowed on this gateway" | O modelo não está em Modelos permitidos, ou está em Modelos negados. | Adicione claude-* em Modelos permitidos. |
| "The request exceeds the gateway size limit" | A conversa passou do limite de tamanho. | Aumente Limite de tamanho da requisição (KB) para 4096, ou execute /compact no Claude Code. |
| No modo automático um comando não roda: "temporarily unavailable, so auto mode cannot determine the safety" | Um segredo digitado antes na conversa chega de novo ao gateway na verificação de segurança do modo automático, e as configurações foram geradas antes da inclusão de CLAUDE_CODE_GATEWAY_HINT_HEADERS. |
Gere o arquivo de novo, ou adicione CLAUDE_CODE_GATEWAY_HINT_HEADERS com o valor 1; ou comece uma conversa nova. |
API Error: 400 com a mensagem da sua política |
O desenvolvedor digitou algo que a sua política bloqueia, como um segredo. | Tire isso da mensagem e envie de novo. |