Claude Code에 화면·동작 바꾸는 Mods 도입
앤트로픽이 Claude Code 2.1.287(10월 1일)에서 Mods를 도입했다. 플러그인으로 설치하는 JavaScript·TypeScript 코드로, 화면 창과 버튼을 그리고 도구 호출을 바꾸거나 승인할 수 있다. 샌드박스 없이 사용자 권한으로 실행된다.
앤트로픽이 Claude Code에 Mods를 도입했다. 10월 1일 공개된 2.1.287 버전의 업데이트 기록에 "Claude Mods: 플러그인(plugin)이 더 깊은 동작을 바꿀 수 있다"고 올라 있다. 공식 문서에 따르면 Mod는 JavaScript나 TypeScript로 쓴 이벤트 핸들러(event handler) 묶음이다. 도구 호출(tool call)이나 제출 같은 이벤트가 생기면 Claude Code가 이를 실행하고, 핸들러는 이벤트를 지켜보거나 바꾸거나 대신 처리할 수 있다. 설치는 /plugin install 이름@마켓플레이스로 하며 CLI와 데스크톱 앱의 Code 탭에서 쓸 수 있다.
기존 훅(hook), , 서버가 Claude Code 바깥에서 도는 것과 달리 Mod는 안에서 돈다. 문서가 꼽은 할 수 있는 일은 다음과 같다.
- 화면 그리기: 대화창 옆 창(pane)이나 프롬프트 위 띠(band)에 탭, 버튼, 입력란을 그린다.
- 기본 화면 바꾸기: 도구 호출 줄, 로딩 표시(spinner), Claude가 질문하는 대화 상자처럼 Claude Code가 그리던 부분을 바꾼다.
- 도구 호출·프롬프트 다루기: 도구 호출을 지켜보거나 고치거나 승인하고, 프롬프트를 바꾸거나 사용자가 입력한 것처럼 제출한다.
- 명령 추가: Claude의 응답 없이 바로 실행되는
/command를 만든다. Claude가 작업하는 중에도 실행된다. - 그 밖: 모델 호출, 타이머 작업, 다른 세션에 메시지 보내기, 파일·네트워크 접근. 한 Mod 안의 핸들러끼리는 변수를 공유한다.
앤트로픽은 (context window) 사용량을 보여주는 token-weather, 위험한 셸 명령을 실행 전에 멈추고 영향을 보여주는 blast-radius, 직전 턴의 파일 수정을 하나씩 다시 보여 주는 replay-theater를 예제로 공개했다. Claude Code의 /diff도 Mod로 만들어졌다.
Mod는 샌드박스(sandbox) 없이 사용자 권한으로 실행된다. 문서는 Mod가 파일 읽기·쓰기, 프로그램 실행, 네트워크 요청, 환경변수와 설정 파일에 든 API 키 읽기, 도구 호출 사전 승인까지 할 수 있다고 적었다. 권한 확인 창(permission prompt)만은 Mod가 바꿀 수 없다. 신뢰하는 작성자의 Mod만 설치하라고 권고하며, claude plugin validate로 설치 전에 Mod가 처리하는 이벤트를 볼 수 있다. 세션 전체를 끄는 --safe-mode, 조직 관리자용 제한 설정도 있다.
설정 파일에 명령을 적어 두는 훅과 달리 Mod는 화면까지 바꿀 수 있어 쓰임새가 넓다. 그만큼 샌드박스 밖에서 사용자 권한으로 돌기 때문에, 설치 전 claude plugin validate로 어떤 이벤트를 처리하는지 확인하는 단계가 문서가 권하는 안전 절차다. 문서와 업데이트 기록은 10월 4일 직접 열어 확인했고, Mod를 설치해 써 보지는 않았다.
