Pular para o conteúdo principal

​
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)
Se você está implantando Claude Code para vários usuários, fixe suas versões de modelo antes de fazer o lançamento.

​
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

​
  1. 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
Ao usar Microsoft Foundry, o comando /logout não está disponível, pois a autenticação é tratada através de credenciais do Azure.

​
  1. 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

​
  1. Fixar versões de modelo

Fixe versões de modelo específicas para cada implantação. Sem fixar, aliases de modelo como sonnet e opus resolvem para o padrão integrado do Claude Code para Foundry, que pode ficar atrás da versão mais recente e pode ainda não estar disponível em sua conta. Foundry não possui verificação de modelo na inicialização, portanto as solicitações falham quando o padrão não está disponível. Quando você criar implantações do Azure, selecione uma versão de modelo específica em vez de “atualizar automaticamente para a mais recente”.
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-5'
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

​
  1. 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