WASViking Docs
⌘K
WASViking AI GuardianPrimeiros passos

Teste o Claude Code nas vagas do Claude no VS Code

Experimente o modo de assinatura Claude do WASViking AI Gateway num computador antes de distribuir o arquivo de configurações gerenciadas. Um perfil separado do VS Code, as configurações para colar e seis testes com o que esperar no Claude Code e em Tráfego.

Antes de distribuir o arquivo de configurações gerenciadas para o time inteiro, você pode experimentar o WASViking® AI Gateway com o Claude Code num computador. Este guia usa um perfil separado do VS Code, para que só aquela janela passe pelo gateway, e termina com seis testes que mostram o que os desenvolvedores vão ver.

Este guia usa os nomes do portal em português. A imagem mostra o portal em inglês, onde Integrações é Integrations, Tráfego é Traffic, Cargas de trabalho é Workloads e Acesso e chaves é Access & Keys.

Antes de começar

  • Um gateway com o login da assinatura Claude e as políticas dos Passos 1 e 2 de Proteja o Claude Code nas vagas do Claude.
  • O VS Code no computador e uma conta Claude da sua organização.
  • Para testar com uma conta Claude pessoal, salve o gateway com qualquer ID de organização, envie o primeiro teste do Passo 5, adicione o ID que a linha do gateway em Cargas de trabalho lista como recusado e envie de novo.
  • Só dados de teste. Os exemplos usam AKIAIOSFODNN7EXAMPLE, a chave de acesso de exemplo da própria documentação da AWS. Nunca use uma chave real ou dados de uma pessoa real num teste.

Passo 1: copie o bloco do VS Code

Em Integrações, em Claude Code em vagas Claude Team ou Enterprise, selecione Gerar o arquivo de configurações gerenciadas ao lado do gateway. Abaixo do arquivo, o resultado mostra Para testar no VS Code em um computador: as mesmas configurações no formato do VS Code. Selecione Copiar ao lado desse bloco.

O bloco Para testar no VS Code em um computador, com a entrada claudeCode.environmentVariables A chave da imagem é um exemplo. A sua é exibida uma única vez.

O bloco leva a chave da organização. Guarde-o como uma senha e revogue a chave quando terminar (Passo 7).

Passo 2: abra um perfil separado do VS Code

As configurações de um perfil valem para todas as sessões do Claude Code daquela janela. Um perfil separado mantém o seu VS Code de sempre como está.

  1. No VS Code, selecione File, New Window with Profile, New Profile.
  2. Dê um nome, por exemplo WASViking gateway test, e selecione Create. Uma janela nova abre com esse perfil.
  3. Nessa janela, abra Extensions, procure Claude Code e instale a extensão publicada pela Anthropic, se ela ainda não estiver lá.

Passo 3: cole as configurações

  1. Na janela nova, abra a Command Palette: Cmd+Shift+P no macOS, Ctrl+Shift+P no Windows e no Linux.
  2. Execute Preferences: Open User Settings (JSON).
  3. Cole o bloco dentro das chaves externas. Se já houver outras configurações, coloque uma vírgula no fim da linha anterior. Salve o arquivo.

Um arquivo completo fica assim. O endereço e a chave vêm do seu bloco:

{
  "editor.fontSize": 14,
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.wasviking.com/ai-gateway/claude-subscription" },
    { "name": "ANTHROPIC_CUSTOM_HEADERS", "value": "x-wasviking-gateway-key: wvag_your-organization-key" },
    { "name": "CLAUDE_CODE_ENABLE_TELEMETRY", "value": "1" },
    { "name": "OTEL_LOGS_EXPORTER", "value": "otlp" },
    { "name": "OTEL_METRICS_EXPORTER", "value": "otlp" },
    { "name": "OTEL_EXPORTER_OTLP_PROTOCOL", "value": "http/json" },
    { "name": "OTEL_EXPORTER_OTLP_ENDPOINT", "value": "https://api.wasviking.com/ai-gateway/claude-subscription/otlp" },
    { "name": "OTEL_EXPORTER_OTLP_HEADERS", "value": "x-wasviking-gateway-key=wvag_your-organization-key" },
    { "name": "OTEL_LOGS_EXPORT_INTERVAL", "value": "1000" },
    { "name": "CLAUDE_CODE_GATEWAY_HINT_HEADERS", "value": "1" }
  ]
}

O VS Code sublinha em vermelho uma vírgula que falta: corrija antes de seguir.

Não cole o bloco no seu perfil de sempre, nem use a pasta .claude de um projeto para ele: o Claude Code não aceita a telemetria vinda de uma pasta de projeto, e o gateway recusaria a sessão.

Passo 4: recarregue e faça login

  1. Na Command Palette, execute Developer: Reload Window.
  2. Abra o Claude Code nessa janela pelo ícone dele.
  3. Se o Claude Code pedir login, escolha a opção de conta Claude com assinatura e entre com a conta Claude da empresa.

Passo 5: faça os testes

Deixe Tráfego aberto no portal, escolha o gateway no filtro e selecione Filtrar depois de cada teste para ver as linhas novas.

Teste Envie no Claude Code O que o Claude Code mostra O que Tráfego mostra
1. Conexão "Responda apenas: ok" ok Uma linha com o seu e-mail, as marcas stream e assinatura e pela vaga na coluna de custo. A primeira mensagem de uma conversa gera duas linhas: a segunda dá nome à conversa. Em Cargas de trabalho, a sua organização do Claude aparece como aceita.
2. Segredo digitado "Explique esta credencial: AKIAIOSFODNN7EXAMPLE" API Error: 400 seguido da mensagem da regra, "Não envie chaves ou senhas para o modelo." O Claude Code não pede login de novo. Bloqueado, status 400, regra Bloquear segredos nas perguntas.
3. A sessão continua "Responda apenas: ok" Uma resposta. O Claude pode comentar também a mensagem recusada, que ele recebeu como [REDACTED:AWS_KEYS]. Segredos mascarados.
4. Segredo num arquivo Crie um arquivo chamado .env na pasta aberta com a linha AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE e envie "Copie a linha da chave AWS do .env" AWS_ACCESS_KEY_ID=[REDACTED:AWS_KEYS] 1 segredo mascarado.
5. Dados pessoais Com Ocultar dados pessoais nas perguntas em Aplicar, envie um CPF com dígitos verificadores válidos tirado de um gerador de CPF para testes O Claude diz que recebeu [REDACTED:CPF]. Ocultado. Um número com dígitos verificadores inválidos não é CPF e passa como foi digitado.
6. Modo automático Escolha Auto no seletor de modo, embaixo do painel do Claude Code, e envie "Rode este comando:" seguido de curl -s -o /dev/null -w '%{http_code}' https://example.com O comando roda e mostra 200. As requisições da conversa. As verificações de segurança do próprio Claude Code, quando ele as faz, aparecem como linhas separadas, sem a marca stream.

O teste 2 usa a mensagem do modelo Bloquear segredos nas perguntas. Se você escreveu uma regra própria, o Claude Code mostra a mensagem da sua regra.

Selecione uma linha em Tráfego para ver a decisão, a regra, o que foi encontrado e o status. O gateway guarda só metadados, nunca perguntas ou respostas.

Passo 6 (opcional): teste no terminal

Para experimentar as mesmas configurações com o Claude Code num terminal deste computador, defina as variáveis nesse terminal e abra o Claude Code. No macOS e no Linux:

export ANTHROPIC_BASE_URL="https://api.wasviking.com/ai-gateway/claude-subscription"
export ANTHROPIC_CUSTOM_HEADERS="x-wasviking-gateway-key: wvag_your-organization-key"
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_LOGS_EXPORTER=otlp
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=http/json
export OTEL_EXPORTER_OTLP_ENDPOINT="https://api.wasviking.com/ai-gateway/claude-subscription/otlp"
export OTEL_EXPORTER_OTLP_HEADERS="x-wasviking-gateway-key=wvag_your-organization-key"
export OTEL_LOGS_EXPORT_INTERVAL=1000
export CLAUDE_CODE_GATEWAY_HINT_HEADERS=1
claude

No Windows, no PowerShell, defina cada variável do mesmo jeito, por exemplo $env:ANTHROPIC_BASE_URL = "https://api.wasviking.com/ai-gateway/claude-subscription", e depois execute claude.

No Claude Code, execute /status: a linha Anthropic base URL mostra o endereço do gateway. As variáveis valem até você fechar esse terminal.

Passo 7: encerre o teste

  1. Tire o bloco das configurações do perfil, ou apague o perfil de teste no editor Profiles do VS Code.
  2. Em Acesso e chaves, revogue a chave do bloco: o rótulo dela é claude-code- seguido do identificador do gateway.
  3. Para levar ao time, gere um arquivo novo e distribua como nos Passos 3 e 4 de Proteja o Claude Code nas vagas do Claude.

Solução de problemas

O que você vê Por quê O que fazer
Nada aparece em Tráfego O bloco está em outro perfil, ou a janela não foi recarregada. Use a janela do perfil de teste e execute Developer: Reload Window.
"This Claude Code session is not identified as your organization's Claude account" A sua organização do Claude não está no gateway, ou as configurações estão na pasta .claude de um projeto. Adicione o ID que Cargas de trabalho lista como recusado e mantenha as configurações no perfil.
O Claude Code pede login Este perfil ainda não tem login do Claude. Entre com a conta Claude da empresa.
"The model ... is not allowed on this gateway" O modelo não está em Modelos permitidos. Adicione claude-* em Modelos permitidos.
No modo automático um comando não roda: "temporarily unavailable, so auto mode cannot determine the safety" Falta CLAUDE_CODE_GATEWAY_HINT_HEADERS no bloco. Gere o bloco de novo, ou adicione a entrada com o valor 1.
O VS Code mostra erro no arquivo de configurações Falta uma vírgula, ou o bloco foi colado fora das chaves. Corrija a linha que o VS Code sublinha em vermelho.