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

Claude Codeの制限がすぐ来る?原因は「キャッシュ読み込み」でした【解決策とテンプレあり】

    最近、Claude Codeで毎日開発していたら「使用制限(usage limit)」にすぐ達するようになって困っていました。

    「まだそんなに使ってないはずなのに、なんで?」と思って、使用量を可視化できる `ccusage` というツールでチェックしてみたら…


    🛠 Claude Codeの使用量を確認するには?【ccusageの使い方】

    Claude Codeで「どれくらい使っているか?」を知るには、
    無料で使える `ccusage` というツールが便利です。

    npx ccusage@latest

    初回は「ccusageをインストールしていい?」と聞かれますので、
    `y`(半角)を入力すればOKです。

    ✅ `npx --yes ccusage@latest` とすれば自動で進みます。

    コマンドを実行すると、以下のような日別トークン使用量レポートが表示されます:

    Date       │ Model     │ Input │ Output │ Cache Read │ Total Tokens │ Cost (USD)
    2025-08-02 │ sonnet-4  │   575 │ 45,508 │ 20,546,010 │ 21,269,459   │ $9.39
    • Input/Output:実際のプロンプトと応答のトークン

    • Cache Read:過去ファイルやコードの読み込み分 ← ここが爆発しやすい

    • Total Tokens / Cost:合計と推定課金額

    さらに詳しい使い方は、こちらのZenn記事もおすすめ:
    🔗 ccusageを使ってClaude Codeの使用量と料金を確認する


    💥 原因は Cache Read の爆発だった

    私の例では、2025年8月2日:

    Input: 575
    Output: 45,508
    Cache Read: 20,546,010 ←やばい
    Total Tokens: 21,269,459
    Cost: $9.39(ほぼ上限)

    会話は軽かったのに、Cache Read だけで2000万トークンを消費していました。
    これが「すぐ制限がかかる」正体です。


    📁 フォルダ構成がトークン消費の原因だった

    私が使っていたプロジェクト構成は以下のようなもの:

    linux-quest-v2/
    ├── day1-minigame/
    ├── day2-minigame/
    ├── ...(day7まで)
    ├── day1.md ~ day7.md
    ├── index.html
    ├── README.md
    ├── script.js
    └── style.css

    一見シンプルですが、

    • `.md`ファイル(Markdown)

    • `.html`ファイル(HTML)

    • `.json`ファイル(ステージデータなど)

    これらすべてが 自動的にClaudeに文脈として読み込まれていたことが判明。


    ✅ 解決策:`.claude` ファイルで読み込みを制御する

    Claude Codeには、プロジェクトフォルダに `.claude` という設定ファイルを置くことで
    「どのファイルを読み込まないか」を指定できます。


    📄 `.claude` 設定テンプレ(私の使用例)

    {
      "clearContextOnNewFile": true,
      "disableCacheRead": false,
      "excludedPaths": [
        "*.md",
        "*.html",
        "*.json",
        "*.csv",
        "*.log",
        "day1-minigame",
        "day2-minigame",
        "day3-minigame",
        "day4-minigame",
        "day5-minigame",
        "day6-minigame",
        "day7-minigame",
        ".git"
      ],
      "maxContextSize": 100000
    }

    📝 `.claude` の作り方(Windowsでも簡単)

    1. メモ帳を開く

    2. 上の設定をコピペ

    3. ファイル名を `.claude` として保存(拡張子 `.txt` をつけないように!)

    4. 保存場所:プロジェクトのルートディレクトリ

    ⚠ ファイルの種類は「すべてのファイル」にして保存してください。


    ✅ 設定後の効果

    翌日、Claude Codeの使用量をチェックすると…

    • Cache Read が激減

    • トークン消費も数百万以内に収まり

    • 制限にかからず1日中快適に作業できるようになりました


    🎯 まとめ

    | 学び | メモ |
    |--------------------------------|--------------------------------------|
    | ✅ トークン制限の犯人は Cache Read | Output よりもキャッシュが爆発する |
    | ✅ `.claude` は必須 | Markdown, JSON, HTMLを除外しよう |
    | ✅ セッションを分けても効果薄い | フォルダ内構造が重いと意味がない |
    | ✅ `ccusage` は定期的に見る | 自分の使用状況を知るのが第一歩 |


    ## 🔧 あとから気づいた、もうひとつの原因

    朝になって、ふと気づきました。

    **作業開始時に開いていたフォルダが、意図していたものと違っていた**のです。  
    開くつもりだったのは `linux-quest-v2/` なのに、  
    ひとつ上のルートフォルダ `projects/` を開いたまま作業していたことに気づきました。

    Claude Codeは、開いているフォルダ全体を文脈として扱い、  
    そこに含まれる `.md`, `.html`, `.json` などのファイルを**すべて読み込もうとします**。

    つまり、自分が使っていない過去のプロジェクトや不要なログファイルなども、  
    **毎回セッションのたびにキャッシュとして自動的に読み込まれていた可能性**があります。

    これが `ccusage` 上で Cache Read が爆発していた**本当の原因のひとつ**だったのかもしれません。

    ---

    これ以降は、**プロジェクトのルートを間違えずに開くこと**、  
    そして `.claude` を正しく配置しておくことが、とても重要だと痛感しました。


    🔗 お役立ちリンク


    ✍️ あとがき

    私は最初「自分の使い方が悪いのかな…?」と思ってましたが、
    仕組みを知れば防げることだったんだとわかりました。

    同じように困っている人の参考になれば嬉しいです!


    🪐 投稿者:@sns_brain
    🧠 ポートフォリオ:https://euro0707.github.io/myportfolio-project-/


    #ClaudeCode #AI開発 #ノーコード #使用制限 #開発Tips #ccusage #ChatGPT活用

     
     
    AIとWeb3で、ちょっと先の未来を探しています。 40代からの小さな実験を、ひとつずつ。

    あなたへのおすすめ