본문으로 건너뛰기
MCP 서버 전체 목록

Context Mode

  • 추천0
  • GitHub 별34K
  • 메모리라이선스Other

코딩 에이전트의 도구 출력이 컨텍스트 창을 채우지 않게 로컬 샌드박스와 SQLite 검색으로 99% 줄이는 무료 로컬 플러그인

원본:mksglu/context-mode

설치 방법은 설치 탭에 정리했어요.

설명

Context Mode

11개 코딩 에이전트에서 쓰는 무료 로컬 플러그인입니다. 도구 출력이 에이전트의 컨텍스트 창을 채우지 않게 하고, 모든 사용 데이터를 내 컴퓨터에만 둡니다. 플러그인은 앞으로도 무료입니다.

npm 다운로드 GitHub 별 Discord 라이선스: ELv2

GitHub 별 3.4만 개 · npm 다운로드 84만 회(2026-11-16 기준, stats.json) · Hacker News 첫 화면과 GitHub Trending에 오른 프로젝트입니다.

💡 Context Mode 플러그인은 무료이며 로컬에서 동작하고 소스는 GitHub에 공개되어 있습니다. Context Mode Gateway는 별도 계정과 구독이 필요한 호스팅 서비스입니다. 같은 아이디어를 도구 출력에서 대화 전체로 넓혀서, Gateway Recall은 긴 세션을 검색 가능하게 유지하고 Gateway Memory는 에이전트가 배운 내용을 세션과 도구를 넘나들며 공유합니다. Gateway 동작 방식 보기

왜 필요한가요

코딩 에이전트는 파일을 읽고, 명령을 실행하고, 웹 페이지를 가져옵니다. 이 결과가 모두 컨텍스트 창에 들어갑니다. Context Mode 플러그인은 이 작업을 로컬 샌드박스에서 실행하고, 전체 출력은 내 컴퓨터의 SQLite 색인에 보관하며, 에이전트에게는 요청한 부분만 돌려줍니다.

Context Mode 플러그인: 무료이며 로컬 동작, 텔레메트리 없음, 데이터는 내 컴퓨터에 남음. 2026-11-01 벤치마크에서 출력 바이트의 99.4% 절감

  • 플러그인은 영구 무료입니다. 집에서도 회사에서도 비용 없이 소스 공개(source-available) 라이선스로 쓸 수 있습니다.
  • 내 컴퓨터에서 실행됩니다. 훅, 샌드박스, 검색이 에이전트 옆의 로컬 프로세스로 돕니다.
  • 데이터는 내 컴퓨터에 남습니다. 모든 색인은 ~/.context-mode에 프로젝트마다 context.db 하나로 저장됩니다.
  • 텔레메트리가 없습니다. 사용 데이터를 모두 내 컴퓨터에만 둡니다. 네트워크 호출은 보안과 개인정보에 모두 적혀 있습니다.
  • 설치 뒤에는 오프라인으로 동작합니다. 샌드박스 실행, 파일 색인, 검색은 로컬 SQLite와 내 런타임만 씁니다.
  • 코드 모드(Code Mode). 에이전트가 데이터를 읽는 대신 짧은 스크립트를 작성하고, 스크립트가 출력한 것만 컨텍스트에 들어갑니다.
  • 작은 응답. 원본 출력이 10KB 이상인 36개 벤치마크 행에서 플러그인 응답 크기의 중앙값은 원본보다 99.4% 작습니다.

도입 현황: 별과 npm 다운로드

인터랙티브 차트에서 막대에 마우스를 올리면 값을 볼 수 있습니다. 별 수는 GitHub GraphQL API(starredAt)에서, npm 다운로드는 api.npmjs.org/downloads/range에서 가져옵니다. 2026-10-29까지 누적 npm 다운로드는 68.3만 회입니다. 매일 작업이 두 차트를 다시 그립니다.

2026-02-23 이후 mksglu/context-mode의 누적 GitHub 별 추이 꺾은선 그래프

context-mode의 최근 90일 일별 npm 다운로드 영역 그래프

  • Hacker News. "Claude Code 컨텍스트 소비를 98% 줄이는 MCP 서버"가 2026-02-28에 570점 이상, 댓글 107개로 첫 화면에 올랐습니다(스레드).
  • GitHub Trending. GitHub Trending을 지켜보는 봇이 2026-04-24부터 2026-10-17 사이 14일 동안 이 저장소를 기록했습니다(uibm/trending-watcher).

프로필의 회사 항목에 2회 이상 나타난 회사별로, 이 저장소에 별을 준 개발자의 소속입니다(2026-11-01 GitHub GraphQL API로 조회, 데이터).

mksglu/context-mode에 별을 준 개발자가 GitHub 프로필에 적은 회사들

설치

지원 에이전트: Claude Code · Codex · Gemini CLI · Qwen Code · Pi · OMP · OpenCode · Copilot CLI · Kiro · VS Code · ZCode. 에이전트마다 자기 설치 명령이 있고, 업데이트 · 확인 · 제거 단계도 함께 있습니다. 자세한 명령은 이 페이지의 「설치」 탭이나 설치 가이드를 보세요.

플러그인에는 Node 24.15.0 이상이 필요합니다(package.json의 engines 기준). Windows에서는 Git for Windows도 필요합니다. 셸 도구가 Git Bash에서 실행되고 doctor가 이를 점검합니다. 패키지와 명령 이름은 context-mode입니다.

npm 방식은 모든 에이전트에서 동작합니다.

npm i -g context-mode
context-mode setup

setup은 수리 기능도 겸합니다. 계획을 보여 주고, 이전 설정을 저장한 뒤 적용하며, 도중에 멈추면 저장해 둔 설정으로 되돌립니다. 설치 후 에이전트를 다시 시작하고 에이전트 안에서 /ctx-doctor를 실행하세요. 각 점검은 PASS 또는 해결 명령을 출력합니다.

설치를 어떻게 시험했나

모든 에이전트에 훅, MCP 서버, 플러그인 스킬이 들어갑니다. 훅이 에이전트에 닿는 방식은 세 가지입니다. 플러그인 패키지 안(Claude Code · Gemini CLI · Qwen Code), 훅 파일(Codex · Copilot CLI · Kiro · VS Code · ZCode), 에이전트 안의 플러그인(OpenCode · Pi · OMP)입니다. CI는 패키징한 결과물로 11개 에이전트 모두에 대해 setup · doctor · 훅 · MCP 핸드셰이크를 Linux · macOS · Windows에서 실행합니다. 기록은 HOOKS-FIRE.md에 있습니다.

사용해 보기

설치 뒤 아래 프롬프트 중 하나를 에이전트에 붙여 넣어 보세요. 각 프롬프트는 Claude Code 2.1.312에서 실제로 한 번 실행했고 답이 원본 데이터와 일치했습니다(증거와 재실행 방법). 다른 에이전트도 같은 도구(ctx_execute, ctx_index, ctx_search)로 같은 일을 합니다.

On https://react.dev/reference/react/useEffect, show me the example that connects to a chat server and cleans up, and list the rules for the dependency array.

훅이 WebFetch를 샌드박스로 보내고, 에이전트가 페이지에서 예제와 규칙을 검색합니다. 원본 601,984B 중 20,860B만 컨텍스트에 도달해 96.5%를 절감했습니다.

Fetch https://jsonplaceholder.typicode.com/photos. Which photo has the longest title (give its id and title), and how many photos have a title that contains the word "est"?

에이전트가 샌드박스에서 JSON 레코드 5,000건을 코드로 처리해 답 두 개를 받습니다. 원본 1,039,898B 중 393B만 도달해 99.96%를 절감했습니다. 이 네 가지 중 가장 좋은 사례입니다.

Here is a Linux syslog sample: https://raw.githubusercontent.com/logpai/loghub/master/Linux/Linux_2k.log. How many authentication failures does it contain, and which 3 remote hosts caused the most?

에이전트가 1,999줄짜리 syslog에서 인증 실패를 샌드박스에서 셉니다. 원본 216,485B 중 566B만 도달해 99.7%를 절감했습니다.

What are the top 10 stories on the Hacker News front page right now? Give title, points and domain for each.

훅이 WebFetch를 샌드박스로 보내고, 에이전트가 페이지에서 글 열 개를 읽습니다. 원본 35,087B 중 1,501B만 도달해 95.7%를 절감했습니다. 첫 화면은 계속 바뀌므로 원본 크기는 실행마다 다릅니다.

절감량 확인하기

프롬프트를 실행한 직후 stats 스킬을 실행하세요. 에이전트마다 명령이 다르며, 스킬은 ctx_stats를 호출해 보고서를 그대로 보여 줍니다.

에이전트명령
Claude Code/ctx-stats
Codex$ctx-stats
Copilot CLI/ctx-stats
Gemini CLICall ctx_stats and show me the report.
KiroCall ctx_stats and show me the report.
OMP/skill:ctx-stats
OpenCodeCall ctx_stats and show me the report.
Pi/skill:ctx-stats
Qwen CodeCall ctx_stats and show me the report.
VS Code (Copilot)/ctx-stats
ZCodeCall ctx_stats and show me the report.

위 JSON 프롬프트를 ctx_execute 한 번으로 실행한 뒤 실제 보고서의 첫 줄들입니다.

context-mode stats
────────────────────────────────────────────────────────────────────────────────

This session · 1 call · <1m active
  1015.5 KB became 3.7 KB: 1011.8 KB kept out (99.6%)
  Without context-mode |████████████████████████████████████████|  1015.5 KB
  With context-mode    |█░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░|     3.7 KB
  about 259K tokens kept out, 1.3 times a 200K window

사용 사례

공개 프로젝트에서 나온 실제 도구 출력을 Context Mode로 처리한 결과입니다. 2026-11-01 벤치마크(2.0.0-next.23, 커밋 16a4bcc5), 5회 실행의 중앙값입니다.

하는 일도구원본컨텍스트에 도달절감
브라우저 페이지 읽기Chrome DevTools MCP take_snapshot, 코드 모드136,514 B463 B99.7%
이슈 40개 나열GitHub CLI gh issue list --json, 코드 모드182,943 B850 B99.5%
체크 포함 PR 25개 나열GitHub CLI gh pr list --json, 코드 모드195,471 B776 B99.6%
라이브러리 문서 조회Context7 query-docs, 코드 모드6,917 B473 B93.2%
테스트 1,106개 실행Vitest vitest run --reporter=verbose, 코드 모드62,909 B429 B99.3%
소스 폴더 린트Biome biome lint --reporter=json, 코드 모드288,523 B577 B99.8%
워크스페이스 설치pnpm pnpm install --frozen-lockfile, 코드 모드14,988 B199 B98.7%
패키지 설치npm npm install --loglevel http, 코드 모드37,761 B435 B98.8%
컨테이너 로그 읽기Docker docker logs, 코드 모드60,374 B587 B99.0%
리소스 72개 계획Terraform terraform plan, 코드 모드34,081 B166 B99.5%
파일 통계 포함 커밋 300개 읽기git git log --stat, 코드 모드164,385 B268 B99.8%
89KB 소스 파일 읽기Read, 훅이 ctx_execute로 보냄91,362 B375 B99.6%
265KB 문서 페이지 가져오기WebFetch, ctx_index와 ctx_search로 보냄271,731 B439 B99.8%
214KB API 응답 가져오기Bash의 curl, 실행 후 대체219,175 B291 B99.9%
Bash에서 187KB git 로그 출력Bash, 출력 대체191,120 B204 B99.9%
같은 git 로그를 호스트 도구로 출력한도를 넘은 호스트 도구 출력 전체 색인191,120 B2,842 B98.5%
214KB GitHub API 응답을 호스트 도구로 출력한도를 넘은 호스트 도구 출력 전체 색인219,175 B4,060 B98.1%
45KB 로그 파일 읽기Read, 훅이 ctx_execute로 보냄46,216 B371 B99.2%
60KB 소스 파일 읽기Read, 훅이 ctx_execute로 보냄61,576 B374 B99.4%
하루 종일 디버깅: 출력 8개, 검색 3번모든 훅과 도구281,261 B3,266 B98.8%

원본 출력: bench/results/2026-11-01-darwin-arm64.json, 입력 출처: SOURCE.md. 에이전트는 요청한 부분만 받고, 전체 출력은 로컬 색인에 남아 ctx_search로 다시 읽을 수 있습니다. Context7 행은 원본이 10KB 미만이라 대표 수치에서는 제외됩니다.

벤치마크

카테고리별 절감 바이트 중앙값 막대 그래프(원본 10KB 이상 행)

모든 대표 수치의 규칙: 원본 출력 10KB 이상인 행, 행마다 5회 실행의 중앙값, ctx_bytes를 raw_bytes와 비교해 측정, 카테고리는 그 행들의 중앙값, 1KB = 1,024B. 그런 행 36개 전체에서 플러그인은 출력 바이트의 중앙값 99.4%를 컨텍스트 밖에 둡니다. 2.0.0-next.23(커밋 16a4bcc5), macOS arm64, 2026-11-01 기준입니다.

카테고리실행 내용행 수절감 중앙값
a. 샌드박스파일이나 명령에 ctx_execute1999.5%
b. 검색로컬 색인에 ctx_search377.2%
c. 일괄ctx_batch: 여러 명령 실행 후 검색293.1%
d. 외부화한도를 넘은 호스트 도구 출력 전체 색인498.3%
f. 훅 리다이렉트큰 Read, curl, WebFetch를 샌드박스로 보냄799.8%
g. 세션 전체스크립트로 진행한 세션 하나198.8%

검색 응답(b)은 일치하는 텍스트를 담기 때문에 77.2%를 절감합니다. 모든 행은 2026-11-01-darwin-arm64.md에 있습니다. 재현은 cd bench && node run.mjs이며, Node만 있으면 오프라인으로 돌아갑니다. 시나리오와 옵션은 bench/README.md를 보세요.

긴 세션

세션이 커져도 컨텍스트는 작게 유지되는 흐름: PreToolUse 훅이 도구 호출을 샌드박스로 보냄

느린 테스트를 오후 내내 디버깅한다고 해 봅시다. 에이전트가 파일을 읽고, 테스트를 돌리고, 문서를 가져오고, 결과마다 컨텍스트 창에 들어갑니다. 창이 가득 차면 호스트가 이를 압축하고, 그 뒤 에이전트는 짧은 요약과 다음 메시지만 봅니다.

Context Mode는 큰 도구 호출의 전체 출력을 내 컴퓨터의 context.db에 보관하고 작은 응답만 줍니다. 압축 시점에는 최대 2,048B짜리 스냅샷이 세션 상태를 보존합니다. 압축 뒤 에이전트는 ctx_resume으로 스냅샷을 읽고, ctx_search로 이전 출력을 키워드로 찾습니다.

벤치마크에서 도구 출력 40개와 압축 1회로 이루어진 스크립트 세션은 442,893B 기록이 되었고, 에이전트를 복귀시킨 ctx_resume 블록은 2,019B였습니다. 666,796B짜리 큰 로그 하나는 컨텍스트에 3,380B만 넣었고 전체 로그는 ctx_search용으로 색인에 남았습니다. 스냅샷이 남길 것을 고르는 방식은 긴 세션 가이드와 ADR-0009에 있습니다.

속도

2026-11-01 벤치마크, 5회 실행의 중앙값입니다.

측정결과
에이전트별 훅 시간(순수 node 시작 대비 추가분)7.5ms ~ 12.3ms
ctx_search, 파일 8개에 대한 쿼리 20개중앙값 1.62ms, 최대 6.70ms
ctx_index, 실제 파일 3개 625,649BMB당 150ms

동작 방식

도구 호출 하나의 단계별 흐름: 에이전트가 도구를 실행하고 PreToolUse 훅이 호출을 막고 샌드박스로 돌림

설치부터 훅 오류까지, 도구 호출 하나를 시간 순서로 따라갑니다.

  1. 설치. 각 에이전트의 설치 명령이 MCP 서버, 훅, 스킬 ctx-doctor · ctx-stats · ctx-upgrade를 그 에이전트의 설정 폴더에 추가합니다. context-mode setup은 기본 명령이 빠뜨린 부분을 쓰거나 고칩니다.

  2. 세션 시작. SessionStart 훅이 프로젝트 데이터베이스를 엽니다. 이전에 실행한 세션이면 에이전트가 ctx_resume을 호출하라는 한 줄을 받습니다.

  3. PreToolUse 검사. 도구가 실행되기 전에 PreToolUse 훅이 정해진 순서로 호출을 검사합니다. 사용자 거부 목록, WebFetch, curl과 wget, 인라인 HTTP · 빌드 명령, OUTPUT_CAP(16,384B)을 넘는 전체 파일 Read, cat이나 tail 같은 단일 파일 셸 덤프 순입니다. 줄 범위를 지정한 Read는 그대로 실행됩니다.

  4. 정확한 호출. 검사에 걸리면 훅이 호출을 멈추고, 쓸 ctx_* 호출을 정확히 알려 줍니다. 예를 들어 ctx_execute에 {"language":"shell","code":"...","intent":"..."}를 쓰라고 합니다. WebFetch는 ctx_index 다음 ctx_search를 안내합니다.

  5. 샌드박스. 코드 모드 단계입니다. 에이전트의 스크립트가 여기서 실행되고, 출력한 것만 돌아옵니다. ctx_execute는 스크립트를 임시 폴더에 쓰고 프로젝트 폴더에서 인자 목록으로 런타임을 띄웁니다. 시간 제한은 EXEC_TIMEOUT_MS(기본이자 최대 600,000ms)이며, 초과하면 프로세스 그룹 전체를 종료합니다(Windows는 taskkill /F /T). 자식 프로세스는 NODE_OPTIONS 같은 프리로드 변수를 뺀 내 환경을 받고, 에이전트는 스크립트가 출력한 것을 최대 OUTPUT_CAP까지 받습니다.

    코드 모드. 에이전트가 짧은 스크립트를 도구 매개변수로 보내면, 스크립트가 샌드박스에서 데이터를 읽고 출력한 것만 컨텍스트로 갑니다. Context Mode 2.0.0-next.26의 Try-it 실행에서 ctx_execute가 JSON 레코드 5,000건(1,039,898B)을 처리했고, 에이전트가 받은 것은 254B였습니다. 또 Context Mode 2.0.0-next.36의 ctx_batch 호출은 설치 로그와 긴 git 로그에 대해 명령이 228,881B를 출력했지만 에이전트는 두 쿼리와 일치하는 부분 8,667B만 받았고, 전체 출력은 색인에 남았습니다.

  6. 색인. 전체 출력은 최대 MAX_CHUNK_BYTES(4,096B) 크기의 조각으로 색인에 들어갑니다. Markdown 조각은 한 제목 절 안에 머물고, 들어맞는 코드 블록은 통째로 유지됩니다. 각 조각은 두 SQLite FTS5 테이블에 들어갑니다. 단어용 Porter 어간 테이블과 경로 · 이름 · 단어 일부용 트라이그램 테이블입니다.

  7. 검색. ctx_search가 두 테이블을 각각 BM25로 순위를 매기고 Reciprocal Rank Fusion으로 두 목록을 합칩니다. 점수는 1/(RRF_K + 순위), RRF_K = 60입니다. 빈 목록을 돌려주기 전에 색인된 단어로 철자 보정을 시도합니다. 검색 범위는 이 세션, 이 워크트리(기본값), 또는 프로젝트 전체이며 조각 미리보기는 최대 SNIPPET_MAX_BYTES(800B)입니다.

  8. 실행 후 대체. 도구를 먼저 실행하는 호스트에서는 PostToolUse 훅이 결과를 검사합니다. REPLACE_TRIGGER_BYTES(4,096B)를 넘는 출력은 통째로 색인에 들어가고, 에이전트는 가장 잘 맞는 조각들과 나머지를 위한 ctx_search 한 줄을 받습니다.

  9. 기록과 압축. 훅이 프롬프트, 편집, 명령, 도구 오류, 결정을 저널에 기록합니다. 압축 뒤 에이전트는 최대 STATE_BUDGET(2,048B)의 상태 블록을 받고, 긴 줄은 전체 행을 가리키는 ctx_resume(seq) 포인터가 됩니다. ctx_resume 응답은 최대 RESUME_CAP(2,048B)입니다. 다음 프롬프트에서는 BM25로 일치하는 저널 행을 되살리는 프롬프트 매칭 블록이 나옵니다.

  10. 데이터베이스. 프로젝트마다 ~/.context-mode 아래 Node 내장 node:sqlite의 context.db 하나가 있습니다. WAL 모드로 동작하고 닫을 때 PASSIVE 체크포인트를 실행합니다. 새 데이터베이스는 임시 이름으로 만든 뒤 한 번에 제자리로 옮기며, 대기 시간 제한은 DB_TIMEOUT_MS(5,000ms)입니다.

  11. 훅 오류. 훅은 항상 exit 0으로 끝납니다. 어떤 오류든 호스트의 허용 응답을 돌려주고 ~/.context-mode/hook-errors.log에 한 줄을 남기므로 에이전트는 계속 일합니다. 띄운 훅의 제한 시간은 HOOK_TIMEOUT_MS(5,000ms)입니다.

모든 숫자와 그 이유는 동작 방식 문서에, 훅이 따르는 규칙은 ADR-0008에 있습니다.

도구

도구하는 일
ctx_execute샌드박스에서 코드나 셸 명령을 실행하고 출력한 것을 돌려줍니다
ctx_batch여러 명령을 실행하고, 출력을 색인하고, 한 번의 호출로 검색합니다
ctx_index파일, 텍스트, URL을 프로젝트 데이터베이스에 색인합니다
ctx_search로컬 색인을 검색해 일치하는 부분을 돌려줍니다
ctx_resume플러그인의 로컬 상태 블록(최대 2,048B) 또는 seq로 지정한 전체 행을 돌려줍니다
ctx_stats컨텍스트 밖에 둔 출력의 양을 보여 줍니다
ctx_doctor설치를 점검합니다. 각 점검은 PASS 또는 해결 명령을 출력합니다
ctx_upgrade설치, 업그레이드, 제거를 하고 옛 contextmode 항목을 교체합니다
ctx_purge세션, 소스, 프로젝트 단위로 색인된 데이터를 삭제합니다

에이전트 안에서는 /ctx-stats가 ctx_stats 결과를, /ctx-doctor가 ctx_doctor를(결함을 신고할 때 이 보고서를 보내세요), /ctx-upgrade가 ctx_upgrade 다음 ctx_doctor를 실행합니다. 전체 목록은 도구 문서를 보세요.

보안과 개인정보

  • 플러그인은 모든 데이터를 내 컴퓨터의 ~/.context-mode에 프로젝트당 데이터베이스 하나로 둡니다. ctx_purge로 세션, 소스, 프로젝트 단위로 지울 수 있습니다. 보안 가이드를 읽어 보세요.
  • 텔레메트리가 없습니다. 사용 데이터, 이벤트, 충돌 보고서가 모두 내 컴퓨터에 남습니다. 네트워크는 네 가지 호출에만 쓰이며 모두 사용자나 에이전트가 시작합니다.
호출언제파일
ctx_index용 URL 가져오기에이전트가 페이지를 요청할 때. 사설·링크 로컬 주소를 막고, 호스트 이름이 가리키는 모든 주소를 확인한 뒤 확인한 주소로 연결하며, 리디렉션마다 다시 확인합니다fetch.ts
npm dist-tags 한 번 읽기(대체는 릴리스 태그의 git ls-remote)context-mode doctor를 실행해 새 버전을 확인할 때doctor-env.ts
npm i -g context-mode 또는 gh issue createcontext-mode upgrade를 실행하거나 키를 눌러 디버그 보고서를 보낼 때commands.ts
에이전트 자체의 설치 명령(npm 또는 git)설치하거나 업데이트할 때에이전트
  • 가드 테스트 D-PRIVACY-NET-1(tests/0008-enforcement.test.mjs)이 소스에서 HTTP 클라이언트, 소켓, DNS 조회, git 네트워크 호출, gh · npm 실행을 검사하고 새 호출 위치를 표시하므로 위 표는 계속 사실로 유지됩니다.
  • doctor와 디버그 보고서는 출력하기 전에 구조를 기준으로 비밀 값을 제거합니다.

ctx_execute의 코드는 내 호스트에서 내 사용자 권한으로 실행됩니다. 프리로드 변수를 뺀 내 파일, 네트워크, 환경을 그대로 쓰므로 에이전트 자체의 권한 확인 창은 켜 두세요. 여기서 "샌드박스"는 출력이 샌드박스에 머물고 컨텍스트 밖에 있다는 뜻입니다. 저장 내용 · 위치 · 삭제 방법은 개인정보 문서에 있습니다.

Context Mode Gateway

플러그인은 내 컴퓨터에서 도구 출력을 다루며 그것만으로 완결됩니다. Context Mode Gateway는 별도 계정과 구독이 있는 호스팅 서비스로, 모든 에이전트의 모든 요청을 다룹니다. 11개 기능은 컨텍스트 절약(Context Saving), Recall, Memory, Skills, Search, 세션 재개, Active Context, Instructions, Protect, 프롬프트 캐싱, Live와 Analytics입니다. 모든 요청에서의 절감, 세션과 에이전트를 넘는 기억, 팀 비용 보고서가 필요할 때 Gateway를 더하세요. 한 컴퓨터의 프로젝트 하나라면 플러그인으로 충분합니다. 둘은 함께 쓸 수 있습니다(Gateway 가이드).

Gateway Recall · Search · 세션 재개는 Gateway 서버에서 세션과 에이전트를 가로질러 동작합니다. 플러그인의 ctx_search와 ctx_resume은 프로젝트 하나의 로컬 context.db를 읽습니다. Gateway를 켜면 요청이 Gateway 서버를 거치지만, 플러그인 자체의 데이터는 내 컴퓨터에 남습니다.

제품실행 위치범위과금
Context Mode 플러그인내 컴퓨터프로젝트 하나, 로컬 context.db무료
Context Mode Gateway호스팅 서비스모든 세션과 에이전트구독(플러그인과 별도)

Gateway는 한 줄 명령으로 설정합니다.

npx @context-mode/cli

이 명령은 구독이 있는 Gateway 계정에 로그인하고 에이전트마다 설정을 하나씩 바꿉니다. 지원 앱: Claude Code · Claude Desktop · Codex · Codex Desktop · T3 Code · OpenCode · Pi. Gateway CLI에는 Node 20.12 이상이 필요합니다.

Live. 진행 중인 세션 하나를 보여 줍니다. 이번 세션에서 아낀 비용, 요청마다 컨텍스트 밖에 둔 바이트, 보관하고 보낸 기록, 요청별 비용과 절감 내역이 나옵니다.

Gateway Live 화면: 세션 중 절감 비용, 요청별로 컨텍스트 밖에 둔 바이트

개요(Overview). 하루 단위의 지출과 Gateway가 아낀 금액을 한눈에 봅니다.

Gateway 개요: 30일 동안 절감 금액, AI 지출, 프롬프트 캐시 할인, 요청당 비용

분석(Analytics). 절감이 어디서 왔는지 보여 줍니다. 숨긴 도구, 보관된 옛 결과, 보관소에 둔 큰 출력, 다듬은 컨텍스트입니다.

Gateway 분석: 시간에 따른 절감 금액을 출처별로 나눈 그래프

지출(Spend). 일별 · 모델별 지출, 요청당 비용, 캐시 적중률로 예산을 짜는 데 도움을 줍니다.

Gateway 지출: 모델별 일일 지출, 요청당 비용, 캐시 적중률

Memory. 사실과 결정이 세션과 에이전트를 넘어 이어집니다. 화면은 Recall이 아낀 양과 답을 찾은 검색 횟수를 보여 줍니다.

Gateway Memory: Recall로 아낀 비용과 하루 검색 횟수

Skills. 스킬을 한 번 추가하면 모든 클라이언트가 필요할 때 씁니다. GitHub에서 스킬을 가져오고 설치된 목록을 봅니다.

Gateway Skills: GitHub에서 가져오기와 설치된 스킬 목록

Protect. 실행 전에 셸 명령마다 검사하는 규칙입니다. 이 화면은 terraform destroy를 막는 규칙입니다.

Gateway Protect: terraform destroy를 막는 새 명령 규칙

이 화면의 수치는 개발자 본인 계정의 30일(2026년 10월 3일 ~ 11월 1일) 사용량이므로 한 계정의 사용 사례로 읽어 주세요.

Gateway를 켜고 시험해 볼 프롬프트 세 개입니다. 각 프롬프트 아래 줄이 보여 주는 기능을 설명합니다.

Move this project from Jest to Vitest. Convert every test file, fix the config, run the suite after each batch, and tell me what is left.

Memory가 긴 작업 동안 계획과 파일 목록을 유지합니다.

Pick up where we stopped yesterday on the Jest to Vitest move. What is done, what is left, and which test was failing?

Recall이 새 세션에서 어제의 작업을 되살립니다.

Which date library did we choose on Tuesday, and why did we reject the other two?

Search가 지난 세션에서 답을 찾습니다.

Gateway 기능 (contextmode.ai/docs 기준)

기능하는 일얻는 것세부
Context Saving옛 도구 출력을 접고, 데이터 작업을 코드로 실행(코드 모드)하고, 도구 스키마를 다듬고, 캐시 표시를 둠2,048B를 넘는 도구 출력이 짧은 포인터가 되고 전체는 보관됨도구 호출이 많은 세션에서 가장 많이 절감
Recall모델은 최근 작업과 옛 작업의 색인을 보고, 에이전트가 나머지를 보관소에서 검색Claude Code · Opus 5.5 · 200K 창 · 2026-10-04: 세션당 평균 비용 $4.8627 → $3.0353(-37.6%)Claude Opus 5.5의 Claude Code에서 측정한 비용
Memory각 사실이 두 시점(참이었던 때, Gateway가 안 때)을 기억같은 계정의 Claude Code와 Codex가 한 저장소를 공유, 종단 간 시험 완료새 세션의 첫 요청에 메모리 블록이 들어감
Skills계정용 스킬 카탈로그, 메시지에 맞는 스킬을 불러옴필요한 메시지에서 맞는 스킬이 로드됨GitHub에서 스킬 가져오기, 로드된 스킬은 프롬프트에 통째로 들어감
SearchGateway를 거친 프롬프트, 명령, 도구 출력을 콘솔과 에이전트 도구로 검색콘솔이나 에이전트에서 지난 프롬프트 · 명령 · 도구 출력 검색콘솔은 각 도구 결과의 첫 4,000자를 검색
Session resume명령 하나로 대화를 네이티브 Claude Code · Codex 세션으로 재구성Claude Code나 Codex에서 대화를 이어 감텍스트, 도구 이름, 요약을 복원, 명령은 15분간 유효
Active Context가장 오래된 부분이 보관소로 가기 전 스레드가 지닐 양(200K · 500K · 1M 토큰)을 설정스레드마다 창 크기 선택지닌 부분보다 오래된 이미지는 짧은 텍스트 메모가 됨
Instructions모든 에이전트에게 답하는 방식을 알리는 최대 4,096자 텍스트첫 요청 뒤 공급자 캐시에서 읽음에이전트가 나에게 쓰는 방식을 설정
Protect셸 명령, 파일 읽기 · 쓰기, 웹 가져오기, 도구 서버 호출을 하는 일 기준으로 검사하는 도구 호출 방화벽모든 호출이 실행 전에 검사됨호출 내용을 읽고 판단
Prompt caching요청을 캐시 친화적으로 유지: 프롬프트 고정 부분에 캐시 표시, 가져온 페이지용 캐시위에서 측정한 비용에 포함공급자 최대치인 캐시 표시 최대 4개 사용
Live와 Analytics각 요청과 Gateway가 아낀 양을 실시간 · 기간별로 표시요청과 절감을 실시간 · 기간별로 확인Gateway를 거치는 모든 요청 포함

Gateway 전용 수치: Claude Code 단독 대비 비용(Claude Opus 5.5, 정가 기준 세션당 평균 달러). 플러그인 수치는 위 벤치마크에 있습니다.

  • 짧은 작업 6개(2026-09-29): 176세션 합산 달러 24.5% 절감(작업별 21% ~ 29%). v3-opus55-short.json
  • Claude Code 긴 세션, 200K 창(2026-10-03/04): 세션당 평균 비용 $4.8627 → $3.0353(-37.6%, 3쌍 평균). ab.json
  • 각 실행 전에 규칙을 고정했습니다: contextmode.ai/docs/benchmarks.

Gateway는 Anthropic과 OpenAI로 요청을 보냅니다. 모델로 가는 길에 요청을 Gateway 서버로 보내고, Recall과 Search를 위해 검색 가능한 세션 기록을 보관하며, 보관된 출력을 다시 읽을 때 비밀 값과 이메일 주소를 가립니다. 개인정보 페이지는 contextmode.ai/privacy입니다. Protect 옆에서 에이전트 자체의 샌드박스도 켜 두세요.

라이선스

Elastic License 2.0(ELv2, LICENSE 파일)이며 소스 공개(source-available) 라이선스입니다. 코드를 쓰고, 복사하고, 바꾸고, 공유할 수 있고, 업무에서도 비용 없이 쓸 수 있습니다. 다만 라이선스 소유자에게 남겨 둔 용도가 세 가지 있습니다.

  1. 소프트웨어 기능의 상당 부분을 다른 사람에게 제공하는 호스팅 · 관리형 서비스로 제공하는 것.
  2. 라이선스 키 기능을 옮기거나, 바꾸거나, 끄거나, 우회하거나, 라이선스 키가 보호하는 것을 제거하거나 숨기는 것.
  3. 소유자의 라이선스, 저작권, 그 밖의 고지를 바꾸거나 지우거나 숨기는 것.

소스는 모두에게 열어 두고 호스팅 서비스는 프로젝트에 남기려고 ELv2를 골랐다고 합니다.

커뮤니티

결함은 /ctx-doctor 전체 보고서와 함께 Discord에 신고하고, 아이디어도 그곳에 보내 주세요. 모든 변경은 메인테이너가 작성하며, 에이전트가 이슈를 올리는 방법은 CONTRIBUTING.md에 있습니다.

영상. Better Stack의 Context Mode 소개. 직접 영상을 만들어 Discord에 공유해 주세요. 조회수 1만 회가 넘는 영상은 이 문서에 추가합니다.

더 알아보기