· 8 Min. · Entwicklerleitfäden

So ändern Sie das Standardmodell in Claude Code (und die neuen Modellwechsel-Hooks in 2.1.251)

So ändern Sie das Standardmodell in Claude Code (und die neuen Modellwechsel-Hooks in 2.1.251)

Das Ändern Ihres Claude Code-Standardmodells beginnt mit der Frage, ob eine Auswahl auch für neue Sitzungen gelten oder nur auf die aktuelle Sitzung angewendet werden soll. Dieser Leitfaden erläutert /model die dauerhafte Speicherung, die zum Redaktionsschluss noch nicht verifizierten Konfigurationsdetails sowie die in Claude Code 2.1.251 eingeführten Hooks für Modellwechsel und Cache-Diagnosen.

Ihr Claude Code-Standardmodell mit /model festlegen

Der entscheidende Unterschied liegt zwischen dem Speichern einer Präferenz und einem vorübergehenden Modellwechsel. Bis zum 29. August 2026 unterstützte /model bereits beide Abläufe.

Version 2.1.153 änderte /model so, dass eine Auswahl als Standard für neue Sitzungen gespeichert wird. Dieses Verhalten gab es bereits vor 2.1.251: Die August-Veröffentlichung führte Hooks für Modellwechsel ein, nicht die Möglichkeit, eine interaktive Modellauswahl zu speichern.

Das auf eine bestimmte Version festgelegte Änderungsprotokoll ist die historische Referenz für diese Unterscheidung. Es dokumentiert sowohl die dauerhafte Speicherung der Auswahl als auch die Aktion in der Modellauswahl für einen vorübergehenden Wechsel.

Eine Präferenz für zukünftige Sitzungen speichern

Verwenden Sie die Modellauswahl:

/model

Wählen Sie das Modell aus, das Sie als Standard verwenden möchten. Das in 2.1.153 eingeführte Speicherverhalten bedeutet, dass diese Auswahl für neue Sitzungen gespeichert wird.

Dies ist die eindeutigste historisch belegte Antwort auf die Frage „Wie speichere ich mein bevorzugtes Modell dauerhaft?“. Dafür muss eine in einer früheren Version eingeführte Funktion nicht als neue Fähigkeit von 2.1.251 dargestellt werden.

Nur für die aktuelle Sitzung wechseln

Drücken Sie s in der Modellauswahl, um das Modell nur für die aktuelle Sitzung zu wechseln. Verwenden Sie diese Aktion, wenn die Auswahl vorübergehend sein soll.

Diese Unterscheidung ist wichtig, wenn Sie älteren Anleitungen folgen oder benutzerdefinierte Tastenkombinationen pflegen. Die bisherige Aktion d in der Modellauswahl wurde zu s, und die zugehörige benutzerdefinierte Tastenbelegung änderte sich von modelPicker:setAsDefault zu modelPicker:thisSessionOnly.

Weitere Informationen zur Modellauswahl finden Sie im Leitfaden zu Claude Code-Modellen. Der versionsspezifische Punkt ist einfach: Eine gewöhnliche Auswahl speichert einen Standard, während die Aktion nur für die aktuelle Sitzung einen vorübergehenden Wechsel ermöglicht.

Konfigurationsdateien, ANTHROPIC_MODEL und Überschreibungen beim Start

Die Modellkonfiguration ist auch über Einstellungsdateien, Umgebungsvariablen und Startflags möglich. Die bereitgestellte Recherche zeigt jedoch eine historische Einschränkung auf: Ihre genaue Dokumentation und Rangfolge wurden nicht unabhängig anhand eines bis zum 29. August 2026 verfügbaren Stands verifiziert.

Das Dokumentation zur Modellkonfiguration und Dokumentation zu den Einstellungen beschreiben diese Wege, doch diese Seiten enthalten spätere Aktualisierungen. Sie können nicht jedes Detail des Verhaltens zum Redaktionsschluss dieses Artikels belegen.

Die folgende Tabelle trennt die dokumentierten Optionen von dem, was die datierten Belege stützen.

Konfigurationsweg Detail aus der bereitgestellten Recherche Historischer Belegstatus für diesen Artikel
Interaktive /model Auswahl Speichert einen Standard für neue Sitzungen Im Änderungsprotokoll vor Redaktionsschluss bestätigt
Aktion in der Modellauswahl s Wechselt nur für die aktuelle Sitzung Im Änderungsprotokoll vor Redaktionsschluss bestätigt
Einstellungsdatei model Schlüssel Eine dauerhaft gespeicherte Konfigurationsoption Genaue Dokumentation vor Redaktionsschluss nicht verifiziert
ANTHROPIC_MODEL Eine Option zur Modellauswahl über die Umgebung Genaue Dokumentation vor Redaktionsschluss nicht verifiziert
Start --model Flag Eine Modellauswahl beim Start Genaue Rangfolge vor Redaktionsschluss nicht verifiziert

Welche Einstellung hat Vorrang?

Die bereitgestellte Recherche verweist auf eine Dokumentation, die das Startflag über ANTHROPIC_MODELeinordnet und die Umgebungsvariable über dem Wert aus der Einstellungsdatei für model . Sie kennzeichnet diese Reihenfolge außerdem ausdrücklich als zum Redaktionsschluss nicht verifiziert.

Daher stellt dieser Artikel diese Rangfolge nicht als gesicherte Tatsache für August 29 dar. Die /model Änderung zur dauerhaften Speicherung ist durch einen datierten Eintrag im Änderungsprotokoll belegt; die genaue Konfigurationshierarchie ist es nicht.

Wie sieht es mit einem Standard für ein einzelnes Projekt aus?

Die Recherche nennt Einstellungsdateien für Nutzer, Projekte und persönliche Projekteinstellungen in der Dokumentation. Sie belegt jedoch weder deren genauen historischen Wortlaut noch das Verhalten der Modelleinstellung anhand eines Stands vor Redaktionsschluss.

Damit fällt die Antwort enger aus als eine Anleitung zur Projektkonfiguration: /model Die dauerhafte Speicherung ist bestätigt, während projektspezifische Dateianweisungen eine historische Verifizierung erfordern. Die CLI-Referenz bietet eine hilfreiche Ergänzung zur Konfiguration über die Befehlszeile, hebt aber die Grenzen der Beleglage dieses Artikels nicht auf.

Was die Hooks für Modellwechsel in 2.1.251 hinzufügen

Claude Code 2.1.251 wurde am 28. August 2026 veröffentlicht. Die offiziellen Versionshinweise führen zwei Hooks mit exakt diesen Namen ein:

  • PreModelSwitch
  • PostModelSwitch

Die Veröffentlichung beschreibt ihre Fähigkeiten als Blockieren, Bestätigen oder Kommentieren eines Modellwechsels. Diese Hooks erweitern den Ablauf der Modellauswahl um Steuerungsmöglichkeiten rund um den Wechsel.

Dies ist die neue Funktion, die von der dauerhaften Speicherung des Standards zu unterscheiden ist. Das Speichern einer Modellpräferenz war bereits verfügbar; die neuen Hook-Ereignisse bieten Möglichkeiten, in einen Modellwechsel einzugreifen.

Kann ein Hook einen Wechsel blockieren oder eine Bestätigung anfordern?

Ja, Blockieren und Bestätigung sind Fähigkeiten, die in der Veröffentlichungsankündigung ausdrücklich genannt werden. Auch das Kommentieren wird aufgeführt.

Die Ankündigung enthält weder die vollständigen Eingabe- und Ausgabeschemas noch die Matcher-Regeln oder die Entscheidungs-JSON. Sie erlaubt daher eine Beschreibung dieser Fähigkeiten, rechtfertigt aber nicht die Veröffentlichung einer ausführbaren Konfiguration allein auf Grundlage der Ankündigung.

Dieselbe Einschränkung gilt für Details wie die Frage, welche Payload-Felder das alte und das neue Modell identifizieren oder wie eine Bestätigungsantwort aufgebaut sein muss. Diese Details fehlen in den bereitgestellten Belegen aus der Zeit vor Redaktionsschluss.

Was ist vor der Implementierung erforderlich?

Eine funktionierende Implementierung benötigt mehr als die Ereignisnamen: Sie braucht das geltende Konfigurationsformat und die unterstützte Spezifikation für Antworten. Die Versionshinweise liefern diese Bestandteile nicht.

Verwenden Sie den Leitfaden zu Claude Code-Hooks für weitere Informationen zu Hooks. Beschränken Sie sich für diese Version genau auf den bestätigten Umfang: PreModelSwitch und PostModelSwitch existieren, und die Ankündigung beschreibt Fähigkeiten zum Blockieren, Bestätigen und Kommentieren.

Prompt-Cache-Verhalten und Kosten beim Fortsetzen prüfen

Version 2.1.251 ergänzt außerdem Diagnosen, die das Prompt-Cache-Verhalten verständlicher machen. Diese Ergänzungen machen Cache-Aktivität und geschätzte Wiederaufbaukosten sichtbar; die Veröffentlichung kündigt keine neuen Tokenpreise oder numerischen Cache-Limits an.

Die neue Cache-Zeile in /cost lesen

Der bestehende Befehl erhält eine Prompt-Cache-Zeile pro Sitzung:

/cost

Diese Zeile zeigt vier Angaben:

  • Trefferquote
  • Cache-Fehlzugriffe
  • Erneut zwischengespeicherte Tokens
  • Warmer oder kalter Zustand

Zusammen bieten diese Angaben einen detaillierteren Einblick in den Cache als eine Kostenangabe allein. Sie unterscheiden Cache-Treffer von Fehlzugriffen und zeigen, wie viele Tokens erneut zwischengespeichert wurden.

Skripte für die Statuszeile erhalten außerdem ein entsprechendes prompt_cache Objekt. Dadurch sind Cache-Diagnosen sowohl über die Statuszeilen-Schnittstelle als auch über /cost.

verfügbar. Die Ankündigung enthält kein vollständiges Schema für dieses Objekt. Betrachten Sie prompt_cache als bestätigten Objektnamen, ohne zusätzliche Felder über die in der Veröffentlichung beschriebenen Diagnoseangaben hinaus anzunehmen.

Informationen zur Wiederaufnahme über SessionStart prüfen

Bei der Wiederaufnahme SessionStart erhalten Hooks jetzt Informationen zur Aktualität der Sitzung und zu den geschätzten Kosten für den Neuaufbau des Prompt-Caches.

Dies unterscheidet sich von der /cost Anzeige: Die Ergänzung zur Wiederaufnahme liefert Hooks Informationen, während der Befehl Cache-Diagnosen pro Sitzung meldet. Beide Ergänzungen betreffen die Einsehbarkeit des Caches, stellen diese Informationen aber über unterschiedliche Schnittstellen bereit.

Die Versionshinweise nennen die genauen Namen der Payload-Schlüssel für die Aktualität der Sitzung oder die geschätzten Kosten des Neuaufbaus nicht. Ein Hook-Beispiel, das diese Namen voraussetzt, würde über die verfügbaren Belege hinausgehen.

Weitere Änderungen an Modellstandards und Diagnosen

Mehrere damit zusammenhängende Änderungen in 2.1.251 sind für die Interpretation eines „Standardmodells“ relevant. Sie betreffen Subagenten, Kontostandards, Präferenzen für den Denkaufwand und die Einsehbarkeit der Gateway-Ausgaben.

Priorität bei der Modellauswahl für Subagenten

CLAUDE_CODE_SUBAGENT_MODEL liefert jetzt einen Standardwert. Der in einer Agentendefinition angegebene model: Wert und ein beim Starten eines Agenten ausdrücklich ausgewähltes Modell haben Vorrang vor dieser Variablen.

Dies ist eine bestätigte Änderung der Priorität im mit einem Tag versehenen Änderungsprotokoll. Sie sollte getrennt von der unbestätigten historischen Rangfolge des Startparameters, der Umgebungsvariablen und des Werts in der Einstellungsdatei für das Hauptmodell betrachtet werden.

Berücksichtigen Sie bei der Prüfung der Modellauswahl eines Subagenten diese ausdrücklichen Festlegungen, bevor Sie die Umgebungsvariable als ausschlaggebend betrachten. Die Leitfaden zu Subagenten bietet umfassenderen Kontext zur Agentenkonfiguration.

Kontostandards und Präferenzen für den Denkaufwand

Enterprise-Abonnements mit nutzerbasierter Lizenzierung verwenden jetzt standardmäßig Opus 5, ebenso wie andere Premium-Tarife.

Diese Änderung auf Kontoebene ist von einer Modellpräferenz zu unterscheiden, die über /modelgespeichert wird. Die Version ändert außerdem die /effort Speicherung: Für jedes Modell wird jetzt ein eigener Standardwert für den Denkaufwand gespeichert.

Der praktische Unterschied besteht darin, dass Modellauswahl und Speicherung des Denkaufwands separate Einstellungen sind. Das neue Verhalten merkt sich für jedes Modell einen Standardwert für den Denkaufwand, statt einen gemeinsamen Standardwert vorzusehen.

Einsehbarkeit der Gateway-Ausgaben

Das /usage Befehl erhält eine Ausgabenlimit Leiste für Entwickler, die ein Claude-Apps-Gateway mit Ausgabenlimits verwenden:

/usage

Statuszeilenskripte erhalten das entsprechende rate_limits.spend_limit Feld. Dies ist eine Ergänzung der Diagnosefunktionen für diesen Gateway-Kontext.

Das Änderungsprotokoll kündigt keine allgemeingültige Dollar-Obergrenze an. Die Anzeige eines Ausgabenlimits sollte daher nicht als festes Limit verstanden werden, das für alle Claude Code-Nutzer gilt.

Wichtige Erkenntnisse

  • /model speicherte bereits vor 2.1.251 einen Standardwert für neue Sitzungen; dieses Verhalten besteht seit 2.1.153.
  • Drücken Sie s in der Modellauswahl, um nur für die aktuelle Sitzung zu wechseln. Benutzerdefinierte Tastenbelegungen verwenden modelPicker:thisSessionOnly.
  • Claude Code 2.1.251 ergänzt PreModelSwitch und PostModelSwitch, mit den in den Versionshinweisen beschriebenen Möglichkeiten zum Blockieren, Bestätigen und Annotieren.
  • /cost, Cache-Daten in der Statuszeile und bei der Wiederaufnahme bereitgestellte SessionStart Informationen machen die Aktivitäten des Prompt-Caches und die geschätzten Kosten des Neuaufbaus sichtbar.
  • CLAUDE_CODE_SUBAGENT_MODEL liefert einen Standardwert, den ausdrückliche Modellfestlegungen für Agenten überschreiben können. Die genaue historische Priorität der Hauptmodellkonfiguration bleibt in der bereitgestellten Recherche unbestätigt.

FAQ

Speichert /model das Standardmodell in Claude Code?

Ja. Version 2.1.153 änderte /model so, dass eine Auswahl als Standard für neue Sitzungen gespeichert wird; dieses Verhalten war bereits vor 2.1.251 vorhanden. Drücken Sie s in der Auswahl, wenn Sie nur für die aktuelle Sitzung wechseln möchten.

Was hat Vorrang: settings.json, ANTHROPIC_MODEL oder --model?

Die bereitgestellte Recherche verweist auf eine Dokumentation, die den Startparameter über ANTHROPIC_MODELund diese Variable über den Modellwert in der Einstellungsdatei einordnet. Die genaue Rangfolge wurde jedoch nicht unabhängig anhand eines Snapshots aus der Zeit vor August 29, 2026 überprüft. Daher belegt dieser Artikel sie nicht als Verhalten zu diesem Stichtag.

Kann ein Hook für Modellwechsel in Claude Code einen Wechsel blockieren?

Die Version 2.1.251 beschreibt PreModelSwitch und PostModelSwitch als Hooks, die das Blockieren, Bestätigen und Annotieren von Modellwechseln unterstützen. Sie liefert keine vollständigen Schemata oder Entscheidungs-JSON, sodass die Ankündigung allein für eine ausführbare Hook-Implementierung nicht ausreicht.

Wo kann ich Cache-Misses und geschätzte Kosten für den Neuaufbau sehen?

In 2.1.251 /cost meldet der Befehl pro Sitzung die Cache-Trefferrate, Cache-Misses, erneut zwischengespeicherte Tokens sowie den warmen oder kalten Zustand; Statuszeilenskripte erhalten ein entsprechendes prompt_cache Objekt. Unabhängig davon erhalten SessionStart Hooks bei der Wiederaufnahme Informationen zur Aktualität der Sitzung und zu den geschätzten Kosten für den Neuaufbau des Prompt-Caches, wobei die Versionshinweise die Namen dieser Payload-Schlüssel nicht angeben.

A

AI Prime Tech veröffentlicht diesen Blog. Die Artikel werden mit KI-Unterstützung verfasst; prüfen Sie versionsspezifische Angaben wie Modell-IDs, Preise und Limits anhand der offiziellen Dokumentation, bevor Sie sich darauf verlassen.

Günstigeren Zugang zur Claude API erhalten

Ein API-Schlüssel für Claude Opus 5.5, Sonnet 5, Haiku 4.5 und Fable 5.1 sowie GPT-6 Modelle. Nutzungsbasierte Abrechnung, kein Abonnement.

API-Schlüssel erhalten →
AI Prime Tech ist ein unabhängiges API-Gateway eines Drittanbieters. Claude™ und Anthropic® sind Marken von Anthropic, PBC. Eine Verbindung oder Unterstützung wird nicht impliziert.