> ## 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 con modelos de Claude en Google Cloud (administrados por Anthropic)

> Configura Claude Code para usar la API de Claude que Anthropic ejecuta a través de tu proyecto de Google Cloud, con credenciales de Google Cloud, IAM y facturación de Marketplace.

Los modelos de Claude en Google Cloud (administrados por Anthropic) son la API de Claude, ejecutada por Anthropic y accesible a través de tu proyecto de Google Cloud. Para usarla desde Claude Code, inicia sesión en Google Cloud y establece tres variables de entorno.

> [!NOTE]
>
> Google Cloud también ofrece Claude a través de Agent Platform de Google Cloud, antes Vertex AI, que administra Google. Si usas Agent Platform, sigue [Claude Code en Agent Platform de Google Cloud](https://code.claude.com/docs/es/google-vertex-ai.md) en su lugar. Para averiguar cuál usas, consulta [¿Qué oferta estás usando?](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/overview#which-offering-are-you-using)

Antes de empezar, [instala Claude Code](https://code.claude.com/docs/es/setup.md#install-claude-code) v2.1.307 o posterior. Para comprobar tu versión, ejecuta `claude --version` en tu shell. Para actualizar, ejecuta `claude update`.

## Requisitos previos

* Un proyecto de Google Cloud en el que se haya completado la [configuración de la cuenta](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account)
* El [rol de IAM](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles) `roles/claude.user` en ese proyecto, para cada cuenta de Google o cuenta de servicio que ejecute Claude Code
* Tu ID de proyecto y tu [ID de espacio de trabajo](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id), que empieza por `wrkspc_`
* La [gcloud CLI](https://cloud.google.com/sdk/docs/install), si inicias sesión con una cuenta de Google en lugar de con un archivo de clave de cuenta de servicio

## Configurar Claude Code

**1. Crea las credenciales predeterminadas de la aplicación**

> [tab] Cuenta de Google
>
> Ejecuta este comando en tu shell e inicia sesión con la cuenta de Google que tiene el rol `roles/claude.user`:
>
> ```bash theme={null}
> gcloud auth application-default login
> ```
>
> Ejecútalo aunque ya hayas ejecutado `gcloud auth login`.
>
> Si `GOOGLE_APPLICATION_CREDENTIALS` está establecida, elimínala. Mientras esa variable esté establecida, Claude Code usa el archivo que indica e ignora las credenciales que guarda el comando.

> [tab] Archivo de clave de cuenta de servicio
>
> En el shell o el trabajo de CI que ejecuta Claude Code, establece `GOOGLE_APPLICATION_CREDENTIALS` en la ruta de un [archivo de clave de cuenta de servicio](https://docs.cloud.google.com/iam/docs/keys-create-delete). Para otras fuentes de credenciales, consulta [cómo autenticarte](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#authentication).

**2. Agrega las variables a tu configuración**

Agrega tres variables al bloque `env` de tu [archivo de configuración de usuario](https://code.claude.com/docs/es/settings.md), `~/.claude/settings.json`. Si el archivo no existe, créalo con este contenido:

```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"
  }
}
```

Usa tu propio ID de proyecto y tu [ID de espacio de trabajo](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id) en lugar de `my-project-id` y el valor `wrkspc_`. Para configurar un solo shell o un trabajo de CI en su lugar, establece las mismas tres variables en ese entorno.

No necesitas iniciar sesión en una cuenta de Anthropic ni cerrar sesión en una.

**3. Inicia Claude Code y comprueba el proveedor**

Ejecuta `claude` en tu shell y luego ejecuta `/status` en el prompt de Claude Code. La línea `API provider` contiene `on Google Cloud`, y las líneas siguientes muestran tu `Workspace ID`, `GCP project` y `GCP location`. Para mostrar las mismas líneas desde tu shell o un trabajo de CI, ejecuta [`claude auth status --text`](https://code.claude.com/docs/es/cli-reference).

Si ves `on Google Cloud`, envía un prompt o ejecuta `claude -p "hello"` en un trabajo de CI. Una respuesta confirma que tus credenciales y tu rol de IAM funcionan. Si no lo ves, o Claude Code muestra un error, [soluciona los problemas de la configuración del proveedor](#troubleshooting).

### Configurar Claude Code para un equipo

Coloca el bloque `env` del paso 2 de [Configurar Claude Code](#set-up-claude-code) en un archivo de [configuración administrada](https://code.claude.com/docs/es/managed-settings.md) en la máquina de cada desarrollador. Otorga a cada desarrollador el rol `roles/claude.user` en el proyecto y pide a cada uno que ejecute `gcloud auth application-default login` en su propia máquina.

## Fijar versiones de modelos

Si despliegas para un equipo, [fija los ID de modelo](https://code.claude.com/docs/es/model-config.md#pin-models-for-third-party-deployments), para que una actualización de Claude Code no cambie a todos a un modelo más reciente a la vez. Agrega estas variables al bloque `env` que contiene las tres variables de [Configurar 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"
  }
}
```

Usa los ID de modelo de la API de Claude que quieras de [Descripción general de los modelos](https://platform.claude.com/docs/en/about-claude/models/overview) en lugar de los valores de ejemplo.

## Variables de entorno

| Variable | Obligatoria | Descripción |
| - | - | - |
| `CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD` | Sí | Establécela en `1` para enviar las solicitudes de modelo a los modelos de Claude en Google Cloud (administrados por Anthropic) |
| `ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID` | Sí, salvo que establezcas `ANTHROPIC_GOOGLE_CLOUD_BASE_URL` | Tu ID de espacio de trabajo |
| `ANTHROPIC_GOOGLE_CLOUD_PROJECT` | Recomendada | Tu ID de proyecto de Google Cloud. Sin ella, Claude Code usa `GOOGLE_CLOUD_PROJECT` |
| `ANTHROPIC_GOOGLE_CLOUD_LOCATION` | No | La [ubicación](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#project-location-and-workspace-resolution) en la URL de la solicitud. El valor predeterminado es `global` |
| `ANTHROPIC_GOOGLE_CLOUD_BASE_URL` | No | Reemplaza la URL base que Claude Code construye a partir del proyecto, la ubicación y el ID de espacio de trabajo, por ejemplo con la dirección de un [gateway de LLM](https://code.claude.com/docs/es/llm-gateway). Claude Code agrega la ruta de la API, como `/v1/messages` |
| `CLAUDE_CODE_SKIP_ANTHROPIC_GOOGLE_CLOUD_AUTH` | No | Establécela en `1` cuando un gateway adjunte las credenciales de Google por sí mismo, para que Claude Code no envíe ningún token de acceso de Google |

## Funciones de Claude Code que no están disponibles

Con Claude Models on Google Cloud (administrado por Anthropic), las funciones que no puedes usar incluyen:

* [Modo rápido](https://code.claude.com/docs/es/fast-mode.md): no puedes activarlo con `/fast` ni con el ajuste `fastMode`
* [Remote Control](https://code.claude.com/docs/es/remote-control.md) y las [sesiones en la nube](https://code.claude.com/docs/es/claude-code-on-the-web.md)
* [Conectores MCP de claude.ai](https://code.claude.com/docs/es/mcp.md#use-mcp-servers-from-claude-ai)
* [Canales](https://code.claude.com/docs/es/channels.md)
* Los [comandos `/design-sync` e `/import`](https://code.claude.com/docs/es/commands#all-commands)
* [Configuración administrada por el servidor](https://code.claude.com/docs/es/server-managed-settings.md). Para aplicar la configuración a tu equipo, usa la [configuración administrada](https://code.claude.com/docs/es/managed-settings.md) en cada máquina en su lugar

Para ver otras funciones que no están disponibles o que tienen compatibilidad parcial, selecciona la pestaña **Google Cloud (Anthropic managed)** en el [resumen de disponibilidad de funciones](https://code.claude.com/docs/es/feature-availability.md#summary-by-provider).

## Solución de problemas

Si Claude Code te pide que inicies sesión, o la línea `API provider` de `/status` no contiene `on Google Cloud`:

* Asegúrate de que `CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD` sea `1`
* Asegúrate de que `claude --version` muestre 2.1.307 o posterior
* Elimina `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_FOUNDRY` y `CLAUDE_CODE_USE_ANTHROPIC_AWS` de tu shell y de tus [archivos de configuración](https://code.claude.com/docs/es/settings.md#find-or-create-your-settings-files)

`CLAUDE_CODE_USE_VERTEX` puede seguir establecida. Después de cambiar una variable, reinicia Claude Code. Si `/status` no muestra el cambio, consulta [Se ignora un valor que estableciste](https://code.claude.com/docs/es/settings.md#a-value-you-set-is-ignored).

### `No workspace ID found`

Establece `ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID` en tu [ID de espacio de trabajo](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id) y luego reinicia Claude Code. Ignora la opción de constructor `workspaceId` que menciona el mensaje: es para quienes llaman al SDK de Anthropic desde su propio código.

### `No project was given`

Establece `ANTHROPIC_GOOGLE_CLOUD_PROJECT` en tu ID de proyecto de Google Cloud y luego reinicia Claude Code.

### `Could not load Google Cloud credentials`

Repite el paso 1 de [Configurar Claude Code](#set-up-claude-code), con una clave nueva si usas un archivo de clave de cuenta de servicio.

### `Google Cloud credentials expired or invalid`

Si el mensaje te indica que actualices tus credenciales de Google Cloud, repite el paso 1 de [Configurar Claude Code](#set-up-claude-code). Con un archivo de clave de cuenta de servicio, usa una clave nueva.

### `Google Cloud authentication failed`

Sigue los pasos de [`Google Cloud credentials expired or invalid`](#google-cloud-credentials-expired-or-invalid). Si eso no resuelve el error:

* **Proyecto**: en `/status`, asegúrate de que la línea `GCP project` indique tu proyecto. Si indica otro proyecto, o no existe esa línea, sigue [`No project was given`](#no-project-was-given)
* **Espacio de trabajo**: en `/status`, asegúrate de que la línea `Workspace ID` muestre tu ID de espacio de trabajo. Si muestra otro, sigue [`No workspace ID found`](#no-workspace-id-found)
* **Rol de IAM**: asegúrate de que la cuenta de Google o la cuenta de servicio que ejecuta Claude Code tenga `roles/claude.user` o `roles/claude.admin` en el proyecto de la línea `GCP project`. Para otorgar el rol, usa [el comando de concesión del servicio](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#before-making-api-calls), o pide a un administrador del proyecto que lo otorgue
* **Servicio**: asegúrate de que el servicio `claude.googleapis.com` esté habilitado en el proyecto de la línea `GCP project`. Para habilitarlo, sigue [los pasos de configuración de la cuenta del servicio](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account), o pide a un administrador del proyecto que lo habilite

## Recursos relacionados

* [Modelos de Claude en Google Cloud (administrados por Anthropic)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed): configuración de la cuenta, roles de IAM, facturación, retención de datos y compatibilidad de funciones
* [Descripción general del despliegue empresarial](https://code.claude.com/docs/es/third-party-integrations.md): las otras formas de desplegar Claude Code, y la configuración de proxy y gateway
* [Configuración de modelos](https://code.claude.com/docs/es/model-config.md): alias de modelos, fijar una versión de modelo y restringir qué modelos pueden seleccionar los usuarios