90 90
91O sinalizador `--model` e a variável de ambiente `ANTHROPIC_MODEL` se aplicam apenas à sessão que você inicia com eles. Para executar modelos diferentes em terminais diferentes ao mesmo tempo, inicie cada um com seu próprio sinalizador `--model` em vez de alternar com `/model`.91O sinalizador `--model` e a variável de ambiente `ANTHROPIC_MODEL` se aplicam apenas à sessão que você inicia com eles. Para executar modelos diferentes em terminais diferentes ao mesmo tempo, inicie cada um com seu próprio sinalizador `--model` em vez de alternar com `/model`.
92 92
93As sessões retomadas iniciadas com `claude --resume`, `--continue` ou o seletor `/resume` mantêm o modelo que estavam usando quando a transcrição foi salva, independentemente da configuração `model` atual. Se esse modelo foi descontinuado, a sessão cai para a ordem de precedência normal. Isso evita que a escolha `/model` de outra sessão altere o modelo ao retomar.93As sessões retomadas iniciadas com `claude --resume`, `--continue` ou o seletor `/resume` mantêm o modelo que estavam usando quando a transcrição foi salva, independentemente da configuração `model` atual. Se esse modelo foi descontinuado ou é excluído por [`availableModels`](#restrict-model-selection), a sessão cai para a ordem de precedência normal. Isso evita que a escolha `/model` de outra sessão altere o modelo ao retomar.
94 94
95Quando o modelo ativo na inicialização vem das configurações do projeto ou gerenciadas em vez de sua própria seleção, o cabeçalho de inicialização mostra qual arquivo de configurações o definiu. Execute `/model` para substituir; a configuração do projeto ou gerenciada reaplicada no próximo lançamento.95Quando o modelo ativo na inicialização vem das configurações do projeto ou gerenciadas em vez de sua própria seleção, o cabeçalho de inicialização mostra qual arquivo de configurações o definiu. Execute `/model` para substituir; a configuração do projeto ou gerenciada reaplicada no próximo lançamento.
96 96
121 Restringir seleção de modelo121 Restringir seleção de modelo
122</h2>122</h2>
123 123
124Os administradores corporativos podem usar `availableModels` em [configurações gerenciadas ou de política](/pt/settings#settings-files) para restringir quais modelos os usuários podem selecionar.124Os administradores corporativos podem usar `availableModels` em [configurações gerenciadas ou de política](/pt/settings#settings-files) para restringir quais modelos os usuários podem selecionar. As entradas correspondem a uma família de modelo como `sonnet`, um prefixo de versão como `claude-sonnet-4-5`, ou um ID de modelo completo como `claude-sonnet-4-5-20250929`.
125 125
126Quando `availableModels` é definido, a lista de permissões se aplica em todos os lugares onde um usuário pode especificar um modelo:126Quando `availableModels` é definido, a lista de permissões se aplica em todos os lugares onde um usuário pode especificar um modelo:
127 127
128* **Modelo de sessão principal**: `/model`, o sinalizador `--model` e a variável de ambiente `ANTHROPIC_MODEL`128* **Modelo de sessão principal**: `/model`, o sinalizador `--model`, a variável de ambiente `ANTHROPIC_MODEL`, a configuração `model` e o modelo restaurado ao [retomar uma sessão](#setting-your-model)
129* **Resolução de alias**: {/* min-version: 2.1.176 */}as variáveis de ambiente `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL` e `ANTHROPIC_DEFAULT_FABLE_MODEL` não podem redirecionar um alias permitido para um modelo fora da lista129* **Resolução de alias**: {/* min-version: 2.1.176 */}as variáveis de ambiente `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL` e `ANTHROPIC_DEFAULT_FABLE_MODEL` não podem redirecionar um alias permitido para um modelo fora da lista
130* **Modo rápido**: {/* min-version: 2.1.176 */}`/fast` recusa alternar quando isso implicaria mudar implicitamente para um modelo Opus fora da lista, com a mensagem "não está nos modelos permitidos da sua organização"130* **Modo rápido**: {/* min-version: 2.1.176 */}`/fast` recusa alternar quando isso implicaria mudar implicitamente para um modelo Opus fora da lista, com a mensagem "não está nos modelos permitidos da sua organização"
131* **Modelos de subagente**: o campo `model` em [subagente](/pt/sub-agents#choose-a-model) frontmatter, o parâmetro `model` da ferramenta Agent, o seletor de modelo em `/agents` e `CLAUDE_CODE_SUBAGENT_MODEL`131* **Modelos de subagente**: o campo `model` em [subagente](/pt/sub-agents#choose-a-model) frontmatter, o parâmetro `model` da ferramenta Agent, o seletor de modelo em `/agents` e `CLAUDE_CODE_SUBAGENT_MODEL`
132* **Modelo de advisor**: a configuração [`advisorModel`](/pt/advisor) configurada132* **Modelo de skill e comando**: o frontmatter `model` em [skills e comandos](/pt/skills)
133* **Cadeias de fallback**: elementos de uma [cadeia de modelo de fallback](#fallback-model-chains) fora da lista são descartados133* **Modelo de advisor**: a configuração [`advisorModel`](/pt/advisor) configurada e o sinalizador `--advisor`
134* **Modelo de agente de fundo**: o modelo selecionado no [seletor de dispatch](/pt/agent-view)
134 135
135Alternar para um modelo bloqueado com `/model` é rejeitado com um erro, enquanto um sinalizador `--model` bloqueado ou valor `ANTHROPIC_MODEL` é substituído na inicialização com um aviso nomeando tanto o modelo solicitado quanto o substituído, e a sessão é iniciada no modelo padrão. Uma substituição de subagente ou advisor bloqueada volta para o modelo herdado ou padrão em vez de falhar na solicitação.136Alternar para um modelo bloqueado com `/model` é rejeitado com um erro, enquanto um sinalizador `--model` bloqueado, valor `ANTHROPIC_MODEL` ou configuração `model` é substituído na inicialização com um aviso nomeando tanto o modelo solicitado quanto o substituído, e a sessão é iniciada no modelo padrão. Uma substituição de subagente, skill ou comando bloqueada volta para o modelo herdado ou padrão em vez de falhar na solicitação; uma configuração `advisorModel` bloqueada desativa o advisor para a sessão, enquanto um sinalizador `--advisor` bloqueado sai com um erro no lançamento. Os modelos excluídos são ocultados do seletor `/model`.
137
138As mudanças automáticas de modelo são verificadas da mesma forma: elementos de uma [cadeia de modelo de fallback](#fallback-model-chains) fora da lista de permissões são descartados, uma atualização de modo de plano como [`opusplan`](#opusplan-model-setting) para um modelo excluído é ignorada para que o planejamento continue no modelo da sessão, e um [fallback automático de modelo](#automatic-model-fallback) cujo alvo é excluído não é executado, portanto a solicitação sinalizada termina com uma recusa. Habilitar [modo rápido](/pt/fast-mode) é recusado quando o modelo em que a sessão seria executada depois está fora da lista de permissões.
136 139
137```json theme={null}140```json theme={null}
138{141{
140}143}
141```144```
142 145
146<h3 id="surface-coverage">
147 Cobertura de superfície
148</h3>
149
150Cada superfície impõe a lista de permissões que recebe. Qual mecanismo de entrega alcança cada superfície difere:
151
152| Mecanismo de entrega | CLI e IDE | Sessões locais do Desktop | Sessões web, mobile e cloud | Agent SDK e não-interativo | Cowork |
153| :------------------------------------------------------------------------------------------------- | :-------- | :------------------------ | :-------------------------- | :------------------------- | :---------------------- |
154| [Configurações gerenciadas pelo servidor](/pt/server-managed-settings) do console de administração | Imposto | Imposto | Imposto | Imposto | Não entregue |
155| [Arquivos de configurações gerenciadas ou MDM](/pt/settings#settings-files) | Imposto | Imposto | Não entregue | Imposto | Imposto onde implantado |
156
157* Sessões em nuvem, em [Claude Code na web](/pt/claude-code-on-the-web) ou no aplicativo Desktop, são executadas em VMs gerenciadas pela Anthropic: as configurações implantadas no seu dispositivo não as alcançam, portanto entregue a lista de permissões através de configurações gerenciadas pelo servidor. Uma mudança de modelo no meio da sessão em uma sessão em nuvem é rejeitada quando o modelo solicitado é excluído pela lista de permissões. A rejeição do lado do servidor na criação da sessão se aplica a [restrições de modelo da organização](#organization-model-restrictions), não à chave de configurações `availableModels`.
158* Cowork, a aba de trabalho agentic no aplicativo Claude Desktop, não é uma superfície Claude Code e não recebe configurações gerenciadas pelo servidor por design. Um arquivo de configurações gerenciadas se aplica a sessões Cowork quando está presente onde a sessão é executada; sessões Cowork remotas são executadas em VMs gerenciadas pela Anthropic, onde um arquivo implantado no dispositivo não está presente.
159* Sessões em [provedores de terceiros](/pt/server-managed-settings#platform-availability) como Bedrock, Vertex AI, Foundry e [Claude Platform on AWS](/pt/claude-platform-on-aws) não recebem configurações gerenciadas pelo servidor, portanto entregue a lista de permissões através de arquivos de configurações gerenciadas ou MDM lá.
160* A entrega gerenciada pelo servidor também requer que a sessão se autentique com um login de organização ou uma chave de API configurada diretamente. Frotas que geram chaves apenas através de um script [`apiKeyHelper`](/pt/settings#available-settings) devem entregar a lista de permissões através de arquivos de configurações gerenciadas ou MDM.
161* A aba Desktop Code também hospeda [sessões SSH](/pt/desktop#ssh-sessions), que leem o arquivo de configurações gerenciadas do host remoto em que são executadas. Veja [Configurações gerenciadas do Desktop](/pt/desktop#managed-settings).
162* Os seletores de modelo em claude.ai e no aplicativo Desktop ocultam ou desabilitam modelos excluídos pela lista de permissões da sua organização. O estado do seletor é uma conveniência para os usuários; a imposição acontece na sessão.
163
143<h3 id="default-model-behavior">164<h3 id="default-model-behavior">
144 Comportamento do modelo padrão165 Comportamento do modelo padrão
145</h3>166</h3>
146 167
147Por padrão, a opção Padrão no seletor de modelo não é afetada por `availableModels`. Ela permanece disponível e representa o padrão de tempo de execução do sistema [baseado no nível de assinatura do usuário](#default-model-setting).168A opção Padrão no seletor de modelo não é afetada por `availableModels` a menos que [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) também esteja definido. Por si só, `availableModels` deixa Padrão disponível, resolvendo para o padrão de tempo de execução do sistema [baseado no nível de assinatura do usuário](#default-model-setting). Se o padrão do nível é um modelo que você pretende restringir, defina `enforceAvailableModels` também.
148 169
149Para estender a lista de permissões à opção Padrão, defina `enforceAvailableModels` como `true` em configurações gerenciadas ou de política junto com uma lista `availableModels` não vazia. Quando o padrão do nível não está na lista de permissões, Padrão se resolve para a primeira entrada permitida em vez do padrão do nível. Isso requer Claude Code v2.1.175 ou posterior.170Um array `availableModels` vazio nunca ativa a imposição do modelo Padrão: com `availableModels: []`, as seleções de modelo nomeadas são bloqueadas, mas o modelo Padrão para o tipo de conta permanece utilizável independentemente de `enforceAvailableModels`.
150 171
151Um array `availableModels` vazio nunca ativa a imposição. Mesmo com `availableModels: []`, os usuários ainda podem usar Claude Code com o modelo Padrão para seu nível, independentemente de `enforceAvailableModels`.172<h3 id="enforce-the-allowlist-for-the-default-model">
173 Impor a lista de permissões para o modelo Padrão
174</h3>
175
176Defina `enforceAvailableModels: true` junto com um `availableModels` não vazio em configurações gerenciadas para estender a lista de permissões à opção Padrão. Isso requer Claude Code v2.1.175 ou posterior.
177
178```json theme={null}
179{
180 "availableModels": ["sonnet", "haiku"],
181 "enforceAvailableModels": true
182}
183```
184
185Quando o modelo padrão para o tipo de conta do usuário não está na lista de permissões, a opção Padrão se resolve para a primeira entrada `availableModels` que nomeia um modelo permitido e disponível, e a linha Padrão do seletor `/model` mostra esse modelo. Isso se aplica em todos os lugares onde o padrão é alcançado: inicialização da sessão, seleção de Padrão em `/model`, a palavra-chave `"default"` em [cadeias de modelo de fallback](#fallback-model-chains) e o fallback usado quando uma seleção excluída é descartada.
186
187`enforceAvailableModels` não tem efeito quando `availableModels` não está definido ou está vazio: com `availableModels: []`, o modelo Padrão para o tipo de conta permanece utilizável, portanto a configuração não pode bloquear os usuários de cada modelo. Quando `availableModels` é não vazio, mas nenhuma entrada se resolve para um modelo permitido e disponível, a imposição se degrada e Padrão cai para o padrão do tipo de conta, com um aviso visível apenas em `--debug`. Mantenha pelo menos uma entrada garantidamente disponível na lista para evitar isso.
188
189Implante ambas as chaves na [fonte gerenciada de maior precedência](/pt/settings#settings-precedence): as fontes gerenciadas implantadas pelo administrador não se mesclam, portanto um par colocado em um arquivo de configurações gerenciadas é ignorado quando o console de administração entrega qualquer configuração.
152 190
153<h3 id="control-the-model-users-run-on">191<h3 id="control-the-model-users-run-on">
154 Controlar o modelo em que os usuários executam192 Controlar o modelo em que os usuários executam
155</h3>193</h3>
156 194
157A configuração `model` é uma seleção inicial, não uma imposição. Ela define qual modelo está ativo quando uma sessão é iniciada, mas os usuários ainda podem abrir `/model` e escolher Padrão, que se resolve para o padrão do sistema para seu nível, independentemente do que `model` está definido.195A configuração `model` é uma seleção inicial, não uma imposição. Ela define qual modelo está ativo quando uma sessão é iniciada, mas os usuários ainda podem abrir `/model` e escolher Padrão, que se resolve para o padrão do sistema para seu nível, independentemente do que `model` está definido, a menos que [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) o redirecione.
158 196
159Para controlar totalmente a experiência do modelo, combine estas configurações:197Para controlar totalmente a experiência do modelo, combine estas configurações:
160 198
182 Comportamento de mesclagem220 Comportamento de mesclagem
183</h3>221</h3>
184 222
185Quando `availableModels` é definido em configurações de usuário, projeto e local apenas, os arrays são mesclados e desduplicados entre esses níveis.223Quando a [fonte de configurações gerenciadas de maior precedência](/pt/server-managed-settings#settings-precedence) define `availableModels`, apenas essa lista se aplica: as entradas em configurações de usuário, projeto ou local não podem estendê-la, e as fontes gerenciadas implantadas pelo administrador não se mesclam entre si, portanto uma lista implantada em um arquivo de configurações gerenciadas é ignorada quando as configurações gerenciadas pelo servidor entregam qualquer chave. Caso contrário, as listas de configurações de usuário, projeto e local são [concatenadas e desduplicadas](/pt/settings#settings-precedence) como outras configurações de array. {/* min-version: 2.1.175 */}A partir de Claude Code v2.1.175, a lista gerenciada substitui entradas de menor precedência; versões anteriores as mesclam.
186 224
187Quando `availableModels` é definido em configurações gerenciadas ou de política, o valor gerenciado ou de política substitui completamente o resultado mesclado: entradas adicionadas em configurações de usuário ou projeto não podem ampliá-lo. Configurações gerenciadas e de política substituem valores de menor precedência para `enforceAvailableModels` da mesma forma. A partir de Claude Code v2.1.175, esta é a única maneira de impor uma lista de permissões rigorosa; versões anteriores mesclam a lista gerenciada com entradas de menor precedência.225Dentro da lista efetiva, uma entrada nomeando um modelo específico em uma família, seja um prefixo de versão ou um ID de modelo completo, desativa a entrada de wildcard dessa família: `["sonnet", "claude-sonnet-4-5"]` permite apenas versões Sonnet 4.5, não cada modelo Sonnet.
188 226
189<h3 id="mantle-model-ids">227<h3 id="mantle-model-ids">
190 IDs de modelo Mantle228 IDs de modelo Mantle
191</h3>229</h3>
192 230
193Quando o [endpoint Bedrock Mantle](/pt/amazon-bedrock#use-the-mantle-endpoint) está habilitado, entradas em `availableModels` que começam com `anthropic.` são adicionadas ao seletor `/model` como opções personalizadas e roteadas para o endpoint Mantle. A configuração ainda restringe o seletor às entradas listadas, portanto inclua os aliases padrão junto com qualquer ID Mantle.231Quando o [endpoint Bedrock Mantle](/pt/amazon-bedrock#use-the-mantle-endpoint) está habilitado, as entradas em `availableModels` que começam com `anthropic.` são adicionadas ao seletor `/model` como opções personalizadas e roteadas para o endpoint Mantle. Esta é uma exceção à correspondência de alias descrita em [Fixar modelos para implantações de terceiros](#pin-models-for-third-party-deployments). A configuração ainda restringe o seletor às entradas listadas, e um ID Mantle incorpora um nome de família, portanto conta como uma entrada específica e desativa o wildcard dessa família: junto com qualquer ID Mantle, liste os prefixos de versão ou IDs completos que você deseja manter selecionáveis. Veja [Comportamento de mesclagem](#merge-behavior).
232
233<h3 id="organization-model-restrictions">
234 Restrições de modelo da organização
235</h3>
236
237Use o botão do Console em vez de `availableModels` quando seus membros se autenticam através da API Anthropic e você deseja um único switch em toda a organização sem implantar arquivos de configurações. Os administradores da organização restringem quais modelos os membros podem executar desabilitando modelos individuais no Console Claude. Esta restrição é entregue com os direitos da conta quando Claude Code se autentica, separada de qualquer lista `availableModels` em configurações, e o servidor impõe a mesma restrição independentemente quando uma sessão é criada. Requer Claude Code v2.1.187 ou posterior.
238
239Um modelo restrito é ocultado do seletor `/model`. Selecioná-lo pelo nome com `--model`, a variável de ambiente `ANTHROPIC_MODEL` ou a configuração `model` mostra o aviso `Model "<name>" is restricted by your organization's settings. Using <model> instead.` e a sessão é iniciada em um modelo permitido. Digitar `/model <name>` para um modelo restrito é rejeitado com `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` e a sessão mantém seu modelo atual.
240
241Os dois mecanismos se compõem: um modelo é selecionável apenas quando é permitido por `availableModels` e não é restrito pela organização. As restrições da organização são entregues a sessões na API Anthropic e implantações de [gateway LLM](/pt/llm-gateway). Sessões em Bedrock, Vertex AI, Foundry e Claude Platform on AWS não as recebem, portanto use `availableModels` nesses provedores.
194 242
195<h2 id="special-model-behavior">243<h2 id="special-model-behavior">
196 Comportamento especial do modelo244 Comportamento especial do modelo
209 257
210Enterprise pagamento conforme o uso significa uma organização Enterprise cobrada por uso em vez de por assento de assinatura.258Enterprise pagamento conforme o uso significa uma organização Enterprise cobrada por uso em vez de por assento de assinatura.
211 259
260Quando as configurações gerenciadas [aplicam a lista de permissões para o modelo Padrão](#enforce-the-allowlist-for-the-default-model) e o padrão do tipo de conta não está em `availableModels`, `default` resolve para o Padrão aplicado em vez do padrão do tipo de conta acima.
261
212Fable 5 não é o modelo padrão em nenhum tipo de conta. As sessões usam Fable 5 apenas depois que você o escolhe, com `/model fable`, uma configuração `model` ou o alias `best` onde Fable 5 está disponível. Escolhê-lo com `/model` o salva como o modelo selecionado em suas configurações de usuário, portanto as sessões posteriores começam em Fable 5 até que você altere os modelos.262Fable 5 não é o modelo padrão em nenhum tipo de conta. As sessões usam Fable 5 apenas depois que você o escolhe, com `/model fable`, uma configuração `model` ou o alias `best` onde Fable 5 está disponível. Escolhê-lo com `/model` o salva como o modelo selecionado em suas configurações de usuário, portanto as sessões posteriores começam em Fable 5 até que você altere os modelos.
213 263
214<h3 id="opusplan-model-setting">264<h3 id="opusplan-model-setting">
267 317
268A sessão então continua nesse modelo Opus. Para retornar a Fable 5, execute `/model fable`.318A sessão então continua nesse modelo Opus. Para retornar a Fable 5, execute `/model fable`.
269 319
320O alvo de fallback é verificado contra [`availableModels`](#restrict-model-selection). Quando é bloqueado, nenhum fallback ocorre. A recusa aparece como um erro normal e o modelo da sessão permanece inalterado.
321
270<h4 id="check-what-triggered-fallback">322<h4 id="check-what-triggered-fallback">
271 Verificar o que acionou fallback323 Verificar o que acionou fallback
272</h4>324</h4>
286* Se ambos os modelos sinalizarem a mesma solicitação, você pode editar o prompt e tentar novamente, ou iniciar uma nova sessão.338* Se ambos os modelos sinalizarem a mesma solicitação, você pode editar o prompt e tentar novamente, ou iniciar uma nova sessão.
287* Em sessões móveis [Claude Code na web](/pt/claude-code-on-the-web), editar e tentar novamente não é suportado. Alterne modelos ou continue a sessão de um navegador de desktop ou do aplicativo de desktop.339* Em sessões móveis [Claude Code na web](/pt/claude-code-on-the-web), editar e tentar novamente não é suportado. Alterne modelos ou continue a sessão de um navegador de desktop ou do aplicativo de desktop.
288* Em [modo não interativo](/pt/cli-reference#cli-flags) e integrações SDK que não podem mostrar o prompt, uma solicitação sinalizada encerra a volta com uma recusa em vez disso.340* Em [modo não interativo](/pt/cli-reference#cli-flags) e integrações SDK que não podem mostrar o prompt, uma solicitação sinalizada encerra a volta com uma recusa em vez disso.
341* Quando o alvo de fallback é bloqueado por [`availableModels`](#restrict-model-selection), o prompt não é mostrado. A solicitação sinalizada termina com a recusa, o mesmo que fallback automático quando o alvo é bloqueado.
289 342
290<h4 id="enable-fallback-on-bedrock-vertex-ai-and-foundry">343<h4 id="enable-fallback-on-bedrock-vertex-ai-and-foundry">
291 Habilitar fallback em Bedrock, Vertex AI e Foundry344 Habilitar fallback em Bedrock, Vertex AI e Foundry
452 505
453A entrada personalizada aparece na parte inferior do seletor `/model`. `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` e `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` são opcionais. Se omitidos, o ID do modelo é usado como o nome e a descrição padrão é `Custom model (<model-id>)`.506A entrada personalizada aparece na parte inferior do seletor `/model`. `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` e `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` são opcionais. Se omitidos, o ID do modelo é usado como o nome e a descrição padrão é `Custom model (<model-id>)`.
454 507
455Claude Code ignora a validação para o ID do modelo definido em `ANTHROPIC_CUSTOM_MODEL_OPTION`, portanto você pode usar qualquer string que seu endpoint de API aceite.508Claude Code ignora a validação para o ID do modelo definido em `ANTHROPIC_CUSTOM_MODEL_OPTION`, portanto você pode usar qualquer string que seu endpoint de API aceite. Quando [`availableModels`](#restrict-model-selection) está definido, inclua o ID do modelo personalizado na lista de permissões também: a entrada personalizada é filtrada do seletor e uma seleção `--model` dela é rejeitada como qualquer outro modelo excluído. Um ID personalizado que incorpora um nome de família, como `my-gateway/claude-opus-4-7`, conta como uma entrada específica para essa família e desabilita seu curinga, portanto também liste as versões que você pretende manter selecionáveis. Consulte [Comportamento de mesclagem](#merge-behavior).
456 509
457<h2 id="environment-variables">510<h2 id="environment-variables">
458 Variáveis de ambiente511 Variáveis de ambiente
505* O sufixo é lido por variável, não por modelo. No Bedrock, Vertex e Foundry, um ID de modelo sem `[1m]` em uma variável usa contexto 200K mesmo se outra variável define o mesmo modelo com o sufixo.558* O sufixo é lido por variável, não por modelo. No Bedrock, Vertex e Foundry, um ID de modelo sem `[1m]` em uma variável usa contexto 200K mesmo se outra variável define o mesmo modelo com o sufixo.
506 559
507<Note>560<Note>
508 A lista de permissões `settings.availableModels` ainda se aplica ao usar provedores de terceiros. A filtragem corresponde ao alias de modelo como `opus`, o prefixo de versão como `claude-opus-4-8`, ou o ID de modelo completo. Qualquer sufixo `[1m]` é removido tanto da entrada da lista de permissões quanto do modelo solicitado antes da correspondência, então uma entrada de `claude-opus-4-8` permite tanto as linhas Opus padrão quanto as de contexto 1M. Prefixos específicos do provedor como `us.anthropic.` não são removidos: liste a mesma forma em `availableModels` que o seletor mostra, ou mapeie através de [`modelOverrides`](#override-model-ids-per-version).561 Uma lista de permissões `availableModels` entregue através de [MDM ou um arquivo de configurações gerenciado](/pt/settings#settings-files) ainda se aplica ao usar provedores de terceiros; [configurações gerenciadas pelo servidor não são entregues lá](/pt/server-managed-settings#platform-availability). A filtragem corresponde a um alias de modelo como `opus`, um prefixo de versão como `claude-opus-4-8`, ou o ID de modelo completo em forma de provedor. Prefixos específicos do provedor como `us.anthropic.` não são removidos, então para permitir um modelo específico, liste o mesmo ID em forma de provedor que o seletor mostra, ou mapeie através de [`modelOverrides`](#override-model-ids-per-version). Qualquer sufixo `[1m]` é removido tanto da entrada da lista de permissões quanto do modelo solicitado antes da correspondência.
509</Note>562</Note>
510 563
511<h3 id="customize-pinned-model-display-and-capabilities">564<h3 id="customize-pinned-model-display-and-capabilities">
572 625
573As substituições substituem os IDs de modelo integrados que suportam cada entrada no seletor `/model`. No Bedrock, as substituições têm precedência sobre qualquer perfil de inferência que Claude Code descobre automaticamente na inicialização. Os valores que você fornece diretamente através de `ANTHROPIC_MODEL`, `--model` ou as variáveis de ambiente `ANTHROPIC_DEFAULT_*_MODEL` são passados para o provedor como estão e não são transformados por `modelOverrides`.626As substituições substituem os IDs de modelo integrados que suportam cada entrada no seletor `/model`. No Bedrock, as substituições têm precedência sobre qualquer perfil de inferência que Claude Code descobre automaticamente na inicialização. Os valores que você fornece diretamente através de `ANTHROPIC_MODEL`, `--model` ou as variáveis de ambiente `ANTHROPIC_DEFAULT_*_MODEL` são passados para o provedor como estão e não são transformados por `modelOverrides`.
574 627
575`modelOverrides` funciona junto com `availableModels`. A lista de permissões é avaliada contra o ID de modelo Anthropic, não o valor de substituição, então uma entrada como `"opus"` em `availableModels` continua a corresponder mesmo quando versões do Opus são mapeadas para ARNs.628`modelOverrides` funciona junto com `availableModels`. A lista de permissões é avaliada contra o ID de modelo Anthropic, não o valor de substituição, então uma entrada como `"opus"` em `availableModels` continua a corresponder mesmo quando versões do Opus são mapeadas para ARNs. Quando `enforceAvailableModels` é definido em configurações gerenciadas, o Padrão imposto é resolvido através de `modelOverrides` apenas da [fonte gerenciada de precedência mais alta](/pt/server-managed-settings#settings-precedence). O mapeamento de um administrador, como uma versão fixada para um ARN de perfil de inferência, é honrado no Padrão imposto. Substituições de configurações de usuário ou projeto não o afetam.
576 629
577<h3 id="prompt-caching-configuration">630<h3 id="prompt-caching-configuration">
578 Configuração de prompt caching631 Configuração de prompt caching
