내부 런타임을 장악하는 확장 체계: Claude Code 모드(Mods)

Об этом предложении

Claude Code가 단순한 CLI 도구를 넘어 개발자 개개인의 작업 환경에 맞춰 런타임과 UI를 재구성할 수 있는 모듈형 플랫폼으로 진화했습니다. 이번 업데이트를 통해 도입된 모드(Mods) 아키텍처는 프로세스 외부에서 일회성으로 개입하던 기존 방식의 한계를 깨고, 클라이언트 내부 런타임에 직접 상주하며 도구 호출 인터셉트, 실시간 UI 렌더링, 세션 수명 관리까지 에이전트의 전체 루프를 제어합니다. 본문에서는 실무 생산성과 토큰 비용 절감을 이끄는 대표적인 커뮤니티 모드들의 활용법과 내부 실행 메커니즘, 그리고 안전한 모드 제작 및 검증 체계를 살펴봅니다. Claude Code Mods Are Game Changers. Set Up These 5 NOW. Claude Code 모드의 개념과 플러그인 동작 원리 Claude Code의 모드는 복잡한 UI 프레임워크를 다루지 않고도 TypeScript 몇 줄이나 자연어 프롬프트만으로 데스크톱 앱의 UI와 에이전트 동작을 변경할 수 있는 플러그인 확장 기능입니다. 공식 발표에서는 컨텍스트 사용량을 시각화하는 Token Weather, 변경 사항 실행 전 삭제 대상 파일을 미리 보여주는 Blast Radius, 변경된 diff를 단계별로 탐색하는 Replay Theater 등이 소개되었습니다. 이 시스템은 CLI와 데스크톱 앱 내부의 /plugin 명령어로 관리되는 확장 구조를 취합니다. 사용자는 Claude에게 특정 기능을 수행하는 모드를 만들어 달라고 요청하는 것만으로 신규 모드를 생성할 수 있으며, 기존에 작성된 플러그인은 마켓플레이스 등록 및 설치 명령어로 환경에 즉각 주입됩니다. # 플러그인 마켓플레이스 등록 및 커뮤니티 모드 설치 예시 claude plugin marketplace add anthropic/claude-plugins-community claude plugin install next-steps@claude-community 이러한 모드 중 하나인 next-steps 는 에이전트의 턴(Turn)이 끝날 때마다 다음에 수행할 작업 3가지를 UI 팝업 형태로 추천합니다. ClickUp 태스크 정리나 기능 구현 시 다음 단계를 일일이 프롬프트로 작성하지 않고 버튼 클릭이나 단순 선택만으로 워크플로우를 이어갈 수 있도록 돕습니다. 비용 및 세션 최적화 모드: cache-keeper와 recording-mode Claude Code 세션을 효율적으로 유지하기 위해 작업 로그를 바탕으로 설계된 대표 모드가 cache-keeper 입니다. Anthropic의 프롬프트 캐시는 세션 내에서 메시지가 오갈 때 캐시가 유지(warm)되지만, 60분 동안 입력이 없으면 캐시가 만료(cold)되어 이후 턴에서 전체 컨텍스트를 다시 읽는 비용이 발생합니다. cache-keeper 모드는 현재 컨텍스트 토큰 크기(예: 109k 토큰), 캐시 만료까지 남은 시간, 세션 및 주간 사용량, API 환산 예상 비용을 상태 표시줄 형태로 상시 렌더링합니다. 또한 캐시가 만료되기 5분 전에 "154k 토큰 캐시가 5분 뒤 콜드 상태가 됩니다. 재작성 시 약 $1.23가 소요됩니다"라는 경고 알림을 띄워 재프롬프트나 핸드오프를 유도합니다. [UI 상태 표시줄 구성] - Cache Warm: 58m 남음 - Context: 109k tokens - Rewrite Cost: $0.87 (만료 시 재작성 비용) - Rate Limit: 5h 10% / Weekly 59% - Actions: [Clear & Continue] [Session Handoff] 버튼 이 모드에는 단일 클릭으로 동작하는 세션 핸드오프 버튼이 결합되어 있습니다. 버튼을 누르면 내부 스킬이 실행되어 현재 세션의 결정 사항과 남은 태스크를 문서로 요약 저장하고, /clear 실행 후 요약본을 새 세션에 자동 주입하여 컨텍스트 창 비대화( Context Rot )를 방지합니다. 함께 사용되는 recording-mode 는 화면 녹화 중 민감한 이메일 주소, 금융 데이터, 가격 정보가 노출되지 않도록 감지하여 실시간으로 UI 텍스트를 마스킹( pricing.html 의 $29 -> $39 변경 내역 등을 플레이스홀더로 숨김) 처리하는 보안 역할을 수행합니다. 장기 작업 가시화와 다중 세션 파일 보호: Goal Tracker & Collision Guard 백그라운드에서 오래 실행되는 작업을 관리하기 위해 제작된 goal-tracker 모드는 /goal 명령어로 세션이 시작될 때 진가를 발휘합니다. 장기 에이전트 실행 시 현재 어떤 태스크를 수행 중인지, 몇 분이 경과했는지 파악하기 어렵다는 문제를 해결하기 위해, 에이전트가 생성한 실행 계획을 4~5단계의 체크리스트 UI( Goal Meter )로 변환해 실시간 진행률(%)과 경과 시간을 표시합니다. 다중 에이전트 환경에서 발생하는 치명적인 덮어쓰기 문제를 방지하는 모드가 collision-guard 입니다. 사용자가 여러 창에서 각각 다른 Claude 세션을 열어두고 병렬로 작업할 때, 특정 세션이 최근 30분 이내에 다른 세션에서 수정된 파일을 다시 쓰거나 편집(Edit, Write, NotebookEdit)하려 하면 즉각 실행을 중단합니다. 선택 옵션 동작 메커니즘 Proceed 충돌 경고를 무시하고 현재 세션의 수정을 그대로 파일에 반영 Move to a worktree Git Worktree를 별도로 생성하여 기존 수정 사항과 작업 분리 Cancel 파일 편집 요청을 즉시 거부하고 에이전트 동작을 중단 Other 대화창에 직접 지시사항을 입력하여 수동으로 해결 기존의 단순 hook 방식이 실행을 완전히 차단하거나 일방적인 스크립트를 돌렸다면, 이 모드는 파일 접근 이력을 검사한 뒤 UI 레벨에서 사용자에게 4가지 분기 선택지를 제공함으로써 에이전트가 다른 세션의 코드를 파괴하지 않도록 안전장치를 제공합니다. Claude Mods - The Biggest Claude Code Upgrade! 모드(Mods)의 본질: 외부 확장에서 내부 제어로의 진화 Claude Code v2.1.287 에 추가된 모드는 클라이언트 내부 런타임에 직접 상주하며 에이전트 루프, 도구 호출, UI 렌더링을 완전히 가로채고 재정의할 수 있는 내부 플러그인 아키텍처입니다. 기존의 스킬(Skills), 훅(Hooks), MCP 서버는 모두 클로드 코드 런타임 외부에 존재했습니다. 클로드 코드가 작업을 수행하다가 필요할 때 이 외부 도구들을 일회성으로 호출하는 방식이었기 때문에, 에이전트의 내부 실행 사이클이나 터미널 화면 출력 자체를 직접 제어하는 것은 불가능했습니다. 반면 모드는 클로드 코드 런타임 내부에 직접 상주하며 동작합니다. 이 구조는 모델이 프롬프트를 해석하고 실제 도구 호출(Tool call)을 실행하기 바로 전 단계에 모드가 직접 개입할 수 있음을 의미합니다. 모델의 출력을 가로채서 위험한 명령을 차단하거나, 파라미터를 강제로 수정하거나, 화면에 렌더링되는 결과물을 마스킹하는 제어권을 사용자에게 넘깁니다. DeepSeek Harness 가 모델 래퍼, 도구, 에이전트 루프 전체를 플러그인으로 교체 가능하게 만든 것과 동일한 설계 사상이 클로드 코드에 적용된 것입니다. 앤트로픽 자체도 이미 클로드 코드의 기본 기능 일부를 내부 모드로 구현해 배포하고 있습니다. 변경 사항을 보여주는 Diff 뷰( cc-plugin-diff )나 프로젝트 지침을 로드하는 AGENTS.md 지원 기능( cc-plugin-agents-md )이 대표적입니다. 향후 더 많은 코어 기능이 모드 형태로 전환될 예정이므로, 동일한 코어 엔진 위에서도 어떤 모드를 조합하느냐에 따라 사용자마다 완전히 다른 맞춤형 에이전트 하네스를 구축하게 됩니다. 구분 훅 (Hooks) 모드 (Mods) 실행 위치 프로세스 외부 (외부 셸 스크립트) 클로드 코드 내부 런타임 (JS/TS) 생명 주기 특정 이벤트마다 1회 실행 후 프로세스 종료 세션 시작 시 로드되어 세션 내내 상주 상태 유지 불가능 (호출 간 상태 유실) 가능 (세션 메모리 및 클로드 상태 저장) 제어 범위 사전 정의된 결정 반환 ( block 등) 명령 재작성, UI 렌더링 가로채기, 슬래시 커맨드 모드의 동작 메커니즘과 단일 모드의 3가지 개입 방식 모드는 register.ts 또는 register.js 파일을 통해 클로드 코드 이벤트에 등록됩니다. 빌드 단계 없이 디렉터리를 지정하면 핫 리로딩(Hot-reloading)을 지원하여, 코드를 수정하고 저장하는 즉시 열려 있는 세션에 반영됩니다. 단, 핫 리로딩 시 모드 내부 변수는 초기화되므로 영속성이 필요한 데이터는 클로드 코드의 내장 상태 객체( $.state )에 저장해야 합니다. 클로드 코드가 Bash 명령(예: git push --force )을 실행하려고 할 때, 등록된 모드 함수는 세 가지 인자를 전달받습니다: 이벤트 객체( e ), 클로드와 상호작용하는 인터페이스( $ ), 그리고 체인을 이어가는 next 함수입니다. 여기서 모드는 관찰(Observe), 재작성(Rewrite), 차단 및 직접 응답(Answer)의 세 가지 방식으로 동작할 수 있습니다. // Bash 도구 호출을 가로채는 모드 등록 예시 on('tool.call', { tool: 'Bash' }, async ($, e, next) => { // 1. 관찰 (Observe): 원래 흐름을 유지하며 로깅 // await next(e); // 2. 재작성 (Rewrite): 명령을 안전한 형태로 변경 // next({ ...e, command: "git push origin HEAD:fix-branch" }); // 3. 차단 및 직접 응답 (Answer): 명령을 취소하고 모델에게 반환 // return { deny: "No force pushes in this repo." }; }); 이 메커니즘은 단순 명령 제어뿐만 아니라 화면 렌더링 단계에도 그대로 적용됩니다. ui.render 이벤트를 가로채면 모델의 실제 컨텍스트는 손상시키지 않은 채 사용자가 보는 화면에서만 이메일이나 API 키 같은 민감 정보(PII)를 실시간으로 마스킹할 수 있습니다. 또한 터미널 상단에 고정 패널을 그려 로컬 GPU 서버(예: DGX Spark 클러스터)의 상태를 출력하거나, 컨텍스트 윈도우 사용량을 시각화하는 게이지를 띄우는 작업도 단일 모드 스크립트 안에서 동시에 처리됩니다. 세션 기록 기반 자동 모드 생성과 보안 검증 체계 모드는 일일이 코드를 작성할 필요 없이 클로드 코드 내에서 프롬프트만으로 자동 생성할 수 있습니다. 특히 효과적인 방법은 사용자의 이전 작업 기록(최근 20개 세션)을 클로드에게 분석시켜 자주 묻는 질문, 실행 전 망설였던 위험 명령( rm -rf 등), 매번 수동으로 확인하는 작업 패턴을 도출한 뒤 전용 모드로 변환하는 워크플로우입니다. # 과거 세션 기반 커스텀 모드 도출 프롬프트 Read this guide: claude.dev/blog/getting-started-with-claude-code-mods Go through my last 20 sessions and see how I use you day to day. 1. Things I keep asking you, or asking you to do. 2. Commands that make me nervous: ones I stopped, rejected, or had you undo. 3. How I check your changes. For each idea: a name, my exact words, a few 'What it should show' lines. Rank the ideas by how much they'd help me. Show me the ideas first. Don't build anything until I pick. 하지만 모드는 사용자의 권한을 그대로 위임받아 파일 시스템 읽기/쓰기, 임의 프로그램 실행, 네트워크 호출( $.http.fetch )을 직접 수행하므로 치명적인 보안 공격 벡터가 될 수 있습니다. 신뢰할 수 없는 외부 모드를 설치할 경우 세션 정보나 민감한 환경 변수가 탈취될 위험이 있습니다. 따라서 타인이 작성한 모드를 설치하기 전에는 반드시 claude plugin validate <경로> 명령어를 실행해야 합니다. 이 유효성 검사 도구는 해당 모드가 어떤 이벤트를 감시하고, 어떤 내부 함수( $.ui.ask , $.state.set 등)를 호출하며, 외부 네트워크 요청을 시도하는지 매니페스트와 코드를 분석해 명세화합니다. 불필요한 네트워크 통신이나 의심스러운 훅이 발견되면 즉시 설치를 중단해야 합니다. 정리 Claude Code v2.1.287의 모드(Mods) 시스템은 에이전트 확장 패러다임을 '외부 도구 호출'에서 '내부 런타임 제어'로 전환했습니다. 프로세스 수명과 함께 동작하는 모드는 도구 호출의 관찰·재작성·차단은 물론 UI 렌더링 영역까지 깊숙이 개입할 수 있습니다. 이를 통해 캐시 만료 전 핸드오프를 유도해 API 비용을 아끼거나( cache-keeper ), 다중 세션 간 파일 쓰기 충돌을 방지하고( collision-guard ), 민감 정보를 실시간 마스킹하는( recording-mode ) 정교한 제어가 가능해졌습니다. 사용자는 과거 세션 로그를 기반으로 자신에게 최적화된 모드를 직접 구축할 수 있게 되었으며, 강력해진 시스템 권한만큼 외부 모드 도입 시에는 정적 유효성 검증 명령어를 통한 사전 점검이 필수가 되었습니다. 다룬 영상 Claude Code Mods Are Game Changers. Set Up These 5 NOW. — Nate Herk | AI Automation · 11분 Claude Mods - The Biggest Claude Code Upgrade! — Prompt Engineering · 10분