1. Tenha sua chave de cliente

Contrate um plano e receba uma chave no formato sk-ant-gateway-.... Ela é a única credencial que você usa no Claude Code.

2. Configure as variáveis

Windows (PowerShell)

$env:ANTHROPIC_BASE_URL="https://vertex-cloud.online/"
$env:ANTHROPIC_AUTH_TOKEN="sk-ant-gateway-SUA_CHAVE"
claude

macOS e Linux

export ANTHROPIC_BASE_URL="https://vertex-cloud.online/"
export ANTHROPIC_AUTH_TOKEN="sk-ant-gateway-SUA_CHAVE"
claude

Para não digitar toda vez, use o script de configuração completa da página inicial: ele salva tudo no settings.json do Claude Code.

3. Teste a conexão

Abra o Claude Code e envie uma mensagem simples, como "olá". Se ele responder, está tudo certo.

Erros comuns e como resolver

  • 401 — chave ausente ou inválida: confira se a chave começa com sk-ant-gateway- e se não há espaço sobrando no final.
  • 403 — modelo não liberado: o modelo pedido não faz parte do seu plano. Escolha outro com /model.
  • 429 — limite atingido: a cota da janela de 5 horas acabou ou o provedor pediu para esperar. O Claude Code tenta de novo sozinho.
  • Conexão falhando: use a URL com a barra no final: https://vertex-cloud.online/.

Acompanhe seu consumo

No painel de consumo você vê tokens usados, requisições, modelos e quando a janela renova. Entenda como os tokens são contados no guia tokens de IA.