A menos que você defina ANTHROPIC_DEFAULT_FABLE_MODEL, o alias fable é resolvido para Fable 5.1, exceto em sessões do gateway de aplicativos Claude, onde fable e best são resolvidos para Fable 5. Antes da v2.1.257, fable era resolvido para Fable 5 em todos os provedores.

Um gateway que não está configurado para servir claude-fable-5-1 rejeita solicitações para esse modelo. Para usar Fable 5.1 através de um gateway que o serve, selecione-o com /model claude-fable-5-1.

Onde um alias é resolvido para um modelo mais antigo, modelos mais novos estão disponíveis selecionando o nome completo do modelo explicitamente ou definindo ANTHROPIC_DEFAULT_OPUS_MODEL ou ANTHROPIC_DEFAULT_SONNET_MODEL.

Antes da v2.1.280, opus era resolvido para Opus 5 na API Anthropic, Claude Platform on AWS, Amazon Bedrock e Agent Platform do Google Cloud a partir da v2.1.219. Antes da v2.1.219, opus era resolvido para Opus 4.8 na API Anthropic a partir da v2.1.154, e no Claude Platform on AWS, Amazon Bedrock e Agent Platform do Google Cloud a partir da v2.1.207. Antes da v2.1.207, opus era resolvido para Opus 4.7 no Claude Platform on AWS e para Opus 4.6 no Amazon Bedrock e Agent Platform do Google Cloud.

Os aliases apontam para a versão recomendada para seu provedor e são atualizados ao longo do tempo. Para fixar uma versão específica, use o nome completo do modelo, por exemplo claude-opus-5-5, ou defina a variável de ambiente correspondente como ANTHROPIC_DEFAULT_OPUS_MODEL.

Trabalhar com Fable

Claude Fable 5.1 e Claude Fable 5 são os modelos mais capazes no Claude Code, adequados para tarefas maiores que uma única sessão. Eles sustentam sessões autônomas longas, investigam antes de agir e verificam seu trabalho com mais frequência do que modelos menores. Fable 5.1 é o lançamento mais recente.

Nenhum modelo Fable é o padrão do tipo de conta em nenhum plano ou provedor. Selecione um explicitamente:

• Fable 5.1: execute /model fable, ou inicie com claude --model fable. Em sessões do gateway de aplicativos Claude, onde o alias é resolvido para Fable 5, execute /model claude-fable-5-1 em vez disso.
• Fable 5: selecione-o por ID de modelo. Na API Anthropic, execute /model claude-fable-5 ou inicie com claude --model claude-fable-5. Em outros provedores, use o ID do modelo Fable 5 do seu provedor ou fixe-o com ANTHROPIC_DEFAULT_FABLE_MODEL.

Se você se conectar à API Anthropic diretamente e suas configurações de usuário contiverem claude-fable-5 ou claude-fable-5[1m] como o modelo, por exemplo porque você selecionou Fable no seletor /model antes da v2.1.257, Claude Code muda esse valor salvo para o alias fable ou fable[1m] na primeira vez que você executa v2.1.257 ou posterior. A linha do modelo de inicialização mostra (auto-updated) uma vez. Um valor claude-fable-5 nas configurações de projeto, local ou gerenciado permanece como está.

Solicitações que os classificadores de segurança de um modelo Fable sinalizam, mais frequentemente em domínios de cibersegurança e biologia, acionam fallback automático de modelo.

Para aproveitar ao máximo o Fable:

• Descreva o resultado, não as etapas: entregue-lhe o resultado que você deseja e deixe-o planejar o caminho. Para mantê-lo trabalhando em direção a esse resultado, defina uma meta.
• Entregue-lhe problemas ambíguos: investigações de causa raiz, depuração de interrupção e decisões de arquitetura são onde a investigação e verificação extras compensam.
• Pule os lembretes de verificação: ele verifica seu próprio trabalho com menos solicitação, então lembretes para testar ou verificar geralmente são desnecessários.
• Dimensione tarefas maiores: entregue-lhe trabalho que você normalmente dividiria em pedaços. Ele mantém sessões longas sem perder o fio.

Na API Anthropic, um modelo Fable aparece no seletor /model a menos que availableModels ou restrições de modelo de organização o excluam. Quando sua organização não consegue usar Fable em absoluto, por exemplo sob retenção zero de dados, a linha permanece no seletor acinzentada, com uma nota sobre o motivo.

Fable e créditos de uso

Dependendo do seu plano e nível de assento, o uso de Fable pode ser cobrado em créditos de uso em vez de usar os limites incluídos do seu plano. Quando isso acontece, o seletor /model mostra "Requer créditos de uso" na linha Fable. Para gerenciar créditos de uso, consulte Adicionar créditos de uso à sua assinatura.

Em sessões interativas, Claude Code mostra um prompt de consentimento antes de uma solicitação Fable cobrar créditos de uso. Membros de planos Enterprise com faturamento de organização não veem o prompt. Você pode continuar no Fable usando créditos de uso ou mudar para seu modelo padrão. Você também pode descartar o prompt:

• No seletor /model, você mantém seu modelo atual.
• No meio da sessão, Claude Code continua a vez no seu modelo padrão.

Depois que você escolhe continuar no Fable usando créditos de uso, Claude Code não mostra o prompt novamente.

Em uma sessão com Remote Control conectado, uma sessão em segundo plano, ou uma sessão de colega de equipe de agentes, ninguém pode estar no terminal, então Claude Code mantém o prompt de consentimento no meio da sessão para o prazo dialogExpiry, cinco minutos por padrão. Se ninguém tiver respondido até o prazo, Claude Code encerra a vez sem enviar a solicitação e adiciona um aviso à transcrição, que o cliente Remote Control também mostra. Sua seleção de modelo não é alterada, e Claude Code pede consentimento novamente na sua próxima mensagem.

O que você pode fazer enquanto o prompt está aguardando depende da sessão:

• Com Remote Control conectado ou em uma sessão de colega, pressione qualquer tecla no terminal para cancelar o prazo, e Claude Code aguarda sua resposta.
• Em uma sessão em segundo plano, responda antes do prazo.
• Se você enviar uma nova mensagem do cliente remoto antes de alguém digitar no terminal, Claude Code encerra a vez da mesma forma, e sua nova mensagem inicia a próxima vez. Depois que alguém digita no terminal, Claude Code continua aguardando a resposta e coloca sua nova mensagem na fila atrás dela.

No modo não interativo com a flag -p e através do Agent SDK, Claude Code nunca mostra o prompt de consentimento. Quando uma solicitação Fable lá cobraria créditos de uso, Claude Code a cobra sem perguntar.

Definindo seu modelo

Você pode configurar seu modelo de várias maneiras, listadas em ordem de prioridade:

1. Durante a sessão: use /model <alias|name> para mudar imediatamente, ou execute /model sem argumento para abrir o seletor. Consulte quando Claude Code pede que você confirme a mudança
2. Na inicialização: inicie com claude --model <alias|name>
3. Variável de ambiente: defina ANTHROPIC_MODEL=<alias|name>
4. Configurações: configure permanentemente em seu arquivo de configurações usando o campo model
5. Padrão para novas sessões: defina ANTHROPIC_DEFAULT_MODEL=<alias|name>

/model salva sua escolha como o padrão para novas sessões escrevendo o campo model em suas configurações de usuário. No seletor:

• Enter: muda o modelo e salva como seu padrão
• s: muda o modelo apenas para esta sessão e deixa seu padrão inalterado. Para usar uma chave diferente, rebinde modelPicker:thisSessionOnly

Digitar /model <name> diretamente se comporta como Enter. Para mudar apenas para esta sessão, abra o seletor com /model e pressione s na linha do modelo.

Se você mudar modelos com /model, a mudança também alcança subagentos que herdam o modelo da conversa principal, porque Claude Code resolve seu modelo a partir daquele que sua sessão está usando quando Claude os inicia. Mude para Opus antes de Claude delegar pesquisa ou execuções de teste para um deles, e esse trabalho é executado no Opus também. Para manter um subagentos personalizado em um modelo menor, defina model em sua definição.

Se você definir um modelo com /model no modo não interativo, com a flag -p, sua escolha se aplica apenas à sessão atual e não é salva como seu padrão; /model nesse modo requer Claude Code v2.1.205 ou posterior. As configurações de projeto e gerenciadas ainda têm precedência e se reaplicam no próximo lançamento. Um modelo padrão de organização que seu administrador configurou para substituir a seleção do usuário também se reaplica no próximo lançamento.

Na v2.1.144 até v2.1.152, /model se aplicava apenas à sessão atual e d no seletor salvava um padrão.

A flag --model e a variável de ambiente ANTHROPIC_MODEL se aplicam apenas à sessão que você inicia com elas. Para executar modelos diferentes em terminais diferentes ao mesmo tempo, inicie cada um com sua própria flag --model em vez de mudar com /model.

Os preços no seletor /model aparecem quando Claude Code fala com a API Anthropic, diretamente ou através de um gateway LLM que a proxeia, e o preço em uma linha é o preço do modelo que essa linha seleciona. Em provedores de terceiros como Amazon Bedrock e no gateway de aplicativos Claude, seu provedor ou gateway determina o que você paga, então as linhas do seletor não mostram preço. O preço é apenas um rótulo de exibição; não afeta qual modelo uma linha seleciona ou o que seu provedor cobra. Antes da v2.1.206, Claude Platform on AWS e sessões de gateway mostravam preços de lista Anthropic, e uma linha poderia mostrar o preço de um modelo diferente do que selecionava.

As 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 o modelo restaurado foi descontinuado ou é excluído por availableModels, a sessão cai para a ordem de precedência normal. Isso evita que a escolha /model de outra sessão mude o modelo ao retomar. Em provedores que usam IDs de implantação específicos do provedor em vez de IDs de modelo Anthropic, como Amazon Bedrock, Agent Platform do Google Cloud e Microsoft Foundry, o modelo de transcrição não é restaurado e a sessão resolve seu modelo através da ordem de precedência normal.

Um modelo que você escolhe para o novo lançamento com --model ou ANTHROPIC_MODEL ainda tem precedência sobre o modelo restaurado. A partir da v2.1.195, também uma variável da família ANTHROPIC_DEFAULT_OPUS_MODEL. ANTHROPIC_DEFAULT_MODEL também pode, sob as condições listadas em sua seção.

Quando o modelo ativo na inicialização vem das configurações de 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 de projeto ou gerenciada se reaplica no próximo lançamento. Em plataformas que incorporam Claude Code e definem CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, a configuração de modelo do host tem precedência sobre as configurações de modelo gerenciadas, enquanto uma lista de permissões availableModels gerenciada permanece em vigor a menos que o host forneça a sua própria; Exceções à precedência de configurações gerenciadas diz quais chaves e variáveis o host substitui.

Se você ou sua organização configurarem hooks PreModelSwitch, eles são executados antes de uma mudança solicitada ser aplicada e podem bloqueá-la ou pedir que você confirme.

Quando Claude Code não consegue dizer quais hooks PreModelSwitch seus plugins gerenciados da organização entregam, por exemplo porque um plugin gerenciado falhou ao carregar, ele recusa a mudança em vez de aplicá-la sem verificação, e verifica novamente em cada nova tentativa. Consulte A mudança de modelo foi bloqueada por um hook PreModelSwitch para a mensagem e recuperação.

Quando você muda modelos através do método setModel() do Agent SDK ou de um dispositivo conectado através de Remote Control, ou um aplicativo como o Desktop app que executa o CLI do Claude Code muda para você, Claude Code verifica se a string é uma que ele reconhece antes de salvá-la. Esta verificação requer Claude Code v2.1.200 ou posterior. Verificar uma escolha Remote Control requer Claude Code v2.1.260 ou posterior em sua máquina. Na API Anthropic, Claude Code reconhece:

• um alias de modelo
• uma entrada do seletor /model
• qualquer nome que comece com claude-
• um valor que você configurou como uma opção de modelo personalizado ou em modelOverrides

Claude Code rejeita uma string não reconhecida com Model "<name>" is not a recognized model id. e a sessão mantém seu modelo atual, em vez de salvar a string e falhar na próxima solicitação. Consulte a referência de erro para etapas de recuperação.

A verificação é executada apenas na API Anthropic. No Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry, Claude Platform on AWS, e atrás de um gateway LLM ou um ANTHROPIC_BASE_URL personalizado, seu provedor ou gateway define os nomes de modelo, então Claude Code passa qualquer string sem verificá-la. A verificação também não cobre a flag --model, a variável de ambiente ANTHROPIC_MODEL, ou a configuração model; um valor digitado incorretamente lá produz Há um problema com o modelo selecionado na primeira solicitação. Claude Code ainda pode escrever a linha de diagnóstico de modelo não reconhecido no tempo de solicitação, em todos os provedores.

Quando o modelo solicitado tem uma data de aposentadoria programada ou é automaticamente remapeado para uma versão mais recente, Claude Code mostra um aviso que nomeia o modelo solicitado. Sessões interativas o mostram como um aviso de inicialização. A partir da v2.1.182, o mesmo aviso é escrito em stderr no modo não interativo ao usar o formato de saída de texto padrão. A verificação também cobre um model definido no frontmatter de subagentos. O aviso stderr é suprimido para --output-format json e stream-json; leia o modelo real do campo modelUsage da mensagem de resultado.

Por exemplo, inicie uma sessão no Opus:

claude --model opus

Depois mude modelos dentro da sessão:

/model sonnet

Arquivo de configurações de exemplo:

{
    "permissions": {
        "allow": ["Bash(npm run lint)"]
    },
    "model": "opus"
}

Defina um modelo padrão para novas sessões

Defina ANTHROPIC_DEFAULT_MODEL=<alias|name> para escolher o modelo em que suas sessões iniciam por padrão. Requer Claude Code v2.1.236 ou posterior.

Claude Code inicia uma nova sessão no modelo da variável apenas quando nenhum destes seleciona um modelo:

• A flag --model
• ANTHROPIC_MODEL
• Um valor model em qualquer arquivo de configurações, incluindo a escolha que você salva com /model
• Um modelo padrão de organização

Uma escolha que você salva com /model tem precedência sobre a variável em lançamentos posteriores também. Com ANTHROPIC_MODEL definido em vez disso, Claude Code retorna ao modelo da variável no próximo lançamento, seja qual for o que você salvou com /model.

Claude Code também resolve a opção Padrão para o modelo da variável, a menos que um modelo padrão de organização se aplique. Quando a opção Padrão é resolvida para o modelo da variável, a linha Padrão no seletor /model mostra o rótulo Definido por ANTHROPIC_DEFAULT_MODEL.

Claude Code ignora a variável nestes casos, e a opção Padrão é resolvida como se você não a tivesse definido:

• Você a definiu como default, inherit, opusplan, ou haiku
• enforceAvailableModels está ativado
• availableModels ou restrições de modelo de organização excluem o modelo
• O modelo não está disponível para sua conta

Quando uma nova sessão iniciaria no modelo da variável, uma sessão que você retoma com claude --resume, --continue, ou o seletor /resume também inicia nele. Claude Code não restaura o modelo salvo na transcrição dessa sessão. Caso contrário, Claude Code não usa a variável quando você retoma uma sessão.

Uma nova sessão inicia em um modelo diferente do que você escolheu

Quando você escolhe um modelo com /model e sua próxima sessão inicia em algo diferente, estas são as causas usuais:

• Você o escolheu para uma sessão. Pressionar s no seletor, iniciar com --model, e executar /model no modo não interativo se aplicam apenas à sessão atual e deixam seu padrão salvo intacto.
• Algo com prioridade mais alta define o modelo. Um valor model nas configurações de projeto ou gerenciadas, ANTHROPIC_MODEL em seu shell, ou um padrão de organização que seu administrador definiu para substituir as escolhas do usuário se aplica novamente em cada lançamento. Sua escolha /model ainda está salva; está sendo superada. Quando as configurações de projeto ou gerenciadas definem o modelo, o cabeçalho de inicialização nomeia o arquivo.
• Claude Code não conseguiu salvar sua escolha. /model escreve model em ~/.claude/settings.json. Se você não conseguir escrever nesse arquivo, por exemplo porque outra ferramenta o gera ou o vincula a uma cópia somente leitura, o modelo que você escolheu dura pela sessão e o próximo lançamento lê o valor antigo. Defina model na ferramenta que gera o arquivo, ou torne o arquivo gravável. Consulte Uma mudança que você fez no Claude Code é perdida em novas sessões.
• Você retomou uma sessão. Uma sessão que você retoma com claude --resume ou --continue geralmente mantém o modelo que estava usando em vez de seu padrão atual.

Restringir seleção de modelo

Administradores corporativos podem usar availableModels em configurações gerenciadas ou de política para restringir quais modelos os usuários podem selecionar. As entradas correspondem a uma família de modelos como sonnet, um prefixo de versão como claude-sonnet-4-5, ou um ID de modelo completo como claude-sonnet-4-5-20250929. Um prefixo de versão também corresponde a IDs de modelo posteriores que o estendem com outro segmento, portanto claude-fable-5 permite tanto Fable 5 quanto Fable 5.1, enquanto claude-fable-5-1 permite apenas Fable 5.1.

Em plataformas que incorporam Claude Code e definem CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, a configuração de modelo do host tem precedência sobre as configurações de modelo gerenciadas, enquanto uma lista de permissões availableModels gerenciada permanece em vigor a menos que o host forneça a sua própria; Exceções à precedência de configurações gerenciadas diz quais chaves e variáveis o host substitui.

Quando availableModels é definido, a lista de permissões se aplica em todos os lugares onde um usuário pode especificar um modelo:

• Modelo de sessão principal: /model, a flag --model, a variável de ambiente ANTHROPIC_MODEL, a configuração model, ANTHROPIC_DEFAULT_MODEL, e o modelo restaurado ao retomar uma sessão
• Resolução de alias: 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
• Modo rápido: /fast recusa alternar quando isso implicaria mudar implicitamente para um modelo Opus fora da lista, com a mensagem "is not in your organization's allowed models"
• Modelos de subagente e colega: o campo model em subagente frontmatter, o parâmetro model da ferramenta Agent, modelos de colega de equipe de agente, CLAUDE_CODE_SUBAGENT_MODEL, e, na v2.1.197 e anteriores, o seletor de modelo no assistente /agents
• Modelos de skill e comando: o frontmatter model em skills e comandos
• Modelo de advisor: a configuração advisorModel configurada e a flag --advisor
• Modelo de agente de fundo: o modelo selecionado no seletor de dispatch

Na API Anthropic e Claude Platform on AWS, um alias de família de modelo, opus, sonnet, haiku ou fable, resolve para seu modelo usual quando a lista de permissões permite esse modelo. Quando a lista de permissões bloqueia esse modelo, Claude Code substitui a versão mais recente da família que a lista de permissões permite e mostra um aviso nomeando os modelos solicitado e substituído. Com ["sonnet", "claude-opus-4-6"], por exemplo, tanto /model opus quanto --model opus selecionam Claude Opus 4.6, o Opus mais recente permitido. Antes da v2.1.205, um alias cuja versão mais recente lançada estava fora da lista era rejeitado ou substituído como qualquer outra seleção bloqueada, mesmo quando a lista permitia uma versão mais antiga.

A substituição precisa de uma versão permitida para pousar: quando a lista de permissões não permite nenhuma versão da família do alias, o alias segue o comportamento de rejeição e substituição abaixo como qualquer outro valor bloqueado.

Claude Code lida com qualquer outra seleção bloqueada de acordo com onde o modelo foi definido:

• /model: Claude Code rejeita a mudança com um erro

• Flag --model, ANTHROPIC_MODEL ou a configuração model: Claude Code substitui o valor na inicialização com um aviso nomeando os modelos solicitado e substituído, e a sessão inicia no modelo padrão

• ANTHROPIC_DEFAULT_MODEL: Claude Code ignora a variável

• Substituição de subagente ou colega: Claude Code executa o subagente ou colega em um modelo de fallback em vez de falhar na solicitação. Veja Escolher um modelo para o fallback do subagente e Especificar colegas e modelos para o fallback do colega.

  Em sessões interativas, Claude Code avisa quando substitui o modelo de um subagente, por este fallback ou pela substituição de versão mais recente permitida acima, nomeando os modelos solicitado e substituído; não relata um fallback de colega.

  Onde a substituição de versão mais recente permitida acima opera, um alias de família bloqueado a segue. Antes da v2.1.222, um alias caía de volta como qualquer outro valor bloqueado em cada provedor

• Substituição de skill ou comando: Claude Code ignora a substituição, incluindo um alias de família bloqueado, e o skill ou comando é executado no modelo de sessão. Um skill ou comando que é executado em um subagente segue o comportamento do subagente acima

• Configuração advisorModel: o advisor é desabilitado para a sessão

• Flag --advisor: Claude Code sai com um erro na inicialização. Em uma sessão de fundo, inicia a sessão sem o advisor em vez de sair

Claude Code oculta modelos excluídos do seletor /model. Um ID de modelo completo na lista que não tem linha de seletor integrada, como uma versão mais antiga que a lista fixa, aparece no seletor /model como sua própria linha rotulada, a menos que Claude Code substitua as opções integradas por um alinhamento modelPicker. Antes da v2.1.199, tal ID era selecionável apenas digitando /model <id>.

Mudanças de modelo que Claude Code faz em seu nome são verificadas da mesma forma:

• Cadeias de modelo de fallback: entradas fora da lista de permissões são descartadas
• Atualizações de modo de plano: na API Anthropic e Claude Platform on AWS, uma atualização como opusplan para um modelo excluído usa a versão mais recente permitida da família de atualização. Em provedores com IDs de modelo específicos do provedor, e quando nenhuma versão é permitida, a atualização é ignorada e o planejamento continua no modelo da sessão
• Fallback automático de modelo: um fallback cujo alvo é excluído não é executado, portanto a solicitação sinalizada termina com uma recusa
• Classificador de modo automático: o padrão Claude Sonnet 5 do classificador se aplica apenas quando a lista de permissões permite Sonnet 5. Quando é excluído, o classificador é executado no modelo da sessão, que a lista de permissões já governa, ou em um modelo Opus quando a sessão é executada em um modelo Fable. Em provedores diferentes da API Anthropic, esse fallback Opus é executado no modelo Opus padrão do provedor sem consultar a lista de permissões. Requer Claude Code v2.1.210 ou posterior
• Modo rápido: ativar o modo rápido é recusado quando o modelo em que a sessão seria executada depois está fora da lista de permissões

{
  "availableModels": ["sonnet", "haiku"]
}

Cobertura de superfície

Cada superfície aplica a lista de permissões que recebe. Qual mecanismo de entrega alcança cada superfície difere:

• Sessões na nuvem, em Claude Code na web ou no aplicativo Desktop, são executadas em VMs gerenciadas pela Anthropic por padrão: as configurações implantadas em seu dispositivo não as alcançam, portanto entregue a lista de permissões através de configurações gerenciadas pelo servidor. Sessões que sua organização roteia para um ambiente auto-hospedado são executadas em sua própria computação e também leem o arquivo de configurações gerenciadas na imagem do executor. Como Claude Code combina fontes gerenciadas diz quando esse arquivo se aplica. Uma mudança de modelo no meio da sessão em uma sessão na nuvem é rejeitada quando o modelo solicitado é excluído pela lista de permissões. Quando a availableModels lista em suas configurações gerenciadas pelo servidor é não vazia, o servidor rejeita a solicitação de um usuário para iniciar uma sessão na nuvem em um modelo que a lista exclui.
• Cowork, a aba de trabalho agentic no aplicativo Claude Desktop, executa suas sessões em Claude Code, mas, por design, não recebe configurações gerenciadas pelo servidor do console de administração claude.ai. 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.
• Sessões em provedores de terceiros como Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry e Claude Platform on AWS não recebem configurações gerenciadas pelo servidor, portanto entregue a lista de permissões através de MDM ou arquivos de configurações gerenciadas lá.
• A entrega gerenciada pelo servidor também requer que a sessão se autentique com um login ou chave elegível. Frotas que geram chaves apenas através de um script apiKeyHelper devem entregar a lista de permissões através de MDM ou arquivos de configurações gerenciadas.
• A aba Desktop Code também hospeda sessões SSH, que leem o arquivo de configurações gerenciadas do host remoto em que são executadas. Veja Configurações gerenciadas de desktop.
• Os seletores de modelo em claude.ai e no aplicativo Desktop ocultam ou desabilitam modelos excluídos pela lista de permissões de sua organização. O estado do seletor é uma conveniência para usuários; não é onde a aplicação acontece.

Comportamento do modelo padrão

Por si só, availableModels deixa a opção Padrão no padrão de tempo de execução do sistema para a conta até que você também defina enforceAvailableModels. Se esse padrão for um modelo que você pretende restringir, defina enforceAvailableModels também.

Uma matriz availableModels vazia nunca ativa a aplicaçã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.

Aplicar a lista de permissões para o modelo Padrão

Defina 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.

{
  "availableModels": ["sonnet", "haiku"],
  "enforceAvailableModels": true
}

A opção Padrão resolve para o padrão do tipo de conta, ou para o modelo padrão da organização quando um administrador definiu um. Quando esse modelo não está na lista de permissões, a opção Padrão em vez disso 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, e o fallback usado quando uma seleção excluída é descartada.

enforceAvailableModels remapeia a opção Padrão apenas quando availableModels é não vazio. Com availableModels: [], o modelo Padrão para o tipo de conta permanece utilizável, portanto a configuração não pode bloquear usuários de cada modelo. Quando availableModels é não vazio, mas nenhuma entrada resolve para um modelo permitido e disponível, a aplicação é ignorada e Padrão resolve para o padrão do tipo de conta, com um aviso visível apenas em --debug. Mantenha pelo menos uma entrada garantida como disponível na lista para evitar isso.

Implante ambas as chaves juntas na fonte gerenciada de classificação mais alta que você entrega. Por padrão, Claude Code lê apenas essa fonte, portanto um par colocado em um arquivo de configurações gerenciadas é ignorado quando o console de administração entrega qualquer configuração; sob a mesclagem de aceitação em como Claude Code combina fontes gerenciadas, Claude Code ainda ignora um mapa modelOverrides de uma fonte classificada abaixo daquela que define availableModels.

Controlar o modelo em que os usuários são executados

A configuração model é uma seleção inicial, não aplicação. Define qual modelo está ativo quando uma sessão inicia, mas os usuários ainda podem abrir /model e escolher Padrão, que resolve para o padrão de tempo de execução do sistema independentemente do que model está definido, a menos que enforceAvailableModels o redirecione.

Para controlar totalmente a experiência do modelo, combine estas configurações:

• availableModels: restringe quais modelos nomeados os usuários podem alternar
• enforceAvailableModels: estende a lista de permissões availableModels à opção Padrão, portanto Padrão não pode resolver para um modelo fora da lista
• model: define a seleção de modelo inicial quando uma sessão inicia
• ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL / ANTHROPIC_DEFAULT_FABLE_MODEL: controlam para o que os aliases sonnet, opus, haiku e fable resolvem, e qual versão o padrão do tipo de conta usa

Este exemplo inicia usuários em Sonnet 4.5, limita o seletor a Sonnet e Haiku, e garante que Padrão resolve para um modelo na lista de permissões em vez do padrão de nível:

{
  "model": "claude-sonnet-4-5",
  "availableModels": ["claude-sonnet-4-5", "haiku"],
  "enforceAvailableModels": true,
  "env": {
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5"
  }
}

Sem enforceAvailableModels ou o bloco env, um usuário que seleciona Padrão no seletor obtém o padrão de tempo de execução em vez da versão fixada em model. As duas configurações cobrem escopos diferentes: enforceAvailableModels faz Padrão obedecer à lista de permissões, enquanto o bloco env fixa qual versão um alias permitido como sonnet resolve. Use enforceAvailableModels sozinho quando restringir famílias de modelos é suficiente; adicione o bloco env quando você também precisa fixar uma versão específica.

Comportamento de mesclagem

Quando as configurações gerenciadas que Claude Code aplica definem availableModels, essa lista sozinha se aplica, além de uma plataforma host que fornece a sua própria: entradas em configurações de usuário, projeto ou local não podem estendê-la, e Claude Code nunca mescla availableModels entre fontes gerenciadas; como Claude Code combina fontes gerenciadas diz qual lista de fonte se aplica. Caso contrário, listas de configurações de usuário, projeto e local são concatenadas e desduplicadas como outras configurações de matriz. Antes de Claude Code v2.1.175, entradas de escopos de precedência mais baixa se mesclavam na lista gerenciada em vez de serem substituídas por ela.

Dentro 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, desabilita a entrada de curinga da família: ["sonnet", "claude-sonnet-4-5"] permite apenas versões Sonnet 4.5, não cada modelo Sonnet.

IDs de modelo Mantle

Quando o endpoint Amazon Bedrock Mantle 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. Esta é uma exceção à correspondência de alias descrita em Fixar modelos para implantações de terceiros. A configuração ainda restringe o seletor a entradas listadas, e um ID Mantle incorpora um nome de família, portanto conta como uma entrada específica e desabilita o curinga da família: junto com qualquer ID Mantle, liste os prefixos de versão ou IDs completos que você quer manter selecionáveis. Veja Comportamento de mesclagem.

Restrições de modelo da organização

Administradores de organização em planos Claude Enterprise restringem quais modelos os membros podem executar desabilitando modelos individuais no console de administração claude.ai. 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 aplica a mesma restrição independentemente quando uma sessão é criada. Requer Claude Code v2.1.187 ou posterior.

A restrição se aplica quando um membro faz login ou usa sua própria chave de API. Credenciais com escopo de organização, como chaves de serviço da organização, não estão vinculadas a um usuário, portanto a restrição não se aplica a elas.

O Claude Console não tem controle de restrição de modelo. Organizações sem um plano Claude Enterprise, incluindo aquelas cujos membros se autenticam através da API Anthropic, restringem modelos com availableModels em configurações gerenciadas, adicionando enforceAvailableModels para cobrir a opção Padrão. Cobertura de superfície diz como cada superfície recebe e aplica estas configurações.

Um 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 inicia 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.

Um alias de família de modelo como opus resolve para seu modelo usual quando a organização o permite. Quando a organização restringe esse modelo, Claude Code substitui a versão mais recente da família que a organização permite, com o mesmo aviso de substituição. /model <alias> é rejeitado apenas quando cada versão de sua família é restrita; um alias definido com --model, ANTHROPIC_MODEL ou a configuração model ainda é substituído na inicialização nesse caso. Antes da v2.1.205, um alias de família era substituído ou rejeitado com base apenas em sua versão mais recente lançada, mesmo quando uma versão mais antiga era permitida.

Restrições se aplicam em toda a organização ou por função:

• Desabilitar um modelo no nível da organização o remove para cada membro.
• O acesso em nível de função concede diferentes modelos a diferentes funções personalizadas, e um membro que possui várias funções pode usar qualquer modelo que uma de suas funções concede.
• Modelos Haiku estão sempre disponíveis e não podem ser desabilitados, portanto cada membro mantém pelo menos um modelo utilizável.
• Uma mudança de acesso entra em vigor em novas solicitações dentro de cerca de um minuto; o seletor /model reflete isso na próxima vez que uma sessão inicia.

Ambas as restrições se aplicam juntas: um modelo é selecionável apenas quando é permitido por availableModels e não é restrito pela organização. Restrições de organização alcançam sessões na API Anthropic e implantações gateway LLM apenas; em qualquer outro provedor, use availableModels.

Modelo padrão da organização

Os administradores da organização em planos Claude Enterprise podem definir um modelo padrão para membros do Claude Code a partir do console de administração claude.ai, para toda a organização ou por função personalizada. Quando um é definido, a opção Padrão é resolvida para esse modelo. Requer Claude Code v2.1.196 ou posterior.

A linha Padrão no seletor /model mostra o nome do padrão da organização com o rótulo Padrão da org. O rótulo lê Padrão da org se o administrador definiu o padrão para toda a organização ou para sua função. Um padrão de função cobre membros dessa função personalizada e tem precedência sobre o padrão em toda a organização; quando várias de suas funções definem padrões diferentes, o modelo mais capaz se aplica.

O padrão da organização é um ponto de partida, não uma restrição. Essas seleções têm precedência sobre ele:

• a flag --model e a variável de ambiente ANTHROPIC_MODEL
• um valor model em configurações gerenciadas ou fornecido através de --settings
• um valor model em suas configurações de usuário, projeto ou local, incluindo um modelo que você salva com /model

Os administradores também podem configurar o padrão da organização para substituir a seleção do usuário. Com a substituição ativada, ela tem precedência sobre o valor model em configurações de usuário, projeto e local, portanto um modelo que você salva com /model se aplica para a sessão atual e o padrão da organização retorna no próximo lançamento. Quando sua seleção difere, /model mostra O padrão da sua organização (<model>) se aplica ao reiniciar. A flag --model, ANTHROPIC_MODEL, configurações gerenciadas e --settings ainda têm precedência mesmo com a substituição ativada. A substituição está disponível para um conjunto limitado de organizações; pergunte ao seu gerente de conta da Anthropic sobre disponibilidade.

Para limitar quais modelos os membros podem selecionar, use restrições de modelo da organização ou availableModels em vez disso.

Claude Code lê o padrão da organização uma vez na inicialização, portanto um padrão que o administrador altera durante a sessão entra em vigor no próximo lançamento.

Quando o padrão da organização não substitui a seleção do usuário, o primeiro lançamento interativo após o administrador alterá-lo limpa a chave model de suas configurações de usuário uma vez, para que o novo padrão se aplique. Ele não altera nada mais no arquivo, e um modelo que você salva com /model após esse lançamento é mantido.

O padrão da organização passa por essas verificações de restrição antes de ser adotado:

• availableModels por si só não se aplica ao padrão da organização, portanto um padrão da organização fora da lista de permissões ainda se aplica. Quando enforceAvailableModels também está definido, um padrão da organização fora da lista de permissões é remapeado para a primeira entrada da lista de permissões, como qualquer outro Padrão
• um padrão da organização que restrições de modelo da organização negam para sua conta é substituído pelo modelo mais recente permitido em sua família, ou uma família de menor custo quando cada versão dela é restrita
• um padrão da organização que não está disponível para sua conta é ignorado, e a opção Padrão é resolvida como seria sem um padrão da organização

A partir da v2.1.199, quando o padrão da organização é uma família de modelo diferente do padrão usual do tipo de conta, o seletor /model mantém uma linha separada para essa família usual, para que você ainda possa alternar para ela em uma sessão. Na v2.1.196 até v2.1.198 essa linha está faltando no seletor.

O padrão da organização alcança apenas sessões autenticadas com a API Anthropic. Para definir um padrão em qualquer outro lugar, incluindo implantações de gateway LLM, use a chave model em configurações gerenciadas em vez disso.

Limites de esforço da organização

Sua organização pode limitar o nível de esforço de duas maneiras. Em um plano Claude Enterprise, os administradores da organização definem limites de esforço por função, descritos abaixo. Em qualquer plano e qualquer provedor, incluindo Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, a configuração gerenciada maxEffortLevel limita o esforço no cliente. Quando ambos se aplicam a um modelo, o limite inferior se aplica.

Os administradores da organização em planos Claude Enterprise podem definir um nível de esforço máximo por modelo para cada função personalizada, juntamente com restrições de modelo da organização no nível da função. Os níveis acima do limite não são oferecidos no seletor /effort, e nomear um nível superior com --effort ou /effort é executado no limite. Em sessões interativas e execuções simples de texto --print, um aviso nomeia os níveis solicitados e aplicados; com saída json ou stream-json ou em agentes em segundo plano, o limite é aplicado silenciosamente. Os limites são por modelo, portanto, alternar modelos pode mudar quais níveis estão disponíveis. Quando várias de suas funções concedem o mesmo modelo, o limite menos restritivo se aplica. Requer Claude Code v2.1.195 ou posterior.

Os limites de esforço são entregues juntamente com restrições de modelo da organização e chegam às mesmas sessões.

Comportamento especial do modelo

Configuração do modelo `default`

O comportamento de default depende do tipo de sua conta:

• Pro, Max, Team, Enterprise e Anthropic API: padrão para Opus 5.5
• Claude Platform on AWS, Amazon Bedrock e Google Cloud's Agent Platform: padrão para Opus 5.5
• Microsoft Foundry: padrão para Sonnet 4.5

Antes da v2.1.280, default era resolvido para Sonnet 5 em Pro e Team Standard, e para Opus 5 em Max, Team Premium, Enterprise, Anthropic API, Claude Platform on AWS, Amazon Bedrock e Google Cloud's Agent Platform a partir de v2.1.219. Antes da v2.1.219, default era resolvido para Opus 4.8 na Anthropic API, Max, Team Premium e Enterprise com pagamento conforme o uso a partir de v2.1.154, e na Claude Platform on AWS, Amazon Bedrock e Google Cloud's Agent Platform a partir de v2.1.207. Antes da v2.1.207, default era resolvido para Opus 4.7 na Claude Platform on AWS e para Sonnet 4.5 no Amazon Bedrock e Google Cloud's Agent Platform.

Quando um administrador definiu um modelo padrão da organização, default é resolvido para esse modelo em vez do padrão do tipo de conta acima. Requer Claude Code v2.1.196 ou posterior. default também pode ser resolvido para o modelo que você definiu com ANTHROPIC_DEFAULT_MODEL, sob as condições listadas em sua seção.

Quando as configurações gerenciadas aplicam a lista de permissões para o modelo Default e o padrão do tipo de conta não está em availableModels, default é resolvido para o Default aplicado em vez do padrão do tipo de conta acima. Quando ambos se aplicam, o padrão da organização substitui o padrão do tipo de conta primeiro e a aplicação é feita em seguida: um padrão da organização na lista de permissões é mantido, enquanto um fora da lista é resolvido para o Default aplicado.

Os modelos Fable não são o padrão do tipo de conta em nenhum plano ou provedor. Escolher um com /model o salva como o modelo selecionado em suas configurações de usuário, para que as sessões posteriores iniciem nele. Para a alteração única que Claude Code faz em uma seleção Fable 5 salva na v2.1.257, consulte Trabalhar com Fable.

Configuração do modelo `opusplan`

O alias do modelo opusplan fornece uma abordagem híbrida automatizada:

• No modo de plano: usa opus para raciocínio complexo e decisões de arquitetura
• No modo de execução: alterna automaticamente para sonnet para geração de código e implementação

Isso combina o raciocínio do Opus para planejamento com a eficiência do Sonnet para execução.

A fase Opus do modo de plano usa a mesma janela de contexto que a configuração do modelo opus, e a fase de execução usa a mesma janela que sonnet. Quando opus e sonnet são resolvidos para modelos que são executados com a janela de contexto de 1M por padrão, como os modelos atuais fazem na Anthropic API, ambas as fases são executadas com ela. Para solicitar contexto de 1M para ambas as fases onde não o fazem, defina o modelo para opusplan[1m], por exemplo com /model opusplan[1m]. Defini-lo com /model requer Claude Code v2.1.265 ou posterior; em versões anteriores, use o sinalizador --model ou a configuração model em vez disso.

Quando availableModels exclui o Opus mais recente mas permite uma versão mais antiga, por exemplo ["sonnet", "claude-opus-4-6"], opusplan usa o Opus mais recente permitido para planejamento e permanece apenas em Sonnet quando todo Opus é excluído. Uma sessão Haiku que normalmente seria atualizada para Sonnet no modo de plano também usa o Sonnet mais recente permitido, e permanece apenas em Haiku quando todo Sonnet é excluído. Antes da v2.1.205, o modo de plano permanecia no modelo da sessão sempre que a versão mais recente da família de atualização era excluída, mesmo quando a lista de permissões permitia uma mais antiga.

A substituição de uma versão mais antiga permitida se aplica na Anthropic API e Claude Platform on AWS. No Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Mantle, cujas implantações usam IDs de modelo específicos do provedor, o modo de plano permanece no modelo da sessão sempre que o modelo de atualização é excluído.

Para uma abordagem híbrida onde Claude decide no meio da tarefa quando consultar um segundo modelo em vez de alternar no limite do plano, consulte a ferramenta advisor.

Cadeias de modelo de fallback

Quando o modelo primário está sobrecarregado, indisponível ou retorna outro erro de servidor não repetível, Claude Code pode alternar para um modelo de fallback em vez de falhar na solicitação. Autenticação, faturamento, limite de taxa, tamanho de solicitação e erros de transporte, e uma negação pela verificação de política da sua organização, nunca acionam uma alternância; esses seguem sua manipulação normal de repetição e erro.

Configure um ou mais modelos de fallback e Claude Code os tenta em ordem, mostrando um aviso quando alterna. A alternância dura apenas para o turno atual, portanto sua próxima mensagem tenta o modelo primário primeiro novamente. Claude Code limita cadeias a três modelos após remoção de duplicatas e ignora entradas extras.

Defina uma cadeia para uma sessão com o sinalizador --fallback-model, que aceita uma lista separada por vírgulas:

claude --fallback-model sonnet,haiku

Para persistir uma cadeia entre sessões, defina fallbackModel em settings como uma matriz:

{
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}

O sinalizador --fallback-model tem precedência sobre a configuração fallbackModel. Cada entrada aceita um nome de modelo ou alias, e "default" se expande para o modelo padrão.

Claude Code não confirma a cadeia na inicialização e /status não a exibe. O aviso mostrado quando uma alternância acontece é o primeiro sinal visível de que um fallback está configurado.

Quando uma solicitação falha, Claude Code tenta cada entrada em ordem até que uma a aceite. Uma entrada que também não pode ser alcançada, como um modelo descontinuado fixado em configurações, falha para a próxima da mesma forma. Claude Code remove dois tipos de entrada antes dessa caminhada começar:

• Fora da lista de permissões: Claude Code descarta qualquer entrada não permitida por availableModels quando lê a cadeia.
• Janela de contexto menor durante compactação: a cadeia também cobre compactação, mas Claude Code não fará fallback para um modelo com uma janela de contexto menor que a do primário, pois resumir lá cortaria parte da conversa primeiro. Se todo fallback for menor, a compactação mostra o erro original e você pode tentar novamente.

Claude Code também aplica a cadeia a subagentes. Quando a solicitação de um subagente falha, Claude Code tenta seus modelos de fallback configurados em ordem, e o subagente continua no modelo que aceita a solicitação. O modelo da sua sessão permanece inalterado. Antes da v2.1.247, uma falha que a cadeia cobria terminava o subagente.

Fallback automático de modelo

Esta seção cobre fallback baseado em conteúdo de modelos Fable, Opus 5.5 e Opus 5. Para fallback baseado em disponibilidade quando um modelo está sobrecarregado ou indisponível, consulte Cadeias de modelo de fallback.

Os modelos Fable, Opus 5.5 e Opus 5 são executados com classificadores de segurança, que na maioria das vezes sinalizam conteúdo de cibersegurança e biologia. Quando um classificador sinaliza uma solicitação e a categoria sinalizada tem um modelo de fallback, Claude Code executa novamente a solicitação nesse modelo e mostra um aviso na transcrição. Para essas duas categorias, o modelo de fallback depende de qual modelo recusou:

• Fable 5.1, Fable 5 e Opus 5.5: solicitações sinalizadas por biologia são executadas novamente em Opus 5, e solicitações sinalizadas por cibersegurança são executadas novamente em Opus 4.8.
• Opus 5: solicitações sinalizadas por cibersegurança são executadas novamente em Opus 4.8. Solicitações sinalizadas por biologia terminam com uma recusa, porque Opus 5 executa seus próprios classificadores de biologia sem modelo de fallback.

No Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, Claude Code resolve esses destinos através de sua implantação, e se você definir ANTHROPIC_DEFAULT_OPUS_MODEL, categorias que têm um fallback são executadas novamente no modelo fixado; consulte Ativar fallback no Bedrock, Agent Platform e Foundry.

Após um fallback, a sessão continua no modelo de fallback. Para retornar ao seu modelo original, execute /model.

O fallback baseado em categoria requer Claude Code v2.1.219 ou posterior. Antes da v2.1.219, toda solicitação Fable 5 sinalizada era executada novamente no modelo Opus padrão do seu provedor, e Opus 5 não era uma fonte de fallback.

O modelo de fallback é verificado contra availableModels. Quando é bloqueado, nenhum fallback ocorre. A recusa é mostrada como um erro normal e o modelo da sessão permanece inalterado.

Verificar o que acionou o fallback

O fallback pode ser acionado na primeira solicitação de uma sessão, antes de você enviar algo incomum, porque a primeira solicitação carrega contexto do espaço de trabalho, como seu conteúdo CLAUDE.md e status do git. Um repositório que contém material de segurança ou biologia pode acionar o classificador apenas nesse contexto.

Para verificar se as personalizações são o gatilho, inicie uma sessão com claude --safe-mode, que desativa personalizações como CLAUDE.md, skills, servidores MCP e hooks. O status do git e nomes de diretórios não são personalizações e ainda estão inclusos.

Perguntar antes de alternar

Para decidir o que acontece cada vez que uma solicitação é sinalizada, em vez de alternar automaticamente, execute /config e desative Switch models when a message is flagged, ou defina switchModelsOnFlag como false em seu arquivo de configurações. Uma solicitação sinalizada pausa a sessão com duas opções: alternar para o modelo de fallback ou editar o prompt e tentar novamente no modelo atual.

Alguns casos se comportam diferentemente:

• Quando a categoria sinalizada não tem modelo de fallback, como um sinalizador de biologia em Opus 5, Claude Code não mostra o prompt e a solicitação termina com a recusa.
• Se ambos os modelos sinalizarem a mesma solicitação, você pode editar o prompt e tentar novamente ou iniciar uma nova sessão.
• Em sessões Claude Code na web no aplicativo móvel, edição e nova tentativa não são suportadas. Alterne modelos ou continue a sessão de um navegador de desktop ou do aplicativo de desktop.
• Em modo não interativo e integrações SDK que não podem mostrar o prompt, uma solicitação sinalizada termina o turno com uma recusa.
• Quando o destino de fallback é bloqueado por availableModels, Claude Code não mostra o prompt. A solicitação sinalizada termina com a recusa, o mesmo que fallback automático quando o destino é bloqueado.

Ativar fallback no Bedrock, Agent Platform e Foundry

No Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, IDs de modelo são específicos do provedor, portanto o fallback automático opera apenas quando Claude Code pode identificar ambos os modelos envolvidos:

• Claude Code deve reconhecer o modelo atual como uma fonte de fallback. Fable 5.1 e Fable 5 são reconhecidos quando o ID do modelo contém claude-fable-5, corresponde ao valor de ANTHROPIC_DEFAULT_FABLE_MODEL ou é mapeado com modelOverrides. Opus 5.5 e Opus 5 são reconhecidos por seu ID de modelo do provedor ou um mapeamento modelOverrides.
• O modelo de fallback deve ser resolvido em sua implantação. Se você definir ANTHROPIC_DEFAULT_OPUS_MODEL, solicitações sinalizadas são executadas novamente nesse modelo para cada categoria que tem um fallback; um sinalizador de biologia em Opus 5 ainda termina com uma recusa. Se você não o definir, solicitações sinalizadas por cibersegurança são executadas novamente em uma entrada Opus 4.8 na lista de modelos do provedor, e solicitações sinalizadas por biologia de um modelo Fable ou Opus 5.5 em uma entrada Opus 5.

Se nenhum dos modelos puder ser identificado, Claude Code não alterna automaticamente. A solicitação sinalizada termina com uma mensagem de recusa, e você pode alternar modelos com /model e tentar novamente. Definir ANTHROPIC_DEFAULT_FABLE_MODEL para seu ID de modelo Fable ativa o reconhecimento de Fable. Definir ANTHROPIC_DEFAULT_OPUS_MODEL para um ID de modelo Opus fornece às categorias sinalizadas um destino de fallback, a menos que o pino nomeie um modelo fora da família Opus ou o modelo que recusou; então Claude Code não alterna e a recusa permanece.

Pesquisa de segurança e cargas de trabalho de biologia

Cargas de trabalho em segurança ofensiva ou biologia, incluindo testes de penetração, exercícios Capture the Flag (CTF) e bases de código adjacentes à biologia, acionam fallback frequentemente, geralmente na primeira solicitação. Para trabalho substantivo de biologia em Fable 5.1, Fable 5 ou Opus 5.5, Claude Code move a sessão para Opus 5 na primeira solicitação sinalizada, e solicitações posteriores sinalizadas por biologia terminam em recusas lá, porque Opus 5 não tem fallback de biologia. Em Opus 5, você recebe essas recusas da primeira solicitação sinalizada.

Este é o roteamento esperado para esses domínios, não um sinalizador de conta. Se sua organização precisar de capacidade de classe Fable para este trabalho, peça ao seu time de contas da Anthropic sobre programas de acesso confiável.

Ajustar nível de esforço

Níveis de esforço controlam raciocínio adaptativo, que permite ao modelo decidir se e quanto pensar em cada etapa com base na complexidade da tarefa. Esforço menor é mais rápido e mais barato para tarefas diretas, enquanto esforço maior fornece raciocínio mais profundo para problemas complexos.

Os níveis de esforço disponíveis dependem do modelo. Modelos não listados aqui não suportam esforço:

Se você definir um nível que o modelo ativo não suporta, Claude Code volta para o nível mais alto suportado no ou abaixo do que você definiu. Por exemplo, xhigh é executado como high em Opus 4.6. Sua organização ou suas próprias configurações também podem limitar os níveis que um modelo oferece; consulte Limites de esforço da organização.

Com a configuração ultracode desativada, Claude Code resolve o nível de esforço da sessão nesta ordem, tomando o primeiro que se aplica:

1. Uma escolha explícita: a variável de ambiente CLAUDE_CODE_EFFORT_LEVEL, lançamento com --effort, ou /effort na sessão (um /effort não interativo tem efeito mais estreito)
2. Suas configurações: o nível que você salvou para o modelo ou uma chave effortLevel, com a precedência entre eles e entre arquivos de configurações declarada em modelSettings
3. O esforço padrão do modelo: high em cada modelo que suporta esforço, exceto que Opus 5.5 padrão para medium, Opus 4.7 padrão para xhigh e, quando sua organização define um nível de esforço padrão para seu modelo padrão da organização, esse nível é o padrão quando você executa esse modelo

Opus 5.5 começa em medium a menos que uma das fontes acima defina um nível para ele, e um effortLevel de nível superior em seu arquivo de configurações de usuário não conta para Opus 5.5. Essa chave é a forma mais antiga que /effort escreveu antes de Claude Code salvar níveis por modelo: continua se aplicando onde se aplicava antes, em Opus 5, Fable 5.1 e modelos anteriores, enquanto Opus 5.5 e modelos lançados após ele começam em seu próprio padrão até você escolher um nível para eles com /effort ou o seletor /model. Um effortLevel de nível superior em configurações de projeto, local ou gerenciadas, ou um passado com --settings, se aplica a cada modelo.

Quando você define low, medium, high ou xhigh em uma sessão interativa em sua máquina, você escolhe quanto tempo dura confirmando-o:

• Enter no controle deslizante /effort ou no seletor /model, ou um nível digitado após /effort: salve o nível como seu padrão e aplique-o em sessões posteriores
• s no controle deslizante /effort ou no seletor /model: aplique o nível apenas a esta sessão. Requer Claude Code v2.1.257 ou posterior

Claude Code salva o nível por modelo, sob a chave modelSettings em suas configurações de usuário, portanto cada modelo mantém seu próprio nível salvo.

max é o nível de raciocínio mais profundo. A menos que você o defina através da variável de ambiente CLAUDE_CODE_EFFORT_LEVEL, Claude Code aplica max apenas à sessão atual.

# Use o alias opus[1m] ou sonnet[1m]
/model opus[1m]
/model sonnet[1m]

# Ou anexe [1m] a um nome de modelo completo
/model claude-opus-4-8[1m]

export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-5-5"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"
export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8[1m]'

export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'
export ANTHROPIC_DEFAULT_OPUS_MODEL_NAME='Opus via Bedrock'
export ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION='Opus 4.7 routed through a Bedrock custom endpoint'
export ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES='effort,xhigh_effort,max_effort,thinking,adaptive_thinking,interleaved_thinking'

{
  "modelOverrides": {
    "claude-opus-4-7": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-prod",
    "claude-opus-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-46-prod",
    "claude-sonnet-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/sonnet-prod"
  }
}