Claude Code com Modelos Claude no Google Cloud (gerenciado pela Anthropic)

Modelos Claude no Google Cloud (gerenciado pela Anthropic) é a Claude API, executada pela Anthropic e acessada por meio do seu projeto do Google Cloud. Para usá-la a partir do Claude Code, faça login no Google Cloud e defina três variáveis de ambiente.

O Google Cloud também oferece o Claude por meio do Agent Platform do Google Cloud, anteriormente Vertex AI, que é gerenciado pelo Google. Se você usa o Agent Platform, siga Claude Code no Agent Platform do Google Cloud. Para descobrir qual deles você usa, consulte Which offering are you using?

Antes de começar, instale o Claude Code v2.1.307 ou posterior. Para verificar sua versão, execute claude --version no seu shell. Para atualizar, execute claude update.

Pré-requisitos

Um projeto do Google Cloud em que a configuração da conta esteja concluída
O papel do IAM roles/claude.user nesse projeto, para cada conta do Google ou conta de serviço que executa o Claude Code
O ID do seu projeto e o seu ID do workspace, que começa com wrkspc_
A gcloud CLI, se você fizer login com uma conta do Google em vez de um arquivo de chave de conta de serviço

Configurar o Claude Code

Criar as Application Default Credentials

Conta do Google
Arquivo de chave de conta de serviço

Execute este comando no seu shell e faça login com a conta do Google que tem o papel roles/claude.user:

gcloud auth application-default login

Execute-o mesmo que você já tenha executado gcloud auth login.Se GOOGLE_APPLICATION_CREDENTIALS estiver definida, remova a definição. Enquanto essa variável estiver definida, o Claude Code usa o arquivo que ela indica e ignora as credenciais que o comando salva.

No shell ou job de CI que executa o Claude Code, defina GOOGLE_APPLICATION_CREDENTIALS como o caminho de um arquivo de chave de conta de serviço. Para outras fontes de credenciais, consulte como se autenticar.

Adicionar as variáveis às suas configurações

Adicione três variáveis ao bloco env do seu arquivo de configurações de usuário, ~/.claude/settings.json. Se o arquivo não existir, crie-o com este conteúdo:

{
  "env": {
    "CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD": "1",
    "ANTHROPIC_GOOGLE_CLOUD_PROJECT": "my-project-id",
    "ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID": "wrkspc_01ABCDEFGHIJKLMN"
  }
}

Use o ID do seu próprio projeto e o seu ID do workspace no lugar de my-project-id e do valor wrkspc_. Para configurar apenas um shell ou um job de CI, defina as mesmas três variáveis nesse ambiente.Você não precisa fazer login em uma conta da Anthropic, nem fazer logout de uma.

Iniciar o Claude Code e verificar o provedor

Execute claude no seu shell e, em seguida, execute /status no prompt do Claude Code. A linha API provider contém on Google Cloud, e as linhas seguintes mostram seu Workspace ID, GCP project e GCP location. Para imprimir as mesmas linhas a partir do seu shell ou de um job de CI, execute claude auth status --text.Se você vir on Google Cloud, envie um prompt ou execute claude -p "hello" em um job de CI. Uma resposta confirma que suas credenciais e seu papel do IAM funcionam. Se você não vir essa linha, ou se o Claude Code mostrar um erro, solucione os problemas da configuração do provedor.

Configurar o Claude Code para uma equipe

Coloque o bloco env da etapa 2 de Configurar o Claude Code em um arquivo de configurações gerenciadas na máquina de cada desenvolvedor. Conceda a cada desenvolvedor o papel roles/claude.user no projeto e peça que cada um execute gcloud auth application-default login em sua própria máquina.

Fixar versões de modelos

Se você fizer a implantação para uma equipe, fixe os IDs dos modelos, para que uma atualização do Claude Code não mova todos para um modelo mais novo de uma só vez. Adicione estas variáveis ao bloco env que contém as três variáveis de Configurar o Claude Code:

{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
  }
}

Use os IDs de modelo da Claude API que você deseja, disponíveis em Models overview, no lugar dos valores de exemplo.

Variáveis de ambiente

Variável	Obrigatória	Descrição
`CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD`	Sim	Defina como `1` para enviar requisições de modelo para Modelos Claude no Google Cloud (gerenciado pela Anthropic)
`ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID`	Sim, exceto se você definir `ANTHROPIC_GOOGLE_CLOUD_BASE_URL`	O ID do seu workspace
`ANTHROPIC_GOOGLE_CLOUD_PROJECT`	Recomendada	O ID do seu projeto do Google Cloud. Sem ela, o Claude Code usa `GOOGLE_CLOUD_PROJECT`
`ANTHROPIC_GOOGLE_CLOUD_LOCATION`	Não	A localização na URL da requisição. O padrão é `global`
`ANTHROPIC_GOOGLE_CLOUD_BASE_URL`	Não	Substitui a URL base que o Claude Code monta a partir do projeto, da localização e do ID do workspace, por exemplo, pelo endereço de um gateway de LLM. O Claude Code acrescenta o caminho da API, como `/v1/messages`
`CLAUDE_CODE_SKIP_ANTHROPIC_GOOGLE_CLOUD_AUTH`	Não	Defina como `1` quando um gateway anexar ele mesmo as credenciais do Google, para que o Claude Code não envie nenhum token de acesso do Google

Recursos do Claude Code que não estão disponíveis

Com os Claude Models on Google Cloud (gerenciados pela Anthropic), os recursos que você não pode usar incluem:

Modo rápido: você não pode ativá-lo com /fast nem com a configuração fastMode
Remote Control e sessões na nuvem
Conectores MCP do claude.ai
Canais
Os comandos /design-sync e /import
Configurações gerenciadas pelo servidor. Para impor configurações para sua equipe, use configurações gerenciadas em cada máquina

Para ver outros recursos que não estão disponíveis ou têm suporte parcial, selecione a aba Google Cloud (Anthropic managed) no resumo de disponibilidade de recursos.

Solução de problemas

Se o Claude Code pedir que você faça login, ou se a linha API provider em /status não contiver on Google Cloud:

Certifique-se de que CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD seja 1
Certifique-se de que claude --version imprima 2.1.307 ou posterior
Remova CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_FOUNDRY e CLAUDE_CODE_USE_ANTHROPIC_AWS do seu shell e dos seus arquivos de configurações

CLAUDE_CODE_USE_VERTEX pode permanecer definida. Depois de alterar uma variável, reinicie o Claude Code. Se /status não mostrar a alteração, consulte Um valor que você definiu é ignorado.

`No workspace ID found`

Defina ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID como o seu ID do workspace e, em seguida, reinicie o Claude Code. Ignore a opção de construtor workspaceId mencionada na mensagem: ela é para quem chama o SDK da Anthropic a partir do próprio código.

`No project was given`

Defina ANTHROPIC_GOOGLE_CLOUD_PROJECT como o ID do seu projeto do Google Cloud e, em seguida, reinicie o Claude Code.

`Could not load Google Cloud credentials`

Repita a etapa 1 de Configurar o Claude Code, com uma nova chave se você usar um arquivo de chave de conta de serviço.

`Google Cloud credentials expired or invalid`

Se a mensagem pedir que você atualize suas credenciais do Google Cloud, repita a etapa 1 de Configurar o Claude Code. Com um arquivo de chave de conta de serviço, use uma nova chave.

`Google Cloud authentication failed`

Siga as etapas de Google Cloud credentials expired or invalid. Se isso não resolver o erro:

Projeto: em /status, certifique-se de que a linha GCP project indique o seu projeto. Se ela indicar outro projeto, ou se não houver essa linha, siga No project was given
Workspace: em /status, certifique-se de que a linha Workspace ID mostre o ID do seu workspace. Se ela mostrar outro, siga No workspace ID found
Papel do IAM: certifique-se de que a conta do Google ou a conta de serviço que executa o Claude Code tenha roles/claude.user ou roles/claude.admin no projeto da linha GCP project. Para conceder o papel, use o comando de concessão do serviço ou peça a um administrador do projeto que o conceda
Serviço: certifique-se de que o serviço claude.googleapis.com esteja ativado no projeto da linha GCP project. Para ativá-lo, siga as etapas de configuração da conta do serviço ou peça a um administrador do projeto que o ative

Claude Models on Google Cloud (Anthropic managed): configuração da conta, papéis do IAM, faturamento, retenção de dados e suporte a recursos
Visão geral da implantação empresarial: as outras formas de implantar o Claude Code e a configuração de proxy e gateway
Configuração de modelos: aliases de modelos, fixação de uma versão de modelo e restrição de quais modelos os usuários podem selecionar

Configuração e acesso

Implantação

Gateways

Uso e custos

Segurança e dados

Adoção

Claude Code com Modelos Claude no Google Cloud (gerenciado pela Anthropic)

Pré-requisitos

Configurar o Claude Code

Configurar o Claude Code para uma equipe

Fixar versões de modelos

Variáveis de ambiente

Recursos do Claude Code que não estão disponíveis

Solução de problemas

`No workspace ID found`

`No project was given`

`Could not load Google Cloud credentials`

`Google Cloud credentials expired or invalid`

`Google Cloud authentication failed`

Pré-requisitos

Configurar o Claude Code

Configurar o Claude Code para uma equipe

Fixar versões de modelos

Variáveis de ambiente

Recursos do Claude Code que não estão disponíveis

Solução de problemas

No workspace ID found

No project was given

Could not load Google Cloud credentials

Google Cloud credentials expired or invalid

Google Cloud authentication failed

Recursos relacionados

`No workspace ID found`

`No project was given`

`Could not load Google Cloud credentials`

`Google Cloud credentials expired or invalid`

`Google Cloud authentication failed`