lcc는 코딩 세션을 요약하지 않고 토큰을 줄인다

lcc(Local Context Compiler)는 Claude Code 세션에서 필요한 메시지는 원문 그대로 보존하고 오래된 도구 출력은 다시 불러올 수 있게 따로 보관해 컨텍스트를 줄이는 도구다. 제작자는 모델이 세션을 요약하는 /compact와 달리 사용자·어시스턴트 메시지를 바이트 단위로 유지한다고 설명한다.

제작자가 공개한 Claude Code 세션 하나(메시지 193개, 도구 호출 75회)에서는 rules, stashed 모드로 토큰 수가 57,083개에서 28,807개로 49.5% 줄었다. 사용자·어시스턴트 메시지 43개는 모두 원문 그대로 남았고, 도구 출력 33개는 recall로 복구할 수 있었다. 다만 제작자는 이 세션이 감축 효과가 큰 사례라고 밝혔다. 2026년 10월 23일 기준 메시지가 100개 이상인 본인 세션 299개(총 3,630만 토큰)에서는 중앙값 기준 감축률이 21.8%(중간 절반은 15~31%, 최고 65%)였다.

172건의 실제 요청을 대상으로 사전 등록한 시험에서는 stashed 컨텍스트와 recall을 쓴 에이전트의 파일 회상 성능이 전체 컨텍스트를 쓴 경우와 비슷했다고 제작자는 보고했다(차이 +0.006, 95% 신뢰구간 −0.023~+0.034, 토큰 36.6% 감소). 제거된 내용에 관한 질문의 90%에서 에이전트가 recall을 호출했다. 같은 세션을 바탕으로 재구현한 /compact 방식 요약은 정확한 값의 73%를 맞혔고, 전체 컨텍스트와 원문 그대로의 컨텍스트는 98%를 맞혔다. 시험의 근거 자료를 참고할 수 있다.

설치와 Claude Code 연동에는 Python 3.11 이상이 필요하다. 패키지 이름은 lcc가 아니라 local-context-compiler다. 최신 세션을 오프라인에서 측정하는 명령은 다음과 같다. 제작자는 이 명령이 개수만 출력하고 파일을 변경하거나 기기 밖으로 전송하지 않는다고 설명한다.

pip install "local-context-compiler[tiktoken]" # the CLI is `lcc`
lcc measure-session "$(ls -t ~/.claude/projects/*/*.jsonl | head -1)" # your latest session

Claude Code 플러그인은 내장 /compact 요약을 대체한다. 함수 훅은 얼리 액세스 기능이어서 Claude Code 2.1.274 이상과 아래 환경 변수 설정이 필요하다. 복구를 위해 mcp__plugin_lcc_lcc__recall을 허용해야 한다. 처리에 실패하거나 충분히 줄이지 못하면 플러그인은 내장 요약으로 넘기고 알림을 표시한다. 자세한 내용은 Claude Code 안내서에 있다.

export CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1
claude plugin marketplace add lucasmartins-ai/lcc
claude plugin install lcc@lcc --config provider=rules --config rulesMode=stashed

lcc는 Claude Code, Cursor, Claude Desktop 등 표준 입출력(stdio) 클라이언트에서 MCP 서버로도 쓸 수 있다. 사용 가능한 도구와 설정은 MCP 안내서를 참조하면 된다.

{"mcpServers": {"lcc": {"command": "lcc", "args": ["mcp"]}}}

제공자에 따라 처리 방식과 데이터 전송 조건이 다르다. rules는 모델 없이 로컬에서 작동하며, stashed 모드는 제거한 출력을 로컬 저장소에 보관해 recall로 복구한다. specialist-v3와 mechanical도 CPU에서 로컬로 실행된다. 반면 jev는 사용자가 명시적으로 선택해야 하는 원격 TypeSafe API 방식이며 TYPESAFE_API_KEY가 필요하다. auto는 키가 있어도 기본적으로 원격 제공자를 선택하지 않는다. 일반 텍스트는 LCC_AUTO_REMOTE=1을 설정하지 않는 한 mechanical을 사용한다. 결과를 신뢰하기 전에 보고서의 provider_used와 degraded를 확인해야 한다. 제공자별 설명은 SPECIALIST.md, TOOL_CALLS.md, JEV.md에 있다.

제작자가 밝힌 한계도 있다. lcc의 구조 검사 결과 PASS는 모델 답변의 정확성을 보증하지 않는다. 보호 규칙과 제한된 복구 기능이 있어도 근거가 사라질 가능성을 완전히 배제하지 못한다. specialist-v3는 Claude Code 대화 기록으로 학습돼 다른 에이전트나 일반 문서는 학습 범위 밖이며, 일반 텍스트는 Jev를 별도로 선택하지 않으면 mechanical을 쓴다. 감축 폭이 25% 미만이면 보고서에서 처리할 가치가 없다고 표시하고, Claude Code 플러그인은 내장 요약을 유지한다. 안전 모델은 관련 문서에 설명돼 있다.

프로젝트는 MIT 라이선스로 배포된다. 설치와 사용법은 저장소와 빠른 시작 안내서에서 확인할 수 있다.