CLAUDE.md: ドロップインファイルによりClaudeの出力トークンが63%削減

CLAUDE.mdの機能

CLAUDE.mdはプロジェクトルートに配置する単一ファイルです。Claude Codeがこれを読み込むと、コード修正なしで即座に動作が変化します。特に出力動作：お世辞、冗長性、フォーマットノイズを対象としています。

解決する問題

デフォルトでは、Claudeは価値を加えない動作にトークンを浪費します：

• 応答を「もちろん！」「素晴らしい質問です！」「絶対に！」で始める
• 「お役に立てれば幸いです！何か必要でしたらお知らせください！」で終わる
• パーサーを壊すエムダッシュ（--）、スマートクォート、Unicode文字を使用する
• 回答前に質問を言い換える
• 求められていない提案を追加する
• 不要な抽象化でコードを過剰設計する
• 誤った発言に同意する（「あなたは絶対に正しいです！」）

ベンチマーク結果

同じ5つのプロンプトをCLAUDE.mdなし（ベースライン）とCLAUDE.mdあり（最適化）でテスト：

• async/awaitの説明：180語→65語（64%削減）
• コードレビュー：120語→30語（75%削減）
• REST APIとは：110語→55語（50%削減）
• 幻覚修正：55語→20語（64%削減）
• 合計：465語→170語（63%削減）

4プロンプトあたり約384出力トークンを節約。注：これは5プロンプトからの方向性を示すもので、統計的に制御された研究ではありません。

効果がある場合とない場合

最も効果的な状況：

• 高出力量の自動化パイプライン（履歴書ボット、エージェントループ、コード生成）
• Claudeのデフォルト冗長性が数百回の呼び出しで蓄積する反復構造化タスク
• セッション間で一貫した解析可能な出力形式を必要とするチーム

効果が薄い状況：

• 単発の短いクエリ（ファイルは毎メッセージでコンテキストに読み込まれ、低出力交換ではネットトークン増加を引き起こす）
• 気軽な単発使用（低ボリュームではオーバーヘッドがペイオフしない）
• 幻覚実装やアーキテクチャドリフトのような深い失敗モードの修正
• タスクごとに複数の新規セッションを使用するパイプライン
• 大規模なパーサー信頼性（代わりにJSONモードのような構造化出力を使用）
• 議論や代替案が目的である探索的またはアーキテクチャ作業

コスト考慮事項

CLAUDE.mdファイル自体は毎メッセージで入力トークンを消費します。節約は出力トークンの削減から生じます。純利益は、出力量が持続的な入力コストを相殺するのに十分高い場合にのみプラスになります。低使用量では、節約よりもコストが高くなります。

モデルサポート

ベンチマークはClaudeのみで実行されました。ルールはモデル非依存であり、コンテキストを読むあらゆるモデルで動作するはずですが、llama.cpp、Mistralなどのローカルモデルでの結果は未検証です。