ai-codex: Pré-indexe sua base de código para economizar tokens do Claude

O que o ai-codex faz

ai-codex é um único script que escaneia seu projeto e gera cinco arquivos compactos em markdown para pré-indexar seu código para conversas com o Claude Code. Isso elimina a fase inicial de exploração onde o Claude normalmente gasta 10-20 chamadas de ferramentas lendo arquivos, escaneando diretórios e verificando funções.

Como funciona

Você executa npx ai-codex uma vez para gerar estes arquivos:

• routes.md — cada rota da API com métodos e tags de autenticação
• pages.md — árvore completa de páginas com flags de cliente/servidor
• lib.md — todas as exportações de bibliotecas com assinaturas de funções
• schema.md — esquema do banco de dados comprimido apenas para campos-chave
• components.md — índice de componentes com props

Depois adicione uma linha ao seu CLAUDE.md dizendo ao Claude para ler estes arquivos primeiro. Todas as conversas futuras pulam completamente a fase de exploração.

Impacto no desempenho

Em projetos grandes, a fase de exploração normalmente consome 30-50K tokens antes de qualquer trabalho real começar. O projeto de exemplo do criador tinha 950+ rotas da API e 255 modelos de banco de dados:

• Sem codex: ~15 chamadas Serena/Read para entender o módulo financeiro
• Com codex: 5 chamadas grep no índice pré-construído, visão completa instantânea — rotas, páginas, esquema, exportações de bibliotecas, componentes
• Tudo em paralelo, tudo em menos de 2 segundos

Detalhes técnicos

A ferramenta funciona com Next.js (App Router & Pages Router) e projetos TypeScript genéricos. Ela detecta automaticamente esquemas do Prisma. A ferramenta inteira foi projetada e construída pelo próprio Claude Code em uma única sessão de conversa. É licenciada sob MIT e disponível no GitHub.