Claude no Google Cloud

A API para acessar o Claude na Google Cloud's Agent Platform é quase idêntica à Messages API, com duas diferenças principais no formato da requisição:

• Na Agent Platform, model não é passado no corpo da requisição. Em vez disso, ele é especificado na URL do endpoint do Google Cloud.
• Na Agent Platform, anthropic_version é passado no corpo da requisição (em vez de como um cabeçalho) e deve ser definido com o valor vertex-2023-10-16.

A Agent Platform também é suportada pelos SDKs de cliente oficiais da Anthropic. Este guia orienta você a fazer uma requisição ao Claude na Agent Platform usando um dos SDKs de cliente da Anthropic.

Observe que este guia pressupõe que você já tenha um projeto do Google Cloud capaz de usar a Agent Platform. Consulte Modelos Anthropic Claude na Agent Platform para mais informações sobre a configuração necessária e um passo a passo completo.

Instale um SDK para acessar a Agent Platform

Primeiro, instale o SDK de cliente da Anthropic para a linguagem de sua escolha.

pip install -U "anthropic[vertex]"

Acessando a Agent Platform

Disponibilidade de modelos

Observe que a disponibilidade dos modelos da Anthropic varia por região. Pesquise por "Claude" no Model Garden ou acesse Modelos Anthropic Claude para obter as informações mais recentes.

IDs de modelo da API

Os termos de ciclo de vida (Descontinuado, Desativado) são definidos em Descontinuações de modelos. As datas de ciclo de vida em plataformas operadas por parceiros são definidas pelo parceiro e podem diferir do cronograma da Claude API. Para a data de desativação atual de qualquer modelo na Agent Platform, consulte a documentação do Google Cloud para modelos Claude na Agent Platform.

Fazendo requisições

Antes de executar requisições, talvez você precise executar gcloud auth application-default login para se autenticar no Google Cloud.

Os exemplos a seguir mostram como gerar texto com o Claude na Agent Platform:

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Consulte os SDKs de cliente e a documentação oficial da Agent Platform para mais detalhes.

O Claude também está disponível por meio do Amazon Bedrock, da Claude Platform na AWS e do Microsoft Foundry.

Retenção de dados

O tratamento de dados para esta oferta é regido pelo Google Cloud. Para detalhes, consulte Agent Platform e retenção zero de dados.

Registro de atividades

A Agent Platform fornece um serviço de registro de requisição-resposta que permite registrar os prompts e as conclusões associados ao seu uso.

A Anthropic recomenda que você registre sua atividade em uma base contínua de pelo menos 30 dias para entender sua atividade e investigar qualquer possível uso indevido.

Suporte a recursos

Para a lista completa de recursos com disponibilidade no Google Cloud, consulte a Visão geral dos recursos.

Destaques de recursos suportados

• Messages API
• Cache de prompt
• Pensamento
• Uso de ferramentas, incluindo a ferramenta Bash, a ferramenta de uso de navegador, a ferramenta de uso de computador, a ferramenta de memória e a ferramenta de editor de texto
• Ferramenta de pesquisa na web
• Citações
• Saídas estruturadas

Recursos não suportados

• Fontes de entrada (fontes de URL para imagens e documentos, Files API)
• Ferramentas do lado do servidor (execução de código, web fetch, advisor)
• Infraestrutura de agentes (Agent Skills, conector MCP, chamada programática de ferramentas)
• Endpoints de API (Message Batches, Models, Admin, Compliance, Usage and Cost)
• Claude Managed Agents
• Fallback do lado do servidor (o parâmetro fallbacks; use o padrão de fallback do lado do cliente em vez disso)

Janela de contexto

Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5.5, Claude Sonnet 5 e Claude Sonnet 4.6 têm uma "context window" (janela de contexto) de 1M de tokens no Agent Platform. Outros modelos Claude, incluindo Sonnet 4.5 e Sonnet 4 (descontinuado), têm uma janela de contexto de 200 mil tokens.

A Agent Platform limita os payloads de requisição a 30 MB. Ao enviar documentos grandes ou muitas imagens, você pode atingir esse limite antes do limite de tokens.

Endpoints globais, multirregionais e regionais

A Agent Platform oferece três tipos de endpoint:

• Endpoints globais: Roteamento dinâmico para máxima disponibilidade
• Endpoints multirregionais: Roteamento dinâmico dentro de uma área geográfica (por exemplo, os Estados Unidos ou a União Europeia) para residência de dados com alta disponibilidade
• Endpoints regionais: Roteamento de dados garantido por regiões geográficas específicas

Endpoints regionais e multirregionais incluem um acréscimo de 10% no preço em relação aos endpoints globais.

Quando usar cada opção

Endpoints globais (recomendado):

• Fornecem máxima disponibilidade e tempo de atividade
• Roteiam dinamicamente as requisições para regiões com capacidade disponível
• Sem acréscimo no preço
• Ideais para aplicações em que a residência de dados é flexível
• Suportam apenas tráfego pay-as-you-go (throughput provisionado requer endpoints regionais)

Endpoints multirregionais:

• Roteiam dinamicamente as requisições entre regiões dentro de uma área geográfica (atualmente us e eu)
• Úteis quando você precisa de residência de dados dentro de uma geografia ampla, mas deseja maior disponibilidade do que uma única região
• Acréscimo de 10% no preço em relação aos endpoints globais
• Suportam apenas tráfego pay-as-you-go (throughput provisionado requer endpoints regionais)

Endpoints regionais:

• Roteiam o tráfego por regiões geográficas específicas
• Necessários para residência de dados em uma única região, exigências rigorosas de conformidade ou throughput provisionado
• Suportam tanto pay-as-you-go quanto throughput provisionado
• O acréscimo de 10% no preço reflete os custos de infraestrutura para capacidade regional dedicada

Implementação

Usando endpoints globais (recomendado):

Defina o parâmetro region como "global" ao inicializar o cliente:

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Usando endpoints multirregionais:

Defina o parâmetro region como um identificador multirregional: "us" para os Estados Unidos ou "eu" para a União Europeia. O SDK roteia as requisições para o endpoint multirregional correspondente (https://aiplatform.us.rep.googleapis.com ou https://aiplatform.eu.rep.googleapis.com), que equilibra dinamicamente o tráfego entre as regiões dentro dessa área geográfica.

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us"  # Multi-region identifier: "us" or "eu"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Usando endpoints regionais:

Especifique uma região específica, como "us-east5" ou "europe-west1":

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us-east5"  # Specify a specific region

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    # Endpoints regionais específicos suportam o Claude Sonnet 4.6 e anteriores; modelos mais novos usam os endpoints globais ou multirregionais
    model="claude-sonnet-4-6",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Recursos adicionais

• Preços da Agent Platform: Preços de IA generativa em cloud.google.com
• Documentação dos modelos Claude: Claude na Agent Platform
• Post no blog do Google: Endpoint global para modelos Claude
• Detalhes de preços da Anthropic: Preços em plataformas de nuvem