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 Foundryexport 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.7 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 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.
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
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:
153 Fixe versões de modelo específicas para cada implantação. Se você usar aliases de modelo (`sonnet`, `opus`, `haiku`) sem fixar, Claude Code pode tentar usar uma versão de modelo mais recente que não está disponível em sua conta Foundry, quebrando usuários existentes quando Anthropic lançar atualizações. Quando você criar implantações do Azure, selecione uma versão de modelo específica em vez de "atualizar automaticamente para a mais recente".153 Fixe versões de modelo específicas para cada implantação. Se você usar aliases de modelo (`sonnet`, `opus`, `haiku`) sem fixar, Claude Code pode tentar usar uma versão de modelo mais recente que não está disponível em sua conta Foundry, quebrando usuários existentes quando Anthropic lançar atualizações. Quando você criar implantações do Azure, selecione uma versão de modelo específica em vez de "atualizar automaticamente para a mais recente".
166As 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.
167
166Para 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.168Para 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.
167169
168[Prompt caching](https://platform.claude.com/docs/en/build-with-claude/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:170[Prompt caching](https://platform.claude.com/docs/en/build-with-claude/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:
