╭──────────────────────────────────────────╮ ╭──────────────────────────────────────────╮ │ >>>>>>>>>>>>>>> ctx_read >>>>>>>>>>>> │ │ >>>>>>>>>>>>>>> ctx_read >>>>>>>>>>>> │ ┌─────────────┐ │ >>>>>>>>>>>>>>> compress >>>>>>>>>>>> │ ┌──────────┐ ┌─────────────┐ │ >>>>>>>>>>>>>>> compress >>>>>>>>>>>> │ ┌──────────┐ │ 100K tokens │ =========>│ >>> AST >>> cache >>> signal >>> │ =========> │ ~5K tok │ │ 100K tokens │ =========>│ >>> AST >>> cache >>> signal >>> │ =========> │ ~5K tok │ └─────────────┘ │ >>>>>>>>>>>>>>> filter >>>>>>>>>>>> │ └──────────┘ └─────────────┘ │ >>>>>>>>>>>>>>> filter >>>>>>>>>>>> │ └──────────┘ │ >>>>>>>>>>>>>>> dedupe >>>>>>>>>>>> │ │ >>>>>>>>>>>>>>> dedupe >>>>>>>>>>>> │ ╔══════════════╗ ╰──────────────────────────────────────────╯ ╔══════════╗ ╔══════════════╗ ╰──────────────────────────────────────────╯ ╔══════════╗ ║ raw input ║ ─ ─ ─ ─ ─ ─ ─ ─ LeanCTX ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ║ output ║ ║ raw input ║ ─ ─ ─ ─ ─ ─ ─ ─ LeanCTX ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ║ output ║ ╚══════════════╝ ╚══════════╝ ╚══════════════╝ ╚══════════╝ ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄ ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ │░░│ │░░│ │░░│ │░░│ │▓▓│ │▓▓│ │▓▓│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │▓▓│ │▓▓│ │▓▓│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ ───> │▓▓│ │▓▓│ │▓▓│ ───> │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ ───> │▓▓│ │▓▓│ │▓▓│ ───> │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ file file file file read cache send tok tok tok tok tok tok file file file file read cache send tok tok tok tok tok tok ╭──────────────────────────────────────────╮ ╭──────────────────────────────────────────╮ │ >>>>>>>>>>>>>>> ctx_read >>>>>>>>>>>> │ │ >>>>>>>>>>>>>>> ctx_read >>>>>>>>>>>> │ ┌─────────────┐ │ >>>>>>>>>>>>>>> compress >>>>>>>>>>>> │ ┌──────────┐ ┌─────────────┐ │ >>>>>>>>>>>>>>> compress >>>>>>>>>>>> │ ┌──────────┐ │ 100K tokens │ =========>│ >>> AST >>> cache >>> signal >>> │ =========> │ ~5K tok │ │ 100K tokens │ =========>│ >>> AST >>> cache >>> signal >>> │ =========> │ ~5K tok │ └─────────────┘ │ >>>>>>>>>>>>>>> filter >>>>>>>>>>>> │ └──────────┘ └─────────────┘ │ >>>>>>>>>>>>>>> filter >>>>>>>>>>>> │ └──────────┘ │ >>>>>>>>>>>>>>> dedupe >>>>>>>>>>>> │ │ >>>>>>>>>>>>>>> dedupe >>>>>>>>>>>> │ ╔══════════════╗ ╰──────────────────────────────────────────╯ ╔══════════╗ ╔══════════════╗ ╰──────────────────────────────────────────╯ ╔══════════╗ ║ raw input ║ ─ ─ ─ ─ ─ ─ ─ ─ LeanCTX ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ║ output ║ ║ raw input ║ ─ ─ ─ ─ ─ ─ ─ ─ LeanCTX ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ║ output ║ ╚══════════════╝ ╚══════════╝ ╚══════════════╝ ╚══════════╝ ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄ ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ │░░│ │░░│ │░░│ │░░│ │▓▓│ │▓▓│ │▓▓│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │▓▓│ │▓▓│ │▓▓│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ ───> │▓▓│ │▓▓│ │▓▓│ ───> │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ ───> │▓▓│ │▓▓│ │▓▓│ ───> │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ file file file file read cache send tok tok tok tok tok tok file file file file read cache send tok tok tok tok tok tok

Claude Code을 위한 LeanCTX

Claude Code는 탁월하다.
하지만 토큰 비용은 아니다.

LeanCTX를 사용하면 MCP 도구 및 셸 후크를 통해 Claude Code의 토큰 비용을 60–90% 절감할 수 있습니다: 압축된 AST 인식 읽기, 약 13 토큰의 캐시 재읽기, 그리고 88–99% 작은 명령어 출력. 세션이 노이즈 대신 신호로 채워져 더 오래 유지됩니다. 설정은 단 하나의 명령어로 완료됩니다: lean-ctx setup.

무료 설치 30개 이상의 모든 도구

문제점

Claude Code이 소비하는 곳 토큰입니다.

작업 중간에 플랜 제한 도달

긴 에이전트 세션은 모든 파일 읽기 및 bash 호출이 원본 그대로 창에 기록되면서 사용량 한도를 빠르게 소진합니다.

압축 과정에서 맥락 상실

창이 가득 차면, 압축 기능은 여전히 필요한 세부 정보까지 요약해 버립니다. 그러면 에이전트는 방금 잊어버린 내용을 다시 읽게 됩니다.

Bash 출력이 기록을 지배하다

단 한 번의 테스트 실행이나 설치만으로도 코드 변경 자체보다 더 많은 토큰 비용이 발생할 수 있습니다.

통합

LeanCTX가 연결되는 방식 Claude Code.

Claude 설정에 MCP 서버 등록

lean-ctx 설정은 Claude Code용 MCP 서버를 등록합니다. 기본적으로 ~13개의 lean-core 도구(ctx_read, ctx_search, ctx_shell 등)를 제공하며, 전체 81-도구 카탈로그는 ctx_call / ctx_expand를 통해 온디맨드로 사용할 수 있습니다.

CLAUDE.md 가이드라인 설치 완료

Setup은 tool-preference 규칙을 작성하여 Claude Code가 압축된 읽기를 우선적으로 사용하도록 합니다. 모든 세션에서 자동으로 적용됩니다.

재시작 간 세션 메모리 유지

발견 사항, 결정 및 진행 상황이 로컬 지식 저장소에 지속적으로 보존되며 새 세션으로 복원됩니다: 재설명할 필요가 줄고, 재읽을 필요도 줄어듭니다.

Setup

단일 명령어로. 자동 감지됨.

# LeanCTX 설치

$ curl -fsSL https://leanctx.com/install.sh | sh

# Claude Code 자동 감지 및 MCP + CLAUDE.md 구성

$ lean-ctx setup

# 연결 상태 확인

$ lean-ctx doctor

# 세션 저장 내용 확인

$ lean-ctx gain

변화점

세 가지 순간 알게 될 것입니다.

압축되지 않는 세션

읽기 데이터가 60–90% 작아져 창이 5–10배 느리게 채워집니다. 긴 작업은 압축이 발생하기 전에 완료됩니다.

지속되는 메모리

내일의 세션은 어제의 학습 내용을 로컬 지식 저장소에서 복원하여 시작합니다. 디스크에서 다시 읽어올 필요가 없습니다.

검증 가능한 영수증

모든 저장은 Ed25519 서명된 원장에 기록됩니다. lean-ctx의 이점은 감사할 수 있는 숫자입니다.

FAQ

Claude Code + LeanCTX, 답변을 얻다.

Claude Code 토큰 사용량과 비용을 줄이려면 어떻게 해야 하나요?

LeanCTX를 설치한 후 lean-ctx setup을 실행하세요. Claude Code는 읽기 데이터를 60–90% 압축하는 MCP 도구를 얻고, 캐시된 재읽기는 약 13 토큰으로 줄이며, bash 출력을 88–99% 축소하여 일반적으로 플랜 제한을 몇 배로 늘립니다.

LeanCTX가 Claude Code의 자체 컨텍스트 관리에 간섭하나요?

아닙니다. LeanCTX는 상위에서 작동합니다: 애초에 창으로 들어오는 데이터를 축소하여 압축이 나중에 발생하거나 아예 일어나지 않게 합니다. Claude Code의 자체 메커니즘은 변경 없이 계속 작동합니다.

CLI와 VS Code 확장 프로그램 모두에서 작동하나요?

네. 동일한 구성을 읽는 모든 Claude Code 인터페이스는 동일한 MCP 서버, 캐시 및 원장을 사용합니다.

컨텍스트를 다양한 종류의 작업에 맞게 조정할 수 있나요?

예. 내장 Context Personas(코딩, 연구, 지원, 데이터 분석, 리드 생성)가 도메인별로 전체 컨텍스트 표면을 재구성합니다: 도구 세트, 읽기 모드, 압축 및 의도 분류법. 연구 세션과 코딩 세션은 동일한 설치에서 서로 다른 튜닝된 컨텍스트를 얻습니다. 하나의 설정(LEAN_CTX_PERSONA)으로 전환할 수 있으며, 재프롬프트가 필요하지 않습니다.

직장에서 사용하시나요?

Team은 조직 전체에 공유되고 감사 가능한 컨텍스트 플레인을 제공하며, 원장은 재무팀에 절감액을 증명합니다. 로컬 사용은 CI를 통해 영구적으로 무료로 유지됩니다.

무료 설치 Team 요금제 보기

Claude Code는 탁월하다.하지만 토큰 비용은 아니다.