Claude-context-lintでトークンオーバーヘッドを削減する方法

機能概要

claude-context-lintは、ユーザー入力前に発生する隠れたコンテキストトークン消費を明らかにするためにClaude Codeプロジェクトを分析します。すべてのClaude Code会話は、CLAUDE.mdファイル、スキル記述、MCPツールスキーマ、基本システムプロンプトからのオーバーヘッドで始まり、これらはすべて即座にコンテキストトークンを消費します。

主な機能と発見

このツールは、CLAUDE.mdファイル、スキル、MCP設定、システムプロンプトをスキャンします。スキルが毎回完全に読み込まれるわけではないことを考慮して、ターンごとのトークンコストと起動時コストを表示します。トークンを浪費するほぼ重複したスキルを検出し、ツールの読み込みを遅延させるためにToolSearchを使用できるMCPサーバーにフラグを立てます。

開発者のテストによると、200Kのコンテキストウィンドウの18%が最初のターンの前に消費されました。最大の要因は、MCPサーバーがツールスキーマを遅延させる代わりに一括で読み込むことでした。

出力例

Claude Code コンテキスト監査
─────────────────────────────
CLAUDE.md 1,240 トークン
スキル (32 読み込み済み) 4,800 トークン 中程度
⚠ ほぼ重複するスキルが3つ検出されました
MCPサーバー (3) 14,100 トークン 重大
postgres 6,600 トークン (22 ツール) [常時読み込み]
システムプロンプト 8,500 トークン (基本オーバーヘッド)
─────────────────────────────
合計オーバーヘッド: 28,640 トークン
入力前使用量: 14.3%

具体的な推奨事項

このツールは、トークン節約見積もりを含む具体的な推奨事項を生成します。出力例では、以下の提案を行っています:

「postgres」MCPでToolSearchを有効化 → −6,270 トークン
12の冗長なスキル記述を短縮 → −1,840 トークン
潜在的な節約: 8,530 トークン (29.8%削減)

インストールと使用方法

インストール不要で実行: npx claude-context-lint

.claude/ディレクトリがある任意のプロジェクトで実行できます。スキャンは約2秒かかります。

技術詳細

このツールは、https://www.npmjs.com/package/claude-context-lint および https://github.com/skibidiskib/claude-context-lint で利用可能です。完全にClaude Codeによって構築され、MITライセンスで提供されています。

📖 完全なソースを読む: r/ClaudeAI