ai-codex : Pré-indexez votre base de code pour économiser des tokens Claude

Ce que fait ai-codex

ai-codex est un script unique qui analyse votre projet et génère cinq fichiers markdown compacts pour pré-indexer votre base de code pour les conversations avec Claude Code. Cela élimine la phase d'exploration initiale où Claude passe typiquement 10 à 20 appels d'outils à lire des fichiers, scanner des répertoires et vérifier des fonctions.

Comment ça fonctionne

Vous exécutez npx ai-codex une fois pour générer ces fichiers :

• routes.md — chaque route API avec les méthodes et les étiquettes d'authentification
• pages.md — l'arborescence complète des pages avec les indicateurs client/serveur
• lib.md — toutes les exportations de bibliothèque avec les signatures de fonction
• schema.md — le schéma de base de données compressé aux champs clés uniquement
• components.md — l'index des composants avec leurs propriétés

Ensuite, ajoutez une ligne à votre CLAUDE.md indiquant à Claude de lire ces fichiers en premier. Chaque conversation future saute entièrement la phase d'exploration.

Impact sur les performances

Sur les grands projets, la phase d'exploration consomme typiquement 30 à 50 000 tokens avant que tout travail réel ne commence. Le projet exemple du créateur comportait plus de 950 routes API et 255 modèles de base de données :

• Sans codex : ~15 appels Serena/Read pour comprendre le module financier
• Avec codex : 5 appels grep sur l'index pré-construit, une vue complète instantanée — routes, pages, schéma, exportations de bibliothèque, composants
• Tout en parallèle, tout en moins de 2 secondes

Détails techniques

L'outil fonctionne avec Next.js (App Router & Pages Router) et les projets TypeScript génériques. Il détecte automatiquement les schémas Prisma. L'outil entier a été conçu et construit par Claude Code lui-même en une seule session de conversation. Il est sous licence MIT et disponible sur GitHub.