SpyBara
Go Premium

microsoft-foundry.md 2026-10-01 23:59 UTC to 2026-10-02 16:57 UTC

This page contains 27 additions and 25 deletions.

2026
Fri 2 18:59

Claude Code en Microsoft Foundry

Aprende a configurar Claude Code a través de Microsoft Foundry, incluyendo configuración, instalación y solución de problemas.

export const ContactSalesCard = ({surface}) => { const utm = content => utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}; const iconArrowRight = (size = 13) => ; const STYLES = .cc-cs { --cs-slate: #141413; --cs-clay: #d97757; --cs-clay-deep: #c6613f; --cs-gray-000: #ffffff; --cs-gray-700: #3d3d3a; --cs-border-default: rgba(31, 30, 29, 0.15); font-family: inherit; } .dark .cc-cs { --cs-slate: #f0eee6; --cs-gray-000: #262624; --cs-gray-700: #bfbdb4; --cs-border-default: rgba(240, 238, 230, 0.14); } .cc-cs-card { display: flex; align-items: center; justify-content: space-between; gap: 16px; padding: 14px 16px; margin: 0; background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default); border-radius: 8px; flex-wrap: wrap; } .cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; } .cc-cs-text strong { font-weight: 550; color: var(--cs-slate); } .cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; } .cc-cs-btn-clay { display: inline-flex; align-items: center; gap: 8px; background: var(--cs-clay-deep); color: #fff; border: none; border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; transition: background-color 0.15s; white-space: nowrap; } .cc-cs-btn-clay:hover { background: var(--cs-clay); } .cc-cs-btn-ghost { display: inline-flex; align-items: center; gap: 8px; background: transparent; color: var(--cs-gray-700); border: 0.5px solid var(--cs-border-default); border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; } .cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); } .dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); } @media (max-width: 720px) { .cc-cs-actions { width: 100%; } }; return

Deploying Claude Code across your organization? Talk to sales about enterprise plans, SSO, and centralized billing.
<a href={https://claude.com/pricing?${utm('view_plans')}#plans-business} className="cc-cs-btn-ghost"> View plans <a href={https://claude.com/contact-sales?${utm('contact_sales')}} className="cc-cs-btn-clay"> Contact sales {iconArrowRight()}
; };

Requisitos previos

Antes de configurar Claude Code con Microsoft Foundry, asegúrese de que tiene:

  • Una suscripción de Azure con acceso a Microsoft Foundry
  • Permisos RBAC para crear recursos e implementaciones de Microsoft Foundry
  • Azure CLI instalado y configurado (opcional - solo necesario si no tiene otro mecanismo para obtener credenciales)

Configuración

1. Aprovisionar recurso de Microsoft Foundry

Primero, crea un recurso de Claude en Azure:

  1. Ve al portal de Microsoft Foundry

  2. Crea un nuevo recurso y anota el nombre de tu recurso

  3. Crea despliegues para los modelos de Claude y anota el nombre de despliegue que asignes a cada uno; establecerás estos nombres como las variables de modelo en el paso 4:

    • Claude Opus
    • Claude Sonnet
    • Claude Haiku

    Cuando configuras un despliegue, también eliges su opción de alojamiento, que determina si la inferencia se ejecuta en Azure o en la infraestructura de Anthropic.

2) Configurar credenciales de Azure

Claude Code admite tres métodos de autenticación para Microsoft Foundry. Elige el método que mejor se ajuste a tus requisitos de seguridad.

Opción A: Autenticación por clave de API

  1. Navega a tu recurso en el portal de Microsoft Foundry
  2. Ve a la sección Endpoints and keys
  3. Copia API Key
  4. Establece la variable de entorno, reemplazando your-azure-api-key con la clave que copiaste:
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key

Opción B: Autenticación de Microsoft Entra ID

Cuando ni ANTHROPIC_FOUNDRY_API_KEY ni ANTHROPIC_FOUNDRY_AUTH_TOKEN están configurados, Claude Code utiliza automáticamente la cadena de credenciales predeterminada del SDK de Azure. Esto admite una variedad de métodos para autenticar cargas de trabajo locales y remotas.

En entornos locales, comúnmente puedes usar Azure CLI:

az login

Opción C: Autenticación por token portador

Claude Code envía el valor de ANTHROPIC_FOUNDRY_AUTH_TOKEN en cada solicitud como el encabezado Authorization: Bearer. Usa esta opción cuando otro proceso, como una aplicación host o un script de inicio de sesión, ya haya obtenido un token de acceso para ti. Requiere Claude Code v2.1.203 o posterior.

Establece la variable en un token portador que Microsoft Entra ID emitió para tu recurso:

export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token

ANTHROPIC_FOUNDRY_AUTH_TOKEN tiene prioridad sobre ANTHROPIC_FOUNDRY_API_KEY y sobre la cadena de credenciales predeterminada.

3. Configurar Claude Code

Establece las siguientes variables de entorno para habilitar Microsoft Foundry:

# Enable Microsoft Foundry integration
export CLAUDE_CODE_USE_FOUNDRY=1

# Azure resource name (replace {resource} with your resource name)
export ANTHROPIC_FOUNDRY_RESOURCE={resource}
# Or provide the full base URL:
# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic

Establece ANTHROPIC_FOUNDRY_RESOURCE solo con el nombre del recurso, como my-resource. Claude Code rechaza una URL o un nombre de host cuando envías un mensaje.

4. Fijar versiones de modelo

Establece las variables de modelo para que coincidan con los nombres de despliegue que creaste en el paso 1.

Sin ANTHROPIC_DEFAULT_OPUS_MODEL, el alias opus en Microsoft Foundry se resuelve a Opus 4.6. Establécelo en el ID de un modelo Opus más reciente, como Opus 4.8:

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-5'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'

Las tareas en segundo plano, como la generación de títulos de sesión, utilizan el modelo pequeño/rápido, normalmente un modelo de clase Haiku. En Microsoft Foundry, Claude Code establece por defecto esto al modelo principal porque no todas las cuentas tienen un despliegue de Haiku. Para usar Haiku para tareas en segundo plano, establece ANTHROPIC_DEFAULT_HAIKU_MODEL en un despliegue de Haiku que esté disponible en tu cuenta, como se muestra arriba.

Para los ID de modelos actuales y heredados, consulta Descripción general de modelos. Consulta Configuración de modelo para la lista completa de variables de entorno.

La caché de prompts está habilitada automáticamente. Para solicitar un TTL de caché de 1 hora en lugar del predeterminado de 5 minutos, establece la siguiente variable; las escrituras de caché con un TTL de 1 hora se facturan a una tasa más alta:

export ENABLE_PROMPT_CACHING_1H=1

Para establecer diferentes TTL para tu conversación principal y para las solicitudes que Claude Code realiza fuera de ella, elige el TTL tú mismo.

5. Ejecutar Claude Code

Con las variables de entorno configuradas, inicia Claude Code desde tu directorio de proyecto:

claude

Claude Code lee CLAUDE_CODE_USE_FOUNDRY y las otras variables de Microsoft Foundry del entorno y se conecta a tu recurso de Azure en el primer prompt. A diferencia de Amazon Bedrock y Google Cloud's Agent Platform, Microsoft Foundry no tiene un asistente de configuración interactivo, por lo que las variables de entorno en los pasos 3 y 4 son la única ruta de configuración.

Para verificar tu configuración, ejecuta /status dentro de Claude Code. La línea del proveedor de API muestra Microsoft Foundry, junto con el nombre del recurso o la URL base que configuraste.

Configuración de RBAC de Azure

Los roles predeterminados Azure AI User y Cognitive Services User incluyen todos los permisos necesarios para invocar modelos de Claude.

Para permisos más restrictivos, cree un rol personalizado con lo siguiente:

{
  "permissions": [
    {
      "dataActions": [
        "Microsoft.CognitiveServices/accounts/providers/*"
      ]
    }
  ]
}

Para más detalles, consulte la documentación de RBAC de Microsoft Foundry.

Solución de problemas

Si recibe un error "Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed":

  • Configure Entra ID en el entorno, o establezca ANTHROPIC_FOUNDRY_API_KEY.

Si las solicitudes fallan con errores de conexión repetidos en el primer mensaje:

  • Verifique que ANTHROPIC_FOUNDRY_RESOURCE esté configurado con el nombre de recurso real en lugar de un marcador de posición. Claude Code construye la URL del punto de conexión a partir de este valor, por lo que un nombre incorrecto apunta a un host que no existe.

Recursos adicionales