Source: https://aiprimetech.io/ja/blog/claude-code-default-model-and-model-switch-hooks/ 2026年8月29日 · 8分 · 開発者ガイド # Claude Codeのデフォルトモデルを変更する方法（2.1.251の新しいモデル切り替えフックも紹介） A 著者 [AI Prime Tech](https://aiprimetech.io/ja/) · AI支援による執筆 自分の Claude Codeのデフォルトモデル を変更するには、まず、選択を新しいセッションにも引き継ぐのか、現在のセッションだけに適用するのかを理解する必要があります。このガイドでは、 /model の永続化、公開時点では未検証の設定の詳細、Claude Code 2.1.251で導入されたモデル切り替えフックとキャッシュ診断について説明します。 ## /modelでClaude Codeのデフォルトモデルを設定する 重要なのは、設定を保存することと、一時的にモデルを切り替えることの違いです。2026年の8月29日までに、 /model はすでに両方のワークフローに対応していました。 バージョン2.1.153では、 /model が変更され、選択したモデルが新しいセッションのデフォルトとして保存されるようになりました。この動作は2.1.251より前から存在していました。8月のリリースで導入されたのはモデル切り替えフックであり、対話的に選択したモデルを記憶する機能ではありません。 この [バージョンを固定した変更履歴](https://raw.githubusercontent.com/anthropics/claude-code/v2.1.251/CHANGELOG.md) が、この違いを確認するための過去の参照資料です。選択を永続化する動作と、一時的に切り替えるためのピッカー操作の両方が記録されています。 ### 今後のセッション用に設定を保存する モデルピッカーを使用します。 ``` /model ``` デフォルトにしたいモデルを選択します。2.1.153で導入された永続化の動作により、この選択は新しいセッション用に保存されます。 これは、「希望するモデルを継続して使うにはどうすればよいですか？」という問いに対する、過去の資料で裏付けられた最も明確な回答です。以前のリリースで導入された機能を、2.1.251の新機能として扱う必要はありません。 ### 現在のセッションだけで切り替える 押すキーは s です。ピッカー内でこのキーを押すと、現在のセッションだけでモデルを切り替えられます。選択を一時的なものにしたい場合は、この操作を使用してください。 この違いは、古い手順に従う場合や、カスタムキーボードショートカットを管理する場合に重要です。ピッカーの以前の d 操作は、次の操作に変更されました。 s。また、関連するカスタムキーバインドの変更前の値は modelPicker:setAsDefault で、変更後の値は modelPicker:thisSessionOnly. モデル選択についてのより幅広い情報は、 [Claude Codeモデルガイド](/ja/claude-code/models/)を参照してください。このリリースに関する要点は明確です。通常の選択ではデフォルトが保存され、セッション限定の操作では一時的に切り替わります。 ## 設定ファイル、ANTHROPIC_MODEL、起動時のオーバーライド モデルの設定には、設定ファイル、環境変数、起動フラグを使う方法もあります。ただし、提供された調査には、過去の情報に関する制約が示されています。2026年8月29日までに利用可能だったスナップショットでは、これらの正確なドキュメントと優先順位が独立して検証されていません。 この [モデル設定のドキュメント](https://code.claude.com/docs/en/model-config) と [設定のドキュメント](https://code.claude.com/docs/en/settings) ではこれらの方法が説明されていますが、そのページには後日更新された内容が含まれています。そのため、この記事の基準日時点の動作を細部まで裏付けることはできません。 次の表では、ドキュメントに記載された選択肢と、日付のある証拠で裏付けられる内容を区別しています。 | 設定方法 | 提供された調査の詳細 | この記事における過去の情報の確認状況 | 対話的な /model 選択 | 新しいセッションのデフォルトを保存 | 基準日以前の変更履歴で確認済み | ピッカー操作 s | 現在のセッションだけで切り替え | 基準日以前の変更履歴で確認済み | 設定ファイルの model キー | 永続的な設定オプション | 基準日以前の正確なドキュメントは未検証 | ANTHROPIC_MODEL | 環境変数によるモデル選択オプション | 基準日以前の正確なドキュメントは未検証 | 起動 --model フラグ | 起動時のモデル選択 | 基準日以前の正確な優先順位は未検証 ### どの設定が優先されますか？ 提供された調査では、ドキュメント上、起動フラグの優先順位は次の設定より高いと報告されています。 ANTHROPIC_MODEL。また、環境変数は設定ファイルの model 値より優先されます。ただし、この順序が公開基準日時点では未検証であることも明記されています。 そのため、この記事では、この優先順位を29年8月時点で確立された事実として提示していません。 /model の永続化に関する変更には日付のある変更履歴の裏付けがありますが、正確な設定の優先順位にはありません。 ### 特定のプロジェクト用のデフォルトはどうですか？ 調査では、ドキュメントにユーザー設定ファイル、プロジェクト設定ファイル、個人用プロジェクト設定ファイルがあることを確認しています。ただし、基準日以前のスナップショットから、当時の正確な記述やモデル設定の動作を裏付けてはいません。 そのため、回答できる範囲はプロジェクト設定のチュートリアルよりも限定されます。 /model の永続化は確認されていますが、プロジェクト固有のファイルに関する手順には過去の情報の検証が必要です。 [CLIリファレンス](/ja/claude-code/cli/) はコマンドライン設定の有用な補足資料ですが、この記事が根拠にできる範囲を広げるものではありません。 ## 2.1.251でモデル切り替えフックが追加する機能 Claude Code 2.1.251は2026年8月28日にリリースされました。その [公式リリースノート](https://github.com/anthropics/claude-code/releases/tag/v2.1.251) では、正確な名前が次のとおりであるフックが導入されています。 - PreModelSwitch - PostModelSwitch リリースでは、これらの機能はモデル切り替えのブロック、確認、注釈付与であると説明されています。これらのフックは、切り替えに関する制御を追加して、モデル選択のワークフローを拡張します。 これが、デフォルトの永続化とは区別すべき新機能です。モデルの設定を保存することはすでに可能でした。新しいフックイベントは、モデル変更に関与する方法を追加します。 ### フックでブロックしたり、確認を求めたりできますか？ はい。ブロックと確認は、リリースの発表で明示された機能です。注釈付与も挙げられています。 発表には、完全な入出力スキーマ、マッチャールール、判断に関するJSONは記載されていません。そのため、これらの機能を説明する根拠にはなりますが、発表だけを基に実行可能な設定を公開する根拠にはなりません。 同じ制約は、変更前と変更後のモデルを識別するペイロードのフィールドや、確認レスポンスの構造といった詳細にも当てはまります。これらの詳細は、提供された基準日以前の証拠には含まれていません。 ### 実装前に何が必要ですか？ 動作する実装には、イベント名だけでなく、適用される設定形式と、サポートされるレスポンス仕様が必要です。リリースノートには、これらの情報が記載されていません。 参照する資料は [Claude Codeフックガイド](/ja/claude-code/hooks/) です。フック全般の情報を確認できます。このリリースについては、確認済みの範囲を正確に捉えてください。 PreModelSwitch と PostModelSwitch が存在し、発表ではブロック、確認、注釈付与の機能が説明されています。 ## プロンプトキャッシュの動作と再開コストを確認する バージョン2.1.251では、プロンプトキャッシュの動作を理解するのに役立つ診断機能も追加されています。これらの追加機能は、キャッシュの動作状況と推定再構築コストを表示します。このリリースでは、新しいトークン料金や数値で示されるキャッシュ上限は発表されていません。 ### /costの新しいキャッシュ行を確認する 既存のコマンドに、セッションごとのプロンプトキャッシュ行が追加されます。 ``` /cost ``` この行には、次の項目が表示されます。 - ヒット率 - ミス - 再キャッシュされたトークン - ウォームまたはコールドの状態 これらを組み合わせることで、コストの数値だけよりも詳しくキャッシュの状況を把握できます。キャッシュヒットとミスを区別し、再キャッシュされたトークン数を表示します。 ステータスラインスクリプトにも、対応する prompt_cache オブジェクトが追加されます。これにより、ステータスラインのインターフェースでもキャッシュ診断を利用できるようになり、次のコマンドからも確認できます。 /cost. 発表には、そのオブジェクトの完全なスキーマは記載されていません。 prompt_cache は確認済みのオブジェクト名として扱い、リリースで説明されている診断情報以外のフィールドがあるとは想定しないでください。 ### SessionStartで再開時の情報を確認する 再開時には、 SessionStart フックにセッションの経過状況と、プロンプトキャッシュの再構築にかかる推定コストが渡されるようになりました。 これは、次の表示とは異なります。 /cost 表示：再開時の追加機能はフックに情報を渡す一方、このコマンドはセッションごとのキャッシュ診断情報を報告します。どちらの追加機能もキャッシュの可視性に関わりますが、その情報を提供するインターフェースは異なります。 リリースノートには、セッションの経過状況や推定再構築コストに対応する正確なペイロードのキー名は記載されていません。それらの名前を仮定したフックの例は、確認できる根拠の範囲を超えてしまいます。 ## その他のモデルのデフォルト設定と診断機能の変更 「デフォルトモデル」を解釈する際には、2.1.251に含まれる関連する変更も重要です。これらはサブエージェント、アカウントのデフォルト設定、思考量の設定、ゲートウェイの支出の可視性に関わります。 ### サブエージェントのモデルの優先順位 CLAUDE_CODE_SUBAGENT_MODEL がデフォルト値を指定するようになりました。エージェント定義の model: の値と、エージェントの起動時に明示的に選択されたモデルは、その変数より優先されます。 これは、タグ付きの変更履歴で確認された優先順位の変更です。メインモデルの起動フラグ、環境変数、設定ファイルの値について、未検証の過去の優先順位とは区別する必要があります。 サブエージェントのモデル選択を調べる際は、環境変数が決定要因だと判断する前に、これらの明示的な選択を考慮してください。 [サブエージェントガイド](/ja/claude-code/subagents/) では、エージェント設定についてより広い背景情報を提供しています。 ### アカウントのデフォルト設定と思考量の設定 シートベースのEnterpriseサブスクリプションでは、他のプレミアムプランと同様に、Opus 5がデフォルトになりました。 このアカウントレベルの変更は、次の方法で保存されるモデル設定とは別です。 /model。このリリースでは、次の設定の保存方法も変更されています。 /effort 保存：モデルごとに個別のデフォルトの思考量が保存されるようになりました。 実用上の違いは、モデル選択と思考量の保存が別々の設定であることです。新しい思考量の動作では、共通の思考量のデフォルト値を設けるのではなく、モデルごとのデフォルト値を記憶します。 ### ゲートウェイの支出の可視性 この /usage コマンドに、次のバーが追加されます。 支出上限 支出上限を設定したClaudeアプリのゲートウェイを使用する開発者向けのバーです。 ``` /usage ``` ステータスラインスクリプトには、対応する次のフィールドが追加されます。 rate_limits.spend_limit フィールド。これは、そのゲートウェイ環境向けの診断機能の追加です。 変更履歴では、すべてのユーザーに共通するドル建ての上限は発表されていません。したがって、支出上限の表示があることを、すべてのClaude Codeユーザーに適用される固定上限があると解釈すべきではありません。 ## 重要なポイント - /model は、2.1.251より前から新しいセッションのデフォルトを保存していました。この動作は2.1.153から導入されています。 - 押すキーは s をモデル選択画面で押すと、現在のセッションだけでモデルを切り替えられます。カスタムキーバインドでは次を使用します。 modelPicker:thisSessionOnly. - Claude Code 2.1.251では、次が追加されます。 PreModelSwitch と PostModelSwitch。リリースでは、ブロック、確認、注釈の機能が説明されています。 - /cost、ステータスラインのキャッシュデータ、再開時の SessionStart 情報により、プロンプトキャッシュの動作と推定再構築コストを把握しやすくなります。 - CLAUDE_CODE_SUBAGENT_MODEL はデフォルト値を指定しますが、エージェントのモデルを明示的に選択すると、その値を上書きできます。提供された調査では、メインモデルの設定に関する正確な過去の優先順位は未検証です。 ## よくある質問 ### Claude Codeの/modelはデフォルトモデルを保存しますか？ はい。バージョン2.1.153で、次の動作が変更されました。 /model 選択したモデルが新しいセッションのデフォルトとして保存されるようになり、この動作は2.1.251より前から存在していました。次のキーを押してください。 s モデル選択画面で押すと、現在のセッションだけでモデルを切り替えられます。 ### settings.json、ANTHROPIC_MODEL、--modelのうち、どれが優先されますか？ 提供された調査によると、ドキュメントでは起動フラグが次の変数より優先されるとされています。 ANTHROPIC_MODEL、さらにその変数が設定ファイルのモデル値より優先されるとされています。ただし、29年の8月2026日より前のスナップショットでは正確な順序を独立して検証できていないため、この記事ではその基準日時点の動作として確定していません。 ### Claude Codeのモデル切り替えフックは変更をブロックできますか？ 2.1.251のリリースでは、次のフックについて説明されています。 PreModelSwitch と PostModelSwitch は、モデル切り替えのブロック、確認、注釈に対応するとされています。完全なスキーマや判定用のJSONは示されていないため、この発表だけでは実行可能なフックを実装するための情報が足りません。 ### キャッシュミスと推定再構築コストはどこで確認できますか？ 2.1.251では、 /cost がセッションごとのキャッシュヒット率、キャッシュミス、再キャッシュされたトークン数、ウォームまたはコールドの状態を報告します。ステータスラインスクリプトには、対応する次のオブジェクトが追加されます。 prompt_cache オブジェクト。また、 SessionStart フックには、再開時にセッションの経過状況とプロンプトキャッシュの推定再構築コストが渡されます。ただし、リリースノートにはそれらのペイロードのキー名は明記されていません。 [Claude](/ja/blog/tag/claude/)[コーディング](/ja/blog/tag/coding/)[モデル](/ja/blog/tag/models/) A [AI Prime Tech](https://aiprimetech.io/ja/) このブログはAI Prime Techが公開しています。記事の草稿はAIの支援を受けて作成されています。モデルID、料金、制限など、バージョンによって異なる詳細については、利用の判断に用いる前に公式ドキュメントで確認してください。 Claude APIをより低価格で利用 Claude Opus 5.5、Sonnet 5、Haiku 4.5、Fable 5.1に加え、GPT-6のモデルを、単一のAPIキーで利用できます。従量課金制で、サブスクリプションは不要です。 [APIキーを取得 →](/register) AI Prime Techは独立したサードパーティのAPIゲートウェイです。Claude™およびAnthropic®はAnthropic, PBCの商標です。提携や推奨を示唆するものではありません。