Claude no Vertex AI: preços, Claude Code, cotas e qual versão escolher

Há duas formas de usar o Claude sem sair do seu contrato e do seu faturamento do Google Cloud. Uma é a versão gerenciada pelo Google, que o Google opera como parte do Agent Platform (antigo Vertex AI). A outra é a versão gerenciada pela Anthropic, em que você usa a API do Claude operada pela Anthropic a partir de um projeto do Google Cloud. Esta última está em disponibilidade geral desde 22 de outubro de 2026 (anúncio da Anthropic). As duas aparecem na sua fatura do Google Cloud, mas diferem nos recursos disponíveis, nas regiões, em quem gerencia os limites de uso e no suporte ao Claude Code.

Com base na documentação oficial da Anthropic e do Google Cloud (consultada em 26 de outubro de 2026), este artigo explica como as duas versões diferem, os preços, as regiões, como começar, a configuração do Claude Code e como lidar com cotas e erros 429. Nas seções que tratam das duas versões, elas aparecem na ordem gerenciada pelo Google → gerenciada pela Anthropic, com as mesmas cores.

1. Como as duas versões diferem

As duas se chamam "Claude Models on Google Cloud" e se distinguem por "Google managed" ou "Anthropic managed" entre parênteses. O Google agora chama o Vertex AI de "Gemini Enterprise Agent Platform", e os títulos da documentação passaram a usar Agent Platform. A tela de login do Claude Code, porém, ainda mostra "Google Vertex AI".

Fontes: a tabela comparativa de "Claude Models on Google Cloud", da Anthropic, e "Use Claude models on Google Cloud (Anthropic managed)" e "Anthropic Claude models", do Google Cloud. Consultado em 26 de outubro de 2026.

Elas também têm pontos em comum. As duas são chamadas com credenciais do Google Cloud (incluindo as Application Default Credentials, ou ADC), e as cobranças aparecem na sua fatura do Google Cloud. A partir do Claude 4.6, os IDs de modelo são os mesmos da API do Claude nas duas versões (por exemplo, claude-opus-5-5). Nos modelos anteriores, só a versão gerenciada pelo Google coloca @ antes da data (por exemplo, claude-haiku-4-5@20251001).

Na versão gerenciada pela Anthropic, uma nova organização da Anthropic é criada para cada projeto do Google Cloud. Ela é separada de qualquer organização que você já use com a API do Claude ou do Claude Enterprise, e uma organização existente não pode ser transferida. Chaves de API, workspaces e configurações do Console não são levados junto, e recursos como arquivos e lotes ficam na organização original.

2. Como escolher: 5 perguntas

Comece de cima e fique com a primeira que se aplicar ao seu caso. Se nenhuma se aplicar, decida pela facilidade de estimar os custos. A versão gerenciada pelo Google publica sua tabela de preços e suas cotas padrão, então você consegue estimar orçamento e limites antes de começar. As vantagens da versão gerenciada pela Anthropic, a variedade de recursos e o acesso antecipado às novidades, pesam se você conseguir confirmar os preços na página do Marketplace e os limites com seu representante da Anthropic.

• Você quer usar o Claude Code com cobrança pelo Google Cloud→Gerenciada pelo Google
• Você quer que só o Google trate seus dados, ou precisa de VPC Service Controls, armazenamento de dados regional ou certificações como FedRAMP High→Gerenciada pelo Google
• Você precisa que a inferência rode só dentro da UE→Gerenciada pelo Google (multirregião eu)
• Você usa a Files API, Agent Skills, Managed Agents, web fetch, o conector MCP, a execução de código ou a Message Batches API→Gerenciada pela Anthropic
• Você quer o modo rápido do Opus 5.5→Gerenciada pela Anthropic

A segunda pergunta reúne os casos em que a documentação do Google Cloud recomenda escolher a versão gerenciada pelo Google (Use Claude models on Google Cloud (Anthropic managed)).

Também dá para usar as duas. Por exemplo, os desenvolvedores usam o Claude Code pela versão gerenciada pelo Google, enquanto sua própria aplicação chama os Managed Agents pela versão gerenciada pela Anthropic. As duas aparecem na mesma fatura do Google Cloud, mas os consoles de administração e a gestão dos limites de uso são separados.

3. Diferenças de recursos

As maiores diferenças estão nos recursos do lado do servidor operados pela Anthropic. A versão gerenciada pelo Google gira em torno da Messages API e não oferece armazenamento de arquivos nem ambientes de execução de agentes.

Fontes: Feature support em "Claude Models on Google Cloud (Anthropic managed)", "Claude Models on Google Cloud (Google managed)" e "Fast mode", da Anthropic. O modo rápido na versão gerenciada pelo Google não aparece na lista de recursos compatíveis da documentação da Anthropic, que não diz nem que está disponível nem que não está (a tabela de recursos do Claude Code o indica como indisponível no Agent Platform). Consultado em 26 de outubro de 2026.

Para entender como os Managed Agents funcionam, veja "O que são os Claude Managed Agents?"; para a velocidade e o preço do modo rápido, veja "Claude Opus 5.5: o que muda".

4. Preços: é igual à API do Claude?

Preços da versão gerenciada pelo Google

No endpoint global da versão gerenciada pelo Google, os preços de entrada, saída e cache do Opus 5.5, do Sonnet 5.5 e do Haiku 5.5 são os mesmos da API do Claude da Anthropic. As multirregiões us e eu custam 10% a mais que o global (os endpoints regionais também custam 10% a mais, mas só atendem o Sonnet 4.6 e modelos anteriores; veja a seção 5).

Fontes: "Pricing", da Anthropic, a seção de modelos Claude da Anthropic em "Agent Platform pricing", do Google Cloud, e "Claude Models on Google Cloud (Google managed)", da Anthropic (os endpoints multirregionais e regionais custam 10% a mais que o global, para Sonnet 4.5, Haiku 4.5, Opus 4.5 e modelos posteriores). Consultado em 26 de outubro de 2026. A versão gerenciada pela Anthropic não está no gráfico porque seus preços por token não constam da documentação oficial (veja a seção abaixo).

Dólares americanos por milhão de tokens. Preços da API do Claude da Anthropic e do endpoint global da versão gerenciada pelo Google (páginas de preços das duas empresas, consultadas em 26 de outubro de 2026). As multirregiões us/eu custam 1,1 vez esses valores. As leituras de cache custam 0,05 vez a entrada no Opus 5.5 e no Sonnet 5.5, e 0,1 vez no Haiku 5.5 (nota da página de preços da Anthropic). Para a lista completa de modelos e o histórico de preços, veja "Claude Fable, Opus, Sonnet e Haiku: comparação de preços".

O Provisioned Throughput, que reserva capacidade por uma taxa fixa, não está disponível no global nem nas multirregiões e exige um endpoint regional (documentação do Google Cloud). Os endpoints regionais só atendem o Sonnet 4.6 e modelos anteriores, então o Opus 5.5, o Sonnet 5.5 e o Haiku 5.5 são usados com pagamento conforme o uso.

Preços da versão gerenciada pela Anthropic

Na versão gerenciada pela Anthropic, a Anthropic mede o uso em Claude Consumption Units (CCU, 1 CCU = US$ 0,01) e o informa ao Google Cloud, e ele aparece na sua fatura do Google Cloud. A Anthropic não envia uma fatura separada. Nem a Anthropic nem o Google Cloud publicam uma tabela de preços por token na documentação oficial (consultado em 26 de outubro de 2026). O mais seguro é conferir os preços na página do Google Cloud Marketplace antes de contratar e, depois de começar, fazer um pequeno teste e confirmar o valor real na página Usage do Claude Console e nos relatórios de faturamento do Google Cloud.

Três coisas estão documentadas oficialmente:

• O modo rápido do Opus 5.5 custa US$ 8 de entrada e US$ 40 de saída por milhão de tokens (página Fast mode e anúncio da Anthropic).
• Adicionar inference_geo: "us" a uma requisição para manter a inferência nos EUA multiplica por 1,1 os preços de todas as categorias ("Data residency", da Anthropic).
• Se você tem um compromisso de gasto com o Google Cloud, o uso conta para ele como outras compras do Marketplace. Se tem um acordo de desconto, fale com seu representante da Anthropic ou do Google Cloud antes de começar (os descontos não são aplicados retroativamente).

Preços de lotes

As duas versões tratam lotes de forma diferente. A versão gerenciada pelo Google usa a predição em lote do Agent Platform (com entrada JSONL do BigQuery ou do Cloud Storage), e os preços estão na coluna de lotes da página de preços do Google Cloud. A versão gerenciada pela Anthropic oferece a mesma Message Batches API da API do Claude, mas os preços de lote também não constam da documentação oficial. O desconto de lote da API do Claude (direta) é explicado em "Claude Fable, Opus, Sonnet e Haiku: comparação de preços".

5. Regiões e armazenamento de dados

No Claude sobre o Google Cloud, a location que você chama determina onde a inferência roda. A versão gerenciada pelo Google oferece três tipos, enquanto a versão gerenciada pela Anthropic oferece só o global.

Fontes: "Claude Models on Google Cloud (Google managed)" e "(Anthropic managed)", da Anthropic, "Agent Platform partner models", do Google Cloud. Consultado em 26 de outubro de 2026.

Os locais de armazenamento de dados também diferem. A versão gerenciada pelo Google armazena os dados na região ou multirregião que você escolher. No entanto, a página de modelos de parceiros do Google Cloud também diz que o local de processamento pode ser diferente do local de armazenamento. Já a documentação da Anthropic diz que a inferência multirregional fica dentro de us ou eu, e a relação entre as duas afirmações não é explicada. Se você tem requisitos rígidos sobre onde o processamento acontece, confirme com o Google Cloud antes de assinar um contrato. Também é possível usar a política da organização constraints/gcp.restrictEndpointUsage para bloquear o endpoint global e permitir só as multirregiões.

Na versão gerenciada pela Anthropic, a região de armazenamento do workspace é "us" e não pode ser alterada ("Data residency", da Anthropic).

Em 26 de outubro de 2026, as multirregiões presentes na documentação oficial de qualquer uma das duas versões cobrem só os EUA e a UE. Se o processamento ou o armazenamento precisarem ficar dentro de um país específico fora dessas áreas, confirme com o Google Cloud ou com seu representante da Anthropic que existe uma location adequada antes de assinar um contrato.

6. Primeiros passos

As duas versões exigem um projeto do Google Cloud e uma conta de faturamento com o faturamento ativado. Abaixo estão os passos da documentação oficial para disponibilizar cada versão, seguidos dos passos comuns para autenticar e chamar o modelo.

Gerenciada pelo Google: primeiros passos

1. Ative a API do Agent Platform

   gcloud config set project YOUR-PROJECT-ID
   gcloud services enable aiplatform.googleapis.com

   Faça isso uma vez por projeto.
2. Ative no Model Garden os modelos Claude que quiserQuem for ativá-los precisa do papel Consumer Procurement Entitlement Manager (roles/consumerprocurement.entitlementManager). Além disso, a política da sua organização precisa permitir cloudcommerceconsumerprocurement.googleapis.com. A documentação do Claude Code diz que a aprovação do acesso pode levar de 24 a 48 horas (a documentação do Google Cloud não informa quanto tempo leva).
3. Conceda um papel a quem fará as chamadasConceda um papel que inclua a permissão aiplatform.endpoints.predict (roles/aiplatform.user).

Fontes: "Claude Models on Google Cloud (Google managed)", da Anthropic, "Agent Platform partner models", do Google Cloud. Consultado em 26 de outubro de 2026.

Gerenciada pela Anthropic: primeiros passos

1. Contrate no MarketplaceAbra "Claude Models on Google Cloud (Anthropic managed)" no Google Cloud Marketplace e clique em "Subscribe". Você precisa de permissões de compra no Marketplace na conta de faturamento.
2. Ative dois serviços

   gcloud services enable claude.googleapis.com \
     anthropic-managed-claude.cloudpartnerservices.goog \
     --project=YOUR-PROJECT-ID

   Faça isso uma vez por projeto.
3. Ative a organizaçãoClique em "Activate" na página do Claude e siga o link enviado ao seu e-mail de contato para informar o nome da organização, o tipo de empresa, o país e o caso de uso, e aceitar os Commercial Terms of Service e a Usage Policy da Anthropic. Isso exige roles/claude.admin.
4. Anote o ID do seu workspaceNo Claude Console (aberto a partir do console do Google Cloud), vá em Settings > Workspaces e anote o ID que começa com wrkspc_. Você precisa dele para fazer chamadas.
5. Conceda um papel a quem fará as chamadasConceda roles/claude.user. Os papéis são por projeto, então, se quiser separar equipes, use projetos diferentes (cada projeto vira uma organização da Anthropic separada).

Fonte: Set up your account em "Claude Models on Google Cloud (Anthropic managed)", da Anthropic (consultado em 26 de outubro de 2026). Não é possível entrar na organização da Anthropic com um endereço de e-mail; o Console é aberto a partir do console do Google Cloud.

As duas versões: autenticar e chamar

Em qualquer uma das versões, execute gcloud auth application-default login na máquina que faz as chamadas para criar as ADC, e o SDK usará essas credenciais (em servidores, use credenciais de conta de serviço). Depois, chame o modelo com o cliente do SDK da seção 7.

7. Chamando o Claude pelo SDK

Os SDKs oficiais da Anthropic suportam as duas versões. Só mudam o pacote a instalar e o nome do cliente; o messages.create é escrito do mesmo jeito que com a API do Claude.

Gerenciada pelo Google (Python)

# pip install -U "anthropic[vertex]"
from anthropic import AnthropicVertex

client = AnthropicVertex(project_id="YOUR-PROJECT-ID", region="global")  # "us" ou "eu" também funcionam
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Olá, Claude"}],
)

Em TypeScript, use AnthropicVertex de @anthropic-ai/vertex-sdk. Para chamar por HTTP sem o SDK, a URL tem o formato https://aiplatform.googleapis.com/v1/projects/YOUR-PROJECT-ID/locations/global/publishers/anthropic/models/claude-opus-5-5:rawPredict; não coloque o nome do modelo no corpo da requisição e inclua nele "anthropic_version" (vertex-2023-10-16 ou 2026-10-21). Para streaming, use :streamRawPredict. O que muda na nova versão de API 2026-10-21 é explicado em "temperature is deprecated for this model: causas e solução".

Gerenciada pela Anthropic (Python)

# pip install -U "anthropic[google_cloud]"
# Variáveis de ambiente: ANTHROPIC_GOOGLE_CLOUD_PROJECT e
#           ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID (obrigatória)
from anthropic import AnthropicGoogleCloud

client = AnthropicGoogleCloud()
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Olá, Claude"}],
)

Em TypeScript, é AnthropicGoogleCloud de @anthropic-ai/google-cloud-sdk (os dois estão em beta). Por HTTP, os corpos de requisição e resposta são os mesmos da API do Claude; as diferenças são:

• URL base: https://claude.googleapis.com/v1/projects/{project}/locations/global/workspaces/{workspace}/invoke, que inclui o ID do workspace (não envie o cabeçalho anthropic-workspace-id).
• Autenticação: envie um token de acesso do Google com Authorization: Bearer (não envie x-api-key).
• Chaves de API: não podem ser criadas. As variáveis de ambiente ANTHROPIC_API_KEY e ANTHROPIC_BASE_URL são ignoradas.

Fontes: "Claude Models on Google Cloud (Anthropic managed)" e "(Google managed)", da Anthropic. Consultado em 26 de outubro de 2026.

8. Usando o Claude Code no Google Cloud

No Google Cloud, o Claude Code suporta a versão gerenciada pelo Google. A tabela de recursos do Claude Code define o Agent Platform como "run by Google, configured with CLAUDE_CODE_USE_VERTEX" (operado pelo Google e configurado com essa variável). A documentação do Claude Code não descreve como usá-lo com a versão gerenciada pela Anthropic (consultado em 26 de outubro de 2026).

Duas formas de configurar

1. Configure com o assistenteInicie o claude e, na tela de login, escolha "3rd-party platform" → "Google Vertex AI" (se você já estiver logado, use /login). Ele pede o método de autenticação, o projeto e a região, e permite verificar quais modelos estão disponíveis e fixá-los. O resultado é salvo em env nas suas configurações de usuário (~/.claude/settings.json), e você pode reabri-lo depois com /setup-vertex.
2. Configure com variáveis de ambienteÉ o mais indicado para CI e para distribuir a uma equipe. Depois de ativar os modelos no Model Garden, defina o seguinte.

   export CLAUDE_CODE_USE_VERTEX=1
   export CLOUD_ML_REGION=global
   export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID
   
   # Fixar os modelos
   # Modelo principal: o Sonnet segura os custos. Para o Opus, use claude-opus-5-5
   export ANTHROPIC_MODEL=claude-sonnet-5-5
   export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
   export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5-5
   export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5

   Os motivos para fixar os modelos estão no aviso abaixo.

Em qualquer caso, execute /status depois da configuração. Se "API provider" mostrar Google Vertex AI e aparecerem linhas com o projeto do GCP, a região e o modelo, a configuração funcionou.

Fontes: "Claude Code on Google Cloud's Agent Platform" e "Environment variables", do Claude Code. Consultado em 26 de outubro de 2026.

Se um modelo não estiver disponível na location de CLOUD_ML_REGION, você pode trocar a região só para esse modelo, como em VERTEX_REGION_CLAUDE_HAIKU_4_5=us-east5 (este exemplo chama só o Haiku 4.5 na região us-east5). CLOUD_ML_REGION aceita global, us ou eu, ou um nome de região como us-east5. O Claude Agent SDK também usa a versão gerenciada pelo Google com as mesmas variáveis de ambiente (veja "O que é o Claude Agent SDK?").

Recursos do Claude Code disponíveis no Agent Platform

O computer use desta tabela é o recurso do Claude Code (que exige assinatura), não a ferramenta computer use da API da seção 3. Fonte: "Feature availability", do Claude Code (/logout e a busca de ferramentas MCP vêm de "Claude Code on Google Cloud's Agent Platform"). Consultado em 26 de outubro de 2026. Os conectores do claude.ai também não são carregados (veja "claude.ai connectors are disabled no Claude Code").

9. Cotas e erros 429

Gerenciada pelo Google: as cotas são por família de modelos

Os modelos lançados depois de 26 de maio de 2026 (Opus 5.5, Sonnet 5.5, Haiku 5.5 e outros) usam cotas compartilhadas por toda a família de modelos (para modelos anteriores, consulte as cotas por modelo na mesma página do Google Cloud). Por exemplo, qualquer que seja a versão do Opus chamada no global, ela consome a mesma cota anthropic-claude-opus, e não é preciso pedir cota de novo quando sai uma nova versão. O global e cada multirregião têm cotas separadas.

Fonte: cotas padrão de "Quotas for Anthropic Claude models", do Google Cloud (consultado em 26 de outubro de 2026). A entrada é a soma dos tokens sem cache e das gravações de cache. O Google observa que os limites variam por conta e podem ser restringidos.

Consulte as cotas e peça aumentos na página "Quotas & System Limits" do console do Google Cloud. Filtrar por base_model (por exemplo, anthropic-claude-opus) facilita encontrá-las. As contagens de tokens dessa página podem ser imprecisas por causa de como funcionam as estimativas e os reembolsos; para contagens exatas, use a API de contagem de tokens ou o token_count no Metrics Explorer.

Quando você ultrapassa uma cota, recebe um erro 429 com esta mensagem:

Resource exhausted, please try again later.

Esta é a mensagem para o uso com pagamento conforme o uso ("Error code 429", do Google Cloud). Com Provisioned Throughput, ela é "Too many requests. Exceeded the Provisioned Throughput."

1. Use o global se não tiver requisitos sobre o local da inferênciaEle tem cotas maiores que as multirregiões e é processado na região que tiver capacidade. No Claude Code, defina CLOUD_ML_REGION=global. Se você tiver um requisito como manter a inferência dentro da UE, pule este passo e peça primeiro um aumento (passo 3).
2. Espere e tente de novoRepita com backoff exponencial com teto e evite picos repentinos de volume.
3. Peça um aumento de cotaPeça pela página "Quotas & System Limits" mencionada acima.

Fontes: "Error code 429", do Google Cloud, a solução de problemas de "Claude Code on Google Cloud's Agent Platform", do Claude Code.

Gerenciada pela Anthropic: os limites são gerenciados pela Anthropic

Os limites de uso são gerenciados pela Anthropic, e os valores padrão não constam da documentação oficial. Para aumentos, fale com seu representante da Anthropic ou com a equipe de vendas. A documentação da Anthropic recomenda confirmar seus limites antes de migrar tráfego de produção. Os erros têm o mesmo formato da API do Claude: ultrapassar um limite retorna um 429 rate_limit_error, e o congestionamento retorna um 529 overloaded_error. Se faltarem permissões do IAM, o Google Cloud retorna 403.

1. Espere e tente de novoRepita com backoff exponencial e evite picos repentinos de volume (igual à versão gerenciada pelo Google).
2. Confirme os limites antes da produçãoAntes de migrar, informe ao seu representante da Anthropic o volume de que você precisa e confirme seus limites.
3. Peça um aumento de limiteFale com seu representante da Anthropic ou com a equipe de vendas. Os limites não podem ser aumentados pela página de cotas do Google Cloud.

Fontes: Rate limits em "Claude Models on Google Cloud (Anthropic managed)", da Anthropic, e "Errors". Consultado em 26 de outubro de 2026.

Resumo

Perguntas frequentes

P. O Claude no Vertex AI é mais caro que a API do Claude?

No endpoint global da versão gerenciada pelo Google, os preços de entrada, saída e cache do Opus 5.5, do Sonnet 5.5 e do Haiku 5.5 são os mesmos. As multirregiões us e eu custam 10% a mais (páginas de preços da Anthropic e do Google Cloud, consultadas em 26 de outubro de 2026). Na versão gerenciada pela Anthropic, os preços por token não constam da documentação oficial, então confira a página do Google Cloud Marketplace.

P. Posso usar uma chave de API do Claude?

As duas versões são chamadas com autenticação do Google Cloud (ADC ou uma conta de serviço), não com uma chave de API criada no Claude Console. A versão gerenciada pela Anthropic não permite criar chaves de API, e definir ANTHROPIC_API_KEY não tem efeito.

P. Posso usar o Claude Code com a versão gerenciada pela Anthropic?

A documentação do Claude Code não descreve uma configuração para a versão gerenciada pela Anthropic (consultado em 26 de outubro de 2026). A configuração do Google Cloud no Claude Code (CLAUDE_CODE_USE_VERTEX) é para a versão gerenciada pelo Google.

P. Posso mudar minha organização atual da Anthropic para o faturamento do Google Cloud?

Não. A versão gerenciada pela Anthropic cria uma nova organização por projeto, e organizações existentes não podem ser convertidas. Chaves de API, workspaces e configurações do Console não são levados junto, então você precisa recriá-los na nova organização.