SpyBara
Go Premium

microsoft-foundry.md 2026-06-09 06:34 UTC to 2026-06-10 23:57 UTC

34 added, 86 removed.

2026
Sat 27 01:01 Fri 26 23:00 Thu 25 23:58 Wed 24 22:02 Tue 23 22:00 Mon 22 23:59 Fri 19 22:58 Thu 18 22:00 Wed 17 17:02 Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51

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.

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, cree un recurso de Claude en Azure:

  1. Navegue al portal de Microsoft Foundry
  2. Cree un nuevo recurso, anotando el nombre de su recurso
  3. Cree implementaciones para los modelos de Claude:
    • Claude Opus
    • Claude Sonnet
    • Claude Haiku

2) Configurar credenciales de Azure

Claude Code admite dos métodos de autenticación para Microsoft Foundry. Elija el método que mejor se ajuste a sus requisitos de seguridad.

Opción A: Autenticación por clave API

  1. Navegue a su recurso en el portal de Microsoft Foundry
  2. Vaya a la sección Endpoints and keys (Puntos finales y claves)
  3. Copie API Key (Clave API)
  4. Establezca la variable de entorno:
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key

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

Cuando ANTHROPIC_FOUNDRY_API_KEY no está configurado, 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 puede usar Azure CLI:

az login

3. Configurar Claude Code

Establezca 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

4. Fijar versiones de modelo

Establezca las variables de modelo para que coincidan con los nombres de implementación que creó en el paso 1.

Sin ANTHROPIC_DEFAULT_OPUS_MODEL, el alias opus en Foundry se resuelve a Opus 4.6. Establézcalo en el ID de Opus 4.8 para usar el modelo más reciente:

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-6'
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 Foundry, Claude Code establece por defecto esto al modelo principal porque no todas las cuentas tienen una implementación de Haiku. Para usar Haiku para tareas en segundo plano, establezca ANTHROPIC_DEFAULT_HAIKU_MODEL en una implementación de Haiku que esté disponible en su cuenta, como se muestra arriba.

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

Prompt caching está habilitado automáticamente. Para solicitar un TTL de caché de 1 hora en lugar del predeterminado de 5 minutos, establezca 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

5. Ejecutar Claude Code

Con las variables de entorno configuradas, inicie Claude Code desde su directorio de proyecto:

claude

Claude Code lee CLAUDE_CODE_USE_FOUNDRY y las otras variables de Foundry del entorno y se conecta a su recurso de Azure en el primer mensaje. A diferencia de Bedrock y Vertex AI, 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.

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.

Recursos adicionales