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](#4-pin-model-versions) 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](https://ai.azure.com/)
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:
```bash theme={null}
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](https://learn.microsoft.com/en-us/azure/developer/javascript/sdk/authentication/credential-chains#defaultazurecredential-overview) 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:
```bash theme={null}
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.
3. Configurar Claude Code
Defina as seguintes variáveis de ambiente para ativar Microsoft Foundry:
```bash theme={null}
# 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
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:
```bash theme={null}
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](https://platform.claude.com/docs/en/about-claude/models/overview). Consulte [Configuração de modelo](/pt/model-config#pin-models-for-third-party-deployments) para a lista completa de variáveis de ambiente.
[Prompt caching](/pt/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:
```bash theme={null}
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:
```bash theme={null}
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:
```json theme={null}
{
"permissions": [
{
"dataActions": [
"Microsoft.CognitiveServices/accounts/providers/*"
]
}
]
}
```
Para detalhes, consulte [documentação RBAC do Microsoft Foundry](https://learn.microsoft.com/en-us/azure/ai-foundry/concepts/rbac-azure-ai-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
* [Documentação do Microsoft Foundry](https://learn.microsoft.com/en-us/azure/ai-foundry/what-is-azure-ai-foundry)
* [Modelos do Microsoft Foundry](https://ai.azure.com/explore/models)
* [Preços do Microsoft Foundry](https://azure.microsoft.com/en-us/pricing/details/ai-foundry/)