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 no Microsoft Foundry

Saiba como configurar Claude Code através do Microsoft Foundry, incluindo configuração, instalação e resolução de problemas.

Pré-requisitos

Antes de configurar Claude Code com Microsoft Foundry, certifique-se de que você tem:

  • Uma assinatura do Azure com acesso ao Microsoft Foundry
  • Permissões RBAC para criar recursos e implantações do Microsoft Foundry
  • Azure CLI instalado e configurado (opcional - necessário apenas se você não tiver outro mecanismo para obter credenciais)

Configuração

1. Provisionar recurso do Microsoft Foundry

Primeiro, crie um recurso Claude no Azure:

  1. Navegue até o portal do Microsoft Foundry
  2. Crie um novo recurso, anotando o nome do seu recurso
  3. Crie implantações para os modelos Claude:
    • Claude Opus
    • Claude Sonnet
    • Claude Haiku

2) Configurar credenciais do Azure

Claude Code suporta dois métodos de autenticação para Microsoft Foundry. Escolha o método que melhor se adequa aos seus requisitos de segurança.

Opção A: Autenticação por chave de API

  1. Navegue até seu recurso no portal do Microsoft Foundry
  2. Vá para a seção Endpoints e chaves
  3. Copie a Chave de API
  4. Defina a variável de ambiente:
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key

Opção B: Autenticação do Microsoft Entra ID

Quando ANTHROPIC_FOUNDRY_API_KEY não está definido, Claude Code usa automaticamente a cadeia de credenciais padrão do Azure SDK. Isso suporta uma variedade de métodos para autenticar cargas de trabalho locais e remotas.

Em ambientes locais, você pode usar comumente a Azure CLI:

az login

3. Configurar Claude Code

Defina as seguintes variáveis de ambiente para ativar Microsoft Foundry:

# Ativar integração do Microsoft Foundry
export CLAUDE_CODE_USE_FOUNDRY=1

# Nome do recurso do Azure (substitua {resource} pelo nome do seu recurso)
export ANTHROPIC_FOUNDRY_RESOURCE={resource}
# Ou forneça a URL base completa:
# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic

4. Fixar versões de modelo

Defina as variáveis de modelo para corresponder aos nomes de implantação que você criou na etapa 1.

Sem ANTHROPIC_DEFAULT_OPUS_MODEL, o alias opus no Foundry resolve para Opus 4.6. Defina-o para o ID Opus 4.8 para usar o modelo mais recente:

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'

As tarefas em segundo plano, como geração de título de sessão, usam o modelo pequeno/rápido, normalmente um modelo da classe Haiku. No Foundry, Claude Code usa como padrão o modelo primário porque nem toda conta tem uma implantação Haiku. Para usar Haiku para tarefas em segundo plano, defina ANTHROPIC_DEFAULT_HAIKU_MODEL para uma implantação Haiku que esteja disponível em sua conta, conforme mostrado acima.

Para IDs de modelo atuais e legados, consulte Visão geral de modelos. Consulte Configuração de modelo para a lista completa de variáveis de ambiente.

Prompt caching está ativado automaticamente. Para solicitar um TTL de cache de 1 hora em vez do padrão de 5 minutos, defina a seguinte variável; gravações de cache com TTL de 1 hora são cobradas a uma taxa mais alta:

export ENABLE_PROMPT_CACHING_1H=1

5. Executar Claude Code

Com as variáveis de ambiente definidas, inicie Claude Code a partir do diretório do seu projeto:

claude

Claude Code lê CLAUDE_CODE_USE_FOUNDRY e as outras variáveis Foundry do ambiente e se conecta ao seu recurso Azure no primeiro prompt. Diferentemente de Bedrock e Vertex AI, Foundry não possui um assistente de configuração interativo, portanto as variáveis de ambiente nas etapas 3 e 4 são o único caminho de configuração.

Configuração do Azure RBAC

As funções padrão Azure AI User e Cognitive Services User incluem todas as permissões necessárias para invocar modelos Claude.

Para permissões mais restritivas, crie uma função personalizada com o seguinte:

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

Para detalhes, consulte documentação RBAC do Microsoft Foundry.

Resolução de problemas

Se você receber um erro "Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed":

  • Configure Entra ID no ambiente, ou defina ANTHROPIC_FOUNDRY_API_KEY.

Recursos adicionais