Claude Codeトークン節約術｜消費を測って5手順で減らす

結論: Claude Codeのトークン消費は、会話が長くなるほど複利的に膨らむ構造を持っています。節約の第一歩は「どこで何トークン使っているか」を/usageで測ること。そのうえで、タスク切り替え時の/clear、CLAUDE.mdのスキル分離、MCP棚卸し、Hooksによる前処理、外部エージェントへの委譲の5手順を、効果が大きく手軽な順に試せます。

この記事の要点:

• Anthropic公式ドキュメントによると、エンタープライズ環境の平均コストは開発者1人あたり1日約13ドル、月額150〜250ドルで、90%のユーザーは1日30ドル以下に収まっている（https://code.claude.com/docs/ja/costs、参照日: 2026-09-05）
• トークン消費は複利的に膨らむ。ファイル読み取りやツール出力はコンテキストに蓄積し、次のターンでまるごと再送信される
• Spotify Engineeringが2026年9月3日に公開した事例では、大量ファイル読み取りを外部エージェントに委譲している。結果としてbulk-readのトークン消費を平均90%削減したと報告された（出典、参照日: 2026-09-05）

対象読者: Claude Codeを日常的に使っていて、セッション制限に頻繁に到達する、または月額コストを下げたいエンジニア

読了後にできること: /usageでトークン消費の内訳を確認し、5つの手順から自分の環境に合った節約策を1つ実装できる

この記事では、トークン消費の仕組みから5つの具体的な削減手順までを整理します。Claude Code自体のパフォーマンス改善（遅い・止まる問題）についてはコンテキスト管理ガイドを、APIレベルのコスト最適化についてはClaude APIコスト最適化をそれぞれ参照してください。

まず測り、効果の大きい順に5手順で減らす。

トークン消費の仕組み — 複利で膨らむ構造

Claude Codeは会話のたびにコンテキスト全体をAPIへ送信する。チャットUIと同じ仕組みだが、コーディングエージェントではファイル読み取り、grepの結果、テスト出力、MCPサーバーからの応答がすべてコンテキストに追加されるため、消費量の伸び方が急になる。

起動時の固定コスト

セッション開始時に読み込まれるのは、システムプロンプト、CLAUDE.md、MCPツール名、スキル一覧、環境情報などだ。公式ドキュメントによると、MCPツール定義はデフォルトで遅延読み込みされるため、ツール名だけがコンテキストに入る（https://code.claude.com/docs/ja/mcp、参照日: 2026-09-05）。

ここで重要なのは、CLAUDE.mdはセッション開始時に全文読み込まれる点だ。200行のCLAUDE.mdは、そのセッション中のすべてのターンで繰り返し送信される。

ターンごとの複利

この複利構造を、具体例で確認する。

ターン4の時点で、Claude Codeが送信するのは追加の3,000トークンだけでなく、累計24,000トークン全体だ。ターン1で読んだファイルの内容もコンテキスト内に残り続けるため、毎ターン再送信されている。

拡張思考（Extended Thinking）の影響

拡張思考はデフォルトで有効であり、思考トークンは出力トークンとして課金される。公式ドキュメントによると、デフォルトの思考予算はモデルに応じて数万トークンに達する場合がある（https://code.claude.com/docs/ja/costs、参照日: 2026-09-05）。深い推論が不要な単純タスクなら、/effortで努力レベルを下げてコスト削減が可能だ。

1ターンの追加は小さくても、コンテキスト全体の再送信で消費が加速する。

トークン消費を測る — /usage と StatusLine

節約の前に、まず現状を測る。

/usage コマンドの読み方

/usageを実行すると、セッションの詳細なトークン使用統計が表示される。

Total cost:            $0.55
Total duration (API):  6m 19.7s
Total duration (wall): 6h 33m 10.2s
Total code changes:    0 lines added, 0 lines removed

Pro、Max、Team、Enterpriseプランでは、使用量の内訳も確認できる。スキル、サブエージェント、MCPサーバーごとの消費割合が表示されるため、何がトークンを食っているかの特定に使える。dで過去24時間、wで過去7日間の切り替えも可能だ。

StatusLineでリアルタイム監視

/statuslineコマンドを使うと、コンテキスト使用量をステータスバーに表示する設定を自動生成できる。表示内容はカスタムスクリプト形式で定義されるため、プロジェクトに合わせた情報（ブランチ名、テスト状態など）も追加可能だ。

コンテキストが50%を超えたら/compactを検討し、70%を超えたら/clearで新規セッションに切り替える——この目安が効果的だ。

5つの節約手順 — 手軽で効果が大きい順に

手順1: タスク切り替え時に/clearする

効果: 大　難易度: 低

最もシンプルで効果が大きいのが、関連のない作業に切り替えるときの/clearによるセッション区切りだ。

公式ドキュメントでは「古いコンテキストは後続のすべてのメッセージでトークンを浪費する」と明記されている（https://code.claude.com/docs/ja/costs、参照日: 2026-09-05）。バグ修正の後にドキュメント作成をする場合、バグ修正のコンテキストはドキュメント作成に不要だ。

/clearの前に/renameでセッション名を付けておけば、後から/resumeで戻れる。

手順2: CLAUDE.mdをスキルに分離する

効果: 中〜大　難易度: 低

CLAUDE.mdに書かれた指示は、セッション全体を通じてコンテキストに常駐する。PRレビューの手順、データベース移行のルール、特定のフレームワーク向けの規約など、特定のワークフローだけで使う指示をスキルに移動すれば、関連のない作業中のオーバーヘッドが消える。

公式ドキュメントは「CLAUDE.mdを200行以下に保つことを目指してください」と推奨している（https://code.claude.com/docs/ja/costs、参照日: 2026-09-05）。

移動前: CLAUDE.md 500行（常にコンテキストに読み込まれる）
移動後: CLAUDE.md 150行 + スキル3本（呼び出し時のみ読み込み）

スキルはオンデマンド読み込みのため、使わない回のトークン消費はゼロだ。

手順3: MCPサーバーを棚卸しする

効果: 中　難易度: 低

MCPツール定義はデフォルトで遅延読み込みされるが、Claudeが特定のツールを使うとその定義がコンテキストに入る。/mcpで設定済みサーバーの一覧を確認し、使っていないサーバーを無効にしよう。

公式ドキュメントでは「CLIツール（gh、aws、gcloud、sentry-cliなど）はMCPサーバーよりコンテキスト効率が高い」と説明されている。CLIツールはツールごとのリストを追加しないためだ（https://code.claude.com/docs/ja/costs、参照日: 2026-09-05）。

/contextを実行すれば、現在のコンテキストで何がスペースを消費しているかを確認できる。

手順4: Hooksでデータを前処理する

効果: 中〜大　難易度: 中

Claude CodeのHooks機能を使うと、Claudeがデータを見る前に前処理できる。

たとえば、10,000行のログファイルを読む代わりに、HooksのPreToolUseでエラー行だけを抽出して返せば、コンテキストを数万トークンから数百に削減可能だ。

# PreToolUse hookの例: テスト出力から失敗だけを抽出
cmd=$(echo "$input" | jq -r '.tool_input.command')
if [[ "$cmd" =~ ^(npm test|pytest|go test) ]]; then
  filtered_cmd="$cmd 2>&1 | grep -A 5 -E '(FAIL|ERROR|error:)' | head -100"
  echo "{\"hookSpecificOutput\":{...\"updatedInput\":{\"command\":\"$filtered_cmd\"}}}"
fi

公式ドキュメントに掲載されているこの例では、テストランナーの出力を失敗パターンだけにフィルタリングしている。テスト全体の出力が数千行でも、Claudeのコンテキストに入るのはエラー周辺の数十行だけだ。

ただし、Hooksの実行は環境依存であり、設定ミスでフィルタリングが効かない場合もある。変更後は/usageでトークン消費が実際に減ったことを確認しよう。

手軽で効果が大きい手順から順に試す。

手順5: 重い作業を外部エージェントに委譲する

効果: 大　難易度: 高

Spotify Engineeringが2026年9月3日のブログ記事で公開したのは、I/O集約型の作業を外部エージェントに委譲する手法だ。同記事の主張は「AIコーディングエージェントの仕事の大半はI/Oであり、そこを安価なモデルに任せれば本体のトークン消費が激減する」というものである。

Spotify Portalの仕組み

Spotify Portalの「モード」は宣言的なエージェントで、一時的なランタイム上で動作する。同ブログでは「AWS Lambdaのようなもの、ただしエージェント用」と説明されている。

2つの特化モードが公開されている。

Claude CodeのPreToolUse hooksが350行を超えるファイル読み取りを検知すると、Portalのbulk-readerモードへ自動的にルーティングする仕組みだ。bulk-readerはGemini 2.5 Flash等の安価なモデルでファイルを要約し、要約結果だけをClaude Codeのコンテキストに返す。

関連プラグインはGitHub（spotify/portal-ai-plugins）で公開されている。

自前で同様の構成を組むには

Spotify Portalを使わなくても、同じ考え方をサブエージェントで再現できる。公式ドキュメントでは「テスト実行、ドキュメント取得、ログ処理をサブエージェントに委任すると、詳細な出力がサブエージェントのコンテキストに留まり、メインの会話に戻るのはサマリーだけ」と説明されている（https://code.claude.com/docs/ja/costs、参照日: 2026-09-05）。

Agentツールやエージェントチームを使う場合は、チームメイトにSonnetを指定し、スポーンプロンプトを焦点の絞られたものにすることで追加のトークン消費を抑えよう。

やりがちな失敗と回避策

❌ /compactを早くかけすぎる

回避: /compactは会話履歴を要約して圧縮するが、要約の過程で文脈が失われることがある。まず/clearでセッションを分けられないか検討し、分けられない場合に/compactを使う。「Focus on code samples and API usage」のようにカスタム指示を添えれば、残すべき情報を指定できる。

❌ Opusをデフォルトのまま使い続ける

回避: Sonnetはほとんどのコーディングタスクを処理でき、Opusよりコストが低い。複雑なアーキテクチャ設計や多段階の推論が必要なときだけ/modelでOpusに切り替え、終わったら戻す運用が効果的だ。単純なサブエージェントタスクなら、サブエージェント設定でmodel: haikuを指定できる。

❌ エージェントチームを起動したまま放置する

回避: エージェントチームは各チームメイトが独自のコンテキストウィンドウを持ち、トークン消費はおおよそチームサイズに比例する。公式ドキュメントによると「アクティブなチームメイトはアイドル状態でもトークンを消費し続ける」ため、作業完了後は速やかに停止しよう。

Pro・Max 5x・Max 20xの使い分け

Claude Codeの料金プランは、月間のトークン消費量で損益分岐が変わる。

注意: 上記の月額は2026年9月5日時点の公式料金ページ（https://claude.com/pricing）に基づく。プランの詳細や制限は変更される可能性があるため、最新情報は公式サイトで確認してほしい。

制限に到達した場合は、/usage-creditsで使用量クレジットの購入や月間支出制限の設定が可能だ。意図しない超過を防ぐには、支出制限を事前に設定しておくのが有効だ。

自分の利用パターンに合ったプランを選ぶ。

よくある質問

Q1: /usageの金額は実際の請求額と同じですか？

いいえ。公式ドキュメントによると、/usageの金額はトークン数から局所的に計算された推定値であり、実際の請求書と異なる場合がある。確定した請求額はClaude Console（https://platform.claude.com/usage）の使用量ページで確認できる。Max/Proサブスクライバーの場合、セッションコスト数値は参考値だ。

Q2: /clearするとそれまでの作業内容は消えますか？

コンテキスト（会話履歴）はクリアされるが、ファイルへの変更やgitコミットはそのまま残る。/clearの前に/renameでセッション名を付けておけば、/resumeで過去のセッションに戻れる。

Q3: CLAUDE.mdを短くしすぎると、Claudeの精度が下がりませんか？

特定ワークフロー向けの指示をスキルに分離するのがポイントだ。スキルは呼び出し時にのみ読み込まれるため、必要なときには同じ指示が適用される。CLAUDE.mdには常に必要な基本ルールだけを残す形になる。

Q4: Spotify Portalは無料で使えますか？

Portal関連のプラグインはgithub.com/spotify/portal-ai-pluginsで公開されている。ただし、モードが使用するモデル（Gemini 2.5 Flash等）のAPI料金は別途発生する。公式ブログでは「インフラ管理、APIキー、常時起動サーバーは不要」と説明されている。

Q5: サブエージェントを使うと逆にコストが増えませんか？

サブエージェントは独自のコンテキストウィンドウを持つため、追加のトークンを消費する。ただし、詳細な出力はサブエージェント側に留まり、メインの会話に返るのはサマリーだけなので、メインコンテキストの肥大化を防ぐ効果がある。大量のログ解析やドキュメント取得など、出力が大きい作業ほど効果的だ。サブエージェントにはSonnetやHaikuなど低コストのモデルを指定できる。

/usageを開いて、最初の1つから試す

トークン節約は「全部やらなければ意味がない」種類の取り組みではない。/usageで現状を測り、消費が多い部分から1つだけ対策を入れるだけで変化が見える。

まずは次のセッションで/usageを実行し、どのMCPサーバーやスキルがトークンを消費しているかを確認してほしい。タスク切り替え時に/clearを挟むだけでも、セッション後半のトークン消費は大きく変わる。

次に読むなら: Claude Codeのコンテキスト管理と性能改善についてはコンテキスト管理ガイドで、APIレベルのコスト構造と最適化についてはClaude APIコスト最適化で詳しく解説しています。

参考・出典

• コストを効果的に管理する — Anthropic Claude Code公式ドキュメント（https://code.claude.com/docs/ja/costs）（参照日: 2026-09-05）
• Portal by Spotify cut my Claude Code token usage by 90% — Spotify Engineering（https://engineering.atspotify.com/2026/9/portal-by-spotify-cut-my-claude-code-token-usage-by-90）（参照日: 2026-09-05）
• Claude Code Token Optimization: 19 Changes to Cut Costs — Build to Launch（https://buildtolaunch.substack.com/p/claude-code-token-optimization）（参照日: 2026-09-05）
• Claude Codeのトークン消費を抑える方法まとめ — NEXTSCAPE blog（https://blog.nextscape.net/archives/2026/06/03/093108）（参照日: 2026-09-05）
• Claude Code のコンテキスト管理とトークン消費を抑える運用方法 — Qiita @Yasushi-Mo（https://qiita.com/Yasushi-Mo/items/0071f71ba102d2125c13）（参照日: 2026-09-05）
• Claude Codeトークン節約9選 — Zenn @activecore（https://zenn.dev/activecore/articles/claude-code-resident-cost）（参照日: 2026-09-05）
• Hooks — Anthropic Claude Code公式ドキュメント（https://code.claude.com/docs/ja/hooks）（参照日: 2026-09-05）
• Skills — Anthropic Claude Code公式ドキュメント（https://code.claude.com/docs/ja/skills）（参照日: 2026-09-05）