Codesight CLI는 코드베이스를 스캔하여 AI 코딩 에이전트의 토큰 사용량을 줄입니다.

Codesight의 기능
Codesight는 코드베이스를 스캔하여 AI 어시스턴트를 위한 간결한 컨텍스트 팩을 생성하는 CLI 도구로, .codesight/ 디렉터리에 저장됩니다. 이는 Claude Code와 같은 AI 코딩 에이전트가 각 대화 시작 시 동일한 파일을 반복적으로 탐색하는 것을 방지하며, 이는 일반적으로 실제 작업 시작 전에 25K–60K 토큰을 소비합니다.
작동 방식
리포지토리 루트에서 npx codesight를 실행하세요. 이 도구는 정규식 대신 AST/구조적 파싱을 사용하여 TypeScript(Next.js, Express, Fastify, Hono, Nest, tRPC, React), Python(FastAPI, Django, SQLAlchemy), Go(Gin, Gorm) 스택을 스캔합니다. 여러 파일을 생성합니다:
CODESIGHT.md– 아키텍처 및 주요 진입점에 대한 1–2k 토큰 개요routes.md– 메서드, 경로, 태그가 포함된 모든 API 경로schema.md– 주요 필드 및 관계가 포함된 데이터베이스 모델components.md– UI 컴포넌트 및 속성env.md– 사용 위치 및 누락된 기본값이 포함된 환경 변수graph.md– "핫" 파일 및 영향 범위 분석이 포함된 임포트 그래프
영향 범위 분석은 임포트 그래프를 탐색하여 특정 파일에 의존하는 정확한 파일, 경로, 모델을 보여주어 "이것을 변경하면 무엇이 깨질까?"라는 질문에 답하는 데 도움을 줍니다.
통합
CLAUDE.md에 한 줄을 추가하여 Claude가 트리를 탐색하기 전에 .codesight/CODESIGHT.md 및 관련 파일을 읽도록 지시하세요. 이 도구는 MCP 서버 및 Claude Code, Cursor, Codex, Copilot을 위한 사전 구성된 프로필을 제공하므로, 이러한 도구들은 .codesight를 높은 우선순위 컨텍스트로 취급합니다.
벤치마크
실제 프로덕션 코드베이스의 버전 1.3.1 벤치마크:
- SaveMRR(Hono + Drizzle, 4 작업 공간, 92 파일): 5,129 출력 토큰 대 66,040 예상 탐색 토큰(12.9배 감소)
- BuildRadar(raw HTTP + Drizzle, 53 파일): 3,945 출력 토큰 대 46,020 예상 탐색 토큰(11.7배 감소)
- 이들 평균: ≈12.3배 토큰 감소
TypeScript/Next 백엔드에서, 긴 "이해 + 기능 추가 + 변경 사항 검토" 세션에서 Claude가 트리를 탐색하는 대신 Codesight 파일을 읽을 때 40–50K 토큰의 탐색이 회피되었습니다.
기술적 세부사항
런타임 의존성이 없는 단일 npx 바이너리. MIT 라이선스. GitHub에서 https://github.com/Houseofmvps/codesight에서 이용 가능.
📖 Read the full source: r/ClaudeAI
👀 See Also

CLAUDE.md 구성 관리를 위한 두 가지 Claude 코드 스킬
한 개발자가 CLAUDE.md 설정을 처리하기 위해 두 가지 Claude Code 스킬을 만들었습니다: /cc-init는 새 프로젝트를 위한 간결한 설정을 생성하고, /cc-optimize는 기존 프로젝트의 불필요한 부분과 문제점을 분석합니다. 둘 다 컨텍스트 오버헤드를 줄이고 지시 사항 준수를 개선하는 것을 목표로 합니다.

Argus: 실시간 클로드 코드 관측을 위한 오픈소스 VS Code 확장
Argus는 VS Code 내에서 Claude Code 에이전트의 단계를 실시간으로 시각화하여 타임라인, 종속성 그래프, 비용/루프 탐지를 제공, 토큰 낭비 행동을 디버깅합니다.
mcp-memory: SQLite FTS5 + Google의 OKF를 이용한 빠른 에이전트 메모리
mcp-memory는 Google의 OKF 형식과 SQLite FTS5를 사용하여 하위 20ms 조회를 제공하는 AI 에이전트용 영구 메모리 MCP 서버입니다. memory_store, memory_retrieve, memory_search, memory_get_last의 네 가지 도구를 포함합니다.

클로드 코드용 맞춤 출력 스타일 컬렉션
한 개발자가 클로드 코드를 위한 13가지 맞춤형 출력 스타일을 만들어 AI의 동작을 시스템 프롬프트를 통해 수정했습니다. 이 스타일에는 잔인한 코드 비판을 위한 '로스트', 안내형 질문을 위한 '소크라테스', 적대적 테스트를 위한 '브레이커', 실용적 해결책을 위한 '십 잇', 보안 중심을 위한 '파라노이드', 테스트 주도 개발을 위한 'TDD' 등이 포함됩니다.