Skip to main content

​
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, anotando o nome de implantação que você atribui a cada um; você definirá esses nomes como as variáveis de modelo na etapa 4:
    • Claude Opus
    • Claude Sonnet
    • Claude Haiku

​
  1. Configurar credenciais do Azure

Claude Code suporta três 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, substituindo your-azure-api-key pela chave que você copiou:
Opção B: Autenticação do Microsoft Entra ID Quando nem ANTHROPIC_FOUNDRY_API_KEY nem ANTHROPIC_FOUNDRY_AUTH_TOKEN estão definidos, 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:
Opção C: Autenticação por token de portador Claude Code envia o valor de ANTHROPIC_FOUNDRY_AUTH_TOKEN em cada solicitação como o cabeçalho Authorization: Bearer. Use esta opção quando outro processo, como um aplicativo host ou um script de login, já tiver obtido um token de acesso para você. Requer Claude Code v2.1.203 ou posterior. Defina a variável para um token de portador que o Microsoft Entra ID emitiu para seu recurso:
ANTHROPIC_FOUNDRY_AUTH_TOKEN tem precedência sobre ANTHROPIC_FOUNDRY_API_KEY e sobre a cadeia de credenciais padrão.
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:

​
  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 Microsoft Foundry, que pode ficar atrás da versão mais recente e pode ainda não estar disponível em sua conta. Microsoft 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 Microsoft Foundry resolve para Opus 4.6. Defina-o para o ID Opus 4.8 para usar o modelo mais recente:
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 Microsoft 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:

​
  1. Executar Claude Code

Com as variáveis de ambiente definidas, inicie Claude Code a partir do diretório do seu projeto:
Claude Code lê CLAUDE_CODE_USE_FOUNDRY e as outras variáveis Microsoft Foundry do ambiente e se conecta ao seu recurso Azure no primeiro prompt. Diferentemente de Amazon Bedrock e Google Cloud’s Agent Platform, Microsoft 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. Para verificar sua configuração, execute /status dentro do Claude Code. A linha do provedor de API mostra Microsoft Foundry, junto com o nome do recurso ou URL base que você configurou.

​
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:
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.
Se as solicitações falharem com erros de conexão repetidos no primeiro prompt:
  • Verifique se ANTHROPIC_FOUNDRY_RESOURCE está definido para o nome do recurso real em vez de um espaço reservado. Claude Code constrói a URL do endpoint a partir deste valor, portanto, um nome incorreto aponta para um host que não existe.

​
Recursos adicionais