ai-codex: Предварительно индексируйте свою кодовую базу, чтобы экономить токены Claude

Что делает ai-codex

ai-codex — это единый скрипт, который сканирует ваш проект и генерирует пять компактных markdown-файлов для предварительного индексирования кодовой базы для разговоров с Claude Code. Это устраняет начальную фазу исследования, где Claude обычно тратит 10–20 вызовов инструментов на чтение файлов, сканирование директорий и проверку функций.

Как это работает

Вы запускаете npx ai-codex один раз, чтобы сгенерировать эти файлы:

• routes.md — каждый API-маршрут с методами и тегами аутентификации
• pages.md — полное дерево страниц с флагами клиент/сервер
• lib.md — все экспорты библиотек с сигнатурами функций
• schema.md — схема базы данных, сжатая до ключевых полей
• components.md — индекс компонентов с пропсами

Затем добавьте одну строку в ваш CLAUDE.md, указывая Claude сначала прочитать эти файлы. Каждый последующий разговор полностью пропускает фазу исследования.

Влияние на производительность

В больших проектах фаза исследования обычно расходует 30–50 тыс. токенов до начала реальной работы. В примере создателя проекта было 950+ API-маршрутов и 255 моделей БД:

• Без codex: ~15 вызовов Serena/Read для понимания финансового модуля
• С codex: 5 вызовов grep по предварительно построенному индексу, мгновенное полное представление — маршруты, страницы, схема, экспорты библиотек, компоненты
• Всё параллельно, всё менее чем за 2 секунды

Технические детали

Инструмент работает с Next.js (App Router и Pages Router) и обычными TypeScript-проектами. Он автоматически определяет схемы Prisma. Весь инструмент был спроектирован и построен самим Claude Code в рамках одного сеанса разговора. Он распространяется под лицензией MIT и доступен на GitHub.