Claude Code：トークンの85%を無駄にしていた真犯人と対策

Claude Codeを使っていて、すぐに使用制限に達してしまう経験はありませんか？

実は、原因はあなたが書いているコードではないかもしれません。
読み込んでいるファイルが問題なのです。

Reddit上で報告された事例では、コンテキストウィンドウの85%がnode_modulesの読み込みに消費されていました。
この問題は設定ミスではありません。

Claude Codeの設計上の盲点が引き起こしています。
本記事では、この問題の本質と具体的な対策方法を解説します。

トークン消費の実態

あるユーザーはリファクタリング作業中に、わずか3回のセッションで制限に到達しました。
そこでログを確認すると、驚くべき事実が判明します。

10万トークンのうち、8万5千トークンがnode_modulesやビルド成果物、gitの内部ファイルに消費されていたのです。
実際のコード作業に使えたのは、わずか15%でした。

問題はさらに深刻です。
この状況は、設定ファイルで適切にブロックルールを設定していても発生するのです。

二重の権限システムという罠

Claude Codeには2つの独立した権限システムがあります。
しかし、それらは互いに通信しません。

一つはファイル読み込みの権限管理です。
もう一つはbashコマンドの権限管理です。

設定ファイルでRead()のブロックルールを定義しても、grepやfindといったbashコマンドには適用されません。
つまり、慎重に作成したdenyリストは、コマンドライン経由では完全に無視されるのです。

この設計は直感に反します。
ファイルシステムへのアクセスをブロックしたつもりでした。

しかし、コマンド経由では自由にアクセスできてしまいます。
セキュリティの穴と言っても過言ではありません。

具体的な解決策

幸いなことに、比較的シンプルな対策が存在します。
それは、bashコマンドの実行前にフィルタリングを行う方法です。

わずか5行のスクリプトで実装できます。
まず、検証用のスクリプトファイルを作成しましょう。

手順は以下の通りです：

プロジェクトルートに.claudeディレクトリを作成
その中にscriptsフォルダを配置
validate-bash.shというファイルを作成

スクリプトの内容は次のようになります：

#!/bin/bash
COMMAND=$(cat | jq -r '.tool_input.command')
BLOCKED="node_modules|\.env|__pycache__|\.git/|dist/|build/"

if echo "$COMMAND" | grep -qE "$BLOCKED"; then
 echo "ERROR: Blocked directory pattern" >&amp;2
 exit 2
fi

次に、設定ファイルでこのスクリプトをフックとして登録します。
.claude/settings.local.jsonに以下を追加してください：

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{
        "command": "bash .claude/scripts/validate-bash.sh"
      }]
    }]
  }
}

この設定により、bashコマンドが実行される前に検証が走ります。
そして、ブロック対象のパターンが含まれていれば、実行は中断されます。