Use o Claude Code pelo AI Gateway

Faça o Claude Code, no VS Code ou no terminal, passar pelo WASViking AI Gateway com a chave de API da Anthropic da sua organização, uma chave do gateway por desenvolvedor e um gateway preparado para assistentes de código.

O Claude Code pode enviar as requisições de modelo pelo WASViking^® AI Gateway. Assim as suas políticas valem para o que os desenvolvedores enviam, orçamentos e limites de taxa cobrem o uso, e o registro de requisições mostra cada requisição com o desenvolvedor que a fez.

Antes de começar

• Cobrança. As requisições por este gateway usam a chave de API da Anthropic da sua organização e são cobradas por token nessa conta da Anthropic. Para desenvolvedores em vagas Claude Team ou Enterprise, que mantêm o próprio login do Claude, veja Proteja o Claude Code nas vagas do Claude.
• Uma chave de API da Anthropic, criada no Anthropic Console.
• O AI Gateway ligado, como em Proteja chamadas a APIs de modelos.
• O Claude Code nos computadores dos desenvolvedores, no VS Code ou no terminal.

Passo 1: adicione a credencial da Anthropic

Em Providers & Models, selecione Add credential, escolha Anthropic como provedor, cole a chave de API da Anthropic e salve. Selecione Test na nova linha: o provedor deve aceitar a chave.

Passo 2: crie um gateway para o assistente de código

Em Workloads, selecione New gateway e preencha:

O que a opção Coding assistant muda nesse gateway:

• Um segredo encontrado num arquivo que o Claude Code lê, numa mensagem anterior ou no prompt de sistema é trocado por um marcador como [REDACTED:AWS_KEYS] antes de a requisição sair, e a sessão continua.
• O que o desenvolvedor digita na mensagem mais nova segue as suas políticas, então um segredo digitado num prompt continua recusado quando a sua política bloqueia segredos.
• Código não é tratado como dado sensível, porque é com ele que um assistente de código trabalha.

Passo 3: adicione uma rota

Em Routing & Failover, adicione uma rota para o gateway com os modelos claude-*, a credencial da Anthropic e a função Primary.

Passo 4: crie uma chave por desenvolvedor

Em Access & Keys, crie uma chave para cada desenvolvedor e escolha o desenvolvedor em Belongs to. O registro de requisições, os orçamentos e os alertas passam a mostrar quem fez cada requisição, e revogar uma chave afeta só aquele desenvolvedor.

Passo 5: aponte o Claude Code para o gateway

O endereço do gateway para o Claude Code é a URL base de Anthropic SDKs na aba Integrations, como https://api.wasviking.com/ai-gateway/anthropic.

No VS Code, execute Preferences: Open User Settings (JSON) e adicione:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.wasviking.com/ai-gateway/anthropic" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "wvag_the-developer-key" },
    { "name": "CLAUDE_CODE_GATEWAY_HINT_HEADERS", "value": "1" }
  ]
}

No terminal, adicione os mesmos valores em ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.wasviking.com/ai-gateway/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "wvag_the-developer-key",
    "CLAUDE_CODE_GATEWAY_HINT_HEADERS": "1"
  }
}

CLAUDE_CODE_GATEWAY_HINT_HEADERS faz o Claude Code indicar quais requisições levam o que o desenvolvedor digitou. O Claude Code também envia requisições próprias, como as verificações de segurança do modo automático, que repetem mensagens anteriores: com essa variável, o gateway mascara um segredo nelas em vez de recusá-las.

Para configurar uma equipe inteira, o seu time de TI pode distribuir os mesmos valores pelas configurações gerenciadas do Claude Code e definir allowedProviders como ["customEndpoint"], para que o Claude Code só funcione pelo gateway.

Passo 6: confira a conexão

No Claude Code, execute /status. A linha Anthropic base URL mostra o endereço do gateway e a linha Auth token cita ANTHROPIC_AUTH_TOKEN. Envie uma mensagem: ela aparece em Traffic com o nome do desenvolvedor.

Políticas que combinam com um gateway de assistente de código

• Segredos nos prompts: Bloquear. Vale para o que o desenvolvedor digita; os segredos em arquivos são mascarados pelo gateway.
• Dados pessoais: Somente auditoria. O Claude Code envia o e-mail do próprio desenvolvedor em cada requisição, e ocultá-lo reescreve todas as requisições.
• Injeção de prompt: Bloquear.
• Código-fonte: não é necessário. Código não conta como dado sensível nesse gateway.

Limites que vale conhecer

• Um gateway que usa chaves do gateway não aceita o login de uma assinatura do Claude. Sem ANTHROPIC_AUTH_TOKEN com uma chave do gateway, as requisições são recusadas com 401.
• Recursos do Claude Code que exigem login no claude.ai, como Remote Control e ditado por voz, não ficam disponíveis enquanto houver uma chave do gateway.
• O /context mostra contagens aproximadas de tokens, e o seletor /model mostra os modelos que já vêm no Claude Code.

Solução de problemas