Claude Models on Google Cloud (Anthropic managed)

O Google Cloud gerencia o acesso e o faturamento do Claude Models on Google Cloud (Anthropic managed). Para comparar as duas ofertas do Google Cloud, ou para verificar qual delas você usa, consulte Claude Models on Google Cloud.

Configure sua conta

Para configurar sua conta para o Claude Models on Google Cloud (Anthropic managed), você precisa do seguinte:

• Permissão para fazer compras no Google Cloud Marketplace na sua conta de faturamento
• Permissão para ativar serviços no projeto
• Um papel do IAM que permita abrir o Claude Console, necessário para a etapa 4

Estas etapas criam uma nova organização da Anthropic para o seu projeto do Google Cloud. Ela é separada de qualquer organização da Anthropic que sua empresa já tenha. Isso inclui uma organização do Claude Enterprise. Para migrar de uma organização existente, consulte Migrando de uma organização existente da Anthropic.

Se você tiver um desconto existente, entre em contato com seu representante de conta da Anthropic ou do Google Cloud antes de iniciar estas etapas. Descontos não podem ser aplicados a uso passado.

1. 1

   Assine no Marketplace

   1. Abra o Google Cloud Marketplace e encontre a listagem Claude Models on Google Cloud (Anthropic managed).
   2. Escolha Subscribe e conclua o fluxo de compra.
   3. Volte à listagem e escolha Manage on Console. Isso abre a página do Claude no console do Google Cloud.

   Para voltar à página do Claude mais tarde, selecione seu projeto no console do Google Cloud. Em seguida, vá para Agent Platform > Models > Claude Platform e escolha Anthropic managed.

2. 2

   Ative os serviços

   Ative dois serviços em cada projeto que chama o Claude Models on Google Cloud (Anthropic managed):

   • claude.googleapis.com fornece a API do Claude Models on Google Cloud (Anthropic managed). Esse serviço também define as permissões do IAM. As chamadas falham sem ele.
   • anthropic-managed-claude.cloudpartnerservices.goog é o serviço do Marketplace que atribui o uso do projeto à sua assinatura.

   CLI

   

   gcloud services enable claude.googleapis.com \
     anthropic-managed-claude.cloudpartnerservices.goog \
     --project=my-project-id

   Substitua my-project-id pelo ID do seu projeto.

   Você também pode ativar ambos na página do Claude ou em APIs & Services. A ativação é uma etapa única para cada projeto. Para verificar se ambos os serviços estão ativados, execute gcloud services list --enabled --project=my-project-id e procure os dois nomes.

3. 3

   Configure sua organização da Anthropic

   1. Na página do Claude, escolha Activate.
   2. No fluxo de configuração da Anthropic, insira um endereço de e-mail de contato.
   3. Abra o link de configuração enviado para esse endereço.
   4. Preencha o nome da organização, o tipo de entidade, o país e o uso pretendido.
   5. Aceite os Termos de Serviço Comerciais e a Política de Uso da Anthropic.

   O endereço de contato é usado apenas para a configuração e para avisos do serviço. Para saber como as pessoas abrem o Claude Console após a configuração, consulte Usando o Claude Console.

4. 4

   Abra o Claude Console

   Quando sua organização da Anthropic estiver ativa, o botão na página do Claude muda para Open Claude Console. Escolha-o. O Google Cloud verifica seu acesso no IAM. Em seguida, ele redireciona seu navegador para platform.claude.com. Você estará conectado à nova organização.

   Enquanto estiver no Claude Console, encontre o ID do seu workspace e copie-o. Todos que chamam o Claude Models on Google Cloud (Anthropic managed) precisam dele. Repasse-o aos seus desenvolvedores.

Para adicionar outro projeto, repita estas etapas nesse projeto, a partir da etapa 2.

Solução de problemas na configuração da conta

Se você encontrar um dos problemas a seguir ao configurar o Claude Models on Google Cloud (Anthropic managed), aplique a correção correspondente:

• gcloud services enable não encontra anthropic-managed-claude.cloudpartnerservices.goog: Execute o comando com a conta que concluiu a compra no Marketplace ou entre em contato com seu representante de conta da Anthropic.
• Um erro de permissão na sua primeira chamada de API: Verifique se claude.googleapis.com está ativado no projeto que você está chamando. Verifique se quem faz a chamada tem roles/claude.user ou roles/claude.admin nesse projeto. Para saber o que cada papel permite, consulte Papéis do IAM. Uma nova concessão ou um serviço recém-ativado pode levar um momento para entrar em vigor.
• "Signed in as a different account" após seguir o link de configuração: Escolha Log out and continue. Em seguida, use o endereço de e-mail que você inseriu na etapa 3.
• O botão diz "Finish Setup" em vez de "Open Claude Console": Sua organização da Anthropic existe, mas a configuração dela não está concluída. Um administrador precisa terminar o formulário de detalhes da organização.
• A página Usage não mostra dados após sua primeira chamada de API: Os dados de uso podem levar alguns minutos para aparecer no Claude Console.

Gerencie o acesso

Papéis do IAM

O Claude Models on Google Cloud (Anthropic managed) tem três papéis predefinidos do IAM. Conceda os papéis no projeto.

Por exemplo, o comando a seguir permite que uma conta de serviço chame o Claude Models on Google Cloud (Anthropic managed):

gcloud projects add-iam-policy-binding my-project-id \
  --member="serviceAccount:my-app@my-project-id.iam.gserviceaccount.com" \
  --role="roles/claude.user"

Para permissões, papéis predefinidos e tipos de log de auditoria, consulte Permissões do IAM para o Claude Models on Google Cloud (Anthropic managed).

Ativar claude.googleapis.com cria um agente de serviço para o projeto. Não remova as concessões de papel dele. Removê-las faz com que o Claude Models on Google Cloud (Anthropic managed) pare de funcionar no projeto.

Usando o Claude Console

Com o Claude Models on Google Cloud (Anthropic managed), você não pode usar um endereço de e-mail para entrar na sua organização da Anthropic. Em vez disso, escolha Open Claude Console na página do Claude no console do Google Cloud. O IAM do Google Cloud controla quem pode abrir o Claude Console. Dos três papéis do IAM predefinidos, apenas roles/claude.admin no projeto permite abrir o Claude Console.

Workspaces

No Claude Models on Google Cloud (Anthropic managed), a configuração cria sua organização da Anthropic com um workspace, o Default Workspace. Para criar mais workspaces, abra o Claude Console e vá para Settings > Workspaces. Na mesma página, você pode renomear ou arquivar qualquer workspace, exceto o Default Workspace. Cada workspace tem seu próprio ID de workspace. Arquivos, skills, batches, sessões do Claude Managed Agents e outros recursos do workspace pertencem ao workspace cujo ID você define para a solicitação.

Você concede papéis do IAM no projeto, portanto um papel se aplica a todos os workspaces desse projeto. Quando as equipes precisarem de acesso separado, dê a cada equipe seu próprio projeto do Google Cloud. Cada projeto tem sua própria organização da Anthropic, então repita as etapas de configuração em cada projeto, a partir da etapa 2.

Antes de fazer chamadas de API

Para chamar o Claude Models on Google Cloud (Anthropic managed), você precisa do seguinte:

1. Um projeto do Google Cloud com uma assinatura ativa e uma organização da Anthropic cuja configuração esteja concluída. Consulte Configure sua conta.
2. A gcloud CLI instalada, para desenvolvimento local.
3. O papel roles/claude.user, concedido no projeto à identidade que faz as chamadas.
4. Application Default Credentials para essa identidade. Consulte Autenticação.
5. O ID do seu projeto e o ID do seu workspace.

Para conceder o papel à sua própria conta para desenvolvimento local, execute o comando a seguir. Você precisa de permissão para alterar a política do IAM do projeto.

gcloud projects add-iam-policy-binding my-project-id \
  --member="user:you@example.com" \
  --role="roles/claude.user"

Substitua my-project-id pelo ID do seu projeto. Substitua you@example.com pelo endereço de e-mail da sua conta do Google. Para ver o projeto que o gcloud está usando, execute gcloud config get-value project. Para contas de serviço e os outros papéis, consulte Papéis do IAM.

Encontre o ID do seu workspace

Para encontrar o ID do seu workspace para o Claude Models on Google Cloud (Anthropic managed), abra o Claude Console e vá para Settings > Workspaces. O ID começa com wrkspc_. Se você não conseguir abrir o Claude Console, peça a alguém que consiga abri-lo para enviar o ID a você.

Defina o projeto e o workspace como variáveis de ambiente para que os clientes do SDK e a CLI ant os utilizem:

export ANTHROPIC_GOOGLE_CLOUD_PROJECT="my-project-id"
export ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID="wrkspc_01AbCdEf23GhIj"

Instale um SDK

O cliente do SDK para o Claude Models on Google Cloud (Anthropic managed) é AnthropicGoogleCloud. O cliente resolve suas credenciais do Google. Ele também monta a URL base a partir do seu projeto, localização e ID do workspace.

Instale o pacote que fornece o cliente:

pip install -U "anthropic[google_cloud]"

Para usar a CLI ant em vez disso, instale-a ou atualize-a para a versão mais recente. Uma versão sem suporte ao Claude Models on Google Cloud (Anthropic managed) ignora as variáveis ANTHROPIC_GOOGLE_CLOUD_*. Ela então faz uma das seguintes coisas:

• Envia a solicitação para a Claude API com qualquer outra credencial que você tenha configurado
• Falha com um erro de autenticação

Fazendo solicitações

O Claude Models on Google Cloud (Anthropic managed) fornece os endpoints da Claude API sob uma URL base que nomeia seu projeto, uma localização e seu workspace:

https://claude.googleapis.com/v1/projects/{project}/locations/global/workspaces/{workspace}/invoke

As rotas no nível da organização, cujos caminhos começam com /v1/organizations/, usam uma URL base sem o workspace:

https://claude.googleapis.com/v1/projects/{project}/locations/global/claudeOrganization/invoke

Se você não definir a URL base, os clientes do SDK escolhem entre essas duas para cada solicitação.

Acrescente o caminho da Claude API à URL base. Por exemplo, a Messages API fica em .../invoke/v1/messages. Três coisas diferem de uma solicitação à Claude API:

• URL base: As URLs com escopo de projeto mostradas anteriormente, no lugar de https://api.anthropic.com.
• Autenticação: Um cabeçalho Authorization: Bearer com um token de acesso do Google. Não envie um cabeçalho x-api-key.
• Workspace: O ID do workspace faz parte da URL. Não envie um cabeçalho anthropic-workspace-id.

Todo o resto é igual ao da Claude API, incluindo o seguinte:

• Os cabeçalhos anthropic-version e anthropic-beta
• O corpo da solicitação
• Streaming
• A resposta

Os exemplos de código em outras partes desta documentação criam o cliente da Claude API e leem uma chave de API. Para executar um deles com o Claude Models on Google Cloud (Anthropic managed), substitua a importação e o construtor do cliente pelos dos exemplos a seguir. Para um exemplo em cURL, aplique as três diferenças listadas anteriormente.

Antes de executar estes exemplos, conclua as etapas em Antes de fazer chamadas de API.

from anthropic import AnthropicGoogleCloud

client = AnthropicGoogleCloud()

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

O exemplo em cURL pede ao gcloud um token de Application Default Credentials. Os tokens de acesso têm vida curta. Gere um para cada sessão em vez de armazená-lo.

IDs de modelo da API

O Claude Models on Google Cloud (Anthropic managed) usa os mesmos IDs de modelo da Claude API, por exemplo claude-opus-5-5. Para os modelos e seus IDs, consulte Visão geral dos modelos.

No Claude Models on Google Cloud (Anthropic managed), uma solicitação para um modelo que não está disponível para sua organização da Anthropic retorna um erro. A mensagem de erro diz Model {model} is not available for this organization's inference configuration.

Resolução de projeto, localização e workspace

Os clientes do Claude Models on Google Cloud (Anthropic managed) aceitam as configurações da tabela a seguir. Um valor que você passa ao criar o cliente tem prioridade sobre a variável de ambiente. Para definir o projeto e o ID do workspace explicitamente, passe project e workspace_id.

Mantenha a localização como global. A localização é independente de onde a inferência é executada; portanto, para inferência somente nos EUA, defina inference_geo: "us" em cada solicitação, conforme descrito em Residência de dados.

A CLI ant aceita as mesmas configurações como flags:

• ID do projeto: --google-cloud-project
• ID do workspace: --google-cloud-workspace-id
• Localização: --google-cloud-location
• URL base: --google-cloud-base-url

A CLI usa o Claude Models on Google Cloud (Anthropic managed) quando o projeto, o ID do workspace ou a localização está definido. Definir GOOGLE_CLOUD_PROJECT, a URL base ou ambos não é suficiente.

Autenticação

Cada solicitação ao Claude Models on Google Cloud (Anthropic managed) carrega um token de acesso OAuth 2.0 do Google em um cabeçalho Authorization: Bearer. O token tem o escopo https://www.googleapis.com/auth/cloud-platform.

O Google Cloud gerencia o acesso. Seu gateway em claude.googleapis.com faz o seguinte para cada solicitação:

1. Verifica suas credenciais do Google Cloud.
2. Verifica se quem faz a chamada tem a permissão do IAM de que a solicitação precisa. Caso não tenha, o Google Cloud retorna um erro HTTP 403.
3. Encaminha a solicitação para a Anthropic. A Anthropic valida a solicitação.

Para conceder permissões, consulte Papéis do IAM.

Os clientes do SDK obtêm o token das Application Default Credentials (ADC). Qualquer fonte de credenciais compatível com ADC funciona:

• Desenvolvimento local: Execute gcloud auth application-default login.
• No Google Cloud: O cliente usa automaticamente a conta de serviço anexada à carga de trabalho, por exemplo no Compute Engine, GKE ou Cloud Run.
• Um arquivo de chave de conta de serviço: Defina GOOGLE_APPLICATION_CREDENTIALS com o caminho dele.
• Workload Identity Federation e representação de conta de serviço: Configure-os como faria para qualquer API do Google Cloud.

Verifique se as ADC estão funcionando:

gcloud auth application-default print-access-token

O Claude Models on Google Cloud (Anthropic managed) não usa chaves de API. No Claude Console, você não pode criar chaves de API para a organização da Anthropic que a configuração cria. Os clientes do SDK para o Claude Models on Google Cloud (Anthropic managed) ignoram estas variáveis de ambiente:

• ANTHROPIC_API_KEY
• ANTHROPIC_AUTH_TOKEN
• ANTHROPIC_BASE_URL

Precedência de credenciais

O cliente do SDK para o Claude Models on Google Cloud (Anthropic managed) procura credenciais na ordem a seguir. O cliente usa a primeira que encontrar:

1. Um provedor de token que você passa como token_provider ao criar o cliente. É uma função ou fonte de token que retorna um token de acesso. O cliente solicita um token a ele em cada solicitação. Armazenar em cache e renovar o token fica a seu cargo.
2. Um objeto de credenciais do Google que você passa como credentials ao criar o cliente. O SDK de Go não tem essa opção.
3. Application Default Credentials.

Go e Java diferem dos outros SDKs:

• Go: Para a opção 1, o cliente aceita um oauth2.TokenSource. Ele armazena o token em cache até que o token expire.
• Java: Use GoogleCloudBackend.fromEnv() para ler as Application Default Credentials e as variáveis de ambiente em Resolução de projeto, localização e workspace.

O cliente não tem uma variável de ambiente própria para a credencial. Use a GOOGLE_APPLICATION_CREDENTIALS das ADC em vez disso.

Se suas solicitações passam por um proxy que anexa o token para você, defina skip_auth. O cliente então não envia nenhum cabeçalho Authorization. Você não pode combinar essa configuração com as opções de credencial anteriores.

Quando a CLI ant usa o Claude Models on Google Cloud (Anthropic managed), ela sempre obtém o token das Application Default Credentials. Ela não aceita provedor de token, objeto de credenciais nem configuração de skip-auth.

Antes de usar ant com o Claude Models on Google Cloud (Anthropic managed), certifique-se de que nenhum destes esteja definido:

• Uma chave de API
• Um token de autenticação
• --profile ou ANTHROPIC_PROFILE, se nomear um perfil de configuração com o qual a CLI consiga se autenticar
• Qualquer uma das variáveis de federação da Anthropic:
  • ANTHROPIC_FEDERATION_RULE_ID
  • ANTHROPIC_ORGANIZATION_ID
  • ANTHROPIC_SERVICE_ACCOUNT_ID
  • ANTHROPIC_IDENTITY_TOKEN
  • ANTHROPIC_IDENTITY_TOKEN_FILE

Se algum estiver definido, a CLI usa essa credencial em vez das configurações do Google Cloud de Encontre o ID do seu workspace. Se apenas algumas das variáveis de federação estiverem definidas, a CLI para com um erro. Quando mais de uma credencial está definida, a CLI exibe uma nota indicando qual delas usa.

Deixe também ANTHROPIC_WORKSPACE_ID e a flag --workspace-id sem definir. A CLI ainda envia esse valor como um cabeçalho anthropic-workspace-id. As solicitações ao Claude Models on Google Cloud (Anthropic managed) não devem carregar esse cabeçalho. Defina o workspace com --google-cloud-workspace-id ou ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID em vez disso.

Assim como os clientes do SDK, a CLI não envia solicitações do Claude Models on Google Cloud (Anthropic managed) para --base-url ou ANTHROPIC_BASE_URL.

Suporte a recursos

Esta seção lista os recursos que funcionam no Claude Models on Google Cloud (Anthropic managed) e os recursos que não são compatíveis nele. Ela não lista todos os recursos da Claude API e não indica se um recurso não listado funciona.

Os recursos a seguir funcionam no Claude Models on Google Cloud (Anthropic managed) da mesma forma que na Claude API:

• "Fast mode" (modo rápido): Modo rápido para Claude Opus 5.5.

• Recursos beta: Se um beta estiver limitado a organizações selecionadas na Claude API, a organização da Anthropic que a configuração cria precisa do mesmo acesso.
• Ferramentas: Uso de ferramentas, incluindo:
  • Pesquisa na web
  • Busca na web (web fetch)
  • Execução de código
  • A ferramenta de memória
  • A ferramenta advisor
  • O conector MCP
• Skills e arquivos: Agent Skills e a Files API.
• Capacidades do modelo:
  • Cache de prompt
  • Pensamento estendido
  • Fallback no lado do servidor
  • Streaming
  • Saídas estruturadas
  • Contagem de tokens
• Batches e modelos: A Message Batches API e a Models API.

Para ativar ou desativar a Compliance API para a organização da Anthropic que a configuração cria, abra o Claude Console, vá para Settings > Compliance e use a opção Compliance API.

Chaves de criptografia gerenciadas pelo cliente (CMEK) estão disponíveis com chaves do Google Cloud KMS. Para ativar CMEK para a organização da Anthropic que a configuração cria, consulte Chaves de criptografia gerenciadas pelo cliente. Para configurar uma chave, siga Configurar o Google Cloud KMS para CMEK. Em seguida, registre, verifique e anexe a chave no Claude Console, conforme descrito na aba Claude Console da página de configuração.

Claude Managed Agents

O Claude Managed Agents está disponível por meio do Claude Models on Google Cloud (Anthropic managed), incluindo o seguinte:

• Agentes
• Ambientes
• Sessões
• Cofres de credenciais
• Armazenamentos de memória
• Implantações agendadas
• Sandboxes auto-hospedados

O acesso é verificado quando uma sessão ou uma implantação é criada, não enquanto ela é executada:

• Sessões em execução continuam em execução. Se você revogar o acesso ao Google Cloud da identidade que criou uma sessão, a sessão não para. Para interrompê-la, envie a ela um evento user.interrupt isoladamente. Depois que a sessão estiver idle, você pode arquivá-la ou excluí-la.
• Implantações agendadas continuam em execução. Uma implantação não verifica novamente o acesso de quem a criou a cada execução agendada. Para interrompê-la, pause-a, atualize-a ou arquive-a.

Ao remover um usuário ou rotacionar uma conta de serviço, revise as sessões e implantações que essa identidade criou.

Recursos não compatíveis

Os itens a seguir não são compatíveis com o Claude Models on Google Cloud (Anthropic managed):

• Chaves de API: A autenticação é feita apenas por meio de credenciais do Google Cloud.
• Túneis MCP: Os túneis MCP não estão disponíveis no Claude Models on Google Cloud (Anthropic managed).
• Memory stores em ambientes auto-hospedados: Memory stores não são compatíveis com sessões em ambientes auto-hospedados.
• Workers pré-construídos de sandbox auto-hospedado: Os workers auto-hospedados na CLI ant e nos SDKs de Python, TypeScript e Go não são compatíveis com o Claude Models on Google Cloud (Anthropic managed). Em vez disso, implemente seu próprio worker que chame diretamente os endpoints Work de Environments. Para os papéis e permissões de que seu worker precisa, consulte Permissões de IAM para ambientes.

Janela de contexto

Os tamanhos da "context window" (janela de contexto) no Claude Models on Google Cloud (Anthropic managed) são os mesmos da Claude API. Para o limite de cada modelo, consulte Janelas de contexto.

Faturamento, limites de taxa e registro em log

Limites de taxa

A Anthropic gerencia os "rate limits" (limites de taxa) do Claude Models on Google Cloud (Anthropic managed). Para solicitar limites mais altos, entre em contato com seu representante de conta da Anthropic ou fale com vendas. Para saber como os limites de taxa são medidos e informados, consulte Limites de taxa.

Faturamento

O Claude Models on Google Cloud (Anthropic managed) é faturado por meio do Google Cloud Marketplace. A Anthropic mede seu uso. Ela informa o uso ao Google Cloud em Claude Consumption Units. As cobranças aparecem na sua fatura do Google Cloud. A Anthropic não envia uma fatura separada.

Veja os dados de uso e custo nas páginas Usage e Cost no Claude Console.

Se você tiver um compromisso de gastos com o Google Cloud, o uso conta para ele da mesma forma que outras compras no Marketplace.

Retenção de dados

A Anthropic é a processadora de dados do Claude Models on Google Cloud (Anthropic managed). Alguns serviços de suporte, como os sistemas de confiança e segurança da Anthropic, processam dados fora do Google Cloud.

O Claude Models on Google Cloud (Anthropic managed) segue a mesma política de retenção de dados da Claude API. Consulte API e retenção de dados. A Zero Data Retention (ZDR) está disponível mediante solicitação. Entre em contato com seu representante de conta da Anthropic.

Um acordo de ZDR em outra organização da Anthropic não se estende à sua organização do Claude Models on Google Cloud (Anthropic managed).

Monitoramento e registro em log

O Cloud Audit Logs registra a atividade da API do Claude Models on Google Cloud (Anthropic managed) no seu projeto. As entradas aparecem sob o serviço claude.googleapis.com. Cada rota da API pertence a um de dois tipos de log:

• Logs de Data Access: Abrangem a maioria das rotas, incluindo mensagens, batches, arquivos, skills, modelos e a maioria dos recursos do Claude Managed Agents. Ficam desativados por padrão.
• Logs de Admin Activity: Abrangem as demais rotas, incluindo as rotas de chaves de criptografia e a maioria das rotas de cofres de credenciais. A exceção é a rota de vaults.verify, que é Data Access. Os logs de Admin Activity estão sempre ativados.

Para manter um registro das solicitações, ative os logs de Data Access para claude.googleapis.com nas configurações de log de auditoria do seu projeto.

Para os tipos de log de auditoria por rota, consulte Permissões do IAM para o Claude Models on Google Cloud (Anthropic managed).

IDs de solicitação

As respostas bem-sucedidas do Claude Models on Google Cloud (Anthropic managed) carregam o cabeçalho request-id.

Migrando de uma organização existente da Anthropic

Você não pode converter uma organização existente da Anthropic em uma organização do Claude Models on Google Cloud (Anthropic managed). Isso inclui uma organização que você usa diretamente com a Claude API.

Planeje a migração como uma transição para uma nova organização:

• Crie a nova organização primeiro. Siga Configure sua conta.
• Recrie o acesso e a configuração. Chaves de API, workspaces e configurações do Claude Console não são transferidos. Conceda papéis do IAM no projeto em vez de criar chaves de API. Para recriar seus workspaces, consulte Workspaces. Para acordos de ZDR, consulte Retenção de dados.
• Planeje os recursos armazenados. Arquivos, skills, batches e recursos do Claude Managed Agents permanecem na organização existente.
• Atualize sua integração. Para saber o que muda e o que permanece igual, consulte Fazendo solicitações. Para os recursos não compatíveis, consulte Recursos não compatíveis.
• Faça a transição no seu próprio ritmo. As duas organizações são independentes e podem atender tráfego em paralelo. Você pode migrar as cargas de trabalho gradualmente. A organização existente mantém seu faturamento atual. Antes de transferir o tráfego de produção, verifique os limites de taxa.

Migrando do Claude Models on Google Cloud (Google managed)

Para migrar para o Claude Models on Google Cloud (Anthropic managed), conclua as etapas a seguir. Antes de migrar cargas de trabalho que dependem de um acordo de ZDR, consulte Retenção de dados. Para saber o que muda quando você migra, consulte Como as duas ofertas do Google Cloud diferem.

1. 1

   Configure sua conta

   Conclua todas as etapas em Configure sua conta.

2. 2

   Configure o acesso

   Conceda roles/claude.user a cada identidade que chama o Claude Models on Google Cloud (Anthropic managed). Defina seu projeto e o ID do workspace como variáveis de ambiente. Para ambos, consulte Antes de fazer chamadas de API.

3. 3

   Instale o pacote do SDK

   Instale o pacote que fornece o cliente para o Claude Models on Google Cloud (Anthropic managed). Consulte Instalar um SDK.

4. 4

   Substitua a importação e o cliente

   Altere o código que importa e cria seu cliente. Use AnthropicGoogleCloud no lugar de AnthropicVertex. Em uma requisição cURL, altere a URL, os cabeçalhos e o corpo. Seu código atual cria um cliente para o Claude Models on Google Cloud (Google managed). Por exemplo, o código a seguir cria esse cliente com o endpoint global:

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   from anthropic import AnthropicVertex
   
   project_id = "MY_PROJECT_ID"
   region = "global"
   
   client = AnthropicVertex(project_id=project_id, region=region)

   O código a seguir cria o cliente para o Claude Models on Google Cloud (Anthropic managed):

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   from anthropic import AnthropicGoogleCloud
   
   client = AnthropicGoogleCloud()

   O novo cliente lê seu projeto e o ID do workspace das variáveis de ambiente que você definiu em Encontre o ID do seu workspace. Você não os passa ao criar o cliente. Suas chamadas à Messages API permanecem como estão, exceto pelos IDs de modelo e recursos da próxima etapa.

5. 5

   Verifique os IDs de modelo e os recursos

   • IDs de modelo: Se você usa um modelo anterior ao Claude 4.6, substitua o @ antes da data do snapshot em seu ID por um hífen. Por exemplo, claude-haiku-4-5@20251001 se torna claude-haiku-4-5-20251001. Para os modelos e seus IDs, consulte IDs de modelo da API.
   • Recursos: Verifique o Suporte a recursos para cada recurso que seu código usa.
   • Localização: Se você usa hoje um endpoint multirregional ou regional, verifique qual localização o Claude Models on Google Cloud (Anthropic managed) usa. Consulte Resolução de projeto, localização e workspace.
6. 6

   Execute uma requisição de teste

   Execute a requisição em Fazendo requisições para verificar se sua configuração funciona. Em seguida, execute seu próprio código. Se uma chamada falhar com um erro de permissão, consulte Solução de problemas na configuração da conta. Antes de migrar o tráfego de produção, verifique os "rate limits" (limites de taxa).

Próximos passos