Claude Code 플러그인 제작: 지식 베이스를 위키로 컴파일하여 컨텍스트 토큰 84% 절감
Built a Claude Code plugin that turns your knowledge base into a compiled wiki - reduced my context tokens by 84%
핵심 요약
Claude Code에서 여러 마크다운 파일을 하나의 위키로 통합해 컨텍스트 토큰 사용량을 획기적으로 줄여주는 플러그인을 개발함.
- 토큰 최적화 — 여러 마크다운 파일을 하나의 위키로 통합하여 컨텍스트 토큰 사용량을 84% 절감함.
- 간편한 사용법 — 디렉토리 스캔 및 위키 컴파일 명령어를 통해 Claude가 자연스럽게 참조하도록 설계됨.
- 비파괴적 방식 — 기존 AGENTS.md나 CLAUDE.md를 수정하지 않고 별도의 위키 파일로 운영하여 안전함.
- 지식 관리 — 프로젝트 아이디어, 회의록 등 방대한 컨텍스트 파일을 효율적으로 관리할 수 있음.
Karpathy의 LLM 지식 베이스 관련 트윗을 기반으로 Claude Code 플러그인을 만들었음. 유용할 것 같아 공유함.
Claude와 작업할 때마다 회의록, 전략 문서, 메모 등 수많은 마크다운 파일을 세션 시작 시마다 읽어 들여야 했고, 토큰 비용이 빠르게 늘어났음. 이 플러그인은 그 모든 파일을 구조화된 위키로 컴파일해서, Claude가 20개의 원본 파일 대신 하나의 합성된 기사를 읽게 함. 내 경우 세션 시작 시 토큰 사용량이 약 47K에서 7.7K로 줄었음.
세 단계로 작동함: /wiki-init으로 스캔할 디렉토리를 설정하고, /wiki-compile로 위키를 빌드한 뒤, AGENTS.md에 참조를 추가하면 됨. 그 후에는 Claude가 별도의 명령어 없이 자연스럽게 이를 사용함.
이 방식에서 마음에 드는 점은 스테이징 접근 방식이라 AGENTS.md나 CLAUDE.md를 전혀 건드리지 않는다는 것임. 위키는 기존 설정 옆에 그냥 존재함. 검증해 보고 익숙해진 뒤에 확신이 들 때만 전환하면 됨. 롤백도 설정 필드 하나만 바꾸면 끝임.
아직 초기 단계라 원본 파일 대비 답변 품질을 공식적으로 벤치마킹하진 않았지만, 내 사용 경험상 정확했음.
GitHub: https://github.com/ussumant/llm-wiki-compiler
질문 환영함.
