
CLAUDE.mdが長いと使用量は増える?|0〜48,000文字で実測した「毎回読み込まれる量」と短くする方法【実機で確認・2026年10月】
「CLAUDE.md にルールを足し続けていたら、いつの間にか長くなっていた」。「長いと、依頼のたびに料金が増えるのだろうか」。「どのくらいの長さまでなら大丈夫なのか」。Claude Code を使う人なら、一度は気になることだと思います。
以前書いた記事「CLAUDE.mdの書き方」では、CLAUDE.md に何を書くか、テンプレートと実例を書きました。この記事は、その続きです。CLAUDE.md が長くなると、毎回の作業で何がどれだけ増えるのか。公式の説明と、私が実機で測った数字を分けて書きます。
私は Claude Code と Codex を毎日使って、教材づくり、note・Gumroad への出品、画像づくりを自動化しています。Claude Code の CLAUDE.md も使っています。ただし、私は料金や API の専門家ではありません。この記事の数字は、私が測った範囲のものです。全文無料です。
情報の扱い方を書いておきます。公式の情報は、Claude Code のドキュメント(メモリ、コスト、コマンド、CLI のページ)を2026年10月17日に開いて読みました。公式の文は「要約すると」と断って、私の言葉で書きます。
実測の条件は、Windows 11、Claude Code 2.1.301、2026年10月17日、claude -p(画面なし)で、モデルは Haiku 5.5(claude-haiku-5-5)です。費用は、実行結果の JSON にある total_cost_usd の値で、API の定価で計算した見積もりです。サブスクリプションの枠の消費量そのものではありません。
この記事で分かること
CLAUDE.md は、いつ、どこから読み込まれるか(公式の要約)
何も書かなくても、1回の呼び出しにどれだけのトークンが載っているか(実測)
CLAUDE.md を 3,000・12,000・48,000 文字にしたとき、何がどれだけ増えたか(実測)
費用への効き方。2回目以降のキャッシュと、モデルの単価による差(実測と計算)
/context の見方
短くする方法。公式で書かれていることと、私の考えを分けて
先に結論
公式によると、CLAUDE.md は起動のたびに、会話の最初から文脈に読み込まれます。長いほど文脈を多く使い、守られにくくなるので、目安は200行以下とされています
実測(Haiku 5.5)では、CLAUDE.md を空にしたままでも、1回の呼び出しに約25,000トークンが載っていました。システムの指示や、道具の定義などです
日本語の CLAUDE.md は、1文字あたり約0.93〜0.98トークン増えました。48,000文字のとき、文脈は約69,800トークンでした
2回目以降はキャッシュの読み取りになり、Haiku 5.5 では、48,000文字でも1回の費用は約0.0008ドルでした。ただし、Sonnet 5.5 や Opus 5.5 は1トークンの単価が高く、同じ増え方でも金額の差は大きくなります
短くするには、毎回必要なことだけを CLAUDE.md に書き、長い手順や一部の作業だけの指示は、スキルや場所を限ったルールに分けます。公式では、@ で別ファイルに取り込んでも、起動時に一緒に読まれるので軽くはならないとされています

CLAUDE.md は、いつ、どこから読み込まれるか
公式のメモリのページ(2026年10月17日に確認)を要約すると、CLAUDE.md は次の場所に置けます。広い順に並べます。
組織の管理(managed policy):組織が決めた指示。Windows では C:\Program Files\ClaudeCode\CLAUDE.md
個人(全プロジェクト):~/.claude/CLAUDE.md
プロジェクト(チームで共有):./CLAUDE.md または ./.claude/CLAUDE.md
個人(そのプロジェクトだけ):./CLAUDE.local.md
読み込まれるタイミングと、範囲は次のとおりです。
起動したとき、作業フォルダと、その上のすべてのフォルダにある CLAUDE.md と CLAUDE.local.md が読まれます。見つかったものは、上の階層から順に、ひとつの文脈へつなげられます
作業フォルダの下のサブフォルダにある CLAUDE.md は、起動時には読まれません。そのフォルダのファイルを読んだり、書いたり、編集したりしたときに、初めて読まれます
--add-dir で追加したフォルダの CLAUDE.md は、既定では読まれません
読み込まれた内容は、会話の最初に毎回入ります。システムの指示のあとに、ユーザーの発言の形で届く、とされています
/compact で会話を要約したあとも、プロジェクト直下の CLAUDE.md は、ディスクから読み直されて戻されます
CLAUDE.md の内容は、命令ではなく文脈として扱われます。守られるかどうかは、長さと書き方に左右されます
1ファイルは4 MiBまで全部読まれます。ただし、公式の目安は200行以下で、それより長いファイルがあると、起動時と /status で警告が出ます
ここで大事なのは、起動時に読まれる CLAUDE.md は、会話のたびに文脈に入るという点です。書いた行は、その作業で使うかどうかに関係なく、毎回の文脈の一部になります。
実測:何も書かなくても約25,000トークン載る
測り方は、次のとおりです。
同じ作業フォルダに CLAUDE.md を置き、中身を 0・3,000・12,000・48,000 文字の4段階にしました。中身は日本語の文章です
各段階で、次のコマンドを2回ずつ実行しました。1回目は、キャッシュを書き込む「初回(cold)」、2回目は直後で、キャッシュを読み取る「2回目(warm)」です
claude -p "OK と答えて" --output-format json --setting-sources project,local「文脈のトークン数」は、入力と、キャッシュの書き込み・読み取りを足した数です
費用は、JSON の total_cost_usd の値です
結果は、次のとおりです。
0文字(空):文脈 24,974トークン。初回の費用 $0.0019、2回目 $0.0003
3,000文字:文脈 27,910トークン。初回 $0.0024、2回目 $0.0003
12,000文字:文脈 36,326トークン。初回 $0.0041、2回目 $0.0004
48,000文字:文脈 69,849トークン。初回 $0.0109、2回目 $0.0008
まず、何も書かなくても、約25,000トークンが毎回載っていた点です。内訳は、後で書く /context で見られます。システムの指示が約3,300トークン、システムの道具の定義が約13,600トークン、スキルの一覧が約2,200トークンでした。CLAUDE.md の分は、この上に乗ります。
なお、/context の合計は 20.5k で、この JSON の文脈の合計 24,974 とは一致しません。数え方の違いだと思われますが、理由は確かめていません。
文字数が増えると、どれだけ増えるか
CLAUDE.md の文字数を増やしたときの増え方は、0文字との差から計算しました。
3,000文字:+2,936トークン(1文字あたり約0.98)
12,000文字:+11,352トークン(1文字あたり約0.95)
48,000文字:+44,875トークン(1文字あたり約0.93)
字数が多いほど1文字あたりは少なく見えました。別の実験(E7)で、日本語の文章を1,000字と6,000字で送って測ったところ、1文字あたり約0.93トークンでした。この実験では、Haiku 5.5・Sonnet 5.5・Opus 5.5 の3つとも、同じ約0.93でした。CLAUDE.md の増え方を実測したのは Haiku 5.5 だけです。
同じ方法で測った英文は、1文字あたり約0.28トークンでした。字数で見ると、日本語は英文の3倍以上のトークンを使います。同じ字数でも、書く言語で文脈の量が変わる、ということです。
費用への効き方
費用は、キャッシュの有無で大きく変わります。同じ文脈が続けて読まれると、2回目からはキャッシュの読み取りになります。実測の2回目(warm)が、それです。
Haiku 5.5 の値で見ると、次のとおりです。
2回目(キャッシュの読み取り):何も書かないと $0.0003、48,000文字で $0.0008。差は約 $0.0005
1回目(キャッシュの書き込み):何も書かないと $0.0019、48,000文字で $0.0109。差は約 $0.009
Haiku 5.5 では、金額の差は小さく見えます。ただ、ここで注意したいのは、1トークンの単価がモデルで違うことです。「Claude Opus 5.5とは?」の記事の単価で見ると、Haiku 5.5 の入力は、プロンプトが10万トークンまでのとき100万トークンあたり $0.10 です。Sonnet 5.5 は $2、Opus 5.5 は $4 です。Haiku 5.5 に比べて、20倍から40倍の差があります。
同じ増え方でも、単価の高いモデルほど金額の差は大きくなります。たとえば、「Claude Opus 5.5とは?」の記事によると Opus 5.5 のキャッシュ読み取りは100万トークンあたり $0.20 です。今回増えた約4万5千トークンを毎回読み取ると、1回あたり約 $0.009 になります。これは私の計算で、Opus 5.5 で実際に測ったものではありません。
Haiku 5.5 には、もう1つ注意があります。「Claude Opus 5.5とは?」の記事と公式によると、プロンプトが10万トークンを超えると、入力の単価が上がります。CLAUDE.md が長くなって、文脈全体が10万トークンを超えると、その段に入ります。今回の実測(何も書かないときの約25,000トークンと、1文字あたり約0.93〜0.98トークン)から計算すると、CLAUDE.md が約7万7,000字から8万字を超えると、その段に入ります。私の計算です。48,000文字は約7万トークンで、まだその手前でした。
サブスクリプションの場合は、料金ではなく枠を使います。私の /usage の画面(直近24時間と直近7日間の両方)には、「always-on context over 40k tokens」、つまり常にかかっている文脈が40kトークンを超えていた分に、使用量の12%が向かった、と出ていました。画面の説明はこの一文だけで、どう数えているかは分かりません。サブスクリプションの枠の計算式は公開されていないので、CLAUDE.md が増えた分が枠をどれだけ使うかは、断定できません。
/context の見方
/context は、いまの文脈が何でどれだけ埋まっているかを、色つきの表で見せるコマンドです。公式では、重い道具への節約の提案、メモリの肥大(memory bloat)、上限への警告も出る、とされています。
-p の実行で打った出力で、見る所は次の3つです。
Memory files の欄:読み込まれた CLAUDE.md が、トークン数つきで出ます。12,000文字のとき、CLAUDE.md は 11.2k で、表の合計は 31.7k でした。0文字のときは、この行が出ませんでした
System tools と Skills の欄:CLAUDE.md とは関係なく、最初から入っている分です。この環境では、システムの道具が約13.6k、スキルが約2.2k でした
サブフォルダの CLAUDE.md は、起動時には Memory files の欄に出ません。公式では、読み込まれたときに、ターミナルに Loaded の行が出るとされています
CLAUDE.md の中身を開いて編集するなら、/memory で読み込まれたファイルの一覧を見て、そこから開けます。公式では、どのファイルが起動時に読み込まれたかは /context で確かめるよう書かれています。
短くする方法
ここからは、公式で書かれていることと、私の考えを分けて書きます。
公式で書かれていること
1ファイルは200行以下が目安です。公式は、長いほど文脈を多く使い、守られにくくなる、と書いています
毎回の作業で必要な事実だけを書きます。ビルドやテストのコマンド、書き方の決まり、プロジェクトの構成、「いつも○○する」という規則です。公式の例では、「Format code properly」より「2-space indentation を使う」のように、具体的に書くことを勧めています
複数の段階がある手順や、コードベースの一部にしか関係しない内容は、スキルか、パス指定つきのルールに移します。パス指定つきのルールは、起動時には読まれず、対象のファイルを扱うときに読まれます。パス指定のないルールは、起動時に読まれます
関係のない作業に移るときは、/clear で新しい会話を始めます。古い文脈は、以降のすべての依頼でトークンを使い続けるからです
使っていない MCP サーバーは、/mcp で無効にします
@ で別ファイルを取り込んでも、取り込んだファイルは起動時に一緒に読み込まれます。長いファイルを整理するのには役立ちますが、文脈の量は減りません
ブロックの HTML コメントは、文脈に入る前に取り除かれる、とされています。ただし、この動きは私の実測ではありません
私の考え(公式には書かれていないこと)
ふだんは読まない資料(長い書き方の手引きや、過去の決定の記録など)は、CLAUDE.md に全文を書かず、別のファイルに置くのがよいと考えています。CLAUDE.md には、「この作業のときだけ、そのファイルを読む」と1行だけ書きます。@ で取り込むのとは違い、読むのは必要なときだけになる、という考えです。ただし、この形で何トークン減るかは、私は測っていません
CLAUDE.md に行を足すときは、足す前に、削ってよい行を探すのがよいと考えています。行ごとに「これは毎回必要か」と確かめると、長くなるのを防ぎやすいはずです
週に1回くらい、/context の Memory files の数字を見て、増えすぎていないかを確かめるのもよいと思います
使うときの注意点
実測は Haiku 5.5 の CLAUDE.md だけです。Sonnet 5.5 と Opus 5.5 で、CLAUDE.md の増え方を測ったわけではありません。E7 の値は、送った文章で測ったものです
費用は、API の定価での見積もりです。サブスクリプションの枠の消費量とは違います
0文字のときの約25,000トークンは、この環境の数字です。ユーザー全体の CLAUDE.md や、入っているスキルや MCP の量で、変わります。/context の合計(20.5k)と JSON の合計(24,974)が一致しない理由は、確かめていません
公式の数字(200行という目安など)と料金は、更新で変わります。実際に使うときは、公式のページを確かめてください
まとめ
CLAUDE.md は起動のたびに、会話の最初から文脈に入ります。長いほど文脈を使い、守られにくくなるので、目安は200行以下です
何も書かなくても、Haiku 5.5 では約25,000トークンが毎回載っていました
日本語は1文字あたり約0.93〜0.98トークン増えます。48,000文字で、文脈は約69,800トークンでした
2回目以降はキャッシュの読み取りになり、Haiku 5.5 では金額の差は小さく見えました。Sonnet 5.5 と Opus 5.5 は単価が高く、差は大きくなります
短くするには、毎回必要な事実だけを書き、長い手順や一部の作業の指示は、スキルやパス指定のルールに分けます。@ での取り込みは、軽くはなりません
次の一歩は、いま使っている CLAUDE.md を開いて、行数と文字数を数えることです。そのうえで、「毎回必要か」で行を分けてください。/context で Memory files の数字を見るのも、数分でできます。
次に読む
CLAUDE.mdの書き方|コピペで使えるテンプレートと実例・置き場所・ベストプラクティス(無料):この記事の前に読む、書き方の基本
Claude Codeのスキル(Skills)の作り方(無料):毎回の頼み方を手順書にして、呼べる形にする
Claude Codeのスラッシュコマンド一覧(無料):/clear・/compact・/context の使い分け
Claude Codeの使用量を減らすモデルの使い分け(¥100):作業と調べものでモデルを分ける考え方
Claude Code テンプレート集(¥9,800):CLAUDE.md・スキル・フック・自動化の実物パック
このアカウントをフォローすると、Claude Code や Codex の新しい手順の記事が届きます。ぜひフォローしてください。
この先で分かること(今後の有料記事)
文脈の量を、記事ごとに測る手順と、測った結果の読み方
長い CLAUDE.md を、スキルとパス指定のルールに分けたときの文脈の変化
実際に膨らんで困った CLAUDE.md の失敗と、直し方の記録
まさのAI実務ラボ|Codex・Claude Code では、有料記事が読み放題になります。テンプレートや指示文をまとめて使いたい方はご覧ください。