メニュー

AI

Claude Codeのコスト管理:/usageの見方とエフォートの使い分け

Claude Codeの /usageコマンドでトークン使用量と推定コストを確認する方法と、思考の深さを調整する「エフォート」(low〜max)の使い分けを、Anthropicの公式ドキュメントをもとに整理します。

公開
茹で時間
7 分
言語
日本語 · English
目次(4項目)
  1. /usageで何が分かるか
  2. エフォートの5段階と使い分け
  3. Opus 5.5は既定がmedium
  4. コストを抑える実務のポイント

Claude CodeのOpus 5.5で、既定のエフォートがmediumに変わりました。Opus 5と比べてトークン単価も下がっています。とはいえ、エフォートを上げるほど思考量が増え、コストも上がるという関係は変わりません。

/usageコマンドでセッションのトークン使用量と推定コストを確認しながら、作業内容に合わせてエフォートを調整します。

/usageで何が分かるか

/usageを実行すると、画面上部のSessionブロックに、今のセッションで使ったトークン数と推定コストが表示されます。

Total cost:            $0.55
Total duration (API):  6m 20s
Total duration (wall): 6h 33m 10s
Total code changes:    0 lines added, 0 lines removed
Usage by model:
   claude-sonnet-4-6:  1.2k input, 5.3k output, 940.0k cache read, 50.0k cache write ($0.55)

出典:Manage costs effectively(Claude Code公式ドキュメント)

ここでのTotal costは、トークン数からリスト価格をもとにローカルで計算した推定値です。組織の管理者が契約レートを設定していない限り、実際の請求額そのものではありません。Pro・Maxのサブスクリプション利用者は、プランの利用枠に含まれるため、この金額は請求には関係しません。正確な金額はClaude ConsoleのUsageページで確認できます。

この合計は/clearで会話をリセットすると0に戻ります。会話が長く続くセッションほど数字が積み上がっていくので、無関係な作業に切り替えるときは/clearを使うと、次の作業のコストを切り分けて把握できます。

最初のやり取りのあとにはPrompt cache (main)の行も追加され、リクエストのうち何%がキャッシュから読まれたか、キャッシュが外れた回数、キャッシュが有効期限内かどうか(warm / cold)が分かります。プロンプトキャッシュはサブスクリプションでは1時間、APIキーでは既定で5分の有効期限があり、期限が切れると次のリクエストで会話全体を読み直すため、コストが跳ね上がります。作業の合間を空けすぎないことも、キャッシュを無駄にしないコツです。

キャッシュの行を気にする理由は、公式ブログに書かれています。Anthropicは、2026年3月から9月までのClaude Codeの利用を集計しています。1回のリクエストで読み込むコンテキストは約2.6倍に増え、入力と出力のトークンの比は189:1から324:1になりました。Claudeは書くよりもはるかに多くを読んでいます。

Claude Codeの利用の変化をまとめた図。1つのプロンプトでClaudeが作業する時間は3.3倍、中断は68%減。ツールサーバーやスキルを使う割合は約2倍、プロンプトに文章を貼り付ける割合は3分の1減。リクエストあたりのコンテキストは2.6倍、入力と出力のトークンの比は189:1から324:1に変わった
2026年3〜9月のClaude Codeの利用の変化。出典:Claude Opus 5.5: Built for coding sessions that use more context(Claude公式ブログ)

そのため、エージェントやコーディングの作業では、キャッシュの読み込みが費用の大半を占めます。Opus 5.5では、入力と出力の単価が20%、キャッシュの読み込みの単価が60%下がりました。下の図の左側が単価で、100万トークンあたり、入力が4ドルなのに対して、キャッシュの読み込みは0.2ドルです。

Claude Opus 5.5とGPT-6 Astraを比べた図。左は100万トークンあたりの単価で、Opus 5.5は入力4ドル、出力20ドル、キャッシュの読み込み0.2ドル。右は5つのベンチマークの結果
左が単価、右がベンチマーク。比べている相手はOpenAIのGPT-6 Astra。出典:Claude Opus 5.5: Built for coding sessions that use more context(Claude公式ブログ)

同じ公式ブログは/usageでキャッシュから読んだ割合を確かめ、その割合を下げないようにすることを勧めています。セッションの途中でモデルを切り替えない、といった習慣です。

Pro・Max・Team・Enterpriseのプランでは、/usageに直近24時間または7日間の利用状況の内訳も表示されます。スキルやサブエージェント、MCPサーバーごとの利用割合や、長いコンテキストやキャッシュミスなどコストを押し上げている要因も分かります。

エフォートの5段階と使い分け

エフォート(effort)は、Claude Codeがモデルにどれだけ深く思考させるかを調整する設定です。レベルが上がるほど、モデルはより多くのステップで思考し、トークン使用量も増えます。

Anthropicの公式ドキュメントでは、Opus 5.5やSonnet 5などの対応モデルで選べる5段階が、次のように説明されています。

レベル向いている作業
low短く、範囲が限定された、応答速度を優先したい作業
mediumコストを抑えつつ、多少の判断力低下を許容できる作業
highトークン使用量と判断力のバランスが求められる幅広い作業
xhighより深い推論が必要な作業(トークン費用は高くなる)
max難しい自律的な作業で、性能を最大化したい場合

エフォートの変更は/effortコマンドで行います。

/effort          # スライダーを開いて選ぶ
/effort high     # 直接レベルを指定する
/effort auto     # モデルの既定値に戻す

対話中に選ぶときは、Enterを押すと、以降のセッションでも使う既定値として保存されます。sを押すと、現在のセッションだけに適用されます。

Opus 5.5は既定がmedium

Opus 5.5のエフォートの既定値はmediumで、Opus 5や大半の対応モデルの既定値highより1段階低くなっています。公式ドキュメントによると、Anthropicの検証でOpus 5.5のmediumがOpus 5のhighと同等かそれ以上の性能を示したためです。

Opus 5からOpus 5.5に切り替えるときは、/effort highをそのまま引き継ぐのではなく、まずmediumから試すことが推奨されています。

サブエージェントだけエフォートを下げることもできます。プロンプトで頼む方法と、lowとhighの時間と費用の実測は、サブエージェントのエフォートの記事に書きました。

コストを抑える実務のポイント

公式ドキュメントの「Reduce token usage」では、次のような習慣が紹介されています。

  • 無関係な作業に移るときは/clearする:古い会話が残っていると、それ以降の全てのやり取りでトークンを消費し続ける
  • 作業に見合ったモデルを選ぶ:Sonnetで足りるコーディング作業はSonnetに任せ、Opusは複雑な設計判断や多段階の推論が必要な場面に絞る
  • 使っていないMCPサーバーは無効にする:/mcpで一覧を確認し、CLIツール(gh、awsなど)で代替できるものは、そちらを優先する
  • ログ処理やテスト結果の確認など、出力の多い作業はサブエージェントに任せる:詳細な出力はサブエージェント側にとどまり、メインの会話には要約だけが戻る
  • 具体的な指示を書く:「コードベースを改善して」のような曖昧な指示は、モデルが広い範囲を探索することになり、トークンを多く使う

公式ドキュメントはエンタープライズでの利用実績として、開発者1人につき、1日平均約13ドル、1か月では150〜250ドルという目安も示しています。90%の利用者は1日あたり30ドル未満に収まっているとされています。

udon
Microsoft 365、ServiceNow、Copilotなどを自ら検証し実務で使える「コシのある知見」を記録しています。