Claude Code 모드 시작하기

Claude Code 모드(mod) 는 세션 안에서 실행되는 JavaScript/TypeScript 확장으로, 이벤트를 관찰하거나 기본 동작을 바꾸고 터미널과 데스크톱 앱에 맞춤 UI를 그릴 수 있음 모드는 플러그인에 포함된 훅 체인으로 동작하며, 이벤트를 그대로 넘겨 관찰하거나 입력을 수정하거나 기본 동작 대신 직접 응답할 수 있음 약 80줄의 Token Weather 예제는 매 턴 컨텍스트 사용량을 읽어 프롬프트 위에 날씨 형태로 표시하며, 핫 리로드 이후에도 기록을 유지하고 UI를 자동 갱신함 Blast Radius는 위험한 명령을 실행 전에 검토하게 하고, Replay Theater는 직전 턴의 파일 수정을 차례로 보여줌 Claude Code 2.1.287 이상에서 모드가 기본 활성화되며 API는 릴리스마다 바뀔 수 있음. 모드는 Claude Code와 같은 접근 권한을 가지므로 신뢰할 수 있는 저장소만 설치해야 함 모드의 구조와 동작 방식 모드는 설정, 권한 규칙, 슬래시 명령, 스킬, 상태 표시줄보다 더 깊게 Claude Code를 바꿀 수 있음 자주 확인하는 정보를 표시하거나, 특정 명령 앞에 확인 절차를 두거나, 원하는 방식의 변경 검토 화면을 만들 수 있음 claude를 실행한 뒤 원하는 모드를 자연어로 요청하고 핫 리로드를 허용하면, 턴이 끝날 때 모드가 나타남 모드는 일반적인 Claude Code 플러그인 구조를 사용함 .claude-plugin/plugin.json에 매니페스트를 두고, hooks/hooks.json의 modules에 모듈 하나를 지정함 모듈은 register(on, options)를 내보내며, 내부에서 on(event, matcher?, hook)으로 훅을 등록함 훅은 ($, e, next)를 받아 미들웨어처럼 연결됨 $는 UI, 세션, 상태, 저장소, 파일, 프로세스, 시계, HTTP, 도구, 명령, 모델 등에 접근하는 API임 e는 이벤트 입력 데이터이며, next(e)는 다음 플러그인으로 이벤트를 넘김 체인 끝에서는 Claude Code의 기본 동작이 실행됨 훅의 동작은 관찰, 수정, 직접 응답으로 나뉨 관찰: await next(e)의 결과를 확인한 뒤 그대로 반환함 수정: next({ ...e, command: safer })처럼 이후 체인이 받을 입력을 바꿈 직접 응답: next를 호출하지 않고 거부 결과를 반환하거나 명령과 도구를 직접 처리함 이벤트는 도구 호...