Built a local pre-processing plugin for Claude Code after research & measuring real metrics (3,500+ tests, v1.22.1) — Looking for feedback & ideas

개요

개발자가 Claude Code의 로컬 사전 처리 플러그인인 chamnan을 개발했으며, 3,500개 이상의 테스트를 거쳐 v1.22.1 버전에 도달했으며 커뮤니티의 피드백과 아이디어를 구하고 있습니다.

주요 내용

* 개발 배경: 대규모 복잡한 프로젝트에서 Claude Code 사용 시 컨텍스트, 토큰 소모, 보안에 대한 더 나은 제어가 필요했습니다. 시중의 다양한 플러그인을 테스트했으나 실제 사용 환경에서 기대와 다른 결과가 발생하는 것을 확인했습니다. 특히 민감한 코드베이스를 다루기에 예측 가능하고 안전한 로컬 사전 처리 레이어를 구축할 필요성을 느꼈습니다.
* 개발 과정 및 노력: 단순한 헬퍼 스크립트로 시작했으나 컨텍스트 유지, 토큰 예산 관리, 로컬 마스킹을 개선하기 위해 1,000개 이상의 논문과 기술 문서를 검토하며 엔지니어링 노력을 기울였습니다. 엣지 케이스(암묵적 컨텍스트 손실, 오탐, 크로스 플랫폼 경로 문제, 상태 드리프트)를 해결하기 위해 "테스트로 증명될 때까지 버그가 수정되었다고 믿지 않는다"는 원칙을 적용했습니다.
* 플러그인 기능 (chamnan):
* 결정론적 컨텍스트 예산 관리: Claude Code에 전달하기 전에 리포지토리 컨텍스트를 미리 색인화하고 트리밍하여 실제 테스트에서 Quick Index 오버헤드를 크게 줄였습니다.
* 로컬 보안 및 마스킹: 로컬에서 비밀 정보 및 내부 문자열을 스크러빙하여 외부로 유출되지 않도록 합니다.
* 에이전트 연속성 / 메모리: 세션 결정, 학습 내용, 프로젝트 기록을 .chamnan/ 내부에 로컬로 저장하여 Claude Code가 세션 간 아키텍처를 재발견하는 데 토큰을 낭비하지 않도록 합니다.
* Monorepo 및 Multi-adapter 지원: 중첩된 체크아웃, 복잡한 디렉토리 구조, OS별 엣지 케이스를 깔끔하게 처리하도록 설계되었습니다.
* 기술 스택: 순수 Python으로 작성되었으며 표준 라이브러리만 사용하고 외부 패키지는 전혀 사용하지 않았습니다.
* 피드백 요청: 개발자는 이 플러그인을 매일 사용하지만, 대규모 또는 개인 정보 보호에 민감한 프로젝트를 다루는 다른 개발자들과 공유하기 위해 개발되었으므로 커뮤니티의 의견을 받고 싶어 합니다. 과거 Claude Code 워크플로우를 망가뜨렸던 엣지 케이스나 리포지토리 구조, 또는 로컬 헬퍼 플러그인에서 보고 싶은 안전 검증 및 컨텍스트 기능에 대한 피드백을 구합니다.

시사점

chamnan 플러그인은 Claude Code와 같은 LLM 기반 도구를 대규모 및 보안에 민감한 프로젝트에 보다 안정적이고 안전하게 통합할 수 있는 로컬 사전 처리 및 신뢰성 레이어를 제공합니다. 이는 개발자가 LLM의 컨텍스트 관리 및 보안에 대한 우려를 해소하며 워크플로우 효율성을 높이는 데 기여할 수 있습니다.