Configura Claude en Google Cloud (administrado por Google)

Cuando tu empresa compra Claude a través de Google Cloud's Agent Platform, Claude Code, Claude Desktop y las aplicaciones que creas llegan todas a Claude a través de tu propio proyecto de Google Cloud. Inicias sesión con credenciales de Google Cloud, así que no necesitas una clave de API de Anthropic, y Google Cloud factura el uso.

La configuración tiene cuatro partes. Alguien prepara el proyecto una vez, luego cada persona se da acceso a sí misma. A continuación, le envías a Claude una solicitud desde tu terminal y obtienes su respuesta. Después de eso, apuntas la aplicación que usas hacia el proyecto. Si solo llamas a Claude desde tu propio código, puedes detenerte en la respuesta. Para Claude Code, has terminado cuando te responde y /status muestra el ID de tu proyecto.

Google Cloud vende Claude como dos servicios, y se configuran de manera diferente. Así que la primera tarea es verificar cuál tienes.

Verifica qué servicio tienes

Los dos servicios difieren en quién opera Claude. En Claude Models en Google Cloud (administrado por Google), Google opera los modelos de Claude como parte de Google Cloud's Agent Platform, anteriormente Vertex AI. Agent Platform es la parte de Google Cloud en la que funcionan estos pasos: activas su API, obtienes uno de sus roles, y tu uso se factura como uso de Agent Platform. En el servicio administrado por Anthropic, Anthropic opera la Claude API.

Para saber cuál es el tuyo, observa algo que ya tienes. La tabla muestra qué buscar.

Model Garden es la parte de la consola de Google Cloud donde cada modelo tiene su propia tarjeta.

Las URLs de solicitud son una tercera señal. En el servicio administrado por Google, apuntan a un host de Agent Platform, y la ruta de la URL contiene .../publishers/anthropic/models/{model}. La descripción general de los dos servicios enumera los hosts.

Si tienes el servicio administrado por Anthropic, sigue en su lugar Configura Claude en Google Cloud (administrado por Anthropic). Si llamas a api.anthropic.com con una clave de API, no estás usando ninguno de los dos servicios.

Qué necesitas, y qué cuesta

Ten esto listo antes de empezar:

• Un proyecto de Google Cloud con la facturación activada, y su ID de proyecto
• Cuota para los modelos de Claude que usarás, en la región que usarás. Las Cuotas para los modelos de Anthropic Claude de Google enumeran las cuotas predeterminadas e indican dónde ver las de tu proyecto o solicitar más.
• La CLI de gcloud, la herramienta de línea de comandos de Google Cloud
• curl y un shell de Bash, para enviar la solicitud de prueba
• Claude Code, versión 2.1.293 o posterior, si vas a usarlo. Para actualizarlo, ejecuta claude update.

En cualquier lugar donde un comando a continuación muestre YOUR-PROJECT-ID o PROJECT_ID, reemplázalo con el ID de tu proyecto.

Si acabas de instalar la CLI de gcloud, inicia sesión con gcloud auth login o gcloud init. Ese es el propio inicio de sesión de la CLI de gcloud, y la solicitud de prueba lo usa. Las Application Default Credentials, que usa Claude Code, son un inicio de sesión aparte que se trata en "Date acceso".

Google Cloud factura el uso, como uso de Agent Platform. Eso incluye lo que envías desde Claude Code o Claude Desktop. Para consultar los precios, comienza por la sección de facturación de la página de documentación de este servicio.

Prepara el proyecto, una vez

Antes de que alguien pueda llamar a Claude desde un proyecto, el proyecto necesita la API de Agent Platform activada y un modelo de Claude habilitado. Estos pasos se realizan una vez por proyecto de Google Cloud, generalmente por un administrador. Si alguien ya los ha realizado para el tuyo, continúa con "Date acceso".

1. Activa la API de Agent Platform. Apunta gcloud al proyecto, luego habilita el servicio aiplatform.googleapis.com.

   bash

   gcloud config set project YOUR-PROJECT-ID
   gcloud services enable \
     aiplatform.googleapis.com

   Los pasos previos para los modelos de Claude de Google cubren este paso y la verificación de facturación.

2. Habilita los modelos de Claude que usarás, en Model Garden. Google enumera las tarjetas de los modelos de Claude. Abre la tarjeta de cada modelo y haz clic en Habilitar. Para Claude Code, habilita claude-opus-5-5, claude-sonnet-5-5, claude-haiku-5-5 y claude-sonnet-5. Fijas los tres primeros cuando conectas Claude Code. No fijes Claude Sonnet 5. Con estos fijados, es el modelo predeterminado que verifica las acciones en modo automático, que es el modo en el que comienzan las sesiones interactivas en este servicio a menos que configures otro. Sin los fijados, Claude Code usa un modelo Claude Sonnet predeterminado que está obsoleto en este servicio.

Quien haga clic en Habilitar debe tener el rol Consumer Procurement Entitlement Manager en Identity and Access Management (IAM). Su ID es roles/consumerprocurement.entitlementManager.

Date acceso

El proyecto está listo, pero tu propia cuenta todavía necesita permiso para llamar a Claude y un inicio de sesión que Claude Code pueda usar. Cada persona realiza estos pasos para su propia cuenta.

1. Apunta gcloud al proyecto.

   bash

   gcloud config set project YOUR-PROJECT-ID

2. Obtén un rol que te permita llamar a Claude. La identidad que realiza las llamadas necesita un rol de IAM que incluya el permiso aiplatform.endpoints.predict, como Agent Platform User (roles/aiplatform.user). Este comando otorga ese rol:

   bash

   gcloud projects add-iam-policy-binding \
     PROJECT_ID \
     --member=PRINCIPAL \
     --role=roles/aiplatform.user

   Reemplaza PRINCIPAL con user: y luego tu dirección de correo electrónico, por ejemplo, user:you@example.com. La página de Google sobre cómo conceder acceso muestra las demás formas que puede tomar PRINCIPAL. Si no tienes permiso para cambiar la política de IAM del proyecto, pide a un administrador que ejecute el comando por ti.

3. Inicia sesión con Application Default Credentials. Estas son las credenciales de Google Cloud que usa Claude Code cuando llama a Claude.

   bash

   gcloud auth application-default login

Envía a Claude una solicitud de prueba

Envía a Claude una solicitud antes de conectar una aplicación. Una respuesta te indica que tanto el proyecto como tu acceso funcionan. La solicitud llama a la API de Agent Platform directamente, como lo haría una aplicación que construyas.

1. Verifica con qué cuenta ha iniciado sesión la CLI de gcloud. La solicitud obtiene su token del propio inicio de sesión de la CLI de gcloud, no de Application Default Credentials.

   bash

   gcloud auth list

   La cuenta activa debe ser la que tiene el rol de "Date acceso". Si no lo es, ejecuta gcloud auth login.

2. Envía la solicitud. Reemplaza primero YOUR-PROJECT-ID. Google Cloud factura esta solicitud igual que cualquier otra.

   bash

   curl https://aiplatform.googleapis.com/v1/projects/YOUR-PROJECT-ID/locations/global/publishers/anthropic/models/claude-opus-5-5:rawPredict \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
       "anthropic_version": "2026-10-21",
       "messages": [{"role": "user", "content": "Hey Claude!"}],
       "max_tokens": 100
     }'

   Esta solicitud usa la región global. Si necesitas residencia de datos, tanto el host como la ruta cambian. La documentación muestra la misma solicitud en la multirregión us.

3. Lee la respuesta. Es JSON, y las palabras de Claude están en la entrada content cuyo type es text. La tuya tendrá palabras diferentes y más campos que esta versión abreviada:

   json

   {
     "type": "message",
     "role": "assistant",
     "content": [{"type": "text", "text": "Hello! Nice to meet you."}],
     "stop_reason": "end_turn"
   }

Un error también se devuelve como JSON, con uno de estos códigos:

Los códigos están en la lista de errores de la API de Google. Una vez que tengas una respuesta, si una aplicación no puede llegar a Claude, revisa primero el inicio de sesión y la configuración de esa aplicación.

Conecta Claude Code o Claude Desktop

Con el proyecto listo, tu acceso configurado, y una respuesta de Claude, apunta la aplicación que usas hacia el proyecto. Ambas aplicaciones solicitan los mismos dos valores: el ID de tu proyecto y una región. Los pasos a continuación usan la región global.

Si necesitas residencia de datos, usa la multirregión us o eu. Cuesta un 10 por ciento más que global, que envía solicitudes a cualquier región con capacidad disponible. Los endpoints regionales solo sirven modelos Claude Sonnet 4.6 y anteriores. La documentación compara los endpoints globales, multirregionales y regionales.

Claude Code

El asistente de inicio de sesión se encarga de la parte de Claude Code.

1. Inicia Claude Code.

   bash

   claude

2. Elige Agent Platform. En la solicitud de inicio de sesión, selecciona 3rd-party platform, luego Google Vertex AI. Esa es la etiqueta que la solicitud de inicio de sesión todavía usa para Google Cloud's Agent Platform. Si ya tienes la sesión iniciada, ejecuta /login para abrir el mismo menú.

3. Sigue las indicaciones del asistente. Cuando te pregunte cómo te autenticas con Google Cloud, elige Application Default Credentials de gcloud, que configuraste en "Date acceso". Luego proporciónale el ID de tu proyecto y la región global. El asistente verifica qué modelos de Claude puede invocar tu proyecto y te permite fijarlos. Fija los tres: claude-opus-5-5, claude-sonnet-5-5 y claude-haiku-5-5. Si el asistente parte de una versión diferente de un modelo, cámbiala antes de fijarla. Con un modelo Haiku fijado, Claude Code lo usa para las tareas en segundo plano. El asistente guarda el resultado en tu archivo de configuración de usuario, así que no necesitas exportar las variables de entorno tú mismo.

4. Envíale un mensaje a Claude Code. Cuando te responda, Claude Code está llegando a Claude a través de Google Cloud.

Verifica que esté usando el proyecto que querías. Ejecuta /status. La línea API provider muestra Google Vertex AI. Las líneas GCP project, Default region y Model muestran el ID de tu proyecto, tu región y el modelo resuelto. Compara el ID del proyecto con el proyecto de "Prepara el proyecto, una vez".

Los modelos Claude Opus tienen un precio por token más alto que los modelos Sonnet. Con los tres fijados, el modelo principal de Claude Code sigue siendo Opus, así que se te factura a la tarifa de Opus hasta que cambies de modelo con /model. Para cambiar más tarde tus modelos fijados, proyecto, región o credenciales, ejecuta /setup-vertex para volver a abrir el asistente.

Para configurar Claude Code sin el asistente, por ejemplo, en CI o en una implementación mediante script, configura estas variables de entorno en el shell desde el que inicias claude:

export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=global
export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-5-5'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-5-5'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-5-5'

Si /status no muestra entonces la línea API provider, las variables no están llegando al proceso. Los pasos de configuración manual cubren el resto, incluido cómo fijar versiones de modelo para un equipo.

Claude Desktop

Claude Desktop puede usar modelos de Claude a través del mismo proyecto, y las sesiones de Claude Cowork se ejecutan en esa aplicación. Un administrador de TI generalmente la implementa en todos los dispositivos, así que pregunta si el tuyo ya la tiene. Para probarla en un dispositivo, completa los mismos valores manualmente.

1. Abre la ventana de configuración dentro de la aplicación. Ve a Help → Troubleshooting → Enable Developer Mode, luego Developer → Configure Third-Party Inference….

2. Elige el proveedor. En la sección Connection, configura Inference provider como Vertex AI.

3. Completa la tarjeta de credenciales de Vertex AI. Coloca el ID de tu proyecto en GCP project ID y una región en GCP region. La región puede ser global. Luego proporciona exactamente una fuente de credenciales. GCP credentials file path acepta el archivo que produce gcloud auth application-default login. Google indica dónde se guarda ese archivo.

4. Agrega un modelo. En Models, agrega al menos una entrada de Model list, usando el ID de modelo del publicador de un modelo que hayas habilitado, por ejemplo, claude-opus-5-5.

5. Aplica la configuración. Haz clic en Apply Changes. La aplicación escribe la configuración solo en este dispositivo y se reinicia con ella. Luego envía un mensaje para verificar que Claude responda.

Implementa Claude Desktop en 3P con Google Cloud's Agent Platform cubre las otras formas de iniciar sesión y cómo distribuir la configuración a todos los dispositivos.

Si no funciona

Estos errores pueden impedir que Claude Code llegue a Claude. Busca el tuyo en la tabla, y luego aplica su solución.

Un modelo puede no estar disponible en una ubicación. Algunos modelos se ofrecen solo en global o en ubicaciones multirregionales como eu y us, no en regiones específicas. Si cambias de región, verifica que tus modelos estén disponibles allí.

Estas soluciones provienen de Solución de problemas en Claude Code en Google Cloud's Agent Platform, que profundiza más. Para Claude Desktop, comienza por su propia sección de solución de problemas.

Hacia dónde ir después

Guarda el ID de tu proyecto y tu región donde puedas encontrarlos. Claude Code, Claude Desktop y los clientes SDK los solicitan a todos.

• Para aprender Claude Code, realiza Claude Code 101, luego Claude Code en acción.
• Para aprender Claude Cowork, realiza Introducción a Claude Cowork.
• Para llamar a Claude desde tu propio código, sigue la página de documentación del servicio administrado por Google. Muestra cómo instalar un SDK y hacer una solicitud con el cliente AnthropicVertex.

Para obtener más información sobre el servicio en sí, la documentación tiene una sección sobre cada uno de estos:

• Endpoints globales, multirregionales y regionales
• Límites de velocidad
• Monitoreo y registro
• Facturación