Claude Code con modelos de Claude en Google Cloud (administrados por Anthropic)

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.

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 en su lugar. Para averiguar cuál usas, consulta ¿Qué oferta estás usando?

Antes de empezar, instala 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
El rol de IAM 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, que empieza por wrkspc_
La gcloud CLI, si inicias sesión con una cuenta de Google en lugar de con un archivo de clave de cuenta de servicio

Configurar Claude Code

Crea las credenciales predeterminadas de la aplicación

Cuenta de Google
Archivo de clave de cuenta de servicio

Ejecuta este comando en tu shell e inicia sesión con la cuenta de Google que tiene el rol roles/claude.user:

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.

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. Para otras fuentes de credenciales, consulta cómo autenticarte.

Agrega las variables a tu configuración

Agrega tres variables al bloque env de tu archivo de configuración de usuario, ~/.claude/settings.json. Si el archivo no existe, créalo con este contenido:

{
  "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 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.

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.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.

Configurar Claude Code para un equipo

Coloca el bloque env del paso 2 de Configurar Claude Code en un archivo de configuración administrada 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, 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:

{
  "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 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 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. 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: no puedes activarlo con /fast ni con el ajuste fastMode
Remote Control y las sesiones en la nube
Conectores MCP de claude.ai
Canales
Los comandos /design-sync e /import
Configuración administrada por el servidor. Para aplicar la configuración a tu equipo, usa la configuración administrada 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.

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

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.

`No workspace ID found`

Establece ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID en tu ID de espacio de trabajo 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, 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. 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. 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
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
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, 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, o pide a un administrador del proyecto que lo habilite

Modelos de Claude en Google Cloud (administrados por Anthropic): configuración de la cuenta, roles de IAM, facturación, retención de datos y compatibilidad de funciones
Descripción general del despliegue empresarial: las otras formas de desplegar Claude Code, y la configuración de proxy y gateway
Configuración de modelos: alias de modelos, fijar una versión de modelo y restringir qué modelos pueden seleccionar los usuarios

Configuración y acceso

Despliegue

Gateways

Uso y costos

Seguridad y datos

Adopción

Claude Code con modelos de Claude en Google Cloud (administrados por Anthropic)

Requisitos previos

Configurar Claude Code

Configurar Claude Code para un equipo

Fijar versiones de modelos

Variables de entorno

Funciones de Claude Code que no están disponibles

Solución 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`

Requisitos previos

Configurar Claude Code

Configurar Claude Code para un equipo

Fijar versiones de modelos

Variables de entorno

Funciones de Claude Code que no están disponibles

Solución 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`