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çãopages.md— árvore completa de páginas com flags de cliente/servidorlib.md— todas as exportações de bibliotecas com assinaturas de funçõesschema.md— esquema do banco de dados comprimido apenas para campos-chavecomponents.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.
📖 Read the full source: r/ClaudeAI
👀 See Also
Doc Harness: Uma Habilidade de Código do Claude para Manter o Estado do Projeto Entre Sessões
Doc Harness é uma habilidade do Claude Code que cria um sistema de documentação leve com cinco arquivos estruturados para ajudar agentes de IA a manter o contexto do projeto entre sessões. Ele aborda problemas como redefinições de contexto, regras esquecidas e a necessidade de reexplicar projetos para novos agentes.
Autoencoders de Linguagem Natural: Transformando Representações Internas de Claude em Texto
O Transformer Circuits Thread publica Natural Language Autoencoders que decodificam as ativações internas do Claude em texto legível. Repositório GitHub e demonstração interativa disponíveis.
O Modelo Distilled Qwen 3.5 27B Demonstra Forte Desempenho com o Agente de Codificação Cursor AI
Um usuário relata que a versão destilada opus 4.6 do Qwen 27B funciona efetivamente como o modelo que impulsiona o Cursor, com desempenho comparável ao Gemini 3 Flash. A configuração levou cerca de 10 minutos usando o Cursor para configurar o túnel ngrok e o localllama.
CostClaw: Painel Gratuito de Acompanhamento de Custos Locais para Agentes OpenClaw
CostClaw é um plugin local gratuito que captura todas as chamadas de LLM através dos ganchos nativos do OpenClaw e fornece um painel mostrando a distribuição de modelos, custos por sessão e gráficos de gastos por hora. O desenvolvedor descobriu que seu agente de heartbeat estava executando Claude Sonnet a cada 3 minutos 24/7, custando US$ 60/mês, e mudar para Haiku reduziu sua conta em ~65%.