ai-codex: Indizieren Sie Ihre Codebasis im Voraus, um Claude-Tokens zu sparen

Was ai-codex tut

ai-codex ist ein einzelnes Skript, das Ihr Projekt scannt und fünf kompakte Markdown-Dateien generiert, um Ihren Codebestand für Claude-Code-Konversationen vorzuindizieren. Dadurch entfällt die anfängliche Erkundungsphase, in der Claude normalerweise 10-20 Tool-Aufrufe damit verbringt, Dateien zu lesen, Verzeichnisse zu scannen und Funktionen zu überprüfen.

Wie es funktioniert

Sie führen npx ai-codex einmal aus, um diese Dateien zu generieren:

• routes.md — jede API-Route mit Methoden und Auth-Tags
• pages.md — vollständige Seitenstruktur mit Client/Server-Flags
• lib.md — alle Bibliotheksexporte mit Funktionssignaturen
• schema.md — Datenbankschema auf Schlüsselfelder komprimiert
• components.md — Komponentenindex mit Props

Fügen Sie dann eine Zeile in Ihre CLAUDE.md ein, die Claude anweist, diese Dateien zuerst zu lesen. Jede zukünftige Konversation überspringt die Erkundungsphase vollständig.

Leistungsauswirkung

Bei großen Projekten verbraucht die Erkundungsphase normalerweise 30-50K Tokens, bevor echte Arbeit beginnt. Das Beispielprojekt des Erstellers hatte 950+ API-Routen und 255 DB-Modelle:

• Ohne codex: ~15 Serena/Read-Aufrufe, um das Finanzmodul zu verstehen
• Mit codex: 5 grep-Aufrufe auf dem vorab erstellten Index, sofortiges vollständiges Bild — Routen, Seiten, Schema, Bibliotheksexporte, Komponenten
• Alles parallel, alles unter 2 Sekunden

Technische Details

Das Tool funktioniert mit Next.js (App Router & Pages Router) und generischen TypeScript-Projekten. Es erkennt Prisma-Schemata automatisch. Das gesamte Tool wurde von Claude Code selbst in einer einzigen Konversationssitzung entworfen und gebaut. Es ist MIT-lizenziert und auf GitHub verfügbar.