概要
Claude の出力冗長性を約 63%削減 する CLAUDE.md ファイルについて解説 プロジェクト直下 に1ファイル配置するだけで、 コード変更不要 主な効果は 出力の簡素化 ・ 不要な定型文排除 高頻度自動化や大量出力 がある場面で効果大 入力トークン増加 と 出力トークン削減 のトレードオフ説明
Claude出力簡素化用CLAUDE.mdの概要
- CLAUDE.md は、 Claude Code の出力冗長性・お世辞・不要装飾を削減する設定ファイル
- プロジェクトルートに 1ファイル配置 するだけで即時有効、 コード修正不要
- 出力トークンコスト 削減が主目的(入力トークン消費は増加)
- ベンチマーク では平均 63%の出力削減 実績
- モデル非依存 設計、Claude以外のモデル(llama.cpp, Mistral等)では未検証
主な問題点とCLAUDE.mdによる解決策
- 冗長な冒頭挨拶 (例: "Sure!", "Great question!")→ 即回答 開始
- 不要な締めの挨拶 (例: "I hope this helps!")→ 禁止
- 質問の再掲 → 省略
- 装飾文字やUnicode (emダッシュ、スマートクォート等)→ ASCII出力強制
- AIとしての立場表明 や 不要な注意書き → 原則禁止
- 未依頼の提案 や 過剰な抽象化 → リクエスト範囲内のみ
- 誤情報への同意や曖昧な回答 → 「わからない」と明言
- ユーザー修正指摘の反映 → セッション内で即反映
- 冗長なファイル読み込み や スコープ逸脱 → 禁止
CLAUDE.mdが有効な場面・非推奨な場面
-
有効な場面
- 高頻度自動化パイプライン (例: レジュメボット・エージェントループ・コード生成)
- 繰り返し構造化出力 が求められるケース
- チームでの一貫した出力フォーマット 運用
-
非推奨な場面
- 単発・短文クエリ (毎回ファイル読込で入力トークン増加)
- カジュアルな一時利用
- 根本的な失敗(幻覚・設計逸脱) の修正(追加の制御が必要)
- セッションごとに新規起動するパイプライン
- 厳密な構造化出力 が必要な場合(APIのJSONモード等推奨)
- 議論や多様な提案が重要な作業 (上書き指示で回避可能)
ベンチマーク結果とコスト削減例
-
同一プロンプト での比較
- async/await解説: 180→65語(64%削減)
- コードレビュー: 120→30語(75%削減)
- REST API解説: 110→55語(50%削減)
- 幻覚訂正: 55→20語(64%削減)
- 合計465→170語、約384トークン削減/4プロンプト
-
コスト試算例(Claude Sonnet)
- 100プロンプト/日:約9,600トークン/日、約$0.86/月節約
- 1,000プロンプト/日:約96,000トークン/日、約$8.64/月節約
- 3プロジェクト合計:約288,000トークン/日、約$25.92/月節約
Before/After例
- Without CLAUDE.md
- 冗長な挨拶・提案・まとめ(120語)
- With CLAUDE.md
- バグ指摘と修正のみ (30語、75%削減)
CLAUDE.mdで防げる主な問題リスト
- お世辞的な冒頭文
- 無意味な締め文
- 質問の再掲
- Unicode装飾文字の混入
- AIとしての立場表明
- 不要な注意書き
- 未依頼の追加提案
- 過剰なコード抽象化
- 不明点での曖昧な回答
- ユーザー指摘の無視
- 冗長なファイル読込
- スコープ逸脱
運用・カスタマイズTips
- 失敗事例ごとに具体的なルール追加 が有効(例: エラー時は即停止・トレースバック出力)
- グローバル/プロジェクト/サブディレクトリ 単位でCLAUDE.mdを分割運用可能
- グローバル: トーン・フォーマット
- プロジェクト: 重要ファイルの編集制限
- サブディレクトリ: タスク固有ルール
プロファイルと導入方法
-
プロファイル例
- CLAUDE.md(汎用)
- profiles/CLAUDE.coding.md(開発・コードレビュー向け)
- profiles/CLAUDE.agents.md(自動化パイプライン向け)
- profiles/CLAUDE.analysis.md(データ分析・レポート向け)
-
導入手順
- 汎用: curl -o CLAUDE.md https://raw.githubusercontent.com/drona23/claude-token-efficient/main/CLAUDE.md
- プロファイル利用: git clone https://github.com/drona23/claude-token-efficient cp claude-token-efficient/profiles/CLAUDE.coding.md your-project/CLAUDE.md
- 手動コピー: レポジトリからCLAUDE.md内容をプロジェクト直下に配置
上書きルールとコミュニティ貢献
- ユーザー指示が最優先 (詳細説明や冗長出力を明示的に依頼した場合は従う)
- 改善案・新ルール提案歓迎 (issueで挙動・プロンプト・修正案を報告)
参考・クレジット
- Claudeコミュニティの実体験・要望 を元に構築
- 主要なGitHub issue・技術ブログ・ドキュメントを参照
- MITライセンス で自由利用・改変・配布可
- Drona Gangarapu による開発、PRやプロファイル追加も歓迎