Claude Code では、使うモデル(Opus・Sonnet・Haiku など)と、考える深さ(effort)を切り替えられます。
- モデル:/model(保存される)、
claude --model(その起動だけ)、ANTHROPIC_MODEL - エイリアス:opus・sonnet・haiku・fable・best・opusplan・opus[1m] など
- effort:low・medium・high・xhigh・max。/effort か
--effortで変える - 「session limit」「weekly limit」はモデルを変えても解除されない
この記事は、Claude Code の公式ドキュメント(code.claude.com/docs、2026年10月23日に再照合)にもとづいています。
手元の確認は、2026年9月29日に Windows 11 の Claude Code 2.1.284 で、練習用のフォルダー(C:\demo\cc-b)を使って行いました。
エイリアスを実際に指定した
claude -p "1+1は?数字だけ" --model haiku --output-format json
claude -p "1+1は?数字だけ" --model sonnet --output-format json| 指定 | 実際に使われたモデル |
|---|---|
--model haiku | claude-haiku-4-5-20251001 |
--model sonnet | claude-sonnet-5-5 |
エイリアスの対応先は提供元・Claude Codeのバージョン・上書き設定で異なり、常に全環境の最新モデルとは限りません。記事の実行記録は9月29日時点のものです。
モデルの指定の方法
| 方法 | 効く範囲 |
|---|---|
| /model 名前(引数なしで選択画面) | ユーザー設定に保存。次回起動では上位の設定・組織条件が優先される場合がある |
| 選択画面で s を押す | そのセッションだけ |
claude --model 名前 | その起動だけ |
| ANTHROPIC_MODEL=名前 | その環境で起動したものだけ |
| settings.json の model | 設定したスコープ |
別々のターミナルで違うモデルを使うなら、/model ではなく、起動ごとに --model を付けます。
--resume・--continue で再開した会話は通常、保存時のモデルを引き継ぎます。ただし起動時の明示指定が優先され、廃止・制限されたモデルや提供元固有IDなどでは通常の設定順に戻ります。実際のモデルを起動時の表示で確認してください。
エイリアスの一覧
| エイリアス | 意味 |
|---|---|
| opus・sonnet・haiku・fable | 各系統の対応モデル(提供元・版・設定で異なる) |
| best | Fableを利用できる環境ではfable、それ以外ではopusの対応先 |
| opusplan | プランモード中は opus、実行は sonnet |
| opus[1m]・sonnet[1m] | 対応モデルで100万トークンを指定。元から1Mのモデルには不要で、利用条件にも依存 |
| default | 指定を消して、アカウントの初期値に戻す |
effort(考える深さ)
| 段階 | 向いている作業 |
|---|---|
| low | 結果を毎回見る、短いやり取り |
| medium | 範囲のはっきりした日常の開発(Opus 5.5・Sonnet 5.5 の初期値) |
| high | 確かめることが大事な作業 |
| xhigh | より深く考えさせたいとき |
| max | いちばん深い。効果が頭打ちになったり考えすぎたりしやすいので、試してから |
- /effort(引数なしでスライダー)、/effort high のように直接指定、/effort autoで現在のモデルに保存したeffortを解除
claude --effort high(claude --helpには low・medium・high・xhigh・max と出る)- モデル別のmodelSettingsやeffortLevelで設定(maxは保存不可)。CLAUDE_CODE_EFFORT_LEVELも指定に使えるが、モデルの対応段階や組織・管理設定の上限は超えない
- ultrathinkはそのターンに深い推論を求める指示を加える。APIへ送るeffort値は変えない
簡単な作業ではeffortを下げると消費を抑えられます。対応段階はモデルごとに異なり、たとえばOpus 4.6のxhigh指定はhighで動きます。保存は通常モデル別で、旧形式のユーザー設定effortLevelがOpus 5.5以降に適用されない場合もあります。実効値は/effort statusで確認してください。
対話セッションでlow・medium・high・xhighを直接指定するか、スライダーでEnterを押すと、そのモデルの既定値として保存されます。
そのセッションだけ試したい場合は、v2.1.257以降のスライダーでsを押すか、起動時にclaude --effort highのように指定してください。
maxは環境変数から指定した場合を除いて現在のセッションだけに適用され、非対話の-p内で指定した/effortも既定値には保存されません。
同じhighなどの名前でもモデル間で推論量は同一ではないため、モデルを変更したときは、そのモデルの既定値から結果と消費量を確かめます。
利用制限との関係
公式ドキュメントでは、「session limit」「weekly limit」の上限は全部のモデルで共通なので、/model で変えても解除されないとされています。
「Opus limit」「Sonnet limit」のように系統ごとの上限なら、別の系統に利用枠が残っていて利用可能なら、切替えて続けられます。
制限の仕組みは、Claudeの利用制限のしくみで紹介しています。
まとめ
- ずっと変えるなら /model、その起動だけなら
--model - haiku・sonnet・opusなどの対応先は提供元・版・設定によって変わる
- effort は low〜max。日常は medium、確かめたい作業は high
- session・weekly の上限はモデルを変えても戻らない
参考:Claude Code「Model configuration」「Costs」(2026年10月23日に再照合)と、Claude Code 2.1.284 での実行結果。
よくある質問:Claude Codeのモデルとeffortの切り替え
Claude Codeで使うモデルは、どう切り替えますか?
対話モードの/model 名前はユーザー設定に保存されます。次回起動では上位設定などが優先される場合があります。引数なしで開く選択画面のsなら、そのセッションだけです。非対話モードの/modelも保存しません。
claude --model 名前 はその起動だけ、ANTHROPIC_MODEL=名前 はその環境で起動したものだけ、settings.json の model は設定したスコープで効きます。
別々のターミナルで、違うモデルを使うには?
/model ではなく、起動ごとに --model を付けます。
なお、--resume・--continue で再開した会話は通常、保存時のモデルを引き継ぎます。ただし起動時の明示指定が優先され、廃止・制限されたモデルや提供元固有IDなどでは通常の設定順に戻ります。実際のモデルを起動時の表示で確認してください。
エイリアスには、何がありますか?
opus・sonnet・haiku・fable は各系統の対応モデル(提供元・版・設定で異なる)、best はFableを利用できる環境ではfable、それ以外ではopusの対応先、opusplan はプランモード中は opus・実行は sonnet、opus[1m]・sonnet[1m] は対応モデルで100万トークンを指定します。元から1Mのモデルには不要で、利用条件にも依存します。
default は指定を消して、アカウントの初期値に戻します。
エイリアスは、実際にどのモデルを指しますか?
エイリアスの対応先は提供元・Claude Codeのバージョン・上書き設定で異なり、常に全環境の最新モデルとは限りません。記事の実行記録は9月29日時点のものです。
記事の確認(2026年9月29日、出力の modelUsage より)では、--model haiku が claude-haiku-4-5-20251001、--model sonnet が claude-sonnet-5-5 でした。
effort(考える深さ)は、どう選べばよいですか?
low は結果を毎回見る短いやり取り、medium は範囲のはっきりした日常の開発(Opus 5.5・Sonnet 5.5 の初期値)、high は確かめることが大事な作業、xhigh はより深く考えさせたいとき、max はいちばん深いです。
max は効果が頭打ちになったり考えすぎたりしやすいので、試してから使います。
effort は、どうやって変えますか?
/effort(引数なしでスライダー)、/effort highのように直接指定、/effort autoで現在のモデルに保存したeffortを解除できます。
claude --effort high でも指定できます。
モデル別のmodelSettings、effortLevel、環境変数CLAUDE_CODE_EFFORT_LEVELでも指定できます。ただしモデルの対応段階と管理上限に従います。maxは設定ファイルには保存できません。
ultrathinkはそのターンに深い推論を求める指示を加えますが、APIへ送るeffort値は変わりません。
簡単な作業ではeffortを下げると消費を抑えられます。対応段階はモデルごとに異なり、たとえばOpus 4.6のxhigh指定はhighで動きます。保存は通常モデル別で、旧形式のユーザー設定effortLevelがOpus 5.5以降に適用されない場合もあります。実効値は/effort statusで確認してください。
「session limit」や「weekly limit」に当たったら、モデルを変えれば続けられますか?
続けられません。
公式ドキュメントでは、これらの上限は全部のモデルで共通なので、/model で変えても解除されないとされています。
「Opus limit」「Sonnet limit」のように系統ごとの上限なら、別の系統に利用枠が残っていて利用可能なら、切替えて続けられます。
記事の確認範囲は?
手元の確認は、2026年9月29日に Windows 11 の Claude Code 2.1.284 で、練習用のフォルダーを使って行ったもので、そのほかは公式ドキュメントにもとづきます。2026年10月23日は本文と公式資料の再照合で、モデル切替や消費量の実機再測定はしていません。
モデル名や初期値は変わることがあるので、最新は公式ページで確認してください。
