1. fallbackModelは、混雑で止まったときの「保険」
Claude Code を使っていると、サーバーの混雑で処理が止まってしまうことがあります。そんなときの保険になるのが「fallbackModel」という設定です。
結論から言うと、設定ファイルに次の1行を足すだけです。
{
"fallbackModel": ["sonnet", "haiku"]
}これで、メインのAIが混雑にぶつかったとき、控えのモデル（Sonnet → Haiku）に自動で切り替えて、作業を続けようとしてくれます。
この記事では、2026年6月時点の情報をもとに、混雑で止まる場面・設定方法・動作の仕組み・つまずきやすい落とし穴・注意点を、実際に設定してみた体験を交えて紹介します。Claude Code で「混雑で止まって困った」ことがある人に向けた内容です。
なお、私自身はまだ実際に切り替わる場面には出くわしていません。あくまで「混雑への保険」として設定した、という立場で読んでもらえればと思います。
2. 混雑で止まる場面とは？
Claude Code を使って作業をしていると、ときどき処理が途中で止まってしまうことがあります。原因のひとつが「サーバーの混雑」です。
画面には「overloaded」や「529」といった言葉が出ます。これは、アクセスが集中して、サーバーが一時的に処理しきれなくなっている状態のことです。私の設定ミスではなく、混み合っているときに起きる一時的なものです。
私の場合は、こんな止まり方をしました。
待っている間も、「〜をまとめています」「再トライしています」と Claude が動いているのは見えています。それなのに最後にエラーになると、それまで調べてもらった内容が無駄になって、また同じところからやり直しです。ここが地味に、もったいないと感じました。
（作業が途中で止まってしまったときの体験は、別記事「AIの自動作業が突然止まった日」にもまとめています。）
こうした「混雑による中断」を、できるだけ減らしたい。そこで登場するのが、次に紹介する fallbackModel です。
3. fallbackModelを設定する
設定はとてもシンプルでした。settings.json という設定ファイルに、1行書き足すだけです。
settings.jsonは、Claude Code の動きを細かく決めるための設定ファイルです。パソコンの中の決まった場所に置かれています。
私の環境では、このファイルは次の場所にありました。
~/.claude/settings.json
~/は「自分のユーザーフォルダ」を指す記号です。Windows ならC:\Users\ユーザー名\のことだと思ってください。
このファイルを開いて、次のように書き加えます。すでに settings.json がある人は1行を足すだけ、まだ無い人は新しく作って、この形にすればOKです。
{
"fallbackModel": ["sonnet", "haiku"]
}これだけです。意味は「メインのAIが混雑で止まりそうになったら、まず Sonnet に、それでもダメなら Haiku に切り替えてね」という指示になります。切り替え先は、左から順番に試されます。
書き足したものの、本当に切り替わるのかは、まだ実感がありません。それでも、作業が途中で止まる心配が少し減ると思うと、ちょっとほっとしました。
なお、2026年6月時点では、この設定が使えるのは Claude Code の v2.1.166 以降です。それより前のバージョンを使っている場合は、先にアップデートしておきましょう。
4. ハマりやすい落とし穴
設定そのものは1行で簡単ですが、私が実際にやってみて「おっと」となった落とし穴が2つありました。
落とし穴1：設定したのに「認証が切れています」と出る
設定を書き換えたあと、Sonnet と Haiku への切り替えがちゃんと効くか試してみたところ、こんなエラーが出ました。
> claude --model sonnet -p "reply with OK"
Failed to authenticate. API Error: 401 Invalid authentication credentialsClaude Code は普段どおり使えていたので、まさかここで再ログインが必要になるとは思わず、少し驚きました。とはいえ対処は簡単で、/login で入り直したら、すぐに解決しました。
設定を変えたあとにモデルを指定して試して、もし認証のエラーが出ても、あわてず /login でログインし直せば大丈夫です。
落とし穴2：settings.json の中身は環境によって違う
settings.json の中身は、人それぞれ・環境それぞれで違います。すでにいくつか設定が入っていることもあれば、空っぽのこともあります。
なので、よそで作った「完成形」をそのまま丸ごとコピーして貼り付けると、もともと入っていた設定を上書きして壊してしまうことがあります。安全なのは、いまある settings.json を開いて、fallbackModel の1行だけを足すことです。
5. 設定後の動作（仕組み）
ここからは、fallbackModel を設定すると「どう動くはずか」という仕組みの話です。
以下は仕様として整理した内容です。私自身はまだ実際の切り替わりを目にしていないので、「こう動くはず」という前提で読んでください。
メインのAIが混雑（overloaded／529）などにぶつかると、Claude Code は自動で控えのモデルに切り替えて、処理を続けようとします。先ほど設定した ["sonnet", "haiku"] なら、まず Sonnet に、それでもダメなら Haiku に、という順番で試されます。
（Sonnet や Haiku といったモデルごとの違いは、別記事「Claudeのモデル比較」でまとめています。）
大事なのは、切り替わるのはそのときの処理（ターン）だけということです。混雑が解消すれば、次からはまた元のメインのAIに戻ります。ずっと控えのモデルになりっぱなし、というわけではありません。
混雑は自分の好きなタイミングで起こせるものではないので、実際に切り替わる場面に出くわすのは、もう少し先になりそうです。
6. 注意点：fallbackが効くエラー・効かないエラー
ひとつ大事な注意点があります。fallbackModel が助けてくれるのは、「混雑（overloaded／529）」をはじめとした、サーバー側の都合で止まったときだけ、ということです。
たとえば、さっきの落とし穴で出てきた「認証切れ（401）」は、サーバーの混雑とは別の問題なので、fallbackModel では切り替わりません。ほかにも、短い時間に使いすぎたときの制限や、通信まわりのエラーなど、サーバー側のエラー以外で止まる場面には効きません。
ツールの呼び出しがうまくいかずに止まってしまう、といったケースも同じで、これは混雑が原因ではないので fallbackModel の対象外です。
ですから「fallbackModel を設定すれば、止まるのが全部なくなる」というわけではありません。あくまで「混雑による中断への保険」だと考えておくと、がっかりせずに済みます。
7. まとめ：設定しておくべき人・しなくてもいい人
最後に、fallbackModel を設定したほうがいい人と、そうでもない人を整理します。
設定をおすすめしたいのは、Claude Code で作業していて、混雑による中断によく遭遇する人です。設定は1行で済むうえ、混雑のときの保険になるので、入れておいて損はありません。
逆に、あまり混雑に当たらない人や、止まる原因が混雑以外（認証切れなど）のことが多い人にとっては、急いで設定する必要はないかもしれません。
私自身は、まだ実際に切り替わる場面を見ていません。それでも、「混雑で止まるかも」という心配をひとつ減らせたのは確かです。1行で済む保険として、設定しておく価値はあると思います。
コメント