nadimtuhin/claude-token-optimizer

解決する問題

Claude Code は起動時に過剰なドキュメント、セッションメモ、タスク履歴を読み込むことが多く、コンテキストウィンドウの大部分を消費します。このプロジェクトは、プロジェクトドキュメントを再構成することで、Claude が起動時に必要なファイルのみを読み込むシステムを提供し、実際のコードに数千トークンを割り当てられるようにします。

動作方法

このツールは、特定のファイル階層と .claudeignore ファイルを使用して、構造化されたドキュメントアプローチを実装し、不要なドキュメントの自動読み込みを防ぎます。単一の巨大なドキュメントファイルを、4つのコアファイルに置き換えます：CLAUDE.md、COMMON_MISTAKES.md、QUICK_START.md、ARCHITECTURE_MAP.md。

主な機能：

• フレームワーク対応の初期化：cto init はプロジェクトのフレームワーク（例：Next.js、Django、Go）を自動検出し、関連するベストプラクティスと一般的なミスを適用します。
• トークン測定：cto measure は自動読み込みされるファイルのトークンコストを推定します。
• メンテナンスツール：cto compress と cto prune は、決定論的なルールを使用して CLAUDE.md のサイズを削減します。
• コンテキストインジェクションフック：シェルスクリプトで、Claude Code のフックに統合可能。ユーザーのプロンプトに応じて docs/learnings/ からトピック固有のドキュメントを動的に読み込み、未使用のファイルにはゼロトークンコストを確保します。

対象ユーザー

Claude Code を使用し、自動読み込みドキュメントから需要駆動型読み込みシステムに移行することで、コンテキストウィンドウを最適化し、トークン使用量を削減したい開発者。

特徴

• 顕著なトークン削減：起動時のトークン使用量が通常83〜87％削減されます。
• フレームワーク対応：13の主要なフレームワーク用に事前に定義されたパターンがあります。
• CI対応の監査：cto audit はドキュメント構造の健全性チェックを提供し、CI/CDパイプラインで機械可読なJSON出力を生成します。
• 動的コンテキストインジェクション：ユーザーのプロンプトと docs/learnings/ 内のファイル名を照合し、必要な場合にのみコンテキストをインジェクトします。