Usa modelos de Claude en Google Cloud (administrados por Anthropic)

Modelos de Claude en Google Cloud (administrados por Anthropic) es un servicio que te permite usar la plataforma para desarrolladores de Claude de Anthropic en Cloud de Confiance by S3NS. Úsala para acceder a las funciones más recientes de Anthropic, incluidos los modelos nuevos y las versiones preliminares de investigación, y a la consola de Claude.

En esta página, se abordan los siguientes temas:

Ventajas clave

Entre los beneficios clave de usar los modelos de Claude en Google Cloud (administrados por Anthropic), se incluyen los siguientes:

  • Acceso a la innovación más reciente: Obtén acceso inmediato a los modelos, las funciones, las versiones preliminares de investigación y las versiones beta más recientes de Anthropic en cuanto se lancen.
  • Integración de facturación e identidad deCloud de Confiance by S3NS : Aprovecha tu inversión existente enCloud de Confiance by S3NS . El servicio se integra en la Facturación de Cloud y en Identity and Access Management, y reduce tu compromiso de Cloud de Confiance by S3NS sujeto a la Política de reducción de compromisos de Google Cloud Marketplace.
  • Asistencia unificada: Recibe asistencia de primera línea de la asistencia de Cloud de Confiance by S3NS para problemas relacionados con Agent Platform, con asistencia especializada de segunda línea proporcionada por Anthropic en el servicio administrado.
  • Experiencia integrada de Anthropic: Accede a Claude Console para administrar recursos y explorar funciones nuevas.

Compara los modelos de Claude administrados por Anthropic y por Google

Los modelos de Claude en Google Cloud (administrados por Anthropic) y los modelos de Claude (administrados por Google) en Agent Platform difieren en quién opera la pila, la superficie de la API, la disponibilidad de las funciones y el encargado del tratamiento de datos.

Con los modelos de Claude en Google Cloud (administrados por Anthropic) (claude.googleapis.com), Anthropic administra la API y la plataforma subyacente en sus propios sistemas, y se rigen por las Condiciones del Servicio Comerciales de Anthropic, incluidas las condiciones de tratamiento de datos que se incluyen en ellas, en las que Anthropic es el encargado del tratamiento de datos.

Debes usar un modelo de Claude administrado por Google si necesitas alguna de las siguientes opciones:

  • Inferencia operada por Google en la que Cloud de Confiance by S3NS es el único encargado del tratamiento de datos
  • Datos e inferencias que permanecen dentro del límite de seguridad de Cloud de Confiance by S3NS(con Controles del servicio de VPC, claves de encriptación administradas por el cliente y residencia de datos regional)
  • Cobertura en los programas de cumplimiento de Cloud de Confiance by S3NS (incluidos los requisitos de elegibilidad de FedRAMP High, IL4, IL5, SOC, ISO y la HIPAA)
  • Cuotas y facturación Cloud de Confiance by S3NS integradas
  • Integraciones integradas en servicios de Cloud de Confiance by S3NS , como BigQuery, Model Armor y Agent Engine.

Comparación rápida

En la siguiente tabla, se describen las diferencias clave entre los modelos de Claude administrados por Anthropic y los administrados por Google:

Tipo de modelo Administrado por Anthropic Administrada por Google
Quién opera la pila Anthropic Google
Superficie de la API /v1/messages con claude.googleapis.com Extremos de predicción de Agent Platform, /v1/messages
Disponibilidad de las características Diseñada para que coincida con la API de Claude propia Según el programa de lanzamientos de Agent Platform y Model Garden
Funciones Beta Pasa con encabezados anthropic-beta La compatibilidad con el encabezado anthropic-beta varía según la versión de Model Garden
Autenticación Cloud de Confiance by S3NS IAM. Credenciales predeterminadas de la aplicación, una cuenta de servicio o gcloud auth print-access-token. No x-api-key Cloud de Confiance by S3NS IAM (mismo modelo de credenciales)
Facturación Google Cloud Marketplace (en CCU) Cloud de Confiance by S3NS (facturación de Agent Platform)
URL base claude.googleapis.com REGION-aiplatform.googleapis.com
Cliente del SDK Clase de cliente específica de la plataforma (AnthropicGoogleCloud) Cliente de Agent Platform
Console Consola deCloud de Confiance para IAM, métricas y supervisión, y consola de Claude (platform.claude.com, a la que se accede a través de Cloud de Confiance by S3NS) Consola deCloud de Confiance (Agent Platform y Model Garden)
Límites de frecuencia y cuotas Las solicitudes de cuota se pueden enviar directamente con la consola, pero Anthropic administra los límites de frecuencia y las cuotas Administrado por Cloud de Confiance by S3NS (cuotas de Agent Platform)

Compara las funciones de API compatibles

En la siguiente tabla, se compara el nivel de compatibilidad de varias funciones de la API para los modelos de Claude administrados por Anthropic y por Google:

Función Descripción Administrado por Anthropic Administrada por Google
Pensamiento (extendido, adaptable) Razonar sobre un problema antes de responder, lo que mejora la precisión en tareas complejas
Almacenamiento en caché de instrucciones (automático y explícito) Reutiliza el contenido de las instrucciones repetidas en lugar de volver a procesarlo, lo que reduce el costo y la latencia. Aplícala automáticamente o elige qué se almacena en caché.
Presupuestos de tareas (beta) Administra la inversión en agentes de larga duración otorgándole a Claude una asignación de tokens para las tareas. Claude puede priorizar y cerrar el trabajo de mejor manera.
Uso de herramientas (definido por el cliente) Conectarse a herramientas externas, llamando a las funciones, APIs y sistemas propios del cliente
Citas Devuelve los pasajes exactos que respaldan cada afirmación para verificar las respuestas y mostrar las fuentes.
Un millón de tokens de contexto, imagen/PDF (modelos compatibles) Controla hasta un millón de tokens por solicitud (suficiente para bases de código completas o cientos de documentos). Lee imágenes y archivos PDF.
Almacenamiento en caché de instrucciones (cinco minutos, una hora, automático) Define cuánto tiempo se conserva el contenido almacenado en caché (5 minutos, 1 hora) para reducir el tiempo de procesamiento y los costos de las tareas repetitivas.
Resultados estructurados Garantiza que las respuestas de Claude siempre coincidan con los esquemas JSON especificados o las definiciones de herramientas personalizadas, sin reintentos ni errores de análisis.
Procesamiento por lotes Envía varias solicitudes juntas para el procesamiento asíncrono. Es útil para grandes volúmenes de datos, optimizar la rentabilidad y cuando no se requieren respuestas inmediatas. Usa la inferencia por lotes de Agent Platform
Niveles de servicio Ofrecer diferentes niveles de servicio que permitan equilibrar la disponibilidad, el rendimiento y los costos predecibles, según las necesidades de la aplicación Prioritaria, estándar y por lotes Capacidad de procesamiento aprovisionada, por lotes
Edición de contexto (beta) Optimiza los costos, mantente dentro de los límites y ayuda a los agentes a mantener la concentración y ejecutarse durante más tiempo borrando contenido específico del historial de conversaciones a medida que crece.
Herramientas definidas por Anthropic
Búsqueda web de Google Dar acceso a la Web en tiempo real para buscar información actualizada Las respuestas incluyen citas.
Recuperación web Permite el acceso a la Web en vivo para extraer contenido de páginas web y archivos PDF específicos.
MCP remoto (beta) Conectarse a herramientas y datos externos a través de servidores de MCP remotos, directamente desde la API
Memoria Guarda y recupera información de las conversaciones para que los agentes adquieran conocimientos con el tiempo.
API de Files Sube y administra archivos una vez para usarlos con la API, en lugar de volver a enviar el mismo contenido cada vez.
Uso de la computadora Dale a Claude el control de capturas de pantalla, mouse y teclado de un entorno de escritorio para una interacción autónoma.
Habilidades Son recursos reutilizables que le brindan a Claude experiencia específica en un dominio: flujos de trabajo, contexto y prácticas recomendadas que convierten a un agente de uso general en un especialista.
Ejecución de código Permite que Claude escriba y ejecute código en un entorno de zona de pruebas para analizar datos, generar archivos y realizar iteraciones en soluciones.
Agentes administrados (beta) Usa un arnés de agentes precompilado y configurable que se ejecute en una infraestructura administrada. Es ideal para tareas de larga duración y trabajo asíncrono.
Herramienta de asesoramiento (beta) Permite que un modelo ejecutor más rápido y de menor costo (Haiku, Sonnet) consulte a un modelo asesor de mayor inteligencia (Opus) a mitad de la generación para obtener orientación estratégica, antes de que el modelo ejecutor reanude la tarea.

Comenzar

Para comenzar a usar los modelos de Claude en Google Cloud (administrados por Anthropic), sigue estos pasos para habilitar los modelos de Claude en Google Cloud (administrados por Anthropic) en tu proyecto:

  1. En la consola de Cloud de Confiance , ve a la página Modelos de Claude:

    Abre la consola de Cloud de Confiance

  2. En la lista de opciones de administrador, selecciona Administrado por Anthropic.

  3. Si aún no habilitaste la API de Claude para tu proyecto, en la sección Habilita la API de Claude, haz clic en Habilitar API y, luego, sigue las instrucciones.

  4. En la sección Compra el producto, haz clic en Comprar a través de Marketplace. Se te redireccionará a la página de Marketplace. Puedes comprar el producto al precio de lista o a través de un descuento negociado o una oferta privada. Una vez que hayas comprado el producto correctamente, haz clic en Administrar en Console para volver a la página de Model Garden.

  5. En la sección Activar Claude Console, haz clic en Activar para aprovisionar una nueva organización de Anthropic para tu proyecto de Cloud de Confiance by S3NS . Ingresa una dirección de correo electrónico de contacto única para recibir el vínculo de configuración, abre el vínculo desde esa bandeja de entrada, completa el formulario de detalles de la organización (nombre de la organización, tipo de entidad, país y uso previsto) y acepta las Condiciones del Servicio Comerciales y la Política de Uso de Anthropic. Ten en cuenta que esto crea una organización de Anthropic independiente: las claves de API, los espacios de trabajo, los controles de HIPAA, la retención de datos cero (ZDR) y la configuración de una organización de Anthropic propia existente no se transfieren.

Usa modelos de Claude en Google Cloud (administrados por Anthropic)

Después de habilitar la API de Claude y comprar el producto, puedes usar los modelos de Claude en Google Cloud (administrados por Anthropic) a través de la consola de Claude o con la API de Claude.

Consola de Claude

Para usar la consola de Claude, sigue estos pasos:

  1. Otorga el rol roles/claude.admin (administrador de la plataforma de Claude): Para usar la consola de Claude, primero debes otorgar el rol de Identity and Access Management (IAM) de roles/claude.admin (administrador de la plataforma de Claude) para el proyecto.

  2. En la consola de Cloud de Confiance , ve a la página Modelos de Claude en Google Cloud (administrados por Anthropic):

    Abre la consola de Cloud de Confiance

  3. En la sección Activa la consola de Claude, haz clic en Abrir la consola de Claude.

API de Claude

Puedes interactuar con los modelos de Claude en Google Cloud (administrado por Anthropic) con la autenticación estándar de Cloud de Confiance by S3NS. El extremo de API es https://claude.googleapis.com/.

  1. Otorga el rol roles/claude.user (usuario de la plataforma de Claude): Para realizar llamadas a la API, primero debes otorgar el rol de Identity and Access Management (IAM) de roles/claude.user (usuario de la plataforma de Claude) para el proyecto.

  2. Autentica con Cloud de Confiance by S3NS: Si usas una biblioteca cliente o Google Cloud CLI, la autenticación se controla automáticamente. Para las llamadas directas a la API, asegúrate de haberte autenticado y de poder obtener un token de OAuth 2.0. Puedes obtener un token con Google Cloud CLI:

    gcloud auth print-access-token
    
  3. Llama a la API de Messages: La estructura de la API refleja la API de Messages de Anthropic. Puedes realizar solicitudes con los SDKs de cliente de Anthropic Cloud de Confiance by S3NS(AnthropicGoogleCloud) o directamente a los extremos con alcance de espacio de trabajo en https://claude.googleapis.com/v1/projects/PROJECT_ID/locations/global/workspaces/ANTHROPIC_WORKSPACE_ID/invoke/v1/messages.

    Este es un ejemplo con curl:

    curl -X POST "https://claude.googleapis.com/v1/projects/${PROJECT_ID}/locations/global/workspaces/${ANTHROPIC_WORKSPACE_ID}/invoke/v1/messages" \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "anthropic-version: 2023-06-01" \
    -H "content-type: application/json" \
    -d '{
      "model": "claude-haiku-4-5",
      "max_tokens": 1024,
      "messages": [
        {"role": "user", "content": "Hello, Claude"}
      ]
    }'
    

Referencia de la API

Para obtener una referencia detallada de la API para mensajes, archivos y habilidades, consulta la documentación de la API de Anthropic.

Para las llamadas de REST directas a extremos con alcance de espacio de trabajo (como /v1/messages, /v1/files o /v1/skills), usa https://claude.googleapis.com/v1/projects/PROJECT_ID/locations/global/workspaces/ANTHROPIC_WORKSPACE_ID/invoke como la URL base antes de la ruta de la API de Anthropic (por ejemplo, .../invoke/v1/files). Para los extremos a nivel de la organización (como /v1/organizations/workspaces), usa https://claude.googleapis.com/v1/projects/PROJECT_ID/locations/global/claudeOrganization/invoke como la URL base.