メインコンテンツへスキップ
見出し画像

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 Code や Codex の新しい手順の記事が届きます。ぜひフォローしてください。

    この先で分かること(今後の有料記事)

    • 文脈の量を、記事ごとに測る手順と、測った結果の読み方

    • 長い CLAUDE.md を、スキルとパス指定のルールに分けたときの文脈の変化

    • 実際に膨らんで困った CLAUDE.md の失敗と、直し方の記録

    まさのAI実務ラボ|Codex・Claude Code では、有料記事が読み放題になります。テンプレートや指示文をまとめて使いたい方はご覧ください。

    あなたへのおすすめ