> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Configure o Claude Code para usar a Claude API que a Anthropic executa por meio do seu projeto do Google Cloud, com credenciais do Google Cloud, IAM e faturamento pelo Marketplace.

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.

> [!NOTE]
>
> 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](https://code.claude.com/docs/pt/google-vertex-ai.md). Para descobrir qual deles você usa, consulte [Which offering are you using?](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/overview#which-offering-are-you-using)

Antes de começar, [instale o Claude Code](https://code.claude.com/docs/pt/setup.md#install-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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account) esteja concluída
* O [papel do IAM](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles) `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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id), que começa com `wrkspc_`
* A [gcloud CLI](https://cloud.google.com/sdk/docs/install), 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

**1. Criar as Application Default Credentials**

> [tab] Conta do Google
>
> Execute este comando no seu shell e faça login com a conta do Google que tem o papel `roles/claude.user`:
>
> ```bash theme={null}
> 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.

> [tab] Arquivo de chave de conta de serviço
>
> 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](https://docs.cloud.google.com/iam/docs/keys-create-delete). Para outras fontes de credenciais, consulte [como se autenticar](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#authentication).

**2. 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](https://code.claude.com/docs/pt/settings.md), `~/.claude/settings.json`. Se o arquivo não existir, crie-o com este conteúdo:

```json theme={null}
{
  "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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id) 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.

**3. 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`](https://code.claude.com/docs/pt/cli-reference).

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](#troubleshooting).

### Configurar o Claude Code para uma equipe

Coloque o bloco `env` da etapa 2 de [Configurar o Claude Code](#set-up-claude-code) em um arquivo de [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md) 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](https://code.claude.com/docs/pt/model-config.md#pin-models-for-third-party-deployments), 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](#set-up-claude-code):

```json theme={null}
{
  "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](https://platform.claude.com/docs/en/about-claude/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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#project-location-and-workspace-resolution) 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](https://code.claude.com/docs/pt/llm-gateway). 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](https://code.claude.com/docs/pt/fast-mode.md): você não pode ativá-lo com `/fast` nem com a configuração `fastMode`
* [Remote Control](https://code.claude.com/docs/pt/remote-control.md) e [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md)
* [Conectores MCP do claude.ai](https://code.claude.com/docs/pt/mcp.md#use-mcp-servers-from-claude-ai)
* [Canais](https://code.claude.com/docs/pt/channels.md)
* Os [comandos `/design-sync` e `/import`](https://code.claude.com/docs/pt/commands#all-commands)
* [Configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md). Para impor configurações para sua equipe, use [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md) 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](https://code.claude.com/docs/pt/feature-availability.md#summary-by-provider).

## 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](https://code.claude.com/docs/pt/settings.md#find-or-create-your-settings-files)

`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](https://code.claude.com/docs/pt/settings.md#a-value-you-set-is-ignored).

### `No workspace ID found`

Defina `ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID` como o seu [ID do workspace](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id) 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](#set-up-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](#set-up-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`](#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`](#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`](#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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#before-making-api-calls) 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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account) ou peça a um administrador do projeto que o ative

## Recursos relacionados

* [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/en/build-with-claude/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](https://code.claude.com/docs/pt/third-party-integrations.md): as outras formas de implantar o Claude Code e a configuração de proxy e gateway
* [Configuração de modelos](https://code.claude.com/docs/pt/model-config.md): aliases de modelos, fixação de uma versão de modelo e restrição de quais modelos os usuários podem selecionar