仕様の整理・2026年11月8日に確認
effortの5段階とモデルごとの既定値の差
同じ依頼でも、output_config.effort を書かないときの動きがモデルで違います。省略したとき、Opus 5.5 と Haiku 5.5 は medium、Fable 5.1 と Sonnet 5.5 は high で動きます。モデルを入れ替えるだけで、思考の量と費用が一段動くということです。
このサイトはAnthropicの公式サイトではありません。モデルの提供状況・仕様・料金は変わる可能性があるため、実装や契約の前には公式のドキュメントとご自身のアカウント設定を確認してください。
先に結論
公式のモデル一覧では、既定の effort は Fable 5.1 が high、Opus 5.5 が medium、Sonnet 5.5 が high、Haiku 5.5 が medium です。effort の指定を省いた書き方は「そのモデルの既定値を指定した」のと同じ挙動になる、と effort のページに書かれています。
つまり、Opus 5 から Opus 5.5 に変えて effort を書いていないコードは、黙って一段下がった設定で動きます。エラーにならないので気づきにくい差です。
5段階の意味と、公式が示す使いどころ
| 段階 | 公式の説明（要約） | 想定される用途 |
|---|---|---|
max | 制約なしで最大の能力 | 最も深い推論が要る作業 |
xhigh | 長い作業のための拡張 | 30分を超える長い開発・エージェント作業 |
high | 課題に必要なだけトークンを使う | 複雑な推論・難しいコード |
medium | 節約と能力の中間 | 速度・費用・性能の釣り合いが要るエージェント作業 |
low | 最も効率的。能力は少し下がる | 速度と費用を優先する単純な作業、サブエージェント |
effort は「厳密なトークン予算」ではなく、振る舞いへの合図です。低くしても、難しい問題ではモデルは考えます。ただ、同じ問題でも高い段階より考える量は減ります。
現行4モデルの既定と、公式の出発点の推奨
| モデル | 既定 | 公式の推奨（要約） |
|---|---|---|
| Fable 5.1 | high | まず high。重い作業は xhigh か max、日常の作業は評価で品質が保てるなら medium か low |
| Opus 5.5 | medium | effort が思考量と費用の主な操作。自分の評価で段階を振って決める |
| Sonnet 5.5 | high | 段階の較正が Sonnet 5 と違うので、前の設定を持ち越さずにやり直す |
| Haiku 5.5 | medium | まず medium。low は単純な大量処理向きだが、長いエージェントでは確認を飛ばしやすい |
xhigh を受け付けないのは、公式の一覧では Opus 4.6・Sonnet 4.6・Mythos Preview です。max と xhigh の両方を、現行4モデルは受け付けます。
切り替えるときの手順
- 現在のコードで
output_configを検索し、effort を明示しているかを確かめる - 明示していなければ、移行先の既定値（medium か high）に変わることを前提に費用を見積もる
- 自分の評価用の依頼を、low から high まで1段ずつ同じ入力で動かし、出力と使ったトークン数を保存する
- xhigh か max を使うときは
max_tokensを大きくする。公式の Opus 5.5 移行ガイドは、xhigh と max では64k から始めるよう書いている - 決めた段階を、省略せず明示して固定する
具体例：同じ依頼を3段階で動かす記録の取り方
たとえば社内の議事録要約を Opus 5.5 で動かすとします。effort を書いていないと medium で動いています。そこで同じ100件の議事録を low・medium・high の3通りで動かし、1件ごとに出力の長さ、usage.output_tokens、所要時間、担当者が付けた5段階の評価を表にします。medium と high の評価の差が小さければ medium のまま、差が大きいなら high に上げます。上げた分の費用は、出力トークンの増え方に出力単価（Opus 5.5 は100万トークンあたり$20）を掛けて見積もれます。ここで大事なのは、評価を人が付けることと、段階を明示して固定することです。省略したままだと、次のモデル替えで黙って動きます。
この面で確かめていないこと
- 段階ごとの実際のトークン使用量の差（こちらでは測っていない）
- Fable 5.1 の「評価で保てるなら medium か low」の水準は利用者の評価に依存し、一般則は示されていない
よくある質問
effort を省略するとどうなりますか？
そのモデルの既定の段階で動きます。Opus 5.5 と Haiku 5.5 は medium、他の現行モデルは high です。
effort を上げれば必ず出力が良くなりますか？
公式は能力と費用・速度の取引だと説明しています。上げるほど良くなると保証する記述はなく、評価で確かめるよう案内しています。
effort は思考だけに効きますか？
公式は、テキスト・ツール呼び出しの引数・思考のすべてに効くと書いています。低いと、ツール呼び出しも少なく短くなります。
出典（2026年11月8日に確認）
- effort（Anthropic の API ドキュメント） https://platform.claude.com/docs/en/build-with-claude/effort
- モデル一覧（Anthropic の API ドキュメント） https://platform.claude.com/docs/en/about-claude/models/overview
- Opus 5.5 の移行ガイド（Anthropic の API ドキュメント） https://platform.claude.com/docs/en/models/opus-5-5/migration-guide
編集：ちんあなご編集部。記事の文は写さず、日付・数字・名前などの事実だけを自分の文で書いています。