Context Mode는 일부 큰 도구 결과를 자체 도구로 처리하고 세션 이벤트를 로컬에 색인하는 Claude Code의 타사 플러그인입니다. 개발자는 코딩 중 어떤 내용이 대화에 전달됐는지 살펴볼 수 있습니다. 통계는 플러그인의 출력 처리를 설명할 뿐이며, 작업의 정확성은 변경 파일과 수용 검사로 판단해야 합니다. 이 안내는 관리자의 버전 1.0.169 파일과 Claude Code의 현재 플러그인 안내를 기준으로 2026년 10월 20일 확인했습니다. BIG CHANGE는 이 글을 위해 플러그인을 설치하거나 코딩 세션을 실행하지 않았습니다.

핵심 변화

  • 달라진 점: Claude Code 플러그인이 특정 도구 호출을 가로채고 큰 결과를 대화 밖에 보관하며 세션 이벤트를 나중에 검색하도록 색인할 수 있습니다. 실제 설치된 마켓플레이스 버전과 활성 훅은 자신의 세션에서 확인해야 합니다.
  • 중요한 이유: 긴 코딩 작업에서 개발자는 플러그인의 출력 전달 기록을 실제 파일 및 테스트 결과와 비교할 수 있습니다. 압축 수치를 유용한 작업의 증거로 삼지 않고, 판단에 필요한 근거가 필터링 후에도 남았는지 평가할 수 있습니다.
  • 주의할 점: 설치 환경에서 예정된 호출이 실제로 전달되는지, 대화를 압축하거나 재개한 뒤에도 원본 근거를 볼 수 있는지가 중요합니다. 로컬 보고서로 공급자 요금이나 코드의 정확성을 입증할 수는 없습니다.

설치 전

허가된 Claude Code 터미널 세션과 수정 권한이 있는 저장소를 사용하세요. 관련 파일, 기존 테스트 또는 빌드 명령, 유지할 동작이 정해진 작은 작업을 고릅니다. 기본 세션 제어와 비교하려면 당사의 컨텍스트 확인 및 세션 계속하기 안내 에서 다루는 /context 와 /compact 를 참고하세요. 이 플러그인 없이 사용하는 기능입니다.

터미널에서 설치된 Claude Code와 Node.js 버전을 기록하세요.

Terminal
claude --version
node --version

이 고정 리비전의 플러그인 패키지 는 Node.js 22.5.0 이상을 요구합니다. 해당 Claude Code 매니페스트 는 다음 지정으로 MCP 서버를 시작합니다: node. 플러그인 프로세스가 Node에 접근할 수 있는지 확인한 뒤 대화형 세션에서 /plugin 가 있는지 확인하세요. 없으면 사용 중인 Claude Code 배포판의 설정 안내를 따르세요. 관리자 README의 오래된 최소 버전은 현재 제어 기능의 신뢰할 만한 호환성 검사가 아닙니다.

Bash 훅이 동작하는 macOS, Linux, WSL 또는 Claude Code용 Git Bash가 설정된 Windows를 사용하세요. Claude Code 자체는 네이티브 Windows PowerShell에서 실행되지만, 고정 리비전의 훅 일치 규칙 이 지정한 것은 Bash이며, PowerShell이 아닙니다. 이 파일들은 PowerShell 전용 도구 경로의 자동 전달을 입증하지 않습니다.

작업 공간에 타사 플러그인을 설치할 허가를 받으세요. 조직 규칙에 따라 Elastic License 2.0, 훅 명령과 서버 매니페스트를 검토합니다. Claude Code에 따르면 플러그인 훅과 MCP 서버는 도구 샌드박스 밖에서 사용자 권한으로 실행됩니다. 모델의 도구 호출을 승인해도 이 프로세스가 격리되지는 않습니다. 플러그인은 저장소 내용을 처리하고 사용자의 파일 및 자격 증명 접근 권한을 물려받을 수 있습니다. 로컬 색인도 선택된 프롬프트와 결과가 모델 공급자에게 전달되지 않는다는 뜻은 아닙니다. 민감한 내용을 사용하기 전에 계정의 데이터 사용 조건 을 확인하세요.

1. 설치 범위를 의도적으로 선택하기

Claude Code 대화형 세션에 다음 명령을 입력하세요.

Text
/plugin marketplace add mksglu/context-mode
/plugin install context-mode@context-mode

두 번째 명령은 Claude Code의 현재 설치 절차에 따라 플러그인 상세 패널을 엽니다. 나열된 스킬, 훅, MCP 서버를 확인하세요. 더 넓은 허가가 없으면 로컬 범위 를 골라 이 저장소에서 자신만 시험하도록 합니다. 사용자 범위는 자신의 여러 프로젝트에, 프로젝트 범위는 설치한 협업자에게 활성화합니다. 설치 요약과 다음 화면의 Errors 탭을 읽으세요: /plugin . 안내대로 다시 로드하거나 Claude Code를 재시작하세요. 강제로 /reload-plugins --force 를 실행하면 프롬프트 캐시가 무효화돼 캐시 없는 요청이 발생할 수 있으므로 현재 세션에서 즉시 활성화할 때만 사용하세요.

다음 화면의 Installed 탭에서 Context Mode가 의도한 범위로 나타나는지 확인하세요: /plugin. 별도 터미널에서 실제 설치 버전과 상태를 기록합니다.

Terminal
claude plugin list

조사한 스냅샷은 버전 1.0.169이며 저장소 커밋은 b31c7ee853cb9ea76121e24d368599390972a997입니다. 마켓플레이스 명령은 이 커밋을 고정하지 않습니다 . 명령이나 동작 변경은 실제 설치 버전으로 판단하세요. 관리자가 따로 제공하는 npx 방식은 자동 훅 없이 MCP 도구만 제공하므로 이 플러그인 설치와 같지 않습니다.

2. 설치된 플러그인 진단하기

활성 Claude Code 세션에서 실행하세요.

Text
/context-mode:ctx-doctor

전체 보고서를 보관하세요. 고정 리비전의 진단 스킬 은 결과에 다음 표시를 사용합니다: [OK], [FAIL] , [WARN]. 런타임, 훅 등록, SQLite FTS5 검색 지원, 플러그인 등록, 버전 항목을 확인합니다. 명시된 원인에 따라 실패를 해결하세요. 스킬이나 서버가 없으면 다음 화면의 Errors 탭과 /plugin 관련 문서인 Claude Code 플러그인 문제 해결 안내를 확인하세요. 진단 통과는 설정 진단 결과이며, 다음 단계가 실제 작업 중 전달 여부를 확인합니다.

3. 실제 작업에서 전달 경로 관찰하기

시작 전 목표, 수용 검사, 저장소 상태를 저장하세요. 다음 터미널 명령은 기존 변경을 식별하지만 플러그인 변경이라고 입증하지는 않습니다.

Terminal
git status --short
git diff --stat

Claude Code 세션에서 /context-mode:ctx-stats 를 실행하고 전체 초기 보고서를 저장하세요. 승인된 작업을 수행하며 실제 도구 이름과 결과를 관찰합니다. 해당 읽기, 검색, 셸 명령, MCP 호출이 Context Mode 도구를 사용했는지, 필터가 생략한 원본 세부 정보를 찾을 수 있는지 확인합니다. 이후 같은 통계 명령을 다시 실행하세요.

Text
/context-mode:ctx-stats

이 통계 스킬 은 현재 세션 출력을 도구별로 보고합니다. 해당 호출이 없었다면 빈 보고서는 관찰된 플러그인 효과가 없다는 뜻입니다. 두 보고서를 작업 기록과 보관하고 본 호출과 비교하세요. 관리자의 압축률과 세션 시간은 자체 예시이지 사용자 작업 측정이 아닙니다. 토큰이나 컨텍스트 추정은 공급자 청구서도 정확한 수정의 증거도 아닙니다. Claude Code와 모델 사용에는 계정 또는 공급자 조건이 계속 적용됩니다.

대화가 압축되거나 재개되면 다음 편집을 허용하기 전에 복구된 작업 상태를 확인하세요. 실제 파일, 차이, 원래 수용 명령을 검사하고 필터링 발췌를 판단하는 데 필요한 전체 결과를 가져옵니다. 로컬 이벤트 색인은 이전 결정을 찾는 데 도움이 되지만 기억된 상태가 저장소를 검증하지는 않습니다. 마지막에 실제 검사를 실행하고 차이를 직접 검토하세요. 명령, 종료 결과, 관련 파일, 미해결 실패를 기록합니다. 작업이 실패해도 보고서는 유용할 수 있지만 실패를 통과로 바꿔서는 안 됩니다.

4. 근거를 버리지 않고 복구하기

전달 경로가 필요한 도구를 막으면 정확한 오류와 진단을 보관한 뒤 다음 화면의 Errors 탭을 확인하세요: /plugin. 플러그인이 원인이면 다음 화면의 Installed 탭에서 Context Mode를 끄세요: /plugin. 적용할 곳은 플러그인을 활성화하는 범위입니다. 로컬, 프로젝트, 사용자 설정은 범위와 우선순위가 다릅니다. 새 Claude Code 세션에서 비활성화를 확인하고 일반 도구와 실제 작업 상태가 사용 가능한지 검사하세요. 원인 설명에 필요한 보고서와 원본 출력을 보존합니다.

비활성화해도 로컬 색인은 삭제되지 않습니다. 플러그인의 삭제 스킬 은 의도적이며 되돌릴 수 없는 작업인 /context-mode:ctx-purge 를 설명합니다. 세션 범위에는 정확한 세션 ID가 필요하며 해당 행과 검색 조각을 삭제하되 다른 세션과 프로젝트 통계는 보존합니다. 프로젝트 범위는 색인 내용, 모든 프로젝트 세션 이벤트, 이벤트 파일과 통계를 삭제합니다. 필요한 근거를 보존한 다음 범위를 결정하고 확인하세요. 어느 삭제도 일상적인 문제 해결 단계가 아닙니다. /clear 와 /compact 는 Context Mode 저장 데이터를 지우지 않습니다.

출처 및 추가 자료