Claude Opus 5.5のeffortで迷ったら、まず既定値のmediumから始めてください。単純な定型作業ならlowを比較し、mediumで調査や修正が途中で止まるならhighを試します。長時間の探索的な作業でなお改善が必要ならxhigh、費用より最高の到達率を重視する課題でmaxを検討する順番です。段階を上げれば必ず仕事が早く終わるわけではありません。同じ作業の完了率、やり直し回数、経過時間、作業全体の費用を見て選びます。Anthropicのエフォート説明・Claude Codeでの選び方
この記事はClaude CodeとClaude Messages APIでOpus 5.5を使う人向けです。モデルの提供先、基本料金、Opus 5からの移行全般はClaude Opus 5.5の料金と使い方にまとめています。
5段階は何が違い、どこから選ぶ？
effortは思考トークンの固定枠ではなく、モデルが回答全体にどれほど取り組むかを伝える設定です。思考だけでなく、最終回答やツール呼び出しの量にも影響します。Opus 5.5ではlow、medium、high、xhigh、maxを使えます。設定を省略すると既定値のmediumです。Opus 5の既定値はhighなので、旧モデルと同じ設定名を前提にした比較は避けてください。公式ドキュメント
| レベル | 最初に試す作業 | 判断を変える目安 |
|---|---|---|
low | 名前の変更、既知のパターンの適用など範囲が狭い作業 | 必要な確認や修正が抜けるならmediumへ |
medium | 仕様と完了条件が明確な日常の開発作業。Opus 5.5の既定値 | 一部だけ直して関連箇所を見落とすなら、先に検証手段を与え、それでも止まればhighへ |
high | 調査や複数ファイルの修正を伴う作業 | 完了率の改善が追加の時間と費用に見合うか確認 |
xhigh | 長時間の探索や複雑なエージェント作業 | highでは完了しない同種の課題に絞って比較 |
max | 制約の少ない推論が必要で、費用より到達率を優先する課題 | xhighからの上積みが実際に必要か測る |
これは開始点であって性能保証ではありません。AnthropicはClaude Codeの定型作業にlow、日常的な作業にmedium、mediumで行き詰まった場合にhighを提案しています。また、チェックを実行できればmediumのままで見落としを発見できることもあります。Claude Code公式ブログ
Claude Codeではどう設定する？
Claude Codeの会話で、たとえば/effort highを実行します。現在値は/effort statusで確認できます。変更は次のリクエストから有効です。1回の難しい作業の前に上げ、日常作業に戻るときに下げる使い方はできますが、切り替えにも費用上の影響があります。Claude Code公式ブログ
Claude Codeではeffortやthinkingの変更により会話キャッシュが消去され、次のリクエストで会話全体のキャッシュ書き込み料金が発生します。長い会話の途中で各ターンごとに切り替える前に、続けて行う作業をまとめられるか確認してください。APIのメッセージ単位effortには別のキャッシュ保持手段がありますが、Claude Codeの/effortに同じ挙動を期待することはできません。キャッシュに関する公式説明
Messages APIではどこに書く？
Claude APIのMessagesリクエストではoutput_config.effortを指定します。以下は設定位置を示す最小例です。mediumは既定値なので、省略しても同じ動作になります。日本語のAPIドキュメント
json{ "model": "claude-opus-5-5", "max_tokens": 4096, "messages": [{"role": "user", "content": "この変更の影響範囲を調べてください"}], "output_config": {"effort": "medium"} }
Opus 5.5では適応型思考が常時有効です。旧式のthinking: {"type": "disabled"}や、enabledとbudget_tokensを組み合わせた手動予算を残すと、effortの値に関係なくHTTP 400になります。thinkingフィールドを省くか、対応するadaptiveを使ってください。high以上では、思考と回答の合計を制限するmax_tokensが小さすぎないかも確認します。Opus 5.5の変更点・エフォートの仕様
長いAPI会話でeffortだけを変える場合
通常のトップレベルoutput_config.effortをリクエスト間で変えると、以前のキャッシュ済みプレフィックスは保持されません。一方、Opus 5.5で使えるメッセージ単位effortは別のベータ機能です。mid-conversation-output-config-2026-07-01ヘッダーを付け、内容が空でoutput_config.effortだけを持つsystemメッセージを追加すると、次のuserターンから新しい値が有効になり、それ以前のキャッシュ済みプレフィックスを保持できます。対象モデル・ルートでベータが利用できることを確認し、公式のリクエスト例に沿って実装してください。
高いeffortは費用に見合う？
直接Claude APIを利用する場合、Opus 5.5の通常単価は入力100万トークン当たり4米ドル、出力は20米ドル、5分キャッシュ書き込みは5米ドル、キャッシュ読み取りは0.20米ドルです。これはトークンの単価で、どのeffortでも1回の作業にかかるトークン数やツール実行回数が同じという意味ではありません。Claude Codeを契約プランで使う場合も、このAPI単価をそのまま月額請求と読み替えないでください。公式料金表
独立したArtificial AnalysisのIntelligence Index v4.3.2では、既定のfallbackを有効にしたOpus 5.5の比較が公開されています。表の「費用／課題」は同社の複数評価を重み付けしたベンチマーク課題1件当たりの平均米ドル額であり、一般のAPI呼び出し1回や読者の実際の作業費用ではありません。
この測定ではmediumからmaxに上げるとスコアは51から58へ、費用は$1.34から$5.98へ変わります。「maxが約4.5倍の請求になる」という一般則ではありません。指標は10種類の評価を組み合わせたもので、自分のリポジトリでの完了率や待ち時間を直接測っていません。設定や測定値が更新される可能性もあります。測定方法と費用の定義
選択を確かめるなら、代表的な作業を複数選び、同じ入力・完了条件・ツール・採点方法でmediumと候補の段階を比較します。成功した回数に加え、やり直し、経過時間、入力・出力・キャッシュ書き込み／読み取りを作業単位で記録してください。highが1ターン当たり高くても再試行を減らせば総費用が下がる場合があり、mediumで一度で完了するなら上げる理由は弱くなります。ここで示した判断方法は公開データに基づく比較手順であり、本サイトがOpus 5.5を有料で実測した結果ではありません。Anthropicの作業単位の説明
よくある疑問
effortを省略したらhighになる？
Opus 5.5ではmediumです。 Opus 5の既定値highとは異なります。モデルを切り替えたままeffortを省略すると同条件の比較にならないため、検証時は両方の設定値を記録してください。公式ドキュメント
lowにすれば必ず応答が速く、安くなる？
1リクエストのトークン消費は減る方向に働きますが、作業全体では保証されません。 見落としによる再試行やツール操作が増えれば、総時間・総費用は逆転し得ます。完了率と作業単位の合計を比較してください。エフォートの説明・作業費用の説明
