トークンを節約したくても、何に使われているかが見えないと削りようがありません。
先に答えを書くと、見るのは /context、削る場所は4つです。毎回載る CLAUDE.md、大きな出力、伸びた会話、モデルとエフォート。
空のフォルダで起動した直後でも28.4kが埋まっていて、150行の CLAUDE.md を足すと7.8k増えました。この記事の数字は、すべて claude -p で /context を実行して測ったものです。
この記事でわかること
/contextと/usageで、トークンの行き先を見る方法- CLAUDE.md と rules を「常時」と「必要なときだけ」に分ける方法(150行で7.8k、paths 指定で0)
- 大きなログやテスト出力を、本体の会話に入れない方法(サブエージェントで32.3k→12.7k)
/clearと/compactの使い分け(/compactで61.4k→40.8k)- モデルとエフォートを仕事に合わせて下げる方法
Claude Code のトークン節約とは、モデルに毎回送られる文脈(コンテキスト)を小さく保つことです。料金プランの話ではなく、会話の中身の話です。プランごとの上限や円換算は 料金確認の記事 に書きました。
測った環境は Claude Code 2.1.310、macOS です(2026年11月に確認)。モデルは claude-sonnet-5-5で、窓は1Mトークンでした。トークン数は /context が出す推定値です。各条件とも測定は1回ずつなので、傾向を見る数字として読んでください。
PARTS LIST /目次
トークンは何に使われている?/contextで見る方法
節約の第一歩は、削る前に内訳を見ることです。Claude Code には、いまの文脈の中身を色付きの枠で見せる /context と、セッションの消費や週の上限を見せる /usage があります。
この2つは役割が違います。/context は「いま窓に何が入っているか」、/usage は「どれだけ使ったか」を見るものです。
空のフォルダでも28.4kから始まる
何も置いていない空のフォルダで claude -p "/context" を実行すると、起動直後の合計は28.4k(1Mの3%)でした。会話はまだ1往復もありません。
claude -p "/context"
出力のカテゴリ別の表が次です。「Autocompact buffer」は自動圧縮のために空けてある領域で、合計の28.4kには入っていません。
「(deferred)」と付いた行(MCP ツール12k、システムツール20.8k)も表に出ますが、合計には入っていません。使われるまで定義を読み込まない仕組みで、起動直後に載るのは名前だけです。
この28.4kは自分では削れない部分が大半
System prompt と System tools で19.6kあります。削れるのは Memory files・Skills・MCP の分と、これから増える Messages です。
/contextと/usageの違い
/context は枠で内訳を見せ、メモリの肥大化や重いツールがあれば改善の提案も出します。/context all も使えます。
/usage は Session の欄にセッションのトークン数と推定金額を出します。/cost は /usage の別名です。Pro・Max などのプランでは、何が上限を食っているかの内訳と、直す候補も並びます。
/usageの提案は、節約の宿題リストになる
/usage の内訳には、直近の使用量に占める割合つきで、直す候補が並びます。私の Mac で claude -p "/usage" を実行すると、直近24時間はこうでした(提案の行だけ抜き出しています)。
Last 24h · 3167 requests · 15 sessions
87% Give "general-purpose" subagents a cheaper model
73% Start fresh when you switch tasks · run /clear
27% Stop sessions you no longer need · some ran 8 hours or more
19% Run fewer sessions at once · up to 4 at once
読み方には癖があります。割合は「その行に当てはまる使用量の割合」で、節約できる量ではありません。複数の行に同じ使用量が数えられるので、合計は100%を超えます。
それでも、順位づけには十分役立ちます。上の4行は、この記事の節にそのまま対応しています。サブエージェントのモデル、切り替えのときの /clear、放置したセッション、並行数です。
画面の下に f to fix と出たら、f キーで Claude Code が直せる提案を実行します。/effort の変更はそのまま実行され、CLAUDE.md を削る提案などは、変更案を見せてから Claude が進めます。
CLAUDE.mdとrulesは「常時」と「必要なとき」に分ける
起動直後に載るもののうち、自分で量を決められる代表が CLAUDE.md と rules です。毎回の会話に付いて回るので、ここが太ると全部の往復で効いてきます。
削り方は2つです。そもそも短くするか、特定のファイルを触るときだけ読ませるか。後者は .claude/rules/ に置いたファイルの先頭に paths を書くだけで済みます。
150行で7.8k|書いた量がそのまま載る
次の3構成を作って、それぞれ claude -p "/context" で起動直後の合計を測りました。中身は「サービス層のメソッド名は動詞から始め…」という1行ルールを150行並べた、同じ文章です。
CLAUDE.md に書いても、paths なしの rules に書いても、7.8k 増えました。1行あたり約52トークンです。rules に分けても、paths を付けなければ節約になりません。
importでは軽くならない
CLAUDE.md から別ファイルを取り込む @ の書き方は、整理には役立ちますが、取り込んだファイルも起動時に読み込まれます。文脈は減りません。
paths指定は読んだときだけ載る
paths を付けた rules は、該当するファイルを Read・Write・Edit したときに初めて文脈に入ります。測った rules の先頭は次の4行です。
---
paths:
- "src/**/*.java"
---
この rules がある状態で、src/A.java(5行のクラス)を Read させて合計を測りました。
差は8.0kで、起動時に載っていなかった rules が、ファイルを読んだ瞬間に入った分です。つまり paths は「消える」のではなく「後ろに回る」仕組みです。Java を一切触らない日は、この8.0kを払わずに済みます。
glob は src/**/*.{ts,tsx} のように波括弧で複数の拡張子をまとめて書けます。rules の書き方と CLAUDE.md との分担は CLAUDE.mdとrulesの記事 にまとめています。
手元の構成と、詰め込みで反応が鈍った話
最初は CLAUDE.md に全部のルールを書いていました。しばらくすると、Claude Code の反応が鈍くなったのを感じました。
そこで rules をトピック別に分け、paths で必要なときだけ読ませる形に変えました。精度が戻ったので、効いたのは分割のほうだと見ています。ただ、最初はほとんどのルールに IMPORTANT などの強調語を付けていて、本当に守ってほしいものが埋もれていました。
いまの手元の構成を数えました。このリポジトリの CLAUDE.md は77行、.claude/rules/ は8ファイルで、そのうち7ファイルに paths を付けています。paths なしで常時載せているのは、秘密情報を扱うルールの1ファイルだけです。
このリポジトリで /context を実行すると、合計は38.3kでした。Memory files は9.7kで、内訳は次のとおりです。
自動メモリの MEMORY.md は、先頭200行か25KBまでが毎回読み込まれます。CLAUDE.md を削っても、ここが太っていれば効果が薄くなります。自動メモリも /context の Memory Files に並ぶので、いっしょに見る価値があります。
CLAUDE.md は1ファイル200行以内を目安にします。1行約52トークンで計算すると、200行で10k強です。この目安は私の測った文章での換算で、1行が長い人はもっと重くなります。
特定の作業だけに使う手順はスキルに移す
「PR レビューのときだけ使う手順」のように、作業が決まっている長い指示は、スキルに移す手もあります。スキルは、名前と説明だけが起動直後に載り、本文は呼ばれたときに初めて読み込まれます。
同じ151行を .claude/skills/java-rules/SKILL.md の本文に置き、説明を1行付けて測りました。
/context のスキルの表には、java-rules が約20トークンと出ました。本文の7.8k分は、呼ばれるまで載りません。
paths が「ファイルを触ったとき」に読み込むのに対し、スキルは「Claude が必要だと判断したとき、または自分で呼んだとき」に読み込みます。触るファイルで決まる規約は paths、手順書のようなものはスキル、と分けています。
スキルは圧縮のあとも本文が戻されますが、1スキル5,000トークン・合計25,000トークンが上限です。長いスキルは後ろが切れるので、大事な指示は先頭に置きます。
大きい出力を本体の会話に入れない
節約の効果がいちばん大きいのは、大きなファイルやログを本体の会話に入れないことです。一度入った出力は、以降の全往復で送り直されるからです。
規約と設定は起動時に決まるぶん固定費ですが、ツールの出力は作業しだいで何倍にもなります。変動費のほうが怖い、と言い換えてもいいです。
Readは25,000トークンで打ち切られる
3,000行のログ(1行約80文字)を作り、Read ツールで全部読ませました。Claude が返した答えは次のとおりです。
ただし Read ツールでは全部読み切れていません。上限(25,000トークン)で打ち切られ、読めたのは1〜522行目だけでした。
3,000行のうち読めたのは522行で、会話(Messages)は10.1kから32.7kに増えました。1回の Read で+22.6kです。上限があるので無限には増えませんが、1回でこれだけ載ります。
しかも、必要なのはたいてい「最初にエラーが出た行」のような一点です。全部を載せる必要がありません。grep で絞る、末尾だけ読む、といった指示を先に出しておくと、載る量は桁で変わります。
依頼の出し方でも、読む量は変わります。「このコードベースを改善して」のような広い依頼は、全体を探索するために多くのファイルを読ませます。場所と目的を指定した依頼なら、読むのは必要な範囲だけです。
大きな変更は、実装の前にプランモードで方針を確かめると、向きの違う作業のやり直しを防げます。違う方向に進み始めたら Esc で止め、/rewind でチェックポイントまで戻れます。プランモードの使い方は Planモードの記事 にあります。
サブエージェントに任せると32.3k→12.7k
同じログを使って、本体が直接読む場合とサブエージェントに読ませる場合を比べました。質問は「elapsed が90ms 以上の行が最初に出る id を答えて」で、どちらも答えは90でした。
本体の会話は19.6k軽くなりました。ログの中身はサブエージェントの窓に入り、本体には答えと短い報告だけが戻ります。
注意点は、サブエージェントの消費が消えるわけではないことです。サブエージェントのリクエストは、自分の使用量に別枠で乗ります。軽くなったのは「本体の会話」で、全体の節約ではありません。詳しい使い方は サブエージェントの記事 に書きました。
私の ~/.claude/CLAUDE.md には、サブエージェントは起動だけで約4万トークンかかるという運用メモがあります。だから委譲するのは、Web ページ本文のような大量のデータが本体に流れ込む作業だけにしています。
数十行のファイルを直すだけなら、本体でやったほうが安く済みます。今回の32.3k→12.7kは、約3,000行のログという大きい出力だったから成り立つ数字です。
MCPは名前だけ載る・CLIとフックも使う
MCP のツール定義は、既定では使われるまで読み込まれません。手元の環境には12k分の定義があります。起動直後に載っているのは、名前の685トークンだけでした。
先ほどの表の「MCP tools (deferred)」がその12kです。名前とサーバーの説明を合わせて約1.9kは、使わなくても毎回載ります。
実際に切って測ると、claude -p --strict-mcp-config "/context"(設定ファイルの MCP を読ませない起動)で、合計は28.4kから26.5kに下がりました。差は1.9kで、MCP を3サーバー接続している手元の環境の数字です。サーバーが増えるほど、この固定費は増えます。
減らす手は3つあります。
- 使わない MCP サーバーは
/mcpで無効にする gh・aws・gcloudのような CLI があるなら、MCP より CLI を使う(ツールの一覧が載らず、Claude がコマンドを直接叩くだけで済む)- フック(hooks)でテスト出力を末尾100行に絞る、ログから ERROR の行だけを返す(数万トークンの出力が数百トークンで済む)
MCP の設定は MCP設定ガイド、フックの書き方は hooksの記事 にあります。
この節で見た、載せる量の差をまとめるとこうなります。
/clearと/compactの使い分け
会話が伸びる理由は、毎回の往復で全履歴が送り直されるからです。履歴はキャッシュで安く読まれますが、ゼロにはなりません。1行の質問でも、1日開きっぱなしのセッションでは全体分の使用量が乗ります。
減らす方法は2つあります。会話を捨てて新しく始める /clear と、要約して縮める /compact です。セッションの再開や分岐の操作は セッション管理の記事 に書いたので、ここでは「どちらを選ぶか」だけを扱います。
話題が変わるなら/clear
関係のない作業へ移るときは /clear です。古い会話は、次に読ませたいファイルを押しのけたうえに、全往復で送られ続けます。
/clear は新しい会話を空の文脈で始めるので、追加の費用はかかりません。新しい会話は、起動直後の状態(空のフォルダなら28.4k)から始まります。前の会話は /rename で名前を付けておけば、/resume で戻れます。
次の図が、私の判断の流れです。
flowchart TD
A["次の作業に移る"] -->|"別の話題"| B["/clear<br/>名前を付けてから"]
A -->|"同じ作業の続き"| C{"会話は重い?"}
C -->|"はい"| D["/compact<br/>残す点を添える"]
C -->|"いいえ"| E["そのまま続ける"]
続きをやるなら/compact
同じ作業の続きで、会話だけが重くなっているときは /compact です。履歴を要約に置き換えます。
同じログ読みの会話(61.4k)で /compact を実行したところ、合計は40.8kに下がり、Messages は32.3kから12.5kになりました。
/compact の後ろに文章を足すと、何を残す要約にするかを指示できます。/compact 認証まわりの修正に絞って のように書きます。CLAUDE.md に「Compact instructions」の見出しで方針を書いておく方法もあります。
# Compact instructions
When you are using compact, please focus on test output and code changes
毎回同じ方針で縮めたいなら CLAUDE.md、その場の作業に合わせたいなら /compact の引数、と使い分けます。
/compact は、縮める対象の会話を全部読んで要約します。重くなりきった会話を縮めるほど、その1回が重い、ということです。
自動圧縮に任せきりにせず、作業の区切りで早めに実行します。圧縮が始まる窓の大きさは /autocompact 500k のように数字で決められます。
compactで消えるもの・残るもの
圧縮のあとも、プロジェクト直下の CLAUDE.md と paths なしの rules はディスクから読み直されます。自動メモリも同様です。
消えるのは、会話の中だけで伝えた指示と、paths 付きの rules です。paths 付きは、該当ファイルを次に触ったときにもう一度読み込まれるので、実害は小さいです。ただ、絶対に毎回守らせたい指示は、paths を外すか、プロジェクト直下の CLAUDE.md に移します。
読んでいたファイルも、最近触った5つまでが読み直されます。5,000トークンを超えるファイルは、中身ではなく「参照した」という記録だけが戻ります。圧縮のあとに「さっきのファイルを見て」と言うと、読み直しが走る場合があります。
モデルとエフォートを仕事に合わせる
文脈を軽くしたあとに効くのが、モデルとエフォートです。同じ会話でも、どのモデルが何を考えるかで消費が変わります。
ほとんどのコーディング作業は Sonnet で足ります。Opus は設計の判断や、手順が多い推論に回します。切り替えは /model でできます。
Sonnetを基本に、Opusは必要なときだけ
/model に与えるエイリアスと、節約に関わる使いどころは次のとおりです。
サブエージェントに使うモデルは、定義ファイルの model に書けます。単純な調査なら model: haiku にします。
覚えておきたいのは、組み込みの Explore サブエージェントです。サブスクリプションで使っていると、Explore は Opus で動きます。軽くしたいなら、Explore という名前のサブエージェントを自分で定義して model: haiku を指定すると、組み込みを置き換えられます。
思考トークンはエフォートで下げる
拡張思考(extended thinking)は既定で有効で、思考に使ったトークンは出力トークンとして数えられます。簡単な作業に深く考えさせると、そのぶんが無駄な出力です。
/effort で段階を選びます。レベルは low・medium・high・xhigh・max で、Sonnet 5.5 の既定は medium です。引数なしなら、スライダーが開きます。/effort auto は、保存した設定をクリアして既定に戻します。
Sonnet 5.5・Opus 5.5・Haiku 5.5 では、思考そのものをオフにはできません。下げられるのはエフォートだけです。環境変数 CLAUDE_CODE_EFFORT_LEVEL でも指定できます。
設定を変える前に、/usage の内訳を見るのが近道です。「max から high に」といった提案が出ていれば、そこに当てはまる使用量が10%以上あるということです。/usage の画面で f を押すと、/effort の変更はそのまま実行してくれます。
節約しているのに減りが速いとき
CLAUDE.md を削り、会話もこまめに切っているのに、上限が速く減ることがあります。席を外している間に消費が進む仕組みがあるからです。
離席中に使われるもの
次のようなものが、放っておいても使用量を食います。
- 長い文脈:1行の質問にも、会話全体がキャッシュ読み込みの料金で乗る
- キャッシュ切れ:休憩のあとの最初の1通は、全文脈を読み直す
- 定期実行:
/loopなどの定期タスクが、空いている間も全文脈を送って動く - サブエージェントとエージェントチーム:本体とは別に、それぞれが自分のリクエストを出す
席にいなくても、小さな自動の呼び出しは走ります。セッションの要約(recap)、放置した会話の自動圧縮(idle compaction)、次の入力の提案(prompt suggestions)です。いずれも設定で止められます。
エージェントチームは、各メンバーが独立した窓を持つので、プランモードで動かすと通常のセッションの約7倍のトークンを使います。人数は少なく、作業が終わったら止めます。
Max プランにしてから、もったいない精神でトークンを使い切ること自体が目的になっていた時期があります。何のために Claude Code を回しているのか、わからなくなりました。
節約というと「減らす」話ですが、使う理由が決まっていないと、削った分は別の使い方で埋まるだけです。このあたりは AI疲れの記事 に書いています。
離席の前にできること
離席する前に /compact で縮めておくと、戻ったときの最初の1通が軽くなります。キャッシュが切れた状態で重い文脈を読み直すより、先に縮めたほうが安く済みます。
長い作業を中断するなら、/rename で名前を付けて /clear する手もあります。再開したいときは /resume で戻れます。
よくある質問
Claude Code のトークン節約について、よく出る質問を6つまとめました。数字は、この記事の測定環境(Claude Code 2.1.310)で出たものです。
Q1. Claude Codeのトークン消費を確認するコマンドは?
A1. 窓の中身は /context、消費量は /usage で見ます。/cost は /usage の別名です。作業中に見張りたいなら、ステータスラインに窓の使用量を出す設定もあります。
Q2. /clearと/compactはどちらを使えばいい?
A2. 別の話題に移るなら /clear、同じ作業の続きなら /compact です。/clear は追加の費用がかからず、/compact は縮める対象の会話を読むので1回分のコストがあります。
Q3. CLAUDE.mdは何行までにすべき?
A3. 1ファイル200行以内が目安です。私の測定では、1行約52トークンで150行が7.8kでした。特定のファイルでしか使わないルールは、rules に分けて paths を付けると、触るまで載りません。
Q4. rulesに分けるだけでトークンは減る?
A4. 減りません。paths を付けない rules は、CLAUDE.md と同じく起動時に全部載ります。測定でも、151行の rules は paths なしで7.8k増え、paths を付けると0でした。
Q5. サブエージェントを使うとトークンは節約できる?
A5. 本体の会話は軽くなります。3,000行のログを読ませたとき、本体の Messages は32.3kから12.7kでした。サブエージェントの消費は別に乗るので、全体の節約ではありません。小さい作業には向きません。
Q6. 簡単な作業でもOpusを使うと無駄になる?
A6. 無駄になりやすいです。日々のコーディングは Sonnet で足ります。Opus が必要なのは、設計の判断や手順の多い推論です。/model で切り替え、/effort で思考の深さも下げられます。
Q7. MCPサーバーを切ると、どれくらい軽くなる?
A7. 私の環境(3サーバー接続)では、MCP を読ませない起動で28.4kから26.5kになり、1.9k軽くなりました。ツール定義は使うまで読み込まれないので、固定費は名前とサーバーの説明の分だけです。
Q8. CLAUDE.mdに書くか、スキルにするか、迷ったときは?
A8. 毎回必要な事実だけを CLAUDE.md に書きます。特定のファイルを触るときだけ要る規約は paths 付きの rules、特定の作業のときだけ使う手順はスキルです。同じ151行を置いたとき、CLAUDE.md は+7.8k、スキルは約20トークンでした。
まとめ|今日やる順番と、次の一歩
測って分かったのは、載っているものは全部足し算だったことです。起動直後の28.4k、CLAUDE.md の7.8k、1回の Read の+22.6k。足されるものを見てから、どれを後ろに回すか決めます。
今日やる順番
/contextを実行して、Memory files と Messages の大きさを見る- 常時載っている CLAUDE.md と rules を、paths で後ろに回せないか考える
- 大きいログや調べものは、サブエージェントかフックで絞る
- 作業の区切りで
/clearか/compact - 簡単な作業は Sonnet・低めのエフォートに下げる
文脈の設計そのものを知りたいなら、コンテキストエンジニアリングの記事 も合わせてどうぞ。
/context を1回実行して、Memory files の行を見る。CLAUDE.md が数千トークンあったら、paths を付けて後ろに回せる rules が混ざっていないかを探します。削るのは、見てからです。
続きを追う:X(@Tom_Java_Tech) / RSS
途中経過は、また書きます。

