Claude Opus 4.5のeffortパラメータで出力トークンを節約してみた

Claude APIでOpus 4.5だけにeffortというパラメータがあることを知りました。※Claude Codeじゃないです。

ざっくり言うと、Claudeにどれくらい頑張ってもらうかを3段階で指定できる機能です。lowにするとトークン消費が大幅に減るとのこと。

Claude APIを使っていて、節約したい方向けの記事です。

effortパラメータとは

effortはlow / medium / highの3段階で指定します。

response = client.beta.messages.create(
    model="claude-opus-4-5-20251101",
    betas=["effort-2025-11-24"],
    max_tokens=4096,
    messages=[{"role": "user", "content": "..."}],
    output_config={
        "effort": "medium"
    }
)

公式の案内

thinking budgetとは別物

最初、MAX_THINKING_TOKENSとかbudget_tokensと同じものかと思っていたんですが、違います。

effortは全体的な頑張り度合いを制御するもので、thinking budgetはextended thinking専用の上限設定です。併用もできます。

どれくらい削減できるのか

公式発表の数字がなかなか強烈です。

76%削減はかなりインパクトありますね。mediumでも性能は落ちないというのがポイントです。

使いどころ

公式ドキュメントではこんな使い分けが推奨されていました。

エージェントで複数のClaudeを動かすときに、メインはhighでサブエージェントはlowにする、みたいな使い方が想定されているようです。

現状の制約

いくつか注意点があります。

Opus 4.5限定

今のところclaude-opus-4-5-20251101でしか使えません。
Sonnetとかでは動かないです。

ベータ機能

effort-2025-11-24というベータヘッダーが必要です。

curl https://api.anthropic.com/v1/messages \
    --header "anthropic-beta: effort-2025-11-24" \
    --data '{
        "model": "claude-opus-4-5-20251101",
        "output_config": {"effort": "medium"},
        ...
    }'

Claude Code CLIでは？

--betasオプションでベータを有効にはできるんですが、effortの値を指定するフラグは今のところなさそうです。API経由で使う前提ですね。

試してみた感想

実際にmediumで使ってみたんですが、体感としてはそこまで劣化した感じはしませんでした。

ただ、複雑なコード生成とかだとhighの方が明らかに丁寧な出力になる印象です。単純なタスクならlowでも十分かもしれませんが、このあたりはもう少し検証が必要そうです。

Opus 4.5自体がそもそも高いので、76%削減は地味に効いてくるんじゃないかと思います。エージェント的な使い方をしている人は試してみる価値ありそうです。

参考

• https://www.anthropic.com/news/claude-opus-4-5
• https://platform.claude.com/docs/en/api/messages
• https://platform.claude.com/docs/ja/build-with-claude/effort

ここまで読んでいただき、ありがとうございます。もしこの記事の技術や考え方に少しでも興味を持っていただけたら、ネクストのエンジニアと気軽に話してみませんか。

• 選考ではありません
• 履歴書不要
• 技術の話が中心
• 所要時間30分程度
• オンラインOK

エンジニアと話してみる