Claude Code ガイド

Appearance

モデルフォールバック通知の改善：常に表示＆人間にわかりやすいモデル名 ​

原文（日本語に翻訳） ​

モデルフォールバック通知を改善 — verboseモードの裏に隠れず常に表示されるようになり、人間にわかりやすいモデル名が使用されるようになった

原文（英語） ​

Improved model fallback notifications — now always visible instead of hidden behind verbose mode, with human-friendly model names

概要 ​

Claude Codeでは、指定したモデルが過負荷状態の場合に代替モデルへ自動的にフォールバックする機能があります。v2.1.76以前は、このフォールバックが発生した際の通知が --verbose モード使用時のみ表示されていたため、ユーザーが気づかないままモデルが切り替わることがありました。今回の改善により、フォールバック通知が常に表示されるようになり、さらに内部的なモデルID（claude-opus-4-6-20260301 など）ではなく、「Opus 4.6」「Sonnet」のような人間にわかりやすい名前で表示されるようになりました。

基本的な使い方 ​

フォールバックモデルを指定してClaude Codeを起動します：

bash
claude -p --fallback-model sonnet "このコードをレビューしてください"

デフォルトモデルが過負荷の場合、以下のような通知が表示されます：

⚠ Opus 4.6 is overloaded, falling back to Sonnet

実践例 ​

CI/CDパイプラインでの信頼性向上 ​

CI環境でフォールバックを設定しておくことで、モデルの過負荷時でもパイプラインが停止しません：

bash
# CI/CDスクリプトでフォールバックを設定
claude -p --fallback-model sonnet "テストコードを生成して実行してください"

フォールバックが発生した場合、出力に通知が含まれるため、CIログでモデルが切り替わったことを確認できます。

対話型セッションでのモデル確認 ​

通常の対話型セッションでは、verboseモードを有効にしなくてもフォールバックが発生したことがわかります：

bash
# verboseモードなしでも通知が表示される
claude

セッション中にモデルが切り替わると、プロンプト付近に通知が表示されるため、応答品質の変化の原因をすぐに特定できます。

チームでのデバッグ効率化 ​

以前は「なぜか応答の品質が違う」と感じた場合、--verbose フラグを付けて再実行する必要がありました。v2.1.76以降はフォールバックが常に可視化されるため、問題の切り分けが容易になります：

bash
# 以前：フォールバックを確認するにはverboseが必要だった
claude --verbose

# 現在：通常の起動でもフォールバック通知が表示される
claude

注意点 ​

  • フォールバックはprintモード限定: --fallback-model フラグは -p（printモード）でのみ使用可能です
  • モデル名の表示形式: 内部的なモデルIDではなく、「Opus 4.6」「Sonnet」のような短縮名が表示されます
  • 通知の非抑制: verbose以外のモードでも常に通知が表示されるため、ログの出力量がわずかに増える可能性があります
  • フォールバックの自動性: フォールバックは過負荷時のみ発生し、通常時は指定したモデルがそのまま使用されます

関連情報 ​