Sauf si vous définissez ANTHROPIC_DEFAULT_FABLE_MODEL, l'alias fable se résout en Fable 5.1, sauf dans les sessions de passerelle des applications Claude, où fable et best se résolvent en Fable 5. Avant v2.1.257, fable se résolvait en Fable 5 sur chaque fournisseur.

Une passerelle qui n'est pas configurée pour servir claude-fable-5-1 rejette les demandes pour ce modèle. Pour utiliser Fable 5.1 via une passerelle qui le sert, sélectionnez-le avec /model claude-fable-5-1.

Lorsqu'un alias se résout en un modèle plus ancien, les modèles plus récents sont disponibles en sélectionnant explicitement le nom de modèle complet ou en définissant ANTHROPIC_DEFAULT_OPUS_MODEL ou ANTHROPIC_DEFAULT_SONNET_MODEL.

Avant v2.1.219, opus se résolvait en Opus 4.8 sur l'API Anthropic à partir de v2.1.154, et sur Claude Platform on AWS, Amazon Bedrock et Agent Platform de Google Cloud à partir de v2.1.207. Avant v2.1.207, opus se résolvait en Opus 4.7 sur Claude Platform on AWS et en Opus 4.6 sur Amazon Bedrock et Agent Platform de Google Cloud.

Les alias pointent vers la version recommandée pour votre fournisseur et se mettent à jour au fil du temps. Pour épingler une version spécifique, utilisez le nom de modèle complet, par exemple claude-opus-5, ou définissez la variable d'environnement correspondante comme ANTHROPIC_DEFAULT_OPUS_MODEL.

Travailler avec Fable

Claude Fable 5.1 et Claude Fable 5 sont les modèles les plus puissants de Claude Code, adaptés aux tâches plus importantes qu'une seule séance. Ils maintiennent de longues sessions autonomes, enquêtent avant d'agir et vérifient leur travail plus souvent que les modèles plus petits. Fable 5.1 est la version plus récente.

Aucun des deux modèles Fable n'est la valeur par défaut du type de compte sur aucun plan ou fournisseur. Sélectionnez-en un explicitement :

• Fable 5.1 : exécutez /model fable, ou lancez avec claude --model fable. Dans les sessions de passerelle des applications Claude, où l'alias se résout en Fable 5, exécutez /model claude-fable-5-1 à la place.
• Fable 5 : sélectionnez-le par ID de modèle. Sur l'API Anthropic, exécutez /model claude-fable-5 ou lancez avec claude --model claude-fable-5. Sur d'autres fournisseurs, utilisez l'ID de modèle Fable 5 de votre fournisseur ou épinglez-le avec ANTHROPIC_DEFAULT_FABLE_MODEL.

Si vous vous connectez directement à l'API Anthropic et que vos paramètres utilisateur contiennent claude-fable-5 ou claude-fable-5[1m] comme modèle, par exemple parce que vous avez sélectionné Fable dans le sélecteur /model avant v2.1.257, Claude Code change cette valeur enregistrée en alias fable ou fable[1m] la première fois que vous exécutez v2.1.257 ou version ultérieure. La ligne du modèle de démarrage affiche (auto-updated) une fois. Une valeur claude-fable-5 dans les paramètres du projet, locaux ou gérés reste telle quelle.

Les demandes qu'un modèle Fable signale par ses classificateurs de sécurité, le plus souvent dans les domaines de la cybersécurité et de la biologie, déclenchent un basculement automatique du modèle.

Pour tirer le meilleur parti de Fable :

• Décrivez le résultat, pas les étapes : donnez-lui le résultat que vous voulez et laissez-le planifier le chemin. Pour le maintenir en travaillant vers ce résultat, définissez un objectif.
• Donnez-lui des problèmes ambigus : les enquêtes sur les causes profondes, le débogage des pannes et les décisions architecturales sont les endroits où l'enquête et la vérification supplémentaires sont payantes.
• Ignorez les rappels de vérification : il vérifie son propre travail avec moins d'invites, donc les rappels de tester ou de vérifier sont généralement inutiles.
• Dimensionnez les tâches plus importantes : donnez-lui du travail que vous diviseriez normalement en morceaux. Il maintient de longues sessions sans perdre le fil.

Sur l'API Anthropic, le sélecteur /model répertorie un modèle Fable uniquement après que le serveur le signale comme disponible pour votre organisation. Lorsque vous tapez /model fable ou un ID de modèle Fable, Claude Code vérifie la disponibilité directement auprès du serveur, de sorte qu'une sélection tapée peut réussir même lorsque le sélecteur ne répertorie pas l'entrée.

Fable et crédits d'utilisation

Selon votre plan et votre niveau de siège, l'utilisation de Fable peut être facturée aux crédits d'utilisation au lieu de puiser dans les limites incluses de votre plan. Lorsque c'est le cas, le sélecteur /model affiche « Requires usage credits » sur la ligne Fable. Pour gérer les crédits d'utilisation, consultez Add usage credits to your subscription.

Dans les sessions interactives, Claude Code affiche une invite de consentement avant qu'une demande Fable ne facture les crédits d'utilisation. Les membres des plans Enterprise avec facturation organisationnelle ne voient pas l'invite. Vous pouvez continuer sur Fable en utilisant les crédits d'utilisation ou basculer vers votre modèle par défaut. Vous pouvez également ignorer l'invite :

• Dans le sélecteur /model, vous conservez votre modèle actuel.
• En cours de session, Claude Code continue le tour sur votre modèle par défaut.

Après avoir choisi de continuer sur Fable en utilisant les crédits d'utilisation, Claude Code n'affiche plus l'invite.

Dans une session avec Remote Control connecté, une session en arrière-plan, ou une session d'un coéquipier d'une équipe d'agents, personne ne peut être au terminal, donc Claude Code maintient l'invite de consentement en cours de session jusqu'à la date limite dialogExpiry, cinq minutes par défaut. Si personne n'a répondu avant la date limite, Claude Code termine le tour sans envoyer la demande et ajoute un avis à la transcription, que le client Remote Control affiche également. Votre sélection de modèle est inchangée, et Claude Code demande à nouveau le consentement à votre prochain message.

Ce que vous pouvez faire pendant que l'invite attend dépend de la session :

• Avec Remote Control connecté ou dans une session d'un coéquipier, appuyez sur n'importe quelle touche au terminal pour annuler la date limite, et Claude Code attend votre réponse.
• Dans une session en arrière-plan, répondez avant la date limite.
• Si vous envoyez un nouveau message à partir du client distant avant que quelqu'un n'ait tapé au terminal, Claude Code termine le tour de la même manière, et votre nouveau message commence le tour suivant. Après que quelqu'un ait tapé au terminal, Claude Code continue d'attendre la réponse et met en file d'attente votre nouveau message derrière.

En mode non interactif avec l'indicateur -p et via le SDK Agent, Claude Code n'affiche jamais l'invite de consentement. Lorsqu'une demande Fable là-bas serait facturée aux crédits d'utilisation, Claude Code la facture sans demander.

Définir votre modèle

Vous pouvez configurer votre modèle de plusieurs façons, énumérées par ordre de priorité :

1. Pendant la session : utilisez /model <alias|name> pour basculer immédiatement, ou exécutez /model sans argument pour ouvrir le sélecteur. Consultez when Claude Code asks you to confirm the switch
2. Au démarrage : lancez avec claude --model <alias|name>
3. Variable d'environnement : définissez ANTHROPIC_MODEL=<alias|name>
4. Paramètres : configurez de manière permanente dans votre fichier de paramètres en utilisant le champ model
5. Par défaut pour les nouvelles sessions : définissez ANTHROPIC_DEFAULT_MODEL=<alias|name>

/model enregistre votre choix comme valeur par défaut pour les nouvelles sessions en écrivant le champ model dans vos paramètres utilisateur. Dans le sélecteur :

• Enter : basculer le modèle et enregistrer comme valeur par défaut
• s : basculer le modèle pour cette session uniquement et laisser votre valeur par défaut inchangée. Pour utiliser une clé différente, reliez modelPicker:thisSessionOnly

Taper /model <name> directement se comporte comme Enter. Pour basculer pour cette session uniquement, ouvrez le sélecteur avec /model et appuyez sur s sur la ligne du modèle.

Si vous définissez un modèle avec /model en mode non interactif, avec l'indicateur -p, votre choix s'applique à la session actuelle uniquement et n'est pas enregistré comme valeur par défaut ; /model dans ce mode nécessite Claude Code v2.1.205 ou version ultérieure. Les paramètres du projet et gérés conservent toujours la priorité et se réappliquent au prochain lancement. Un modèle par défaut de l'organisation que votre administrateur a configuré pour remplacer la sélection de l'utilisateur se réapplique également au prochain lancement.

Dans v2.1.144 à v2.1.152, /model s'appliquait à la session actuelle uniquement et d dans le sélecteur enregistrait une valeur par défaut.

L'indicateur --model et la variable d'environnement ANTHROPIC_MODEL s'appliquent uniquement à la session que vous lancez avec eux. Pour exécuter différents modèles dans différents terminaux en même temps, lancez chacun avec son propre indicateur --model plutôt que de basculer avec /model.

Les prix dans le sélecteur /model apparaissent lorsque Claude Code communique avec l'API Anthropic, directement ou via une passerelle LLM qui la proxifie, et le prix sur une ligne est le prix du modèle que cette ligne sélectionne. Sur les fournisseurs tiers tels qu'Amazon Bedrock et sur la passerelle des applications Claude, votre fournisseur ou passerelle détermine ce que vous payez, donc les lignes du sélecteur n'affichent aucun prix. Le prix est une étiquette d'affichage uniquement ; il n'affecte pas le modèle qu'une ligne sélectionne ou ce que votre fournisseur facture. Avant v2.1.206, Claude Platform on AWS et les sessions de passerelle affichaient les prix de liste d'Anthropic, et une ligne pouvait afficher le prix d'un modèle différent de celui qu'elle sélectionnait.

Les sessions reprises commencées avec claude --resume, --continue, ou le sélecteur /resume conservent le modèle qu'elles utilisaient lorsque la transcription a été enregistrée, indépendamment du paramètre model actuel. Si le modèle restauré a été retiré ou est exclu par availableModels, la session revient à l'ordre de priorité normal. Cela empêche le choix /model d'une autre session de modifier le modèle à la reprise. Sur les fournisseurs qui utilisent des ID de déploiement spécifiques au fournisseur plutôt que des ID de modèle Anthropic, tels qu'Amazon Bedrock, Agent Platform de Google Cloud et Microsoft Foundry, le modèle de transcription n'est pas restauré du tout et la session résout son modèle via l'ordre de priorité normal.

Un modèle que vous choisissez pour le nouveau lancement avec --model ou ANTHROPIC_MODEL conserve toujours la priorité sur le modèle restauré. À partir de v2.1.195, une variable de la famille ANTHROPIC_DEFAULT_OPUS_MODEL aussi. ANTHROPIC_DEFAULT_MODEL peut aussi, selon les conditions énumérées dans sa section.

Lorsque le modèle actif au démarrage provient des paramètres du projet ou gérés plutôt que de votre propre sélection, l'en-tête de démarrage indique quel fichier de paramètres l'a défini. Exécutez /model pour remplacer ; le paramètre du projet ou géré se réapplique au prochain lancement. Sur les plates-formes qui intègrent Claude Code et définissent CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, la configuration du modèle de l'hôte a priorité sur les paramètres du modèle géré, tandis qu'une liste d'autorisation availableModels gérée reste en vigueur sauf si l'hôte en fournit une ; Exceptions to managed settings precedence indique quelles clés et variables l'hôte remplace.

Si vous ou votre organisation configurez des crochets PreModelSwitch, ils s'exécutent avant qu'un changement demandé s'applique et peuvent le bloquer ou vous demander de confirmer.

Lorsque Claude Code ne peut pas déterminer quels crochets PreModelSwitch vos plugins gérés de l'organisation fournissent, par exemple parce qu'un plugin géré n'a pas pu se charger, il refuse le changement plutôt que de l'appliquer sans vérification, et il vérifie à nouveau à chaque nouvelle tentative. Consultez Model switch was blocked by a PreModelSwitch hook pour le message et la récupération.

Lorsque vous changez de modèle via la méthode setModel() du SDK Agent ou à partir d'un appareil connecté via Remote Control, ou une application telle que l'application de bureau qui exécute l'interface de ligne de commande Claude Code pour vous, Claude Code vérifie que la chaîne est une qu'il reconnaît avant de l'enregistrer. Cette vérification nécessite Claude Code v2.1.200 ou version ultérieure. Vérifier un choix Remote Control nécessite Claude Code v2.1.260 ou version ultérieure sur votre machine. Sur l'API Anthropic, Claude Code reconnaît :

• un alias de modèle
• une entrée du sélecteur /model
• tout nom qui commence par claude-
• une valeur que vous avez configurée vous-même comme option de modèle personnalisé ou dans modelOverrides

Claude Code rejette une chaîne non reconnue avec Model "<name>" is not a recognized model id. et la session conserve son modèle actuel, au lieu d'enregistrer la chaîne et d'échouer à la prochaine demande. Consultez la référence d'erreur pour les étapes de récupération.

La vérification s'exécute uniquement sur l'API Anthropic. Sur Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry, Claude Platform on AWS, et derrière une passerelle LLM ou une ANTHROPIC_BASE_URL personnalisée, votre fournisseur ou passerelle définit les noms de modèles, donc Claude Code transmet n'importe quelle chaîne sans la vérifier. La vérification ne couvre pas non plus l'indicateur --model, la variable d'environnement ANTHROPIC_MODEL, ou le paramètre model ; une valeur mal tapée là-bas produit There's an issue with the selected model à la première demande à la place. Claude Code peut toujours écrire la ligne de diagnostic unrecognized-model au moment de la demande, sur chaque fournisseur.

Lorsque le modèle demandé a une date de retraite programmée ou est automatiquement remappé à une version plus récente, Claude Code affiche un avertissement qui nomme le modèle demandé. Les sessions interactives l'affichent comme un avis de démarrage. À partir de v2.1.182, le même avertissement est écrit sur stderr en mode non interactif lors de l'utilisation du format de sortie texte par défaut. La vérification couvre également un model défini dans frontmatter de sous-agent. L'avertissement stderr est supprimé pour --output-format json et stream-json ; lisez le modèle réel à partir du champ modelUsage du message de résultat à la place.

Par exemple, démarrez une session sur Opus :

claude --model opus

Puis basculez les modèles au sein de la session :

/model sonnet

Exemple de fichier de paramètres :

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

Définir un modèle par défaut pour les nouvelles sessions

Définissez ANTHROPIC_DEFAULT_MODEL=<alias|name> pour choisir le modèle sur lequel vos sessions démarrent par défaut. Nécessite Claude Code v2.1.236 ou version ultérieure.

Claude Code démarre une nouvelle session sur le modèle de la variable uniquement lorsqu'aucun de ceux-ci ne sélectionne un modèle :

• L'indicateur --model
• ANTHROPIC_MODEL
• Une valeur model dans n'importe quel fichier de paramètres, y compris le choix que vous enregistrez avec /model
• Un modèle par défaut de l'organisation

Un choix que vous enregistrez avec /model a priorité sur la variable aux lancements ultérieurs aussi. Avec ANTHROPIC_MODEL défini à la place, Claude Code revient au modèle de cette variable au prochain lancement, quel que soit ce que vous avez enregistré avec /model.

Claude Code résout également l'option Par défaut au modèle de la variable, sauf si un modèle par défaut de l'organisation s'applique. Lorsque l'option Par défaut se résout au modèle de la variable, la ligne Par défaut dans le sélecteur /model affiche l'étiquette Set by ANTHROPIC_DEFAULT_MODEL.

Claude Code ignore la variable dans ces cas, et l'option Par défaut se résout comme si vous ne l'aviez pas définie :

• Vous l'avez définie sur default, inherit, opusplan, ou haiku
• enforceAvailableModels est activé
• availableModels ou restrictions de modèle de l'organisation excluent le modèle
• Le modèle n'est pas disponible pour votre compte

Lorsqu'une nouvelle session démarrerait sur le modèle de la variable, une session que vous reprenez avec claude --resume, --continue, ou le sélecteur /resume démarre également sur celui-ci. Claude Code ne restaure pas le modèle enregistré dans la transcription de cette session. Sinon, Claude Code n'utilise pas la variable lorsque vous reprenez une session.

Une nouvelle session démarre sur un modèle différent de celui que vous avez choisi

Lorsque vous choisissez un modèle avec /model et que votre prochaine session démarre sur quelque chose d'autre, ce sont les causes habituelles :

• Vous l'avez choisi pour une session. Appuyer sur s dans le sélecteur, lancer avec --model, et exécuter /model en mode non interactif s'appliquent tous à la session actuelle et laissent votre valeur par défaut enregistrée seule.
• Quelque chose avec une priorité plus élevée définit le modèle. Une valeur model dans les paramètres du projet ou gérés, ANTHROPIC_MODEL dans votre shell, ou un modèle par défaut de l'organisation que votre administrateur a défini pour remplacer les choix de l'utilisateur s'applique à nouveau à chaque lancement. Votre choix /model est toujours enregistré ; il est surclassé. Lorsque les paramètres du projet ou gérés définissent le modèle, l'en-tête de démarrage nomme le fichier.
• Claude Code n'a pas pu enregistrer votre choix. /model écrit model dans ~/.claude/settings.json. Si vous ne pouvez pas écrire dans ce fichier, par exemple parce qu'un autre outil le génère ou le lie à une copie en lecture seule, le modèle que vous avez choisi dure pour la session et le prochain lancement lit l'ancienne valeur. Définissez model dans l'outil qui génère le fichier, ou rendez le fichier accessible en écriture. Consultez A change you made in Claude Code is lost in new sessions.
• Vous avez repris une session. Une session que vous reprenez avec claude --resume ou --continue conserve généralement le modèle qu'elle utilisait plutôt que votre valeur par défaut actuelle.

Restreindre la sélection de modèle

Les administrateurs d'entreprise peuvent utiliser availableModels dans les paramètres gérés ou de politique pour restreindre les modèles que les utilisateurs peuvent sélectionner. Les entrées correspondent à une famille de modèles telle que sonnet, un préfixe de version tel que claude-sonnet-4-5, ou un ID de modèle complet tel que claude-sonnet-4-5-20250929. Un préfixe de version correspond également aux ID de modèles ultérieurs qui l'étendent avec un autre segment, donc claude-fable-5 permet à la fois Fable 5 et Fable 5.1, tandis que claude-fable-5-1 permet uniquement Fable 5.1.

Sur les plateformes qui intègrent Claude Code et définissent CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, la configuration de modèle de l'hôte a priorité sur les paramètres de modèle gérés, tandis qu'une liste d'autorisation availableModels gérée reste en vigueur sauf si l'hôte fournit la sienne ; Exceptions à la priorité des paramètres gérés indique quelles clés et variables l'hôte remplace.

Lorsque availableModels est défini, la liste d'autorisation s'applique partout où un utilisateur peut spécifier un modèle :

• Modèle de session principale : /model, l'indicateur --model, la variable d'environnement ANTHROPIC_MODEL, le paramètre model, ANTHROPIC_DEFAULT_MODEL, et le modèle restauré lors de la reprise d'une session
• Résolution d'alias : les variables d'environnement ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL, et ANTHROPIC_DEFAULT_FABLE_MODEL ne peuvent pas rediriger un alias autorisé vers un modèle en dehors de la liste
• Mode rapide : /fast refuse de basculer lorsque cela changerait implicitement vers un modèle Opus en dehors de la liste, avec le message « is not in your organization's allowed models »
• Modèles de sous-agent et de coéquipier : le champ model dans la frontmatter de sous-agent, le paramètre model de l'outil Agent, les modèles de coéquipier d'équipe d'agent, CLAUDE_CODE_SUBAGENT_MODEL, et, sur v2.1.197 et antérieures, le sélecteur de modèle dans l'assistant /agents
• Modèles de compétence et de commande : la frontmatter model dans les compétences et commandes
• Modèle de conseiller : le paramètre advisorModel configuré et l'indicateur --advisor
• Modèle d'agent en arrière-plan : le modèle sélectionné dans le sélecteur de dispatch

Sur l'API Anthropic et Claude Platform on AWS, un alias de famille de modèles, opus, sonnet, haiku, ou fable, se résout à son modèle habituel lorsque la liste d'autorisation permet ce modèle. Lorsque la liste d'autorisation bloque ce modèle, Claude Code substitue la version la plus récente de la famille que la liste d'autorisation permet et affiche un avis nommant à la fois les modèles demandés et substitués. Avec ["sonnet", "claude-opus-4-6"], par exemple, à la fois /model opus et --model opus sélectionnent Claude Opus 4.6, le plus récent Opus autorisé. Avant v2.1.205, un alias dont la version la plus récente publiée était en dehors de la liste était rejeté ou remplacé comme toute autre sélection bloquée, même lorsque la liste permettait une version plus ancienne.

La substitution a besoin d'une version autorisée sur laquelle atterrir : lorsque la liste d'autorisation ne permet aucune version de la famille de l'alias, l'alias suit le comportement de rejet et de remplacement ci-dessous comme toute autre valeur bloquée.

Claude Code gère toute autre sélection bloquée selon l'endroit où le modèle a été défini :

• /model : Claude Code rejette le changement avec une erreur

• Indicateur --model, ANTHROPIC_MODEL, ou paramètre model : Claude Code remplace la valeur au démarrage par un avis nommant à la fois les modèles demandés et substitués, et la session démarre sur le modèle par défaut

• ANTHROPIC_DEFAULT_MODEL : Claude Code ignore la variable

• Remplacement de sous-agent ou de coéquipier : Claude Code exécute le sous-agent ou le coéquipier sur un modèle de secours plutôt que d'échouer la demande. Voir Choisir un modèle pour le secours du sous-agent et Spécifier les coéquipiers et les modèles pour le secours du coéquipier.

  Dans les sessions interactives, Claude Code vous avertit lorsqu'il substitue le modèle d'un sous-agent, par ce secours ou par la substitution de version la plus récente autorisée ci-dessus, nommant les modèles demandés et substitués ; il ne signale pas le secours d'un coéquipier.

  Lorsque la substitution de version la plus récente autorisée ci-dessus fonctionne, un alias de famille bloqué la suit à la place. Avant v2.1.222, un alias revenait comme toute autre valeur bloquée sur chaque fournisseur

• Remplacement de compétence ou de commande : Claude Code ignore le remplacement, y compris un alias de famille bloqué, et la compétence ou la commande s'exécute sur le modèle de session. Une compétence ou une commande qui s'exécute dans un sous-agent suit le comportement du sous-agent ci-dessus à la place

• Paramètre advisorModel : le conseiller est désactivé pour la session

• Indicateur --advisor : Claude Code se termine avec une erreur au lancement. Dans une session en arrière-plan, il démarre la session sans le conseiller au lieu de se terminer

Claude Code masque les modèles exclus du sélecteur /model. Un ID de modèle complet dans la liste qui n'a pas de ligne de sélecteur intégrée, tel qu'une version plus ancienne que la liste épingle, apparaît dans le sélecteur /model comme sa propre ligne étiquetée, sauf si Claude Code remplace les options intégrées par une lineup modelPicker. Avant v2.1.199, un tel ID n'était sélectionnable qu'en tapant /model <id>.

Les changements de modèle que Claude Code effectue en votre nom sont vérifiés de la même manière :

• Chaînes de modèle de secours : les entrées en dehors de la liste d'autorisation sont supprimées
• Mises à niveau du mode plan : sur l'API Anthropic et Claude Platform on AWS, une mise à niveau telle que opusplan vers un modèle exclu utilise la version la plus récente autorisée de la famille de mise à niveau. Sur les fournisseurs avec des ID de modèle spécifiques au fournisseur, et lorsqu'aucune version n'est autorisée, la mise à niveau est ignorée et la planification continue sur le modèle de la session
• Secours de modèle automatique : un secours dont la cible est exclue ne s'exécute pas, donc la demande signalée se termine par un refus à la place
• Classificateur du mode automatique : la valeur par défaut Claude Sonnet 5 du classificateur s'applique uniquement lorsque la liste d'autorisation permet Sonnet 5. Lorsqu'il est exclu, le classificateur s'exécute sur le modèle de la session, que la liste d'autorisation gouverne déjà, ou sur un modèle Opus lorsque la session s'exécute sur un modèle Fable. Sur les fournisseurs autres que l'API Anthropic, ce secours Opus s'exécute sur le modèle Opus par défaut du fournisseur sans consulter la liste d'autorisation. Nécessite Claude Code v2.1.210 ou ultérieur
• Mode rapide : l'activation du mode rapide est refusée lorsque le modèle sur lequel la session s'exécuterait ensuite est en dehors de la liste d'autorisation

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

Couverture de surface

Chaque surface applique la liste d'autorisation qu'elle reçoit. Le mécanisme de livraison qui atteint chaque surface diffère :

• Les sessions cloud, sur Claude Code sur le web ou dans l'application de bureau, s'exécutent sur des machines virtuelles gérées par Anthropic par défaut : les paramètres déployés sur votre appareil ne les atteignent pas, donc livrez la liste d'autorisation via les paramètres gérés par le serveur. Les sessions que votre organisation achemine vers un environnement auto-hébergé s'exécutent sur votre propre calcul et lisent également le fichier de paramètres gérés dans l'image du runner. Comment Claude Code combine les sources gérées indique quand ce fichier s'applique. Un changement de modèle en milieu de session dans une session cloud est rejeté lorsque le modèle demandé est exclu par la liste d'autorisation. Le rejet côté serveur à la création de session s'applique aux restrictions de modèle d'organisation, pas à la clé de paramètres availableModels.
• Cowork, l'onglet de travail agentique dans l'application Claude Desktop, exécute ses sessions sur Claude Code mais, par conception, ne reçoit pas les paramètres gérés par le serveur de la console d'administration claude.ai. Un fichier de paramètres gérés s'applique aux sessions Cowork lorsqu'il est présent où la session s'exécute ; les sessions Cowork distantes s'exécutent sur des machines virtuelles gérées par Anthropic, où un fichier déployé sur l'appareil n'est pas présent.
• Les sessions sur fournisseurs tiers tels qu'Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry, et Claude Platform on AWS ne reçoivent pas les paramètres gérés par le serveur, donc livrez la liste d'autorisation via MDM ou des fichiers de paramètres gérés là-bas.
• La livraison gérée par le serveur nécessite également que la session s'authentifie avec une connexion ou clé éligible. Les flottes qui génèrent des clés uniquement via un script apiKeyHelper doivent livrer la liste d'autorisation via MDM ou des fichiers de paramètres gérés.
• L'onglet Code du bureau héberge également les sessions SSH, qui lisent le fichier de paramètres gérés à partir de l'hôte distant sur lequel elles s'exécutent. Voir Paramètres gérés du bureau.
• Les sélecteurs de modèle sur claude.ai et dans l'application de bureau masquent ou grisent les modèles exclus par la liste d'autorisation de votre organisation. L'état du sélecteur est une commodité pour les utilisateurs ; l'application se fait dans la session.

Comportement du modèle par défaut

En soi, availableModels laisse l'option Par défaut sur la valeur par défaut d'exécution du système pour le compte jusqu'à ce que vous définissiez également enforceAvailableModels. Si ce défaut est un modèle que vous avez l'intention de restreindre, définissez également enforceAvailableModels.

Un tableau availableModels vide n'engage jamais l'application de l'option Modèle par défaut : avec availableModels: [], les sélections de modèles nommés sont bloquées mais le modèle par défaut pour le type de compte reste utilisable quel que soit enforceAvailableModels.

Appliquer la liste d'autorisation au modèle par défaut

Définissez enforceAvailableModels: true aux côtés d'un availableModels non vide dans les paramètres gérés pour étendre la liste d'autorisation à l'option Par défaut. Cela nécessite Claude Code v2.1.175 ou ultérieur.

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

L'option Par défaut se résout au défaut du type de compte, ou au modèle par défaut d'organisation lorsqu'un administrateur en a défini un. Lorsque ce modèle n'est pas dans la liste d'autorisation, l'option Par défaut se résout à la place à la première entrée availableModels qui nomme un modèle autorisé et disponible, et la ligne Par défaut du sélecteur /model affiche ce modèle. Cela s'applique partout où le défaut est atteint : démarrage de session, sélection de Par défaut dans /model, le mot-clé "default" dans les chaînes de modèle de secours, et le secours utilisé lorsqu'une sélection exclue est supprimée.

enforceAvailableModels remapte l'option Par défaut uniquement lorsque availableModels est non vide. Avec availableModels: [], le modèle par défaut pour le type de compte reste utilisable, donc le paramètre ne peut pas verrouiller les utilisateurs hors de chaque modèle. Lorsque availableModels est non vide mais qu'aucune entrée ne se résout à un modèle autorisé et disponible, l'application est ignorée et Par défaut se résout au défaut du type de compte, avec un avertissement visible uniquement sous --debug. Gardez au moins une entrée garantie disponible dans la liste pour éviter cela.

Déployez les deux clés ensemble dans la source gérée la mieux classée que vous livrez. Par défaut, Claude Code ne lit que cette source, donc une paire placée dans un fichier de paramètres gérés est ignorée lorsque la console d'administration livre des paramètres ; sous la fusion opt-in dans comment Claude Code combine les sources gérées, Claude Code ignore toujours une carte modelOverrides d'une source classée en dessous de celle qui définit availableModels.

Contrôler le modèle sur lequel les utilisateurs s'exécutent

Le paramètre model est une sélection initiale, pas une application. Il définit quel modèle est actif au démarrage d'une session, mais les utilisateurs peuvent toujours ouvrir /model et choisir Par défaut, qui se résout à la valeur par défaut d'exécution du système quel que soit ce qui est défini pour model, sauf si enforceAvailableModels le redirige.

Pour contrôler complètement l'expérience du modèle, combinez ces paramètres :

• availableModels : restreint les modèles nommés vers lesquels les utilisateurs peuvent basculer
• enforceAvailableModels : étend la liste d'autorisation availableModels à l'option Par défaut, donc Par défaut ne peut pas se résoudre à un modèle en dehors de la liste
• model : définit la sélection de modèle initiale au démarrage d'une session
• ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL / ANTHROPIC_DEFAULT_FABLE_MODEL : contrôlez à quoi les alias sonnet, opus, haiku, et fable se résolvent, et quelle version la valeur par défaut du type de compte utilise

Cet exemple démarre les utilisateurs sur Sonnet 4.5, limite le sélecteur à Sonnet et Haiku, et garantit que Par défaut se résout à un modèle sur la liste d'autorisation plutôt que la valeur par défaut du niveau :

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

Sans enforceAvailableModels ou le bloc env, un utilisateur qui sélectionne Par défaut dans le sélecteur obtient la valeur par défaut d'exécution plutôt que la version épinglée dans model. Les deux paramètres couvrent des portées différentes : enforceAvailableModels fait que Par défaut obéit à la liste d'autorisation, tandis que le bloc env épingle quelle version un alias autorisé tel que sonnet se résout. Utilisez enforceAvailableModels seul lorsque restreindre les familles de modèles est suffisant ; ajoutez le bloc env lorsque vous avez également besoin d'épingler une version spécifique.

Comportement de fusion

Lorsque les paramètres gérés que Claude Code applique définissent availableModels, cette liste seule s'applique, à part une plateforme hôte qui fournit la sienne : les entrées dans les paramètres utilisateur, projet ou local ne peuvent pas l'étendre, et Claude Code ne fusionne jamais availableModels entre les sources gérées non plus ; comment Claude Code combine les sources gérées indique quelle liste de source s'applique. Sinon, les listes des paramètres utilisateur, projet et local sont concaténées et dédupliquées comme d'autres paramètres de tableau. Avant Claude Code v2.1.175, les entrées des portées de priorité inférieure fusionnaient dans la liste gérée au lieu d'être remplacées par elle.

Dans la liste effective, une entrée nommant un modèle spécifique dans une famille, qu'il s'agisse d'un préfixe de version ou d'un ID de modèle complet, désactive l'entrée de caractère générique de cette famille : ["sonnet", "claude-sonnet-4-5"] permet uniquement les versions Sonnet 4.5, pas tous les modèles Sonnet.

ID de modèle Mantle

Lorsque le point de terminaison Amazon Bedrock Mantle est activé, les entrées dans availableModels qui commencent par anthropic. sont ajoutées au sélecteur /model comme options personnalisées et acheminées vers le point de terminaison Mantle. Ceci est une exception à la correspondance d'alias décrite dans Épingler les modèles pour les déploiements tiers. Le paramètre restreint toujours le sélecteur aux entrées listées, et un ID Mantle intègre un nom de famille, donc il compte comme une entrée spécifique et désactive le caractère générique de cette famille : aux côtés de tous les ID Mantle, listez les préfixes de version ou les ID complets que vous souhaitez garder sélectionnables. Voir Comportement de fusion.

Restrictions de modèle d'organisation

Les administrateurs d'organisation sur les plans Claude Enterprise restreignent les modèles que les membres peuvent exécuter en désactivant les modèles individuels dans la console d'administration claude.ai. Cette restriction est livrée avec les droits du compte lorsque Claude Code s'authentifie, séparé de toute liste availableModels dans les paramètres, et le serveur applique la même restriction indépendamment lorsqu'une session est créée. Nécessite Claude Code v2.1.187 ou ultérieur.

La restriction s'applique lorsqu'un membre se connecte ou utilise sa propre clé API. Les identifiants d'organisation, tels que les clés de service d'organisation, ne sont pas liés à un utilisateur, donc la restriction ne s'applique pas à eux.

La console Claude n'a pas de contrôle de restriction de modèle. Les organisations sans plan Claude Enterprise, y compris celles dont les membres s'authentifient via l'API Anthropic, restreignent les modèles avec availableModels dans les paramètres gérés à la place, en ajoutant enforceAvailableModels pour couvrir l'option Par défaut. Ces paramètres sont appliqués par Claude Code lui-même, pas par le serveur.

Un modèle restreint est masqué du sélecteur /model. Le sélectionner par nom avec --model, la variable d'environnement ANTHROPIC_MODEL, ou le paramètre model affiche l'avis Model "<name>" is restricted by your organization's settings. Using <model> instead. et la session démarre sur un modèle autorisé. Taper /model <name> pour un modèle restreint est rejeté avec Model '<name>' is restricted by your organization's settings. Run /model to choose a different model. et la session garde son modèle actuel.

Un alias de famille de modèles tel que opus se résout à son modèle habituel lorsque l'organisation le permet. Lorsque l'organisation restreint ce modèle, Claude Code substitue la version la plus récente de la famille que l'organisation permet, avec le même avis de substitution. /model <alias> est rejeté uniquement lorsque chaque version de sa famille est restreinte ; un alias défini avec --model, ANTHROPIC_MODEL, ou le paramètre model est toujours remplacé au démarrage dans ce cas. Avant v2.1.205, un alias de famille était substitué ou rejeté en fonction de sa version la plus récente publiée seule, même lorsqu'une version plus ancienne était autorisée.

Les restrictions s'appliquent à l'échelle de l'organisation ou par rôle :

• La désactivation d'un modèle au niveau de l'organisation le supprime pour chaque membre.
• L'accès au niveau du rôle accorde différents modèles à différents rôles personnalisés, et un membre qui détient plusieurs rôles peut utiliser n'importe quel modèle qu'un de ses rôles accorde.
• Les modèles Haiku sont toujours disponibles et ne peuvent pas être désactivés, donc chaque membre garde au moins un modèle utilisable.
• Un changement d'accès prend effet sur les nouvelles demandes dans environ une minute ; le sélecteur /model le reflète la prochaine fois qu'une session démarre.

Les deux restrictions s'appliquent ensemble : un modèle n'est sélectionnable que lorsqu'il est autorisé par availableModels et non restreint par l'organisation. Les restrictions d'organisation atteignent les sessions sur l'API Anthropic et les déploiements de passerelle LLM uniquement ; sur tout autre fournisseur, utilisez availableModels à la place.

Modèle par défaut de l'organisation

Les administrateurs d'organisation sur les plans Claude Enterprise peuvent définir un modèle par défaut pour les membres de Claude Code à partir de la console d'administration claude.ai, pour l'ensemble de l'organisation ou par rôle personnalisé. Lorsqu'un modèle est défini, l'option Par défaut se résout à ce modèle. Nécessite Claude Code v2.1.196 ou version ultérieure.

La ligne Par défaut dans le sélecteur /model affiche le nom du modèle par défaut de l'organisation avec l'étiquette Org default. L'étiquette indique Org default que l'administrateur ait défini le modèle par défaut pour l'ensemble de l'organisation ou pour votre rôle. Un modèle par défaut de rôle s'applique aux membres de ce rôle personnalisé et prend précédence sur le modèle par défaut à l'échelle de l'organisation ; lorsque plusieurs de vos rôles définissent des modèles par défaut différents, le modèle le plus capable s'applique.

Le modèle par défaut de l'organisation est un point de départ, pas une restriction. Ces sélections prennent précédence sur celui-ci :

• le drapeau --model et la variable d'environnement ANTHROPIC_MODEL
• une valeur model dans les paramètres gérés ou fournie via --settings
• une valeur model dans vos paramètres utilisateur, projet ou locaux, y compris un modèle que vous enregistrez avec /model

Les administrateurs peuvent également configurer le modèle par défaut de l'organisation pour remplacer la sélection de l'utilisateur. Avec le remplacement activé, il prend précédence sur la valeur model dans les paramètres utilisateur, projet et locaux, de sorte qu'un modèle que vous enregistrez avec /model s'applique pour la session actuelle et le modèle par défaut de l'organisation revient au lancement suivant. Lorsque votre sélection diffère, /model affiche Your organization's default (<model>) applies on restart. Le drapeau --model, ANTHROPIC_MODEL, les paramètres gérés et --settings prennent toujours précédence même avec le remplacement activé. Le remplacement est disponible pour un ensemble limité d'organisations ; contactez votre équipe de compte Anthropic pour connaître la disponibilité.

Pour limiter les modèles que les membres peuvent sélectionner, utilisez plutôt les restrictions de modèle de l'organisation ou availableModels.

Claude Code lit le modèle par défaut de l'organisation une seule fois au démarrage, de sorte qu'un modèle par défaut que l'administrateur modifie en cours de session prend effet au lancement suivant.

Lorsque le modèle par défaut de l'organisation ne remplace pas la sélection de l'utilisateur, le premier lancement interactif après que l'administrateur le modifie efface la clé model de vos paramètres utilisateur une seule fois, de sorte que le nouveau modèle par défaut s'applique. Il ne change rien d'autre dans le fichier, et un modèle que vous enregistrez avec /model après ce lancement est conservé.

Le modèle par défaut de l'organisation passe par ces vérifications de restriction avant d'être adopté :

• availableModels seul ne s'applique pas au modèle par défaut de l'organisation, de sorte qu'un modèle par défaut de l'organisation en dehors de la liste d'autorisation s'applique toujours. Lorsque enforceAvailableModels est également défini, un modèle par défaut de l'organisation en dehors de la liste d'autorisation est remappé à la première entrée de la liste d'autorisation, comme tout autre modèle Par défaut
• un modèle par défaut de l'organisation que les restrictions de modèle de l'organisation refusent pour votre compte est remplacé par le modèle le plus récent autorisé dans sa famille, ou une famille moins coûteuse lorsque chaque version de celle-ci est restreinte
• un modèle par défaut de l'organisation qui n'est pas disponible pour votre compte du tout est ignoré, et l'option Par défaut se résout comme elle le ferait sans modèle par défaut de l'organisation

À partir de la v2.1.199, lorsque le modèle par défaut de l'organisation est une famille de modèles différente du modèle par défaut habituel du type de votre compte, le sélecteur /model conserve une ligne séparée pour cette famille habituelle, de sorte que vous pouvez toujours basculer vers celle-ci pour une session. Dans les versions v2.1.196 à v2.1.198, cette ligne est absente du sélecteur.

Le modèle par défaut de l'organisation ne s'applique qu'aux sessions authentifiées avec l'API Anthropic. Pour définir un modèle par défaut ailleurs, y compris dans les déploiements de passerelle LLM, utilisez plutôt la clé model dans les paramètres gérés.

Limites d'effort au niveau de l'organisation

Votre organisation peut plafonner le niveau d'effort de deux façons. Sur un plan Claude Enterprise, les administrateurs d'organisation définissent des limites d'effort par rôle, décrites ci-dessous. Sur n'importe quel plan et n'importe quel fournisseur, y compris Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, le paramètre géré maxEffortLevel plafonne l'effort côté client. Lorsque les deux s'appliquent à un modèle, le plafond inférieur s'applique.

Les administrateurs d'organisation sur les plans Claude Enterprise peuvent définir un niveau d'effort maximum par modèle pour chaque rôle personnalisé, aux côtés des restrictions de modèle au niveau de l'organisation. Les niveaux au-dessus du plafond ne sont pas proposés dans le sélecteur /effort, et nommer un niveau supérieur avec --effort ou /effort s'exécute au plafond à la place. Dans les sessions interactives et les exécutions en texte brut --print, un avertissement nomme les niveaux demandés et appliqués ; avec une sortie json ou stream-json ou dans les agents en arrière-plan, le plafonnement s'applique silencieusement. Les plafonds sont par modèle, donc changer de modèle peut modifier les niveaux disponibles. Lorsque plusieurs de vos rôles accordent le même modèle, le plafond le moins restrictif s'applique. Nécessite Claude Code v2.1.195 ou version ultérieure.

Les limites d'effort sont livrées avec les restrictions de modèle au niveau de l'organisation et atteignent les mêmes sessions.

Comportement spécial des modèles

Paramètre de modèle `default`

Le comportement de default dépend de votre type de compte :

• Max, Team Premium, Enterprise et API Anthropic : par défaut Opus 5
• Claude Platform sur AWS, Amazon Bedrock et Agent Platform de Google Cloud : par défaut Opus 5
• Pro et Team Standard : par défaut Sonnet 5
• Microsoft Foundry : par défaut Sonnet 4.5

Avant la v2.1.219, default se résolvait en Opus 4.8 sur l'API Anthropic, Max, Team Premium et Enterprise avec paiement à l'usage à partir de la v2.1.154, et sur Claude Platform sur AWS, Amazon Bedrock et Agent Platform de Google Cloud à partir de la v2.1.207. Avant la v2.1.207, default se résolvait en Opus 4.7 sur Claude Platform sur AWS et en Sonnet 4.5 sur Amazon Bedrock et Agent Platform de Google Cloud.

Quand un administrateur a défini un modèle par défaut de l'organisation, default se résout en ce modèle au lieu du modèle par défaut du type de compte ci-dessus. Nécessite Claude Code v2.1.196 ou ultérieure. default peut également se résoudre en le modèle que vous avez défini avec ANTHROPIC_DEFAULT_MODEL, selon les conditions énumérées dans sa section.

Quand les paramètres gérés appliquent la liste d'autorisation pour le modèle par défaut et que le modèle par défaut du type de compte ne figure pas dans availableModels, default se résout en Default appliqué au lieu du modèle par défaut du type de compte ci-dessus. Quand les deux s'appliquent, le modèle par défaut de l'organisation remplace d'abord le modèle par défaut du type de compte, puis l'application s'y applique : un modèle par défaut de l'organisation autorisé est conservé, tandis qu'un modèle en dehors de la liste se résout en Default appliqué.

Les modèles Fable ne sont le modèle par défaut du type de compte sur aucun plan ou fournisseur. En choisir un avec /model l'enregistre comme modèle sélectionné dans vos paramètres utilisateur, de sorte que les sessions ultérieures commencent dessus. Pour le changement unique que Claude Code apporte à une sélection Fable 5 enregistrée dans la v2.1.257, voir Travailler avec Fable.

Paramètre de modèle `opusplan`

L'alias de modèle opusplan fournit une approche hybride automatisée :

• En mode plan : utilise opus pour le raisonnement complexe et les décisions architecturales
• En mode exécution : bascule automatiquement vers sonnet pour la génération de code et l'implémentation

Cela associe le raisonnement d'Opus pour la planification à l'efficacité de Sonnet pour l'exécution.

La phase Opus en mode plan utilise la même fenêtre de contexte que le paramètre de modèle opus. Sur les niveaux d'abonnement où Opus est automatiquement mis à niveau vers un contexte de 1M, opusplan reçoit la mise à niveau en mode plan également. Pour forcer un contexte de 1M pour les deux phases quand vous n'êtes pas sur un niveau de mise à niveau automatique, définissez le modèle sur opusplan[1m], par exemple avec /model opusplan[1m]. Le définir avec /model nécessite Claude Code v2.1.265 ou ultérieure ; sur les versions antérieures, utilisez l'indicateur --model ou le paramètre model à la place.

Quand availableModels exclut le plus récent Opus mais permet une version antérieure, par exemple ["sonnet", "claude-opus-4-6"], opusplan utilise le plus récent Opus autorisé pour la planification et reste sur Sonnet uniquement quand chaque Opus est exclu. Une session Haiku qui se mettrait normalement à niveau vers Sonnet en mode plan utilise de même le plus récent Sonnet autorisé, et reste sur Haiku uniquement quand chaque Sonnet est exclu. Avant la v2.1.205, le mode plan restait sur le modèle de la session chaque fois que la version la plus récente de la famille de mise à niveau était exclue, même quand la liste d'autorisation permettait une version antérieure.

La substitution d'une version antérieure autorisée s'applique sur l'API Anthropic et Claude Platform sur AWS. Sur Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry et Mantle, dont les déploiements utilisent des ID de modèle spécifiques au fournisseur, le mode plan reste sur le modèle de la session chaque fois que le modèle de mise à niveau est exclu.

Pour une approche hybride où Claude décide au milieu d'une tâche quand consulter un deuxième modèle plutôt que de basculer à la limite du plan, voir l'outil advisor.

Chaînes de modèles de secours

Quand le modèle principal est surchargé, indisponible ou retourne une autre erreur serveur non renouvelable, Claude Code peut basculer vers un modèle de secours au lieu d'échouer la demande. Les erreurs d'authentification, de facturation, de limite de débit, de taille de demande et de transport, et un refus par la vérification de politique de votre organisation, ne déclenchent jamais un basculement ; ceux-ci suivent leur gestion normale des tentatives et des erreurs.

Configurez un ou plusieurs modèles de secours et Claude Code les essaie dans l'ordre, affichant un avis quand il bascule. Le basculement dure uniquement pour le tour actuel, de sorte que votre prochain message essaie d'abord le modèle principal à nouveau. Claude Code limite les chaînes à trois modèles après suppression des doublons et ignore les entrées supplémentaires.

Définissez une chaîne pour une session avec l'indicateur --fallback-model, qui accepte une liste séparée par des virgules :

claude --fallback-model sonnet,haiku

Pour persister une chaîne entre les sessions, définissez fallbackModel dans paramètres comme un tableau :

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

L'indicateur --fallback-model a la priorité sur le paramètre fallbackModel. Chaque entrée accepte un nom de modèle ou un alias, et "default" se développe en le modèle par défaut.

Claude Code ne confirme pas la chaîne au démarrage et /status ne l'affiche pas. L'avis affiché quand un basculement se produit est le premier signe visible qu'un secours est configuré.

Quand une demande bascule, Claude Code essaie chaque entrée dans l'ordre jusqu'à ce que l'une l'accepte. Une entrée qui ne peut pas être atteinte non plus, comme un modèle retiré épinglé dans les paramètres, bascule vers la suivante de la même manière. Claude Code supprime deux types d'entrée avant cette traversée :

• En dehors de la liste d'autorisation : Claude Code supprime toute entrée non autorisée par availableModels quand il lit la chaîne.
• Fenêtre de contexte plus petite lors de la compaction : la chaîne couvre également la compaction, mais Claude Code ne basculera pas vers un modèle avec une fenêtre de contexte plus petite que celle du modèle principal, car résumer là couperait d'abord une partie de la conversation. Si chaque secours est plus petit, la compaction affiche l'erreur d'origine et vous pouvez réessayer.

Claude Code applique également la chaîne aux sous-agents. Quand la demande d'un sous-agent bascule, Claude Code essaie vos modèles de secours configurés dans l'ordre, et le sous-agent continue sur le modèle qui accepte la demande. Le modèle de votre session reste inchangé. Avant la v2.1.247, un échec que la chaîne couvre terminait le sous-agent à la place.

Secours automatique du modèle

Cette section couvre le secours basé sur le contenu des modèles Fable et Opus 5. Pour le secours basé sur la disponibilité quand un modèle est surchargé ou indisponible, voir Chaînes de modèles de secours.

Les modèles Fable et Opus 5 s'exécutent avec des classificateurs de sécurité, qui signalent le plus souvent le contenu de cybersécurité et de biologie. Quand un classificateur signale une demande et que la catégorie signalée a un modèle de secours, Claude Code réexécute la demande sur ce modèle et affiche un avis dans la transcription. Pour ces deux catégories, le modèle de secours dépend du modèle qui a refusé :

• Fable 5.1 et Fable 5 : les demandes signalées pour biologie se réexécutent sur Opus 5, et les demandes signalées pour cybersécurité se réexécutent sur Opus 4.8.
• Opus 5 : les demandes signalées pour cybersécurité se réexécutent sur Opus 4.8. Les demandes signalées pour biologie se terminent par un refus à la place, car Opus 5 exécute ses propres classificateurs de biologie sans modèle de secours.

Sur Amazon Bedrock, Agent Platform de Google Cloud et Microsoft Foundry, Claude Code résout ces cibles via votre déploiement à la place, et si vous définissez ANTHROPIC_DEFAULT_OPUS_MODEL, les catégories qui ont un secours se réexécutent sur le modèle épinglé ; voir Activer le secours sur Bedrock, Agent Platform et Foundry.

Après un secours, la session continue sur le modèle de secours. Pour revenir à votre modèle d'origine, exécutez /model.

Le secours basé sur les catégories nécessite Claude Code v2.1.219 ou ultérieure. Avant la v2.1.219, chaque demande Fable 5 signalée se réexécutait sur le modèle Opus par défaut de votre fournisseur, et Opus 5 n'était pas une source de secours.

Le modèle de secours est vérifié par rapport à availableModels. Quand il est bloqué, aucun secours ne se produit. Le refus est affiché comme une erreur normale et le modèle de la session reste inchangé.

Vérifier ce qui a déclenché le secours

Le secours peut se déclencher à la première demande d'une session, avant que vous n'envoyiez quelque chose d'inhabituel, car la première demande porte le contexte de l'espace de travail comme votre contenu CLAUDE.md et l'état git. Un référentiel qui contient du matériel de sécurité ou de biologie peut déclencher le classificateur sur ce contexte seul.

Pour vérifier si les personnalisations sont le déclencheur, démarrez une session avec claude --safe-mode, qui désactive les personnalisations comme CLAUDE.md, les skills, les serveurs MCP et les hooks. L'état git et les noms de répertoires ne sont pas des personnalisations et sont toujours inclus.

Demander avant de basculer

Pour décider ce qui se passe chaque fois qu'une demande est signalée, plutôt que de basculer automatiquement, exécutez /config et désactivez Basculer les modèles quand un message est signalé, ou définissez switchModelsOnFlag sur false dans votre fichier de paramètres. Une demande signalée met alors la session en pause avec deux options : basculer vers le modèle de secours, ou modifier l'invite et réessayer sur le modèle actuel.

Certains cas se comportent différemment :

• Quand la catégorie signalée n'a pas de modèle de secours, comme un signal de biologie sur Opus 5, Claude Code n'affiche pas l'invite et la demande se termine par le refus.
• Si les deux modèles signalent la même demande, vous pouvez modifier l'invite et réessayer, ou démarrer une nouvelle session.
• Sur les sessions mobiles Claude Code sur le web, la modification et la nouvelle tentative ne sont pas prises en charge. Basculez les modèles, ou continuez la session à partir d'un navigateur de bureau ou de l'application de bureau.
• En mode non interactif et les intégrations SDK qui ne peuvent pas afficher l'invite, une demande signalée termine le tour par un refus à la place.
• Quand la cible de secours est bloquée par availableModels, Claude Code n'affiche pas l'invite. La demande signalée se termine par le refus, de la même manière que le secours automatique quand la cible est bloquée.

Activer le secours sur Bedrock, Agent Platform et Foundry

Sur Amazon Bedrock, Agent Platform de Google Cloud et Microsoft Foundry, les ID de modèle sont spécifiques au fournisseur, de sorte que le secours automatique ne fonctionne que quand Claude Code peut identifier les deux modèles impliqués :

• Claude Code doit reconnaître le modèle actuel comme une source de secours. Fable 5.1 et Fable 5 sont reconnus quand l'ID de modèle contient claude-fable-5, correspond à la valeur de ANTHROPIC_DEFAULT_FABLE_MODEL, ou est mappé avec modelOverrides. Opus 5 est reconnu par son ID de modèle du fournisseur ou un mappage modelOverrides.
• Le modèle de secours doit se résoudre dans votre déploiement. Si vous définissez ANTHROPIC_DEFAULT_OPUS_MODEL, les demandes signalées se réexécutent sur ce modèle pour chaque catégorie qui a un secours ; un signal de biologie sur Opus 5 se termine toujours par un refus. Si vous ne le définissez pas, les demandes signalées pour cybersécurité se réexécutent sur une entrée Opus 4.8 dans la liste des modèles du fournisseur, et les demandes signalées pour biologie d'un modèle Fable sur une entrée Opus 5.

Si l'un ou l'autre modèle ne peut pas être identifié, Claude Code ne bascule pas automatiquement. La demande signalée se termine par un message de refus, et vous pouvez basculer les modèles avec /model et réessayer. Définir ANTHROPIC_DEFAULT_FABLE_MODEL sur votre ID de modèle Fable active la reconnaissance Fable. Définir ANTHROPIC_DEFAULT_OPUS_MODEL sur un ID de modèle Opus donne aux catégories signalées une cible de secours, sauf si l'épingle nomme un modèle en dehors de la famille Opus ou le modèle qui a refusé ; alors Claude Code ne bascule pas et le refus tient.

Recherche en sécurité et charges de travail en biologie

Les charges de travail en sécurité offensive ou en biologie, y compris les tests de pénétration, les exercices Capture the Flag (CTF) et les bases de code adjacentes à la biologie, déclenchent fréquemment le secours, souvent à la première demande. Pour un travail substantiel en biologie sur Fable 5.1 ou Fable 5, Claude Code déplace la session vers Opus 5 à la première demande signalée, et les demandes signalées pour biologie ultérieures se terminent par des refus là, car Opus 5 n'a pas de secours pour la biologie. Sur Opus 5, vous obtenez ces refus à partir de la première demande signalée.

C'est un routage attendu pour ces domaines, pas un signal de compte. Si votre organisation a besoin de la capacité de classe Fable pour ce travail, demandez à votre équipe de compte Anthropic les programmes d'accès de confiance.

Ajuster le niveau d'effort

Les niveaux d'effort contrôlent le raisonnement adaptatif, qui permet au modèle de décider si et combien penser à chaque étape en fonction de la complexité de la tâche. Un effort inférieur est plus rapide et moins cher pour les tâches simples, tandis qu'un effort supérieur fournit un raisonnement plus profond pour les problèmes complexes.

Les niveaux d'effort disponibles dépendent du modèle. Les modèles non énumérés ici ne supportent pas l'effort :

Si vous définissez un niveau que le modèle actif ne supporte pas, Claude Code revient au niveau le plus élevé supporté au niveau ou en dessous de celui que vous avez défini. Par exemple, xhigh s'exécute comme high sur Opus 4.6. Votre organisation ou vos propres paramètres peuvent également limiter les niveaux qu'un modèle offre ; voir Limites d'effort de l'organisation.

Avec le paramètre ultracode désactivé, Claude Code résout le niveau d'effort de la session dans cet ordre, en prenant le premier qui s'applique :

1. Un choix explicite : la variable d'environnement CLAUDE_CODE_EFFORT_LEVEL, le lancement avec --effort, ou /effort dans la session (un /effort non interactif a un effet plus étroit)
2. L'effort par défaut du modèle, sur Fable 5, Opus 4.8 ou Opus 4.7 : à partir de la première fois que vous exécutez l'un de ces modèles, Claude Code maintient l'effort par défaut de ce modèle entre les sessions, même quand vos paramètres résolvent un niveau différent. Opus 5 et Fable 5.1 n'ont pas une telle retenue. Que un niveau que vous avez défini termine la retenue dépend de comment vous l'avez défini, par exemple :
   • Termine la retenue : confirmer un niveau de manière interactive, avec Entrée dans le curseur /effort ou le sélecteur /model ou avec un niveau tapé après /effort, ou choisir un niveau à partir du contrôle d'effort Contrôle à distance d'un appareil connecté
   • Laisse la retenue en place pour les sessions ultérieures : --effort au lancement, ou s dans le curseur /effort ou le sélecteur /model
3. Vos paramètres : le niveau que vous avez enregistré pour le modèle ou une clé effortLevel, avec la priorité entre eux et entre les fichiers de paramètres énoncée à modelSettings
4. L'effort par défaut du modèle : high sur chaque modèle qui supporte l'effort, sauf qu'Opus 4.7 par défaut à xhigh et, quand votre organisation définit un niveau d'effort par défaut pour son modèle par défaut de l'organisation, ce niveau est le défaut quand vous exécutez ce modèle

Quand vous définissez low, medium, high ou xhigh dans une session interactive sur votre machine, vous choisissez combien de temps cela dure en comment vous le confirmez :

• Entrée dans le curseur /effort ou le sélecteur /model, ou un niveau tapé après /effort : enregistrez le niveau comme votre défaut et appliquez-le dans les sessions ultérieures
• s dans le curseur /effort ou le sélecteur /model : appliquez le niveau à cette session uniquement. Nécessite Claude Code v2.1.257 ou ultérieure

Claude Code enregistre le niveau par modèle, sous la clé modelSettings dans vos paramètres utilisateur, de sorte que chaque modèle conserve son propre niveau enregistré.

max est le niveau de raisonnement le plus profond. À moins que vous ne le définissiez via la variable d'environnement CLAUDE_CODE_EFFORT_LEVEL, Claude Code applique max à la session actuelle uniquement.

# Utilisez l'alias opus[1m] ou sonnet[1m]
/model opus[1m]
/model sonnet[1m]

# Ou ajoutez [1m] à un nom de modèle complet
/model claude-opus-4-8[1m]

export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-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"
  }
}