Claude Code の HERMES.md 課金トラブルは何だったのか

Claude Code では最近、典型的な課金トラブルがありました。ユーザーは CLI を起動しただけで、明示的なリクエストをまだ送っていなかったにもかかわらず、ローカルの HERMES.md ファイルが読み込まれ、大きな費用が発生しました。

この件が重要なのは、特定ユーザーの損失額そのものではありません。AI コーディングツールの新しいリスクを示しているからです。ツールが自動で文脈を読むなら、ローカルファイルは実際の token コストになり得ます。

何が起きたのか

公開 issue によると、ユーザーは作業ディレクトリに大きな HERMES.md ファイルを置いていました。Claude Code を起動すると、CLI はプロジェクト文脈をスキャンして読み込みます。問題は、このファイルが自動的に文脈へ含まれ、API 使用量として計上されたことです。

ユーザーはそのファイルをモデルに処理させるよう明示していませんでしたが、課金はすでに発生していました。さらに厄介なのは、この種の動作がツール初期化や文脈準備の段階で起きるため、ユーザーがすぐに費用発生に気づけないことです。

Anthropic はその後 issue で、異常な費用を返金し、追加クレジットも提供すると返信しました。この対応により問題は少なくとも公式に確認され、処理されたと言えます。ただし、AI CLI の「自動文脈」は無料ではない、という点は残ります。

HERMES.md そのものが本質ではありません。長いログ、エクスポート文書、テストデータ、データベース dump、生成レポートなど、どんな大きなファイルでも同じ問題を起こし得ます。

本当の問題は三つの要素が重なったことです。

ファイルが十分大きければ、ツールが「ついでに持ち込んだ」だけでも目に見える費用になります。token 課金のモデルでは、自動化が強いほど境界を明確にする必要があります。

普通の CLI bug なら、コマンド失敗、出力ミス、機能不全で済むことが多いです。課金 bug は、ユーザーの請求額に直接影響するため、より敏感です。

AI コーディングツールでは、課金境界が曖昧になりがちです。

ユーザーには「ツールを起動しただけ」または「一回の会話」に見えても、裏側では複数回のリクエストと大量の文脈送信が発生している可能性があります。

Claude Code、Codex、Cline のような AI コーディングツールを使うなら、まず次のことを確認したいところです。

リポジトリ内に大きなファイルを残す必要がある場合は、ツールにそれらを読まないよう明示するのが安全です。プロジェクトルールにも、ログ、dump、データセット、アーカイブ、大きな Markdown を能動的に読まないよう書いておけます。

この種の問題は、ユーザーの注意だけに頼るべきではありません。ツール側にも明確な境界が必要です。

よりよい設計には次のようなものがあります。

AI コーディングツールが自動エージェントに近づくほど、コストの透明性が重要になります。そうでないと、ユーザーは一回の操作でいくらかかるのか判断できません。

Claude Code の HERMES.md 課金トラブルは、自動文脈と従量課金の衝突です。

ユーザーにとって大事なのは、プロジェクト文脈を管理することです。大きなファイルを AI ツールに標準で見せないこと、予算と使用量に上限を設けること。ツール提供側には、自動ファイル読み込みに対して見えるコスト表示と保護機構が必要です。

参考：