本文へスキップ

本ページはプロモーションが含まれています

AI

Claude Codeのトークン節約|実測で効いた削り方

CATEGORY
DRAWN BY
TOM
DATE
REV.
READ
約19分
SHEETS
8枚
トークン節約(Claude Codeを/contextで測って削る)

トム

SESで約8年、環境を変えられないもどかしさの中にいました。32歳で自社開発企業に転職し、今はClaude Codeと自動化で、仕事も時間も組み直している途中です。
・Javaバックエンドエンジニア(Java歴12年以上)
・資格:基本情報技術者/応用情報技術者/Java Silver/Python3エンジニア認定基礎
詳細なプロフィール

𝕏

トークンを節約したくても、何に使われているかが見えないと削りようがありません。

先に答えを書くと、見るのは /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には入っていません。

カテゴリトークン中身
System prompt2.9kClaude Code 本体の指示
System tools16.7kRead・Edit・Bash などの定義
MCP tools685接続中の MCP ツールの名前
MCP server instructions1.2kMCP サーバーが付ける説明
Memory files1.2k自分の ~/.claude/CLAUDE.md
Skills5.8kスキルの名前と説明
Messages10会話

「(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 などのプランでは、何が上限を食っているかの内訳と、直す候補も並びます。

コマンド見えるもの使う場面
/context窓の中身(カテゴリ別・ファイル別)何が載っているかを疑うとき
/usage(別名 /cost)セッションの消費、プランの上限、上限を食っている行動の内訳どれだけ使ったかを知りたいとき
ステータスライン窓の使用量を常に表示作業中に膨らみ具合を見張るとき

/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行並べた、同じ文章です。

構成起動直後の合計空のフォルダとの差
空のフォルダ28.4k基準
CLAUDE.md に151行36.2k+7.8k
.claude/rules/java.md に151行(paths なし)36.2k+7.8k
同じ内容に paths: "src/**/*.java" を付けた rules28.4k0

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 させて合計を測りました。

条件合計Messages
paths 付き rules あり・A.java を Read した後47.2k18.1k
rules なし(対照)・A.java を Read した後39.2k10.1k

差は8.0kで、起動時に載っていなかった rules が、ファイルを読んだ瞬間に入った分です。つまり paths は「消える」のではなく「後ろに回る」仕組みです。Java を一切触らない日は、この8.0kを払わずに済みます。

glob は src/**/*.{ts,tsx} のように波括弧で複数の拡張子をまとめて書けます。rules の書き方と CLAUDE.md との分担は CLAUDE.mdとrulesの記事 にまとめています。

手元の構成と、詰め込みで反応が鈍った話

LOG2026年8月CLAUDE.md を1ファイルに詰め込んだら反応が鈍った

最初は CLAUDE.md に全部のルールを書いていました。しばらくすると、Claude Code の反応が鈍くなったのを感じました。

そこで rules をトピック別に分け、paths で必要なときだけ読ませる形に変えました。精度が戻ったので、効いたのは分割のほうだと見ています。ただ、最初はほとんどのルールに IMPORTANT などの強調語を付けていて、本当に守ってほしいものが埋もれていました。

いまの手元の構成を数えました。このリポジトリの CLAUDE.md は77行、.claude/rules/ は8ファイルで、そのうち7ファイルに paths を付けています。paths なしで常時載せているのは、秘密情報を扱うルールの1ファイルだけです。

このリポジトリで /context を実行すると、合計は38.3kでした。Memory files は9.7kで、内訳は次のとおりです。

種類中身トークン
User~/.claude/CLAUDE.md(35行)1.2k
Projectこのリポジトリの CLAUDE.md(77行)3.2k
Projectpaths なしの rules(1ファイル)893
AutoMem自動メモリの MEMORY.md4.4k

自動メモリの 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行付けて測りました。

置き場所起動直後の合計増えた分
CLAUDE.md に151行36.2k+7.8k
スキルの本文に151行(説明は1行)28.4k約20トークン

/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 で絞る、末尾だけ読む、といった指示を先に出しておくと、載る量は桁で変わります。

依頼の出し方でも、読む量は変わります。「このコードベースを改善して」のような広い依頼は、全体を探索するために多くのファイルを読ませます。場所と目的を指定した依頼なら、読むのは必要な範囲だけです。

広い依頼絞った依頼
このコードベースを改善してauth.ts のログイン関数に、入力値の検証を足して
ログを見て原因を探してapp.log の末尾200行から、最初の ERROR の行を探して
テストを直して失敗している OrderServiceTest だけを直して。他は触らない

大きな変更は、実装の前にプランモードで方針を確かめると、向きの違う作業のやり直しを防げます。違う方向に進み始めたら Esc で止め、/rewind でチェックポイントまで戻れます。プランモードの使い方は Planモードの記事 にあります。

サブエージェントに任せると32.3k→12.7k

同じログを使って、本体が直接読む場合とサブエージェントに読ませる場合を比べました。質問は「elapsed が90ms 以上の行が最初に出る id を答えて」で、どちらも答えは90でした。

やり方合計Messages
本体が Read ツールで直接読む61.4k32.3k
サブエージェントに読ませ、答えだけ受け取る40.4k12.7k

本体の会話は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の記事 にあります。

この節で見た、載せる量の差をまとめるとこうなります。

状況載る量の目安(実測)
5行のファイルを ReadMessages 10.1k(基準)
3,000行のログを Read(522行で打ち切り)Messages 32.7k(+22.6k)
サブエージェントがログを読み、答えだけ戻すMessages 12.7k

/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になりました。

時点合計Messages
/compact の前61.4k32.3k
/compact の後40.8k12.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 自体が大きなリクエストになる

/compact は、縮める対象の会話を全部読んで要約します。重くなりきった会話を縮めるほど、その1回が重い、ということです。

自動圧縮に任せきりにせず、作業の区切りで早めに実行します。圧縮が始まる窓の大きさは /autocompact 500k のように数字で決められます。

compactで消えるもの・残るもの

圧縮のあとも、プロジェクト直下の CLAUDE.md と paths なしの rules はディスクから読み直されます。自動メモリも同様です。

消えるのは、会話の中だけで伝えた指示と、paths 付きの rules です。paths 付きは、該当ファイルを次に触ったときにもう一度読み込まれるので、実害は小さいです。ただ、絶対に毎回守らせたい指示は、paths を外すか、プロジェクト直下の CLAUDE.md に移します。

読んでいたファイルも、最近触った5つまでが読み直されます。5,000トークンを超えるファイルは、中身ではなく「参照した」という記録だけが戻ります。圧縮のあとに「さっきのファイルを見て」と言うと、読み直しが走る場合があります。

モデルとエフォートを仕事に合わせる

文脈を軽くしたあとに効くのが、モデルとエフォートです。同じ会話でも、どのモデルが何を考えるかで消費が変わります。

ほとんどのコーディング作業は Sonnet で足ります。Opus は設計の判断や、手順が多い推論に回します。切り替えは /model でできます。

Sonnetを基本に、Opusは必要なときだけ

/model に与えるエイリアスと、節約に関わる使いどころは次のとおりです。

エイリアス中身使いどころ
sonnetSonnet の最新日々のコーディング
opusOpus の最新複雑な推論、設計の判断
haiku速くて軽い Haiku単純な作業、サブエージェント
opusplanプランモードは Opus、実行は Sonnet計画だけ重く考えさせたいとき

サブエージェントに使うモデルは、定義ファイルの 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倍のトークンを使います。人数は少なく、作業が終わったら止めます。

LOG2026年10月トークンを使うこと自体が目的になっていた

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。足されるものを見てから、どれを後ろに回すか決めます。

今日やる順番

  1. /context を実行して、Memory files と Messages の大きさを見る
  2. 常時載っている CLAUDE.md と rules を、paths で後ろに回せないか考える
  3. 大きいログや調べものは、サブエージェントかフックで絞る
  4. 作業の区切りで /clear か /compact
  5. 簡単な作業は Sonnet・低めのエフォートに下げる

文脈の設計そのものを知りたいなら、コンテキストエンジニアリングの記事 も合わせてどうぞ。

NEXT STEP
いまのプロジェクトで /context を1回実行して、Memory files の行を見る。

CLAUDE.md が数千トークンあったら、paths を付けて後ろに回せる rules が混ざっていないかを探します。削るのは、見てからです。

途中経過は、また書きます。

NEXT READ本棚から1本

AIで開発を組み直すなら、まずこの5冊から

入門・実践・設計まで、Claude Codeの本をレベル別に5冊選んで比べました。

→ おすすめ5冊を見る

トム

SESで約8年、環境を変えられないもどかしさの中にいました。32歳で自社開発企業に転職し、今はClaude Codeと自動化で、仕事も時間も組み直している途中です。
・Javaバックエンドエンジニア(Java歴12年以上)
・資格:基本情報技術者/応用情報技術者/Java Silver/Python3エンジニア認定基礎
詳細なプロフィール

𝕏

AI

TOC