113 2) Configurar credenciais do Azure113 2) Configurar credenciais do Azure
114</h3>114</h3>
115 115
116Claude 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.116Claude 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.
117 117
118**Opção A: Autenticação por chave de API**118**Opção A: Autenticação por chave de API**
119 119
128 128
129**Opção B: Autenticação do Microsoft Entra ID**129**Opção B: Autenticação do Microsoft Entra ID**
130 130
131Quando `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.131Quando nem `ANTHROPIC_FOUNDRY_API_KEY` nem `ANTHROPIC_FOUNDRY_AUTH_TOKEN` estão definidos, 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.
132Isso suporta uma variedade de métodos para autenticar cargas de trabalho locais e remotas.132Isso suporta uma variedade de métodos para autenticar cargas de trabalho locais e remotas.
133 133
134Em ambientes locais, você pode usar comumente a Azure CLI:134Em ambientes locais, você pode usar comumente a Azure CLI:
137az login137az login
138```138```
139 139
140**Opção C: Autenticação por token de portador**
141
142{/* min-version: 2.1.203 */}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.
143
144Defina a variável para um token de portador que o Microsoft Entra ID emitiu para seu recurso:
145
146```bash theme={null}
147export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token
148```
149
150`ANTHROPIC_FOUNDRY_AUTH_TOKEN` tem precedência sobre `ANTHROPIC_FOUNDRY_API_KEY` e sobre a cadeia de credenciais padrão.
151
140<Note>152<Note>
141 Ao usar Microsoft Foundry, o comando `/logout` não está disponível, pois a autenticação é tratada através de credenciais do Azure.153 Ao usar Microsoft Foundry, o comando `/logout` não está disponível, pois a autenticação é tratada através de credenciais do Azure.
142</Note>154</Note>
162</h3>174</h3>
163 175
164<Warning>176<Warning>
165 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".177 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".
166</Warning>178</Warning>
167 179
168Defina as variáveis de modelo para corresponder aos nomes de implantação que você criou na etapa 1.180Defina as variáveis de modelo para corresponder aos nomes de implantação que você criou na etapa 1.
169 181
170Sem `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:182Sem `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:
171 183
172```bash theme={null}184```bash theme={null}
173export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'185export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'
175export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'187export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'
176```188```
177 189
178As 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.190As 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.
179 191
180Para 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.192Para 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.
181 193
195claude207claude
196```208```
197 209
198Claude 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.210Claude 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.
199 211
200<h2 id="azure-rbac-configuration">212<h2 id="azure-rbac-configuration">
201 Configuração do Azure RBAC213 Configuração do Azure RBAC
