Claude en Google Cloud

La API para acceder a Claude en Google Cloud's Agent Platform es casi idéntica a la Messages API, con dos diferencias clave en el formato de la solicitud:

• En Agent Platform, model no se pasa en el cuerpo de la solicitud. En su lugar, se especifica en la URL del endpoint de Google Cloud.
• En Agent Platform, anthropic_version se pasa en el cuerpo de la solicitud (en lugar de como encabezado), y debe establecerse en el valor vertex-2023-10-16.

Agent Platform también es compatible con los SDK de cliente oficiales de Anthropic. Esta guía te muestra cómo realizar una solicitud a Claude en Agent Platform usando uno de los SDK de cliente de Anthropic.

Ten en cuenta que esta guía asume que ya tienes un proyecto de Google Cloud que puede usar Agent Platform. Consulta Modelos Claude de Anthropic en Agent Platform para obtener más información sobre la configuración necesaria y un recorrido completo.



Instala un SDK para acceder a Agent Platform

Primero, instala el SDK de cliente de Anthropic para el lenguaje de tu elección.

pip install -U "anthropic[vertex]"



Acceso a Agent Platform



Disponibilidad de modelos

Ten en cuenta que la disponibilidad de los modelos de Anthropic varía según la región. Busca "Claude" en el Model Garden o ve a Modelos Claude de Anthropic para obtener la información más reciente.



IDs de modelo de la API

Los términos del ciclo de vida (Obsoleto, Retirado) se definen en Obsolescencia de modelos. Las fechas del ciclo de vida en plataformas operadas por socios las establece el socio y pueden diferir del calendario de la Claude API. Para conocer la fecha de retiro actual de cualquier modelo en Agent Platform, consulta la documentación de Google Cloud para los modelos Claude en Agent Platform.



Realizar solicitudes

Antes de ejecutar solicitudes, es posible que necesites ejecutar gcloud auth application-default login para autenticarte con Google Cloud.

Los siguientes ejemplos muestran cómo generar texto con Claude en Agent Platform:

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Consulta los SDK de cliente y la documentación oficial de Agent Platform para obtener más detalles.

Claude también está disponible a través de Amazon Bedrock, Claude Platform en AWS y Microsoft Foundry.



Retención de datos

El manejo de datos para esta oferta está regido por Google Cloud. Para obtener detalles, consulta Agent Platform y retención cero de datos.



Registro de actividad

Agent Platform proporciona un servicio de registro de solicitudes y respuestas que te permite registrar los prompts y las respuestas asociados con tu uso.

Anthropic recomienda que registres tu actividad al menos de forma continua durante 30 días para comprender tu actividad e investigar cualquier posible uso indebido.



Compatibilidad de funciones

Para ver la lista completa de funciones con disponibilidad en Google Cloud, consulta Descripción general de funciones.



Funciones compatibles destacadas

• Messages API
• Almacenamiento en caché de prompts
• Pensamiento
• Uso de herramientas, incluyendo la herramienta Bash, la herramienta de uso de computadora, la herramienta de memoria y la herramienta de editor de texto
• Herramienta de búsqueda web
• Citas
• Salidas estructuradas



Funciones no compatibles

• Fuentes de entrada (fuentes URL para imágenes y documentos, Files API)
• Herramientas del lado del servidor (ejecución de código, web fetch, advisor)
• Infraestructura de agentes (Agent Skills, conector MCP, llamada programática de herramientas)
• Endpoints de la API (Message Batches, Models, Admin, Compliance, Usage and Cost)
• Claude Managed Agents
• Fallback del lado del servidor (el parámetro fallbacks; usa en su lugar el patrón de fallback del lado del cliente)
• Conjuntos de herramientas de uso de computadora y uso de navegador (computer_toolset_20260801 y browser_toolset_20260801 no están disponibles actualmente en Google Cloud; las versiones beta de la herramienta de uso de computadora siguen disponibles)



Ventana de contexto

Claude Fable 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5 y Claude Sonnet 4.6 tienen una "context window" (ventana de contexto) de 1M de tokens en Agent Platform. Otros modelos Claude, incluidos Sonnet 4.5 y Sonnet 4 (obsoleto), tienen una ventana de contexto de 200k tokens.

Agent Platform limita las cargas útiles de las solicitudes a 30 MB. Al enviar documentos grandes o muchas imágenes, podrías alcanzar este límite antes del límite de tokens.



Endpoints globales, multirregionales y regionales

Agent Platform ofrece tres tipos de endpoints:

• Endpoints globales: Enrutamiento dinámico para máxima disponibilidad
• Endpoints multirregionales: Enrutamiento dinámico dentro de un área geográfica (por ejemplo, Estados Unidos o la Unión Europea) para residencia de datos con alta disponibilidad
• Endpoints regionales: Enrutamiento de datos garantizado a través de regiones geográficas específicas

Los endpoints regionales y multirregionales incluyen un sobreprecio del 10% respecto a los endpoints globales.



Cuándo usar cada opción

Endpoints globales (recomendado):

• Proporcionan máxima disponibilidad y tiempo de actividad
• Enrutan dinámicamente las solicitudes a regiones con capacidad disponible
• Sin sobreprecio
• Ideales para aplicaciones donde la residencia de datos es flexible
• Solo admiten tráfico de pago por uso (el rendimiento aprovisionado requiere endpoints regionales)

Endpoints multirregionales:

• Enrutan dinámicamente las solicitudes entre regiones dentro de un área geográfica (actualmente us y eu)
• Útiles cuando necesitas residencia de datos dentro de una geografía amplia pero quieres mayor disponibilidad que una sola región
• Sobreprecio del 10% respecto a los endpoints globales
• Solo admiten tráfico de pago por uso (el rendimiento aprovisionado requiere endpoints regionales)

Endpoints regionales:

• Enrutan el tráfico a través de regiones geográficas específicas
• Necesarios para residencia de datos en una sola región, mandatos de cumplimiento estrictos o rendimiento aprovisionado
• Admiten tanto pago por uso como rendimiento aprovisionado
• El sobreprecio del 10% refleja los costos de infraestructura de la capacidad regional dedicada



Implementación

Uso de endpoints globales (recomendado):

Establece el parámetro region en "global" al inicializar el cliente:

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Uso de endpoints multirregionales:

Establece el parámetro region en un identificador multirregional: "us" para Estados Unidos o "eu" para la Unión Europea. El SDK enruta las solicitudes al endpoint multirregional correspondiente (https://aiplatform.us.rep.googleapis.com o https://aiplatform.eu.rep.googleapis.com), que equilibra dinámicamente el tráfico entre las regiones dentro de esa geografía.

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us"  # Multi-region identifier: "us" or "eu"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Uso de endpoints regionales:

Especifica una región concreta como "us-east5" o "europe-west1":

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us-east5"  # Specify a specific region

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    # Los endpoints regionales específicos admiten Claude Sonnet 4.6 y anteriores; los modelos más nuevos usan los endpoints globales o multirregión
    model="claude-sonnet-4-6",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)



Recursos adicionales

• Precios de Agent Platform: Precios de IA generativa en cloud.google.com
• Documentación de los modelos Claude: Claude en Agent Platform
• Publicación del blog de Google: Endpoint global para los modelos Claude
• Detalles de precios de Anthropic: Precios en plataformas en la nube