context-mode 정리: 클로드 코드 컨텍스트 98% 아끼는 플러그인, 무료와 유료 구분
AI 코딩 에이전트를 오래 쓰다 보면 어느 순간 대답이 엉뚱해지거나 “대화가 너무 길어 요약합니다” 하고 앞 내용을 잊어버려요. 컨텍스트(대화 창)가 꽉 찼다는 뜻인데, 범인은 대화보다 도구가 쏟아내는 결과물인 경우가 많아요. context-mode는 이 부분을 겨냥한 도구예요. 공식 깃허브 README·라이선스·공식 사이트 요금표를 2026년 10월 17일에 직접 확인해서 정리했어요.

한 줄 요약
context-mode는 클로드 코드·제미나이 CLI·커서 같은 AI 코딩 에이전트에 붙이는 MCP 서버 겸 플러그인이에요. 로그 파일·웹페이지·API 응답 같은 큰 결과물을 대화 창에 그대로 넣지 않고, 따로 실행한 뒤 필요한 줄만 돌려보내요. 대화가 압축될 때를 대비해 작업 기록도 내 PC의 SQLite 데이터베이스에 남겨 둬요.

왜 필요한가
README에 든 예가 와닿아요. 브라우저 자동화 도구(Playwright) 화면 정보 한 번이 56KB, 깃허브 이슈 20개가 59KB, 접속 로그 하나가 45KB라고 해요. 이런 게 몇 번 쌓이면 30분 만에 대화 창의 40%가 사라진다는 게 개발자 설명이에요. 그리고 창이 차서 대화를 압축하면, 에이전트가 어떤 파일을 고치고 있었는지, 무슨 일을 하던 중이었는지 잊어버리죠.


어떻게 줄이나
핵심은 세 가지예요. ① 샌드박스 실행 — 명령이나 코드를 별도 프로세스에서 돌리고, 화면에 찍힌 결과(stdout)만 대화로 넘겨요. 자바스크립트·파이썬·셸 등 12개 언어를 지원해요. ② 검색 색인 — 긴 문서나 웹페이지는 통째로 넣는 대신 SQLite FTS5로 색인해 두고, 필요한 대목만 검색해서 꺼내요. ③ 코드로 생각하기 — 파일 50개를 하나씩 읽는 대신 “세어 주는 스크립트”를 한 번 돌려 숫자만 받아 오게 유도해요.


98% 절약, 어떻게 볼까
README 벤치마크 표에는 Playwright 화면 정보 56.2KB → 299B, 깃허브 이슈 20개 58.9KB → 1.1KB 같은 숫자가 있고, 한 세션 전체로 보면 315KB가 5.4KB로 줄어 98%를 아낀다고 해요. 세션 시간이 약 30분에서 약 3시간으로 늘었다는 설명도 있어요. 다만 이건 개발자가 직접 고른 시나리오로 잰 값이에요. 큰 로그·웹페이지를 많이 다루는 작업일수록 효과가 크고, 짧은 코드 파일만 고치는 작업이라면 차이가 작을 수 있어요.

설치와 지원 도구
클로드 코드는 플러그인 마켓플레이스로 설치해요. /plugin marketplace add mksglu/context-mode 다음 /plugin install context-mode@context-mode, 그리고 다시 시작하면 돼요. /context-mode:ctx-doctor로 설치 상태를 점검하고, /context-mode:ctx-stats로 얼마나 아꼈는지 볼 수 있어요. 제미나이 CLI·VS Code 코파일럿·커서·코덱스 CLI 같은 다른 도구는 Node.js 22.5 이상을 깔고 설정 파일을 직접 고쳐야 해요. 훅을 지원하지 않는 도구는 안내 파일만 복사하는 방식이라 효과가 약하다고 README에 적혀 있어요.


무료 플러그인 vs 유료 클라우드, 헷갈리지 마세요
여기가 가장 헷갈리는 부분이에요. 깃허브의 플러그인(공식 사이트에서는 ‘Context Mode Engine’이라고 불러요)은 무료이고, README는 “원격 전송·사용 추적·계정이 없고, 데이터는 내 PC에만 남는다”고 설명해요. 그런데 context-mode.com에서 파는 ‘Context Mode’ 클라우드 서비스는 따로예요. 에이전트와 AI 모델 사이에 끼는 중계 서비스로, 요금표 기준 무료 1,000회(계정당 한 번), Pro 월 49달러(연 490달러, 월 5만 회)이고 회사 클라우드에서 돌아가요. 플러그인만 쓰면 돈이 들지 않으니, 가입 화면이 나오면 어느 쪽인지 한 번 확인하세요.


라이선스와 주의할 점
라이선스는 MIT가 아니라 Elastic License 2.0이에요. 쓰고, 고치고, 다시 배포하는 건 되지만 이걸 호스팅 서비스로 만들어 남에게 파는 것과 라이선스 표시를 지우는 건 안 돼요. 회사에서 개인 개발 도구로 쓰는 데는 걸릴 게 거의 없지만, 사내 서비스로 묶어 제공하려면 조항을 확인하세요. 그리고 이 도구는 에이전트가 실행하는 명령을 가로채 바꾸는 ‘훅’을 등록해요. 기존에 쓰던 권한 규칙(예: sudo 금지)을 샌드박스에도 똑같이 적용한다고는 하지만, 처음엔 개인 프로젝트에서 써 보고 넓히는 게 안전해요.
누구에게 맞을까
클로드 코드로 큰 저장소를 뒤지거나 로그·웹 문서를 자주 읽히는 분, 대화가 자꾸 압축돼서 작업 흐름이 끊기는 분께 맞아요. 반대로 짧은 질문 위주라면 굳이 설치할 필요는 없어요. 오픈소스 프로젝트라 설치·사용 책임은 사용자에게 있고, 업데이트가 빨라 설치 전 공식 README를 한 번 더 확인하는 걸 추천해요.
출처
· context-mode 공식 깃허브 저장소 (README·문서·라이선스)
· context-mode 공식 사이트·요금표
· GitHub API 별·포크·라이선스·릴리스 (2026-10-17 확인)
컴퓨터가 고장 났다면 부산 컴퓨터수리 · 출장수리 부컴에 맡겨 주세요. 부산·울산·김해·양산 어디든 직접 방문합니다.
