ai-codex: Claude 토큰을 절약하기 위해 코드베이스를 사전 인덱싱하세요

ai-codex의 기능

ai-codex는 프로젝트를 스캔하여 Claude Code 대화를 위해 코드베이스를 사전 인덱싱하는 다섯 개의 간결한 마크다운 파일을 생성하는 단일 스크립트입니다. 이를 통해 Claude가 파일을 읽고, 디렉토리를 스캔하며, 함수를 확인하는 데 일반적으로 10-20개의 도구 호출을 소비하는 초기 탐색 단계를 제거합니다.

작동 방식

다음과 같은 파일을 생성하려면 npx ai-codex를 한 번 실행하세요:

• routes.md — 메서드와 인증 태그가 포함된 모든 API 경로
• pages.md — 클라이언트/서버 플래그가 포함된 전체 페이지 트리
• lib.md — 함수 시그니처가 포함된 모든 라이브러리 내보내기
• schema.md — 주요 필드만으로 압축된 데이터베이스 스키마
• components.md — 속성이 포함된 컴포넌트 인덱스

그런 다음 CLAUDE.md에 Claude가 이 파일들을 먼저 읽도록 지시하는 한 줄을 추가하세요. 이후 모든 대화는 탐색 단계를 완전히 건너뜁니다.

성능 영향

대규모 프로젝트에서 탐색 단계는 일반적으로 실제 작업이 시작되기 전에 30-50K 토큰을 소모합니다. 제작자의 예시 프로젝트에는 950개 이상의 API 경로와 255개의 DB 모델이 있었습니다:

• 코덱스 없음: 재무 모듈을 이해하기 위해 ~15번의 Serena/Read 호출
• 코덱스 사용: 사전 구축된 인덱스에 대한 5번의 grep 호출, 즉시 전체 파악 — 경로, 페이지, 스키마, 라이브러리 내보내기, 컴포넌트
• 모두 병렬로, 모두 2초 미만

기술적 세부사항

이 도구는 Next.js(앱 라우터 및 페이지 라우터) 및 일반 TypeScript 프로젝트와 함께 작동합니다. Prisma 스키마를 자동으로 감지합니다. 전체 도구는 Claude Code 자체에 의해 단일 대화 세션에서 설계 및 구축되었습니다. MIT 라이선스로 제공되며 GitHub에서 사용할 수 있습니다.