Claude en Vertex AI: precios, Claude Code, cuotas y qué versión elegir

Hay dos formas de usar Claude sin salir de tu contrato y tu facturación de Google Cloud. Una es la versión gestionada por Google, que Google opera como parte de Agent Platform (antes Vertex AI). La otra es la versión gestionada por Anthropic, en la que usas la API de Claude operada por Anthropic desde un proyecto de Google Cloud. Esta última está disponible de forma general desde el 22 de octubre de 2026 (anuncio de Anthropic). Las dos aparecen en tu factura de Google Cloud, pero difieren en las funciones disponibles, las regiones, quién gestiona los límites de uso y la compatibilidad con Claude Code.

A partir de la documentación oficial de Anthropic y de Google Cloud (consultada el 26 de octubre de 2026), este artículo explica en qué se diferencian las dos versiones, los precios, las regiones, cómo empezar, la configuración de Claude Code y cómo afrontar las cuotas y los errores 429. En las secciones que tratan ambas versiones, aparecen en el orden gestionada por Google → gestionada por Anthropic, con los mismos colores.

1. En qué se diferencian las dos versiones

Las dos se llaman «Claude Models on Google Cloud» y se distinguen por «Google managed» o «Anthropic managed» entre paréntesis. Google llama ahora a Vertex AI «Gemini Enterprise Agent Platform», y los títulos de su documentación han pasado a Agent Platform. La pantalla de inicio de sesión de Claude Code, sin embargo, sigue mostrando «Google Vertex AI».

Fuentes: la tabla comparativa de «Claude Models on Google Cloud» de Anthropic, y «Use Claude models on Google Cloud (Anthropic managed)» y «Anthropic Claude models» de Google Cloud. Consultado el 26 de octubre de 2026.

También tienen cosas en común. Las dos se llaman con credenciales de Google Cloud (incluidas las Application Default Credentials, o ADC), y los cargos aparecen en tu factura de Google Cloud. Desde Claude 4.6, los ID de modelo son los mismos que en la API de Claude en ambas versiones (por ejemplo, claude-opus-5-5). En los modelos anteriores, solo la versión gestionada por Google pone @ antes de la fecha (por ejemplo, claude-haiku-4-5@20251001).

Con la versión gestionada por Anthropic, se crea una nueva organización de Anthropic por cada proyecto de Google Cloud. Es independiente de cualquier organización que ya uses con la API de Claude o de Claude Enterprise, y una organización existente no se puede trasladar. Las claves de API, los workspaces y la configuración de la Console no se transfieren, y recursos como los archivos y los lotes se quedan en la organización original.

2. Cómo elegir: 5 preguntas

Empieza por arriba y quédate con la primera que se aplique a tu caso. Si no se aplica ninguna, decide según lo fácil que sea estimar los costes. La versión gestionada por Google publica su lista de precios y sus cuotas predeterminadas, así que puedes estimar presupuesto y límites antes de empezar. Las ventajas de la versión gestionada por Anthropic, su amplitud de funciones y el acceso temprano a las novedades, cuentan si puedes confirmar las tarifas en la ficha de Marketplace y los límites con tu representante de Anthropic.

• Quieres usar Claude Code facturado a través de Google Cloud→Gestionada por Google
• Quieres que solo Google trate tus datos, o necesitas VPC Service Controls, almacenamiento de datos regional o certificaciones como FedRAMP High→Gestionada por Google
• Necesitas que la inferencia se ejecute solo dentro de la UE→Gestionada por Google (multirregión eu)
• Usas la Files API, Agent Skills, Managed Agents, web fetch, el conector MCP, la ejecución de código o la Message Batches API→Gestionada por Anthropic
• Quieres el modo rápido de Opus 5.5→Gestionada por Anthropic

La segunda pregunta recoge los casos en los que la documentación de Google Cloud recomienda elegir la versión gestionada por Google (Use Claude models on Google Cloud (Anthropic managed)).

También puedes usar las dos. Por ejemplo, los desarrolladores usan Claude Code a través de la versión gestionada por Google, mientras tu propia aplicación llama a Managed Agents a través de la versión gestionada por Anthropic. Ambas aparecen en la misma factura de Google Cloud, pero las consolas de administración y la gestión de los límites de uso son independientes.

3. Diferencias de funciones

Las mayores diferencias están en las funciones del lado del servidor que opera Anthropic. La versión gestionada por Google se centra en la Messages API, y no ofrece almacenamiento de archivos ni entornos de ejecución de agentes.

Fuentes: Feature support en «Claude Models on Google Cloud (Anthropic managed)», «Claude Models on Google Cloud (Google managed)» y «Fast mode» de Anthropic. El modo rápido en la versión gestionada por Google no aparece en la lista de funciones compatibles de la documentación de Anthropic, que no dice ni que esté disponible ni que no lo esté (la tabla de funciones de Claude Code lo indica como no disponible en Agent Platform). Consultado el 26 de octubre de 2026.

Para saber cómo funcionan los Managed Agents, consulta «¿Qué son los Claude Managed Agents?»; para la velocidad y el precio del modo rápido, consulta «Claude Opus 5.5: qué cambia».

4. Precios: ¿es lo mismo que la API de Claude?

Precios de la versión gestionada por Google

En el endpoint global de la versión gestionada por Google, las tarifas de entrada, salida y caché de Opus 5.5, Sonnet 5.5 y Haiku 5.5 son las mismas que en la API de Claude de Anthropic. Las multirregiones us y eu cuestan un 10 % más que global (los endpoints regionales también cuestan un 10 % más, pero solo sirven Sonnet 4.6 y modelos anteriores; consulta la sección 5).

Fuentes: «Pricing» de Anthropic, el apartado de modelos Claude de Anthropic en «Agent Platform pricing» de Google Cloud, y «Claude Models on Google Cloud (Google managed)» de Anthropic (los endpoints multirregionales y regionales cuestan un 10 % más que global, para Sonnet 4.5, Haiku 4.5, Opus 4.5 y modelos posteriores). Consultado el 26 de octubre de 2026. La versión gestionada por Anthropic no aparece en el gráfico porque sus tarifas por token no figuran en la documentación oficial (consulta la sección siguiente).

Dólares estadounidenses por millón de tokens. Tarifas de la API de Claude de Anthropic y del endpoint global de la versión gestionada por Google (páginas de precios de ambas empresas, consultadas el 26 de octubre de 2026). Las multirregiones us/eu cuestan 1,1 veces estas tarifas. Las lecturas de caché cuestan 0,05 veces la entrada en Opus 5.5 y Sonnet 5.5, y 0,1 veces en Haiku 5.5 (nota de la página de precios de Anthropic). Para la lista completa de modelos y la evolución de las tarifas, consulta «Claude Fable, Opus, Sonnet y Haiku: comparativa de precios».

El Provisioned Throughput, que reserva capacidad por una cuota fija, no está disponible en global ni en las multirregiones y requiere un endpoint regional (documentación de Google Cloud). Los endpoints regionales solo sirven Sonnet 4.6 y modelos anteriores, así que Opus 5.5, Sonnet 5.5 y Haiku 5.5 se usan con pago por uso.

Precios de la versión gestionada por Anthropic

Con la versión gestionada por Anthropic, Anthropic mide el uso en Claude Consumption Units (CCU, 1 CCU = 0,01 US$) y lo comunica a Google Cloud, y aparece en tu factura de Google Cloud. Anthropic no envía una factura aparte. Ni Anthropic ni Google Cloud publican una lista de precios por token en su documentación oficial (consultado el 26 de octubre de 2026). Lo más fiable es comprobar las tarifas en la ficha de Google Cloud Marketplace antes de contratar y, una vez empieces, hacer una pequeña prueba y confirmar el importe real en la página Usage de la Claude Console y en los informes de facturación de Google Cloud.

Hay tres cosas documentadas oficialmente:

• El modo rápido de Opus 5.5 cuesta 8 $ de entrada y 40 $ de salida por millón de tokens (página Fast mode y anuncio de Anthropic).
• Añadir inference_geo: "us" a una solicitud para que la inferencia se quede en EE. UU. multiplica por 1,1 los precios de todas las categorías («Data residency» de Anthropic).
• Si tienes un compromiso de gasto con Google Cloud, el uso cuenta para él como otras compras de Marketplace. Si tienes un acuerdo de descuento, habla con tu representante de Anthropic o de Google Cloud antes de empezar (los descuentos no se aplican con carácter retroactivo).

Precios de los lotes

Las dos versiones gestionan los lotes de forma distinta. La versión gestionada por Google usa la predicción por lotes de Agent Platform (con entrada JSONL desde BigQuery o Cloud Storage), y sus tarifas están en la columna de lotes de la página de precios de Google Cloud. La versión gestionada por Anthropic admite la misma Message Batches API que la API de Claude, pero sus tarifas por lotes tampoco figuran en la documentación oficial. El descuento por lotes de la API de Claude (directa) se explica en «Claude Fable, Opus, Sonnet y Haiku: comparativa de precios».

5. Regiones y almacenamiento de datos

En Claude sobre Google Cloud, la location a la que llamas determina dónde se ejecuta la inferencia. La versión gestionada por Google ofrece tres tipos, mientras que la versión gestionada por Anthropic solo ofrece global.

Fuentes: «Claude Models on Google Cloud (Google managed)» y «(Anthropic managed)» de Anthropic, «Agent Platform partner models» de Google Cloud. Consultado el 26 de octubre de 2026.

Los lugares de almacenamiento de datos también difieren. La versión gestionada por Google almacena los datos en la región o multirregión que elijas. Sin embargo, la página de modelos de socios de Google Cloud también dice que el lugar de procesamiento puede ser distinto del de almacenamiento. La documentación de Anthropic, en cambio, dice que la inferencia multirregional se mantiene dentro de us o eu, y no se explica cómo encajan ambas afirmaciones. Si tienes requisitos estrictos sobre dónde se procesan los datos, consúltalo con Google Cloud antes de firmar un contrato. También puedes usar la política de organización constraints/gcp.restrictEndpointUsage para bloquear el endpoint global y permitir solo las multirregiones.

En la versión gestionada por Anthropic, la región de almacenamiento del workspace es "us" y no se puede cambiar («Data residency» de Anthropic).

A 26 de octubre de 2026, las multirregiones que recoge la documentación oficial de cualquiera de las dos versiones cubren solo EE. UU. y la UE. Si el procesamiento o el almacenamiento deben quedarse dentro de un país concreto fuera de esas zonas, confirma con Google Cloud o con tu representante de Anthropic que existe una location adecuada antes de firmar un contrato.

6. Primeros pasos

Las dos versiones requieren un proyecto de Google Cloud y una cuenta de facturación con la facturación habilitada. A continuación están los pasos de la documentación oficial para habilitar cada versión, seguidos de los pasos comunes para autenticarse y llamar al modelo.

Gestionada por Google: primeros pasos

1. Habilita la API de Agent Platform

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

   Se hace una vez por proyecto.
2. Habilita en Model Garden los modelos Claude que quierasQuien los habilite necesita el rol Consumer Procurement Entitlement Manager (roles/consumerprocurement.entitlementManager). Además, la política de tu organización debe permitir cloudcommerceconsumerprocurement.googleapis.com. La documentación de Claude Code dice que la aprobación del acceso puede tardar de 24 a 48 horas (la documentación de Google Cloud no indica cuánto tarda).
3. Concede un rol a quienes hagan las llamadasConcede un rol que incluya el permiso aiplatform.endpoints.predict (roles/aiplatform.user).

Fuentes: «Claude Models on Google Cloud (Google managed)» de Anthropic, «Agent Platform partner models» de Google Cloud. Consultado el 26 de octubre de 2026.

Gestionada por Anthropic: primeros pasos

1. Contrátala en MarketplaceAbre «Claude Models on Google Cloud (Anthropic managed)» en Google Cloud Marketplace y haz clic en «Subscribe». Necesitas permisos de compra en Marketplace sobre la cuenta de facturación.
2. Habilita dos servicios

   gcloud services enable claude.googleapis.com \
     anthropic-managed-claude.cloudpartnerservices.goog \
     --project=YOUR-PROJECT-ID

   Se hace una vez por proyecto.
3. Activa la organizaciónHaz clic en «Activate» en la página de Claude y sigue el enlace enviado a tu correo de contacto para introducir el nombre de la organización, el tipo de empresa, el país y el caso de uso, y aceptar las Commercial Terms of Service y la Usage Policy de Anthropic. Requiere roles/claude.admin.
4. Anota el ID de tu workspaceEn la Claude Console (que se abre desde la consola de Google Cloud), ve a Settings > Workspaces y anota el ID que empieza por wrkspc_. Lo necesitas para hacer llamadas.
5. Concede un rol a quienes hagan las llamadasConcede roles/claude.user. Los roles son por proyecto, así que si quieres separar equipos, usa proyectos distintos (cada proyecto pasa a ser una organización de Anthropic distinta).

Fuente: Set up your account en «Claude Models on Google Cloud (Anthropic managed)» de Anthropic (consultado el 26 de octubre de 2026). No se puede iniciar sesión en la organización de Anthropic con una dirección de correo; la Console se abre desde la consola de Google Cloud.

Ambas versiones: autenticarse y llamar

En cualquiera de las dos versiones, ejecuta gcloud auth application-default login en la máquina que hace las llamadas para crear las ADC, y el SDK usará esas credenciales (en servidores, usa credenciales de cuenta de servicio). Después, llama al modelo con el cliente del SDK de la sección 7.

7. Llamar a Claude desde el SDK

Los SDK oficiales de Anthropic admiten las dos versiones. Solo cambian el paquete que instalas y el nombre del cliente; messages.create se escribe igual que con la API de Claude.

Gestionada por Google (Python)

# pip install -U "anthropic[vertex]"
from anthropic import AnthropicVertex

client = AnthropicVertex(project_id="YOUR-PROJECT-ID", region="global")  # también vale "us" o "eu"
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hola, Claude"}],
)

En TypeScript, usa AnthropicVertex de @anthropic-ai/vertex-sdk. Para llamar por HTTP sin el SDK, la URL tiene la forma https://aiplatform.googleapis.com/v1/projects/YOUR-PROJECT-ID/locations/global/publishers/anthropic/models/claude-opus-5-5:rawPredict; no pongas el nombre del modelo en el cuerpo de la solicitud y pon en él "anthropic_version" (vertex-2023-10-16 o 2026-10-21). Para streaming, usa :streamRawPredict. Lo que cambia en la nueva versión de API 2026-10-21 se explica en «temperature is deprecated for this model: causas y solución».

Gestionada por Anthropic (Python)

# pip install -U "anthropic[google_cloud]"
# Variables de entorno: ANTHROPIC_GOOGLE_CLOUD_PROJECT y
#           ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID (obligatoria)
from anthropic import AnthropicGoogleCloud

client = AnthropicGoogleCloud()
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hola, Claude"}],
)

En TypeScript, es AnthropicGoogleCloud de @anthropic-ai/google-cloud-sdk (ambos están en beta). Por HTTP, los cuerpos de solicitud y respuesta son los mismos que en la API de Claude; las diferencias son:

• URL base: https://claude.googleapis.com/v1/projects/{project}/locations/global/workspaces/{workspace}/invoke, que incluye el ID del workspace (no envíes la cabecera anthropic-workspace-id).
• Autenticación: envía un token de acceso de Google con Authorization: Bearer (no envíes x-api-key).
• Claves de API: no se pueden crear. Las variables de entorno ANTHROPIC_API_KEY y ANTHROPIC_BASE_URL se ignoran.

Fuentes: «Claude Models on Google Cloud (Anthropic managed)» y «(Google managed)» de Anthropic. Consultado el 26 de octubre de 2026.

8. Usar Claude Code en Google Cloud

En Google Cloud, Claude Code es compatible con la versión gestionada por Google. La tabla de funciones de Claude Code define Agent Platform como «run by Google, configured with CLAUDE_CODE_USE_VERTEX» (operada por Google y configurada con esa variable). La documentación de Claude Code no describe cómo usarlo con la versión gestionada por Anthropic (consultado el 26 de octubre de 2026).

Dos formas de configurarlo

1. Configúralo con el asistenteInicia claude y, en la pantalla de inicio de sesión, elige «3rd-party platform» → «Google Vertex AI» (si ya has iniciado sesión, usa /login). Te pide el método de autenticación, el proyecto y la región, y te deja comprobar qué modelos están disponibles y fijarlos. El resultado se guarda en env de tu configuración de usuario (~/.claude/settings.json), y puedes volver a abrirlo más tarde con /setup-vertex.
2. Configúralo con variables de entornoEs lo adecuado para CI y para desplegarlo en un equipo. Después de habilitar los modelos en Model Garden, define lo siguiente.

   export CLAUDE_CODE_USE_VERTEX=1
   export CLOUD_ML_REGION=global
   export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID
   
   # Fijar los modelos
   # Modelo principal: Sonnet contiene los costes. Para Opus, usa claude-opus-5-5
   export ANTHROPIC_MODEL=claude-sonnet-5-5
   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

   Los motivos para fijar los modelos se explican en el aviso de abajo.

En ambos casos, ejecuta /status después de configurarlo. Si «API provider» muestra Google Vertex AI y aparecen líneas con el proyecto de GCP, la región y el modelo, la configuración ha funcionado.

Fuentes: «Claude Code on Google Cloud's Agent Platform» y «Environment variables» de Claude Code. Consultado el 26 de octubre de 2026.

Si un modelo no está disponible en la location de CLOUD_ML_REGION, puedes cambiar la región solo para ese modelo, como en VERTEX_REGION_CLAUDE_HAIKU_4_5=us-east5 (este ejemplo llama solo a Haiku 4.5 en la región us-east5). CLOUD_ML_REGION admite global, us o eu, o un nombre de región como us-east5. Claude Agent SDK también usa la versión gestionada por Google con las mismas variables de entorno (consulta «¿Qué es Claude Agent SDK?»).

Funciones de Claude Code disponibles en Agent Platform

El computer use de esta tabla es la función de Claude Code (que requiere suscripción), no la herramienta computer use de la API de la sección 3. Fuente: «Feature availability» de Claude Code (/logout y la búsqueda de herramientas MCP proceden de «Claude Code on Google Cloud's Agent Platform»). Consultado el 26 de octubre de 2026. Los conectores de claude.ai tampoco se cargan (consulta «claude.ai connectors are disabled en Claude Code»).

9. Cuotas y errores 429

Gestionada por Google: las cuotas son por familia de modelos

Los modelos lanzados después del 26 de mayo de 2026 (Opus 5.5, Sonnet 5.5, Haiku 5.5 y otros) usan cuotas compartidas por toda la familia de modelos (para modelos anteriores, consulta las cuotas por modelo en la misma página de Google Cloud). Por ejemplo, llames a la versión de Opus que llames en global, consume la misma cuota anthropic-claude-opus, y no necesitas volver a solicitar cuota cuando sale una versión nueva. global y cada multirregión tienen cuotas independientes.

Fuente: cuotas predeterminadas de «Quotas for Anthropic Claude models» de Google Cloud (consultado el 26 de octubre de 2026). La entrada es la suma de los tokens sin caché y las escrituras de caché. Google señala que los límites varían según la cuenta y pueden estar restringidos.

Consulta las cuotas y solicita aumentos en la página «Quotas & System Limits» de la consola de Google Cloud. Filtrar por base_model (por ejemplo, anthropic-claude-opus) facilita encontrarlas. Los recuentos de tokens de esa página pueden ser inexactos por cómo funcionan las estimaciones y los reembolsos; para recuentos exactos, usa la API de recuento de tokens o token_count en Metrics Explorer.

Cuando superas una cuota, recibes un error 429 con este mensaje:

Resource exhausted, please try again later.

Este es el mensaje para el uso con pago por uso («Error code 429» de Google Cloud). Con Provisioned Throughput, es «Too many requests. Exceeded the Provisioned Throughput.»

1. Usa global si no tienes requisitos sobre dónde se hace la inferenciaTiene cuotas más grandes que las multirregiones y se procesa en la región que tenga capacidad. En Claude Code, define CLOUD_ML_REGION=global. Si tienes un requisito como mantener la inferencia dentro de la UE, sáltate este paso y solicita primero un aumento (paso 3).
2. Espera y reintentaReintenta con backoff exponencial con tope, y evita los picos bruscos de volumen.
3. Solicita un aumento de cuotaSolicítalo desde la página «Quotas & System Limits» mencionada arriba.

Fuentes: «Error code 429» de Google Cloud, la resolución de problemas de «Claude Code on Google Cloud's Agent Platform» de Claude Code.

Gestionada por Anthropic: Anthropic gestiona los límites

Los límites de uso los gestiona Anthropic, y los valores predeterminados no figuran en la documentación oficial. Para aumentarlos, habla con tu representante de Anthropic o con ventas. La documentación de Anthropic recomienda confirmar tus límites antes de trasladar tráfico de producción. Los errores tienen la misma forma que en la API de Claude: superar un límite devuelve un 429 rate_limit_error, y la congestión devuelve un 529 overloaded_error. Si faltan permisos de IAM, Google Cloud devuelve 403.

1. Espera y reintentaReintenta con backoff exponencial y evita los picos bruscos de volumen (igual que en la versión gestionada por Google).
2. Confirma los límites antes de pasar a producciónAntes de migrar, indica a tu representante de Anthropic el volumen que necesitas y confirma tus límites.
3. Pide un aumento de límiteHabla con tu representante de Anthropic o con ventas. Los límites no se pueden aumentar desde la página de cuotas de Google Cloud.

Fuentes: Rate limits en «Claude Models on Google Cloud (Anthropic managed)» de Anthropic, y «Errors». Consultado el 26 de octubre de 2026.

Resumen

Preguntas frecuentes

P. ¿Claude en Vertex AI es más caro que la API de Claude?

En el endpoint global de la versión gestionada por Google, las tarifas de entrada, salida y caché de Opus 5.5, Sonnet 5.5 y Haiku 5.5 son las mismas. Las multirregiones us y eu cuestan un 10 % más (páginas de precios de Anthropic y Google Cloud, consultadas el 26 de octubre de 2026). En la versión gestionada por Anthropic, las tarifas por token no figuran en la documentación oficial, así que consulta la ficha de Google Cloud Marketplace.

P. ¿Puedo usar una clave de API de Claude?

Las dos versiones se llaman con autenticación de Google Cloud (ADC o una cuenta de servicio), no con una clave de API creada en la Claude Console. La versión gestionada por Anthropic no puede crear claves de API, y si defines ANTHROPIC_API_KEY, se ignora.

P. ¿Puedo usar Claude Code con la versión gestionada por Anthropic?

La documentación de Claude Code no describe una configuración para la versión gestionada por Anthropic (consultado el 26 de octubre de 2026). La opción de Google Cloud de Claude Code (CLAUDE_CODE_USE_VERTEX) es para la versión gestionada por Google.

P. ¿Puedo pasar mi organización de Anthropic actual a la facturación de Google Cloud?

No. La versión gestionada por Anthropic crea una nueva organización por proyecto, y las organizaciones existentes no se pueden convertir. Las claves de API, los workspaces y la configuración de la Console no se transfieren, así que tienes que volver a crearlos en la nueva organización.