목차
Context Mode는 AI 코딩 에이전트의 컨텍스트 윈도우 낭비 문제를 4가지 방향에서 동시에 해결하는 MCP 서버다. Playwright 스냅샷 하나에 56 KB, GitHub 이슈 20개에 59 KB — 30분 작업 후 컨텍스트의 40%가 사라지는 문제를 샌드박스 도구, SQLite 세션 추적, 코드 기반 분석, 출력 압축으로 근본적으로 해결한다. Hacker News 1위(570+ 포인트)에 오르며 Microsoft·Google·Meta·Amazon·NVIDIA 등의 팀에서 사용된다고 알려져 있다.
문제: 컨텍스트는 4방향에서 소모된다
AI 코딩 에이전트가 작업할수록 컨텍스트가 줄어드는 이유는 한 가지가 아니다:
- 도구 출력 홍수 — MCP 툴콜 결과가 그대로 컨텍스트에 쌓인다. 315 KB짜리 Playwright 스냅샷이 통째로 들어간다.
- 컴팩션 후 기억 소실 — 에이전트가 대화를 압축하면 편집 중인 파일, 진행 중인 작업, 마지막 요청을 잊는다.
- LLM을 데이터 프로세서로 오용 — 파일 50개를 읽어 함수 개수를 세는 대신, 스크립트를 짜서 결과만 출력하면 100배 컨텍스트가 절약된다.
- 장황한 응답 출력 — 인사말, 설명, 부연으로 출력 토큰이 낭비된다.
해결: 4방향 동시 대응
| 문제 | 해결 방식 | 절약 효과 |
|---|---|---|
| 도구 출력 홍수 | 샌드박스 툴이 원본 데이터를 컨텍스트 밖에 격리, BM25로 필요한 부분만 검색 | 315 KB → 5.4 KB (98% 감소) |
| 컴팩션 후 기억 소실 | 파일 편집·git 작업·태스크·에러를 SQLite에 추적, 컴팩션 시 FTS5 인덱싱 후 관련 이벤트만 복원 | 세션 연속성 유지 |
| LLM 데이터 프로세서 오용 | ctx_execute()로 분석 스크립트를 실행하고 console.log() 결과만 수신 | 47 × Read() = 700 KB → 1 × ctx_execute() = 3.6 KB |
| 장황한 응답 | “동굴인처럼 짧게” — 기술 정확도는 유지하면서 군더더기·경어·부연 제거 | 출력 토큰 65–75% 절약 |
Think in Code 패러다임
Context Mode의 핵심 철학: LLM은 데이터를 처리하는 게 아니라 분석 코드를 작성하는 역할이다.
// Before: 47 × Read() = 700 KB
// After: 1 × ctx_execute() = 3.6 KB
ctx_execute("javascript", `
const files = fs.readdirSync('src').filter(f => f.endsWith('.ts'));
files.forEach(f => console.log(f + ': ' +
fs.readFileSync('src/'+f,'utf8').split('\\n').length + ' lines'));
`);주요 MCP 도구
| 도구 | 역할 |
|---|---|
ctx_batch_execute | 여러 명령어를 한 번에 실행·인덱싱·검색 (주 리서치 도구) |
ctx_execute | 분석용 스크립트 실행 (JavaScript·Python·Bash 등) |
ctx_execute_file | 파일 기반 스크립트 실행 |
ctx_search | FTS5 기반 지식베이스 검색 (여러 쿼리 병렬 처리) |
ctx_fetch_and_index | URL 페이지 fetch 후 인덱싱 |
ctx_index | 파일·디렉터리를 수동 인덱싱 |
ctx_stats | 세션별 토큰 절약량·도구별 사용 현황 |
ctx_insight | 15개 이상 지표를 보여주는 로컬 웹 UI |
지원 플랫폼 (14개)
- Claude Code — 플러그인 마켓플레이스 자동 설치, 훅 완전 자동화
- Gemini CLI —
settings.json단일 파일로 MCP + 4개 훅 등록 - VS Code Copilot —
.vscode/mcp.json+.github/hooks/context-mode.json - JetBrains Copilot — Settings UI + 훅 파일
- Cursor —
.cursor/mcp.json+.cursor/hooks.json+.mdc라우팅 파일 - OpenCode —
opencode.json에 MCP + 플러그인 등록 - 그 외 Windsurf, Cline, Amazon Q, GitHub Copilot CLI, Codex, Amp, Zed 등
설치 (Claude Code)
# 플러그인 마켓플레이스 설치 (Claude Code v1.0.33+)
/plugin marketplace add mksglu/context-mode
/plugin install context-mode@context-mode설치 후 /reload-plugins 실행 또는 Claude Code 재시작. 이후 정상 동작 확인:
/context-mode:ctx-doctor모든 항목에 [x]가 표시되면 완료. 라우팅 지침은 SessionStart 훅이 자동 주입하므로 별도 설정 파일이 불필요하다.
MCP 단독 설치 (훅 없이 시험용)
claude mcp add context-mode -- npx -y context-mode샌드박스 6개 도구를 제공하지만 자동 라우팅 강제 없이 동작한다.
라이선스
ELv2 (Elastic License 2.0)
관련 문서
- agent-skills — AI 에이전트 스킬 시스템 개요
- claude-code — Claude Code 에이전트 개요
- codeburn — AI 코딩 에이전트 토큰 사용량 TUI 대시보드
- inference-caching — LLM 추론 비용과 지연 시간을 줄이는 캐시 전략
참고 자료
- mksglu/context-mode — GitHub 공식 저장소