ai-codex: Pre-indexa tu base de código para ahorrar tokens de Claude

Qué hace ai-codex

ai-codex es un único script que escanea tu proyecto y genera cinco archivos compactos en markdown para pre-indexar tu base de código para conversaciones con Claude Code. Esto elimina la fase de exploración inicial donde Claude normalmente gasta 10-20 llamadas a herramientas leyendo archivos, escaneando directorios y verificando funciones.

Cómo funciona

Ejecutas npx ai-codex una vez para generar estos archivos:

• routes.md — cada ruta de API con métodos y etiquetas de autenticación
• pages.md — árbol completo de páginas con indicadores de cliente/servidor
• lib.md — todas las exportaciones de biblioteca con firmas de funciones
• schema.md — esquema de base de datos comprimido solo a campos clave
• components.md — índice de componentes con propiedades

Luego agrega una línea a tu CLAUDE.md diciéndole a Claude que lea estos archivos primero. Cada conversación futura omite completamente la fase de exploración.

Impacto en el rendimiento

En proyectos grandes, la fase de exploración normalmente consume 30-50K tokens antes de que comience cualquier trabajo real. El proyecto de ejemplo del creador tenía 950+ rutas de API y 255 modelos de base de datos:

• Sin codex: ~15 llamadas Serena/Read para entender el módulo de finanzas
• Con codex: 5 llamadas grep en el índice preconstruido, imagen completa instantánea — rutas, páginas, esquema, exportaciones de biblioteca, componentes
• Todos en paralelo, todos en menos de 2 segundos

Detalles técnicos

La herramienta funciona con Next.js (App Router & Pages Router) y proyectos genéricos de TypeScript. Detecta automáticamente esquemas de Prisma. Toda la herramienta fue diseñada y construida por Claude Code mismo en una única sesión de conversación. Tiene licencia MIT y está disponible en GitHub.