Seu Cliente Enterprise Só Usa Google Cloud e Você Só Sabe Configurar AWS? Um Wizard de 2 Minutos Resolve

Eu recebo essa mensagem no WhatsApp pelo menos duas vezes por mês.

“Thulio, a gente quer rodar o Claude Code pelo Google Cloud pra ter billing unificado e data residency, mas o setup é um inferno. Já tentaram 3 vezes e desistiram.”

E eu entendo. Porque até pouco tempo atrás, configurar o Claude Code no Vertex AI significava:

1. Habilitar a API do Vertex AI no projeto GCP
2. Pedir acesso aos modelos Claude no Model Garden (e esperar 24-48h)
3. Configurar autenticação via gcloud ou service account
4. Setar CLAUDE_CODE_USE_VERTEX=1
5. Setar CLOUD_ML_REGION=global (ou uma região específica)
6. Setar ANTHROPIC_VERTEX_PROJECT_ID=seu-projeto
7. Decidir se precisa de DISABLE_PROMPT_CACHING=1
8. Pinar versões de modelo com ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL
9. Configurar VERTEX_REGION_CLAUDE_* para modelos que não suportam global endpoint
10. Testar. Falhar. Debugar 403. Tentar de novo.

Dez passos. Seis variáveis de ambiente mínimas. Uma tarde inteira do dev sênior jogada fora.

Na minha experiência com 300+ software houses, o setup é o assassino silencioso da adoção de IA. Não é o preço. Não é a curva de aprendizado. É o dev que tenta configurar na sexta-feira, não consegue, e na segunda já voltou pro método antigo.

A boa notícia: o Claude Code v2.1.98 matou esse problema com um wizard interativo que faz tudo em 2 minutos.

O Que É o Interactive Vertex AI Setup Wizard

A partir da versão 2.1.98, lançada em 9 de abril de 2026, o Claude Code ganhou um wizard interativo para setup do Google Vertex AI, acessível direto na tela de login.

A documentação oficial descreve o fluxo em três passos:

1. Rode claude no terminal
2. Na tela de login, selecione “3rd-party platform”, depois “Google Vertex AI”
3. O wizard detecta automaticamente seu projeto GCP e região, verifica quais modelos Claude estão habilitados, permite fazer pin de versões, e salva tudo no arquivo de configurações — sem variáveis de ambiente manuais

Acabou. Sem export. Sem .bashrc. Sem “pergunta pro DevOps como faz”.

Depois de configurado, a qualquer momento você pode rodar /setup-vertex para reabrir o wizard e mudar credenciais, projeto, região ou pins de modelo.

Startup Model Checks: Zero Downtime

O wizard também faz startup model checks — quando o Claude Code inicia, ele verifica se os modelos que você pinou ainda estão acessíveis:

• Se uma versão mais nova estiver disponível → sugere atualizar
• Se o modelo pinado não estiver mais disponível → faz fallback automático para a versão anterior
• Se o fallback funciona → mostra aviso, não trava

Isso sozinho já elimina aquele ticket recorrente: “Claude Code parou de funcionar depois do update”.

Por Que Isso Importa: O Contexto Que Ninguém Fala

Vamos ser honestos: a maioria das software houses brasileiras usa AWS. Eu sei porque mentoro mais de 300. O Bedrock é familiar, o billing é conhecido, o IAM já está configurado.

Mas aqui está o problema: seus clientes enterprise não necessariamente usam AWS.

Segundo pesquisas recentes, 89% das organizações enterprise já adotam estratégia multi-cloud. E 42% citam prevenção de vendor lock-in como a razão principal.

O que isso significa na prática? Significa que quando você fecha um contrato com um hospital, uma seguradora, uma rede de varejo, uma fintech, a chance de o cliente exigir Google Cloud é de quase 1 em 3. A Google Cloud cresceu 36% ano a ano e já detém 11% do mercado global de cloud em 2026.

E até agora, se seu time só sabia configurar Claude Code no Bedrock, você tinha duas opções ruins:

1. Migrar manualmente — gastar horas configurando variáveis de ambiente, testando, debugando erros de autenticação
2. Desistir do cliente — “a gente não trabalha com Google Cloud”

Agora tem uma terceira opção: rodar o wizard.

O Stack Multi-Cloud Completo do Claude Code

Com o wizard do Vertex AI, o Claude Code agora é a única ferramenta de AI coding que roda nativamente nas 3 maiores clouds do mundo:

Cloud	Integração	Wizard	Desde
AWS	Bedrock + Mantle	v2.1.92	Mar/2026
Google Cloud	Vertex AI	v2.1.98	Abr/2026
Microsoft	Azure AI Foundry	Manual	—

Nenhum concorrente faz isso. Copilot é Microsoft-only. Cursor não roda em cloud enterprise. Windsurf não tem integração nativa com nenhuma das 3. Codex é API-only sem wizard de setup.

Os Números Que Importam

• 94% dos líderes de TI temem vendor lock-in (Parallels 2026 Survey)
• 89% das empresas já operam multi-cloud, 42% especificamente para prevenir lock-in
• 74% das iniciativas de IA travam por dependências estreitas de um único vendor (Zapier)
• US$315 mil é o custo médio de migração entre clouds por projeto
• 45% dizem que vendor lock-in já impediu adoção de ferramentas melhores
• Vertex AI cresceu 20x no último ano (Google Cloud)
• Brasil representa 6.1% da base global de clientes Google Cloud
• Mercado cloud brasileiro: US$24 bilhões (2025) → US$78 bilhões (2032), crescimento de 18.3% ao ano (Fortune Business Insights)
• 54% de market share do Claude Code em AI coding (vs 21% OpenAI)
• 46% “most loved” entre 15 mil devs (Pragmatic Engineer, fev/2026)
• 1M tokens — janela de contexto suportada no Vertex AI (Opus 4.6, Sonnet 4.6)

Na Prática: Como Configurar em 5 Passos

1. Pré-requisitos (uma vez por projeto GCP)

# Habilitar Vertex AI API
gcloud config set project SEU-PROJETO
gcloud services enable aiplatform.googleapis.com

2. Habilitar modelos Claude no Model Garden

Acesse o Vertex AI Model Garden, busque “Claude”, e solicite acesso. Pode levar 24-48h.

3. IAM

Seu usuário precisa da role roles/aiplatform.user (ou aiplatform.endpoints.predict em role customizada).

4. Rodar o wizard

claude
# Selecione: 3rd-party platform → Google Vertex AI
# Siga os prompts — 2 minutos

5. Verificar

claude --version  # Precisa ser v2.1.98+
# O wizard já configurou tudo — só usar

Para reconfigurar: /setup-vertex dentro do Claude Code.

Dica enterprise: use managed settings para distribuir a config via MDM para todo o time de uma vez.

Model Pinning: Obrigatório Para Enterprise

A documentação é clara:

“Pin specific model versions when deploying to multiple users. Without pinning, model aliases such as sonnet and opus resolve to the latest version, which may not yet be enabled in your Vertex AI project when Anthropic releases an update.”

Sem pinning, seus 20 devs podem estar rodando versões diferentes do modelo. O wizard torna o pinning parte natural do fluxo — não é um passo extra que ninguém lembra.

O wizard salva algo equivalente a:

ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-6'
ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-6'
ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5@20251001'

Data Residency e LGPD

O Vertex AI permite escolher a região onde os dados são processados. Se seu cliente exige que dados não saiam do Brasil (ou de uma região específica):

CLOUD_ML_REGION=southamerica-east1  # São Paulo

Isso é compliance automático. Sem formulário. Sem reunião com jurídico. A região é definida no setup e todo request vai para lá.

O Que Eu Penso

Na minha experiência com 300+ software houses, a maioria perde contratos — ou aceita condições ruins — porque não consegue se adaptar à stack do cliente. O cliente diz “Google Cloud” e o time entra em pânico.

Essa atualização é mais do que um wizard de configuração. É uma declaração de independência de cloud. Sua software house não precisa mais ser “uma empresa AWS” ou “uma empresa Google Cloud”. Com Claude Code, você é uma empresa que entrega software — e a cloud é detalhe de infraestrutura.

E cá entre nós: se 89% dos seus potenciais clientes enterprise já usam multi-cloud, e sua SH só sabe operar em uma cloud, você está perdendo pelo menos 1 em cada 3 contratos enterprise que aparecem.

O wizard leva 2 minutos. O contrato que você pode fechar por causa dele pode valer meses de receita.

Multi-cloud não é tendência — é requisito. E agora, com um wizard de 2 minutos, não existe mais desculpa pra não ter Claude Code rodando na infra certa.

Se você quer implementar esse nível de flexibilidade na sua software house e parar de perder contratos por causa de cloud, esse é o tipo de coisa que a gente discute no dia a dia da mentoria.

Sou Thulio, mentoro 300+ SHs desde 2016.

---

Quer levar sua software house para o próximo nível com IA? Conheça a Imersão Software House 10x — o evento presencial exclusivo para empresas de software que querem crescer com inteligência.

Referências:

• Changelog Claude Code v2.1.98
• Documentação oficial — Google Vertex AI
• Documentação oficial — Amazon Bedrock
• Parallels 2026 Cloud Computing Survey — 94% IT Leaders Fear Vendor Lock-In
• Google Cloud — Expanding Vertex AI with Claude Opus 4.6
• Fortune Business Insights — Brazil Cloud Computing Market

Artigos relacionados:

• Seus Devs Usam Claude Code no Cartão do Fundador e o TI Nem Sabe? Uma Variável Resolve — artigo sobre Bedrock Mantle (AWS)
• Seus 20 Devs Rodam Claude Code e Você Não Sabe Nem Quanto Gastam? Duas Variáveis Resolvem — artigo sobre OTEL Observability
• Seus Devs Rodam Claude Code Sem Sandbox e Um Script Malicioso Vê TUDO? Duas Variáveis Fecham a Jaula — artigo sobre PID Namespace Isolation
• Seu Dev Novo Leva 33 Dias Pra Entregar o Primeiro PR? Um Comando Resolve — artigo sobre /team-onboarding