claude-code-md-hook は何をしますか？
ファイル読み取りをMarkdownと構造インデックスに変換し、Claude Codeが大きなPDF、DOCX、XLSX、PPTX、HTMLで使用するコンテキストを削減します。
概要
このフックは、Claude Codeが大きなファイルを読み取る際に、ファイル内容をMarkdown形式と構造インデックスに変換します。これにより、トークン消費を大幅に削減し、コンテキストウィンドウを効率的に使用できます。
対応ファイル形式
- DOCX (Word文書)
- XLSX (Excelスプレッドシート)
- PPTX (PowerPointプレゼンテーション)
- HTML
仕組み
- Claude Codeがファイルを読み取ろうとすると、このフックが作動します。
- ファイルをMarkdownに変換し、構造インデックスを生成します。
- インデックスは、章、段落、表、画像などの構造情報を含みます。
- 生成されたMarkdownとインデックスがClaude Codeに渡され、コンテキスト使用量が最小限に抑えられます。
使用方法
Claude Codeの設定ファイル（例：.claude/settings.json）に、このフックを登録してください。
{
"hooks": {
"read": "gay-erythroblastosisfetalis55/claude-code-md-hook"
}
}
利点
- コンテキスト削減: 大きなファイルでも、必要な情報だけが抽出されるため、トークン消費が減ります。
- 構造化された情報: ファイルの構造が保持されるため、Claude Codeが内容を理解しやすくなります。
- 効率的な検索: インデックスにより、特定のセクションや要素に素早くアクセスできます。
注意事項
- すべてのファイル形式で完全な変換が保証されるわけではありません。複雑なレイアウトや特殊な要素は、一部情報が失われる可能性があります。
- 変換処理には多少の時間がかかる場合があります。特に大きなファイルでは顕著です。
- このフックはClaude Codeの環境でのみ動作します。