# Claude Opus 5.5のeffort設定：5段階の選び方と費用・キャッシュへの影響

> Claude Opus 5.5のeffortはlowからmaxまでの5段階。Claude CodeとMessages APIでの設定方法、ベンチマーク費用の読み方、キャッシュへの影響を整理します。

- Source: https://www.aifreeapi.com/ja/posts/claude-opus-5-5-effort
- Language: ja
- Published: 2026-09-23
- Updated: 2026-09-23
- Publisher: AI Free API (https://www.aifreeapi.com)

Claude Opus 5.5の`effort`で迷ったら、まず既定値の`medium`から始めてください。単純な定型作業なら`low`を比較し、`medium`で調査や修正が途中で止まるなら`high`を試します。長時間の探索的な作業でなお改善が必要なら`xhigh`、費用より最高の到達率を重視する課題で`max`を検討する順番です。段階を上げれば必ず仕事が早く終わるわけではありません。同じ作業の**完了率、やり直し回数、経過時間、作業全体の費用**を見て選びます。[Anthropicのエフォート説明](https://platform.claude.com/docs/ja/build-with-claude/effort)・[Claude Codeでの選び方](https://claude.com/blog/what-a-task-costs-on-opus-5-5)

この記事はClaude CodeとClaude **Messages API**でOpus 5.5を使う人向けです。モデルの提供先、基本料金、Opus 5からの移行全般は[Claude Opus 5.5の料金と使い方](/ja/posts/claude-opus-5-5)にまとめています。

## effort 5段階の違いと選び方：既定はmedium、次はhigh

`effort`は思考トークンの固定枠ではなく、モデルが回答全体にどれほど取り組むかを伝える設定です。思考だけでなく、最終回答やツール呼び出しの量にも影響します。Opus 5.5では`low`、`medium`、`high`、`xhigh`、`max`を使えます。設定を省略すると既定値の`medium`です。Opus 5の既定値は`high`なので、旧モデルと同じ設定名を前提にした比較は避けてください。[公式ドキュメント](https://platform.claude.com/docs/ja/build-with-claude/effort)

| レベル | 最初に試す作業 | 判断を変える目安 |
| --- | --- | --- |
| `low` | 名前の変更、既知のパターンの適用など範囲が狭い作業 | 必要な確認や修正が抜けるなら`medium`へ |
| `medium` | 仕様と完了条件が明確な日常の開発作業。Opus 5.5の既定値 | 一部だけ直して関連箇所を見落とすなら、先に検証手段を与え、それでも止まれば`high`へ |
| `high` | 調査や複数ファイルの修正を伴う作業 | 完了率の改善が追加の時間と費用に見合うか確認 |
| `xhigh` | 長時間の探索や複雑なエージェント作業 | `high`では完了しない同種の課題に絞って比較 |
| `max` | 制約の少ない推論が必要で、費用より到達率を優先する課題 | `xhigh`からの上積みが実際に必要か測る |

これは開始点であって性能保証ではありません。AnthropicはClaude Codeの定型作業に`low`、日常的な作業に`medium`、`medium`で行き詰まった場合に`high`を提案しています。また、チェックを実行できれば`medium`のままで見落としを発見できることもあります。[Claude Code公式ブログ](https://claude.com/blog/what-a-task-costs-on-opus-5-5)

## Claude Codeでは/effortコマンドで切り替える

Claude Codeの会話で、たとえば`/effort high`を実行します。現在値は`/effort status`で確認できます。変更は**次のリクエストから**有効です。1回の難しい作業の前に上げ、日常作業に戻るときに下げる使い方はできますが、切り替えにも費用上の影響があります。[Claude Code公式ブログ](https://claude.com/blog/what-a-task-costs-on-opus-5-5)

Claude Codeではeffortやthinkingの変更により**会話キャッシュが消去され**、次のリクエストで会話全体のキャッシュ書き込み料金が発生します。長い会話の途中で各ターンごとに切り替える前に、続けて行う作業をまとめられるか確認してください。APIのメッセージ単位effortには別のキャッシュ保持手段がありますが、Claude Codeの`/effort`に同じ挙動を期待することはできません。[キャッシュに関する公式説明](https://claude.com/blog/what-a-task-costs-on-opus-5-5)

## Messages APIではoutput_config.effortに書く

Claude APIのMessagesリクエストでは`output_config.effort`を指定します。以下は設定位置を示す最小例です。`medium`は既定値なので、省略しても同じ動作になります。[日本語のAPIドキュメント](https://platform.claude.com/docs/ja/build-with-claude/effort)

```json
{
  "model": "claude-opus-5-5",
  "max_tokens": 4096,
  "messages": [{"role": "user", "content": "この変更の影響範囲を調べてください"}],
  "output_config": {"effort": "medium"}
}
```

![Claude CodeのeffortコマンドとMessages APIのoutput_config.effortを並べた設定図](https://www.aifreeapi.com/posts/ja/claude-opus-5-5-effort/img/settings.webp)

Opus 5.5では適応型思考が常時有効です。旧式の`thinking: {"type": "disabled"}`や、`enabled`と`budget_tokens`を組み合わせた手動予算を残すと、effortの値に関係なくHTTP 400になります。`thinking`フィールドを省くか、対応する`adaptive`を使ってください。`high`以上では、思考と回答の**合計**を制限する`max_tokens`が小さすぎないかも確認します。[Opus 5.5の変更点](https://platform.claude.com/docs/en/models/opus-5-5/whats-new-opus-5-5)・[エフォートの仕様](https://platform.claude.com/docs/ja/build-with-claude/effort)

### 長いAPI会話でeffortだけを変える場合

通常のトップレベル`output_config.effort`をリクエスト間で変えると、以前のキャッシュ済みプレフィックスは保持されません。一方、Opus 5.5で使える**メッセージ単位effort**は別のベータ機能です。`mid-conversation-output-config-2026-07-01`ヘッダーを付け、内容が空で`output_config.effort`だけを持つ`system`メッセージを追加すると、**次のuserターンから**新しい値が有効になり、それ以前のキャッシュ済みプレフィックスを保持できます。対象モデル・ルートでベータが利用できることを確認し、[公式のリクエスト例](https://platform.claude.com/docs/ja/build-with-claude/effort)に沿って実装してください。

## 高いeffortは費用に見合う？

直接Claude APIを利用する場合、Opus 5.5の通常単価は入力100万トークン当たり**4米ドル**、出力は**20米ドル**、5分キャッシュ書き込みは**5米ドル**、キャッシュ読み取りは**0.20米ドル**です。これはトークンの単価で、どのeffortでも1回の作業にかかるトークン数やツール実行回数が同じという意味ではありません。Claude Codeを契約プランで使う場合も、このAPI単価をそのまま月額請求と読み替えないでください。[公式料金表](https://platform.claude.com/docs/en/models/opus-5-5/overview)

独立した[Artificial AnalysisのIntelligence Index v4.3.2](https://artificialanalysis.ai/models/claude-opus-5-5-medium)では、既定のfallbackを有効にしたOpus 5.5の比較が公開されています。表の「費用／課題」は**同社の複数評価を重み付けしたベンチマーク課題1件当たりの平均米ドル額**であり、一般のAPI呼び出し1回や読者の実際の作業費用ではありません。

| effort | Indexスコア | 加重ベンチマーク課題1件当たりの費用 |
| --- | ---: | ---: |
| [`low`](https://artificialanalysis.ai/models/claude-opus-5-5-low) | 42 | $0.55 |
| [`medium`](https://artificialanalysis.ai/models/claude-opus-5-5-medium) | 51 | $1.34 |
| [`high`](https://artificialanalysis.ai/models/claude-opus-5-5-high) | 54 | $1.82 |
| [`xhigh`](https://artificialanalysis.ai/models/claude-opus-5-5-xhigh) | 56 | $3.46 |
| [`max`](https://artificialanalysis.ai/models/claude-opus-5-5) | 58 | $5.98 |

![mediumとhighで同じ開発作業を試し、完了・再試行・時間・トークン費用を記録する比較手順の図](https://www.aifreeapi.com/posts/ja/claude-opus-5-5-effort/img/task-evaluation.webp)

この測定では`medium`から`max`に上げるとスコアは51から58へ、費用は$1.34から$5.98へ変わります。「maxが約4.5倍の請求になる」という一般則ではありません。指標は10種類の評価を組み合わせたもので、自分のリポジトリでの完了率や待ち時間を直接測っていません。設定や測定値が更新される可能性もあります。[測定方法と費用の定義](https://artificialanalysis.ai/models/claude-opus-5-5-medium)

選択を確かめるなら、代表的な作業を複数選び、**同じ入力・完了条件・ツール・採点方法**で`medium`と候補の段階を比較します。成功した回数に加え、やり直し、経過時間、入力・出力・キャッシュ書き込み／読み取りを作業単位で記録してください。`high`が1ターン当たり高くても再試行を減らせば総費用が下がる場合があり、`medium`で一度で完了するなら上げる理由は弱くなります。ここで示した判断方法は公開データに基づく比較手順で、Opus 5.5を有料で実測した結果ではありません。[Anthropicの作業単位の説明](https://claude.com/blog/what-a-task-costs-on-opus-5-5)

## よくある疑問

### effortを省略したらhighになる？

**Opus 5.5では`medium`です。** Opus 5の既定値`high`とは異なります。モデルを切り替えたままeffortを省略すると同条件の比較にならないため、検証時は両方の設定値を記録してください。[公式ドキュメント](https://platform.claude.com/docs/ja/build-with-claude/effort)

### lowにすれば必ず応答が速く、安くなる？

**1リクエストのトークン消費は減る方向に働きますが、作業全体では保証されません。** 見落としによる再試行やツール操作が増えれば、総時間・総費用は逆転し得ます。完了率と作業単位の合計を比較してください。[エフォートの説明](https://platform.claude.com/docs/ja/build-with-claude/effort)・[作業費用の説明](https://claude.com/blog/what-a-task-costs-on-opus-5-5)