概要
CLAUDE.mdにリポジトリ構成を記述することで、Claude CodeのAPI呼び出し回数とトークン消費量を約半分に削減できることが実証されました。
詳細内容
### 概要
Claude Codeにおいて、プロジェクトの構成やルールを記述する`CLAUDE.md`がトークン消費量やモデル呼び出し回数に与える影響を実測した検証記事です。FastAPI + Reactのテンプレートを使用し、ログイン機能の調査タスクを通じて比較を行っています。
### 主な検証結果
- **API呼び出し数**: 14回から6回へと約57%減少。
- **合計トークン数**: 約67万から約36万へと約46%減少。
- **分析**: `CLAUDE.md`がインデックスとして機能することで、サブエージェント（Explore AI）による手探りのファイル探索が省略され、直接的なファイル読み取りに移行したことが大きな要因です。
### トークン節約のポイント
1. **モデルとの往復回数の削減**: ツール実行のたびに巨大なコンテキストが再送されるため、ターン数を減らすことが最もコスト削減に効きます。
2. **並列処理の活用**: 入口となるファイルを特定させることで、1ターンで複数のファイルを並列Readする効率的な挙動を誘発できます。
3. **インデックスとしての記述**: 実装の詳細ではなく、ディレクトリの役割や機能の入口ファイルを簡潔に書くことが、AIの調査経路を最適化する鍵となります。