ai-codex: コードベースを事前インデックス化してClaudeトークンを節約

ai-codexの機能

ai-codexは、プロジェクトをスキャンして5つのコンパクトなマークダウンファイルを生成し、Claude Codeとの会話のためにコードベースを事前にインデックス化する単一のスクリプトです。これにより、Claudeが通常ファイルを読み込んだり、ディレクトリをスキャンしたり、関数を確認したりするために10-20回のツール呼び出しを費やす初期探索フェーズが不要になります。

仕組み

npx ai-codexを一度実行して以下のファイルを生成します：

• routes.md — メソッドと認証タグ付きのすべてのAPIルート
• pages.md — クライアント/サーバーフラグ付きの完全なページツリー
• lib.md — 関数シグネチャ付きのすべてのライブラリエクスポート
• schema.md — 主要フィールドのみに圧縮されたデータベーススキーマ
• components.md — プロパティ付きのコンポーネントインデックス

次に、CLAUDE.mdに1行追加して、Claudeにこれらのファイルを最初に読むように指示します。これ以降のすべての会話では、探索フェーズが完全にスキップされます。

パフォーマンスへの影響

大規模なプロジェクトでは、探索フェーズで通常30-50Kトークンが消費されてから実際の作業が始まります。作成者の例示プロジェクトには950以上のAPIルートと255のDBモデルがありました：

• codexなし：財務モジュールを理解するために約15回のSerena/Read呼び出し
• codexあり：事前構築されたインデックスに対する5回のgrep呼び出し、瞬時の全体像把握 — ルート、ページ、スキーマ、ライブラリエクスポート、コンポーネント
• すべて並行処理、すべて2秒未満

技術詳細

このツールはNext.js（App Router & Pages Router）および汎用TypeScriptプロジェクトで動作します。Prismaスキーマを自動検出します。このツール全体は、Claude Code自体によって単一の会話セッションで設計・構築されました。MITライセンスで、GitHubで利用可能です。