Claude en plataformas de terceros

Claude en Microsoft Foundry

Accede a los modelos de Claude a través de Microsoft Foundry con puntos finales de autenticación nativos de Azure.

Esta guía te llevará a través del proceso de configuración y realización de llamadas API a Claude en Foundry en Python, TypeScript, o usando solicitudes HTTP directas. Cuando puedas acceder a Claude en Foundry, se te facturará por el uso de Claude en Microsoft Marketplace con tu suscripción de Azure, permitiéndote acceder a las últimas capacidades de Claude mientras administras costos a través de tu suscripción de Azure.

Disponibilidad regional: En el lanzamiento, Claude está disponible como un tipo de implementación Global Standard en recursos de Foundry con US DataZone próximamente. Los precios de Claude en Microsoft Marketplace utilizan los precios estándar de API de Anthropic. Visita nuestra página de precios para más detalles.

Vista previa

En esta integración de plataforma de vista previa, los modelos de Claude se ejecutan en la infraestructura de Anthropic. Esta es una integración comercial para facturación y acceso a través de Azure. Como procesador independiente para Microsoft, los clientes que usan Claude a través de Microsoft Foundry están sujetos a los términos de uso de datos de Anthropic. Anthropic continúa proporcionando sus compromisos de seguridad y datos líderes en la industria, incluida la disponibilidad de retención de datos cero.

Requisitos previos

Antes de comenzar, asegúrate de tener:

Una suscripción activa de Azure
Acceso a Foundry
La CLI de Azure instalada (opcional, para la gestión de recursos)

Instalar un SDK

Los SDK de cliente de Anthropic admiten Foundry a través de paquetes específicos de la plataforma.

# Python
pip install -U "anthropic"

# Typescript
npm install @anthropic-ai/foundry-sdk

Aprovisionamiento

Foundry utiliza una jerarquía de dos niveles: los recursos contienen tu configuración de seguridad y facturación, mientras que las implementaciones son las instancias de modelo que llamas a través de API. Primero crearás un recurso de Foundry, luego crearás una o más implementaciones de Claude dentro de él.

Aprovisionamiento de recursos de Foundry

Crea un recurso de Foundry, que es necesario para usar y administrar servicios en Azure. Puedes seguir estas instrucciones para crear un recurso de Foundry. Alternativamente, puedes comenzar creando un proyecto de Foundry, que implica crear un recurso de Foundry.

Para aprovisionar tu recurso:

Navega al portal de Foundry
Crea un nuevo recurso de Foundry o selecciona uno existente
Configura la gestión de acceso usando claves API emitidas por Azure o Entra ID para control de acceso basado en roles
Opcionalmente, configura el recurso para que sea parte de una red privada (Red Virtual de Azure) para mayor seguridad
Anota el nombre de tu recurso—lo usarás como {resource} en los puntos finales de API (por ejemplo, https://{resource}.services.ai.azure.com/anthropic/v1/*)

Creación de implementaciones de Foundry

Después de crear tu recurso, implementa un modelo de Claude para que esté disponible para llamadas API:

En el portal de Foundry, navega a tu recurso
Ve a Modelos + puntos finales y selecciona + Implementar modelo > Implementar modelo base
Busca y selecciona un modelo de Claude (por ejemplo, claude-sonnet-4-5)
Configura los ajustes de implementación:
- Nombre de implementación: Por defecto es el ID del modelo, pero puedes personalizarlo (por ejemplo, my-claude-deployment). El nombre de implementación no se puede cambiar después de que haya sido creado.
- Tipo de implementación: Selecciona Global Standard (recomendado para Claude)
Selecciona Implementar y espera a que se complete el aprovisionamiento
Una vez implementado, puedes encontrar tu URL de punto final y claves bajo Claves y Punto final

El nombre de implementación que elijas se convierte en el valor que pasas en el parámetro model de tus solicitudes API. Puedes crear múltiples implementaciones del mismo modelo con diferentes nombres para administrar configuraciones separadas o límites de velocidad.

Autenticación

Claude en Foundry admite dos métodos de autenticación: claves API y tokens de Entra ID. Ambos métodos utilizan puntos finales alojados en Azure en el formato https://{resource}.services.ai.azure.com/anthropic/v1/*.

Autenticación con clave API

Después de aprovisionar tu recurso de Claude en Foundry, puedes obtener una clave API del portal de Foundry:

Navega a tu recurso en el portal de Foundry
Ve a la sección Claves y Punto final
Copia una de las claves API proporcionadas
Usa el encabezado api-key o x-api-key en tus solicitudes, o proporciónalo al SDK

Los SDK de Python y TypeScript requieren una clave API y un nombre de recurso o URL base. Los SDK leerán automáticamente estos valores de las siguientes variables de entorno si están definidas:

ANTHROPIC_FOUNDRY_API_KEY - Tu clave API
ANTHROPIC_FOUNDRY_RESOURCE - El nombre de tu recurso (por ejemplo, example-resource)
ANTHROPIC_FOUNDRY_BASE_URL - Alternativa al nombre del recurso; la URL base completa (por ejemplo, https://example-resource.services.ai.azure.com/anthropic/)

Los parámetros resource y base_url son mutuamente excluyentes. Proporciona el nombre del recurso (que el SDK usa para construir la URL como https://{resource}.services.ai.azure.com/anthropic/) o la URL base completa directamente.

Ejemplo usando clave API:

import os
from anthropic import AnthropicFoundry

client = AnthropicFoundry(
    api_key=os.environ.get("ANTHROPIC_FOUNDRY_API_KEY"),
    resource='example-resource', # your resource name
)

message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content)

Mantén tus claves API seguras. Nunca las confirmes en el control de versiones ni las compartas públicamente. Cualquiera con acceso a tu clave API puede hacer solicitudes a Claude a través de tu recurso de Foundry.

Autenticación de Microsoft Entra

Para mayor seguridad y gestión centralizada del acceso, puedes usar tokens de Entra ID (anteriormente Azure Active Directory):

Habilita la autenticación de Entra para tu recurso de Foundry
Obtén un token de acceso de Entra ID
Usa el token en el encabezado Authorization: Bearer {TOKEN}

Ejemplo usando Entra ID:

import os
from anthropic import AnthropicFoundry
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

# Get Azure Entra ID token using token provider pattern
token_provider = get_bearer_token_provider(
    DefaultAzureCredential(),
    "https://cognitiveservices.azure.com/.default"
)

# Create client with Entra ID authentication
client = AnthropicFoundry(
    resource='example-resource', # your resource name
    azure_ad_token_provider=token_provider  # Use token provider for Entra ID auth
)

# Make request
message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content)

La autenticación de Azure Entra ID te permite administrar el acceso usando Azure RBAC, integrar con la gestión de identidades de tu organización y evitar administrar claves API manualmente.

IDs de solicitud de correlación

Foundry incluye identificadores de solicitud en los encabezados de respuesta HTTP para depuración y rastreo. Cuando contactes con soporte, proporciona tanto los valores request-id como apim-request-id para ayudar a los equipos a localizar e investigar rápidamente tu solicitud en los sistemas de Anthropic y Azure.

Características admitidas

Claude en Foundry admite la mayoría de las poderosas características de Claude. Puedes encontrar todas las características actualmente admitidas aquí.

Características no admitidas

Admin API (puntos finales /v1/organizations/*)
Models API (/v1/models)
Message Batch API (/v1/messages/batches)

Respuestas de API

Las respuestas de API de Claude en Foundry siguen el formato de respuesta estándar de API de Anthropic. Esto incluye el objeto usage en los cuerpos de respuesta, que proporciona información detallada sobre el consumo de tokens para tus solicitudes. El objeto usage es consistente en todas las plataformas (API de primera parte, Foundry, Amazon Bedrock y Google Vertex AI).

Para detalles sobre encabezados de respuesta específicos de Foundry, consulta la sección de IDs de solicitud de correlación.

IDs de modelo de API e implementaciones

Los siguientes modelos de Claude están disponibles a través de Foundry. Los modelos de última generación (Sonnet 4.5, Opus 4.1 y Haiku 4.5) ofrecen las capacidades más avanzadas:

Modelo	Nombre de implementación predeterminado
Claude Sonnet 4.5	`claude-sonnet-4-5`
Claude Opus 4.1	`claude-opus-4-1`
Claude Haiku 4.5	`claude-haiku-4-5`

Por defecto, los nombres de implementación coinciden con los IDs de modelo mostrados arriba. Sin embargo, puedes crear implementaciones personalizadas con diferentes nombres en el portal de Foundry para administrar diferentes configuraciones, versiones o límites de velocidad. Usa el nombre de implementación (no necesariamente el ID del modelo) en tus solicitudes API.

Monitoreo y registro

Azure proporciona capacidades integrales de monitoreo y registro para tu uso de Claude a través de patrones estándar de Azure:

Azure Monitor: Rastrear uso de API, latencia y tasas de error
Azure Log Analytics: Consultar y analizar registros de solicitud/respuesta
Gestión de costos: Monitorear y pronosticar costos asociados con el uso de Claude

Anthropic recomienda registrar tu actividad en al menos una base móvil de 30 días para entender patrones de uso e investigar cualquier problema potencial.

Los servicios de registro de Azure se configuran dentro de tu suscripción de Azure. Habilitar el registro no proporciona a Microsoft o Anthropic acceso a tu contenido más allá de lo necesario para facturación y operación del servicio.

Solución de problemas

Errores de autenticación

Error: 401 Unauthorized o Invalid API key

Solución: Verifica que tu clave API sea correcta. Puedes obtener una nueva clave API del portal de Azure bajo Claves y Punto final para tu recurso de Claude.
Solución: Si usas Azure Entra ID, asegúrate de que tu token de acceso sea válido y no haya expirado. Los tokens típicamente expiran después de 1 hora.

Error: 403 Forbidden

Solución: Tu cuenta de Azure puede carecer de los permisos necesarios. Asegúrate de tener el rol de Azure RBAC apropiado asignado (por ejemplo, "Cognitive Services OpenAI User").

Limitación de velocidad

Error: 429 Too Many Requests

Solución: Has excedido tu límite de velocidad. Implementa lógica de retroceso exponencial y reintento en tu aplicación.
Solución: Considera solicitar aumentos de límite de velocidad a través del portal de Azure o soporte de Azure.

Encabezados de límite de velocidad

Foundry no incluye los encabezados de límite de velocidad estándar de Anthropic (anthropic-ratelimit-tokens-limit, anthropic-ratelimit-tokens-remaining, anthropic-ratelimit-tokens-reset, anthropic-ratelimit-input-tokens-limit, anthropic-ratelimit-input-tokens-remaining, anthropic-ratelimit-input-tokens-reset, anthropic-ratelimit-output-tokens-limit, anthropic-ratelimit-output-tokens-remaining y anthropic-ratelimit-output-tokens-reset) en respuestas. Administra la limitación de velocidad a través de las herramientas de monitoreo de Azure en su lugar.

Errores de modelo e implementación

Error: Model not found o Deployment not found

Solución: Verifica que estés usando el nombre de implementación correcto. Si no has creado una implementación personalizada, usa el ID de modelo predeterminado (por ejemplo, claude-sonnet-4-5).
Solución: Asegúrate de que el modelo/implementación esté disponible en tu región de Azure.

Error: Invalid model parameter

Solución: El parámetro model debe contener el nombre de tu implementación, que se puede personalizar en el portal de Foundry. Verifica que la implementación exista y esté configurada correctamente.

Recursos adicionales

Documentación de Foundry: ai.azure.com/catalog
Precios de Azure: azure.microsoft.com/en-us/pricing
Detalles de precios de Anthropic: Documentación de precios
Guía de autenticación: Consulta la sección de autenticación arriba
Portal de Azure: portal.azure.com

Claude en plataformas de terceros

Claude en Microsoft Foundry

Accede a los modelos de Claude a través de Microsoft Foundry con puntos finales de autenticación nativos de Azure.

Vista previa

Requisitos previos

Antes de comenzar, asegúrate de tener:

Una suscripción activa de Azure
Acceso a Foundry
La CLI de Azure instalada (opcional, para la gestión de recursos)

Instalar un SDK

Los SDK de cliente de Anthropic admiten Foundry a través de paquetes específicos de la plataforma.

# Python
pip install -U "anthropic"

# Typescript
npm install @anthropic-ai/foundry-sdk

Aprovisionamiento

Aprovisionamiento de recursos de Foundry

Para aprovisionar tu recurso:

Navega al portal de Foundry
Crea un nuevo recurso de Foundry o selecciona uno existente
Configura la gestión de acceso usando claves API emitidas por Azure o Entra ID para control de acceso basado en roles
Opcionalmente, configura el recurso para que sea parte de una red privada (Red Virtual de Azure) para mayor seguridad
Anota el nombre de tu recurso—lo usarás como {resource} en los puntos finales de API (por ejemplo, https://{resource}.services.ai.azure.com/anthropic/v1/*)

Creación de implementaciones de Foundry

Después de crear tu recurso, implementa un modelo de Claude para que esté disponible para llamadas API:

En el portal de Foundry, navega a tu recurso
Ve a Modelos + puntos finales y selecciona + Implementar modelo > Implementar modelo base
Busca y selecciona un modelo de Claude (por ejemplo, claude-sonnet-4-5)
Configura los ajustes de implementación:
- Nombre de implementación: Por defecto es el ID del modelo, pero puedes personalizarlo (por ejemplo, my-claude-deployment). El nombre de implementación no se puede cambiar después de que haya sido creado.
- Tipo de implementación: Selecciona Global Standard (recomendado para Claude)
Selecciona Implementar y espera a que se complete el aprovisionamiento
Una vez implementado, puedes encontrar tu URL de punto final y claves bajo Claves y Punto final

Autenticación

Autenticación con clave API

Después de aprovisionar tu recurso de Claude en Foundry, puedes obtener una clave API del portal de Foundry:

Navega a tu recurso en el portal de Foundry
Ve a la sección Claves y Punto final
Copia una de las claves API proporcionadas
Usa el encabezado api-key o x-api-key en tus solicitudes, o proporciónalo al SDK

Los SDK de Python y TypeScript requieren una clave API y un nombre de recurso o URL base. Los SDK leerán automáticamente estos valores de las siguientes variables de entorno si están definidas:

ANTHROPIC_FOUNDRY_API_KEY - Tu clave API
ANTHROPIC_FOUNDRY_RESOURCE - El nombre de tu recurso (por ejemplo, example-resource)
ANTHROPIC_FOUNDRY_BASE_URL - Alternativa al nombre del recurso; la URL base completa (por ejemplo, https://example-resource.services.ai.azure.com/anthropic/)

Ejemplo usando clave API:

import os
from anthropic import AnthropicFoundry

client = AnthropicFoundry(
    api_key=os.environ.get("ANTHROPIC_FOUNDRY_API_KEY"),
    resource='example-resource', # your resource name
)

message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content)

Autenticación de Microsoft Entra

Para mayor seguridad y gestión centralizada del acceso, puedes usar tokens de Entra ID (anteriormente Azure Active Directory):

Habilita la autenticación de Entra para tu recurso de Foundry
Obtén un token de acceso de Entra ID
Usa el token en el encabezado Authorization: Bearer {TOKEN}

Ejemplo usando Entra ID:

import os
from anthropic import AnthropicFoundry
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

# Get Azure Entra ID token using token provider pattern
token_provider = get_bearer_token_provider(
    DefaultAzureCredential(),
    "https://cognitiveservices.azure.com/.default"
)

# Create client with Entra ID authentication
client = AnthropicFoundry(
    resource='example-resource', # your resource name
    azure_ad_token_provider=token_provider  # Use token provider for Entra ID auth
)

# Make request
message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content)

La autenticación de Azure Entra ID te permite administrar el acceso usando Azure RBAC, integrar con la gestión de identidades de tu organización y evitar administrar claves API manualmente.

IDs de solicitud de correlación

Características admitidas

Claude en Foundry admite la mayoría de las poderosas características de Claude. Puedes encontrar todas las características actualmente admitidas aquí.

Características no admitidas

Admin API (puntos finales /v1/organizations/*)
Models API (/v1/models)
Message Batch API (/v1/messages/batches)

Respuestas de API

Para detalles sobre encabezados de respuesta específicos de Foundry, consulta la sección de IDs de solicitud de correlación.

IDs de modelo de API e implementaciones

Los siguientes modelos de Claude están disponibles a través de Foundry. Los modelos de última generación (Sonnet 4.5, Opus 4.1 y Haiku 4.5) ofrecen las capacidades más avanzadas:

Modelo	Nombre de implementación predeterminado
Claude Sonnet 4.5	`claude-sonnet-4-5`
Claude Opus 4.1	`claude-opus-4-1`
Claude Haiku 4.5	`claude-haiku-4-5`

Monitoreo y registro

Azure proporciona capacidades integrales de monitoreo y registro para tu uso de Claude a través de patrones estándar de Azure:

Azure Monitor: Rastrear uso de API, latencia y tasas de error
Azure Log Analytics: Consultar y analizar registros de solicitud/respuesta
Gestión de costos: Monitorear y pronosticar costos asociados con el uso de Claude

Anthropic recomienda registrar tu actividad en al menos una base móvil de 30 días para entender patrones de uso e investigar cualquier problema potencial.

Solución de problemas

Errores de autenticación

Error: 401 Unauthorized o Invalid API key

Solución: Verifica que tu clave API sea correcta. Puedes obtener una nueva clave API del portal de Azure bajo Claves y Punto final para tu recurso de Claude.
Solución: Si usas Azure Entra ID, asegúrate de que tu token de acceso sea válido y no haya expirado. Los tokens típicamente expiran después de 1 hora.

Error: 403 Forbidden

Solución: Tu cuenta de Azure puede carecer de los permisos necesarios. Asegúrate de tener el rol de Azure RBAC apropiado asignado (por ejemplo, "Cognitive Services OpenAI User").

Limitación de velocidad

Error: 429 Too Many Requests

Solución: Has excedido tu límite de velocidad. Implementa lógica de retroceso exponencial y reintento en tu aplicación.
Solución: Considera solicitar aumentos de límite de velocidad a través del portal de Azure o soporte de Azure.

Encabezados de límite de velocidad

Errores de modelo e implementación

Error: Model not found o Deployment not found

Solución: Verifica que estés usando el nombre de implementación correcto. Si no has creado una implementación personalizada, usa el ID de modelo predeterminado (por ejemplo, claude-sonnet-4-5).
Solución: Asegúrate de que el modelo/implementación esté disponible en tu región de Azure.

Error: Invalid model parameter

Solución: El parámetro model debe contener el nombre de tu implementación, que se puede personalizar en el portal de Foundry. Verifica que la implementación exista y esté configurada correctamente.

Recursos adicionales

Documentación de Foundry: ai.azure.com/catalog
Precios de Azure: azure.microsoft.com/en-us/pricing
Detalles de precios de Anthropic: Documentación de precios
Guía de autenticación: Consulta la sección de autenticación arriba
Portal de Azure: portal.azure.com