클로드 코드 Mods(모드) 정리: 직접 만드는 창·명령어, 공식 예제와 설치 전 주의점
10월 1일 클로드 코드 v2.1.287에 Mods(모드)가 추가됐어요. 게임 모드처럼 클로드 코드 안에 내가 원하는 창·버튼·/명령어를 직접 넣는 개조 기능이에요. 키보드 Shift+Tab으로 바꾸는 ‘권한 모드’와는 다른 기능이에요. 공식 문서와 앤트로픽이 공개한 예제를 기준으로 정리했어요(2026년 10월 3일 확인).
Mods가 뭔가요

Mod는 클로드 코드가 어떤 일을 할 때마다 끼어드는 작은 프로그램이에요. AI가 도구를 쓰려 할 때, 내가 질문을 보낼 때, 화면을 그릴 때 그 순간을 지켜보거나(관찰), 바꾸거나(수정), 대신 처리(응답)할 수 있어요. 자바스크립트나 타입스크립트로 만들고, 원하는 걸 말로 설명하면 클로드가 Mod를 대신 짜 줘요.

v2.1.287 이상이면 기본으로 켜져 있어요. 내 버전은 터미널에서 claude --version으로 확인해요. 같은 날 ‘You should know’라는 기본 Mod도 함께 나왔는데, 옆에서 다른 AI가 지켜보다가 놓치기 쉬운 걸 알려 주는 기능이에요(직접 켜야 해요).
이런 걸 만들 수 있어요
공식 문서의 첫 예제는 AI가 도구를 몇 번 썼는지 세서 스피너 옆에 보여 주는 Mod예요. 파일 3개, 코드 몇 줄이에요. 아래 영상은 공식 문서 시연이에요. 화면 아래 ‘tool calls: 1…2…3…’이 올라가는 걸 보세요.
도구 사용 횟수를 세는 Mod · 출처: Claude Code 공식 문서 시연 영상


AI 차례를 기다리지 않고 바로 실행되는 나만의 /명령어도 만들고, 입력칸 위나 옆에 탭·버튼·입력칸이 달린 창도 띄울 수 있어요. 클로드 코드가 원래 그리는 화면(도구 실행 줄, 스피너, 질문 창)을 바꾸는 것도 돼요.
앤트로픽 공식 예제 3가지

Blast Radius는 AI가 rm -rf, git reset --hard, 강제 푸시, DB 마이그레이션 같은 걸 하려 하면 실행 전에 붙잡고 지워질 파일이나 사라질 커밋을 보여 준 뒤 진행·취소를 고르게 해요. 실수로 날리는 사고를 막는 데 바로 쓸 만해요.


Replay Theater는 /replay로 방금 AI가 고친 파일을 한 단계씩 다시 보여 주고, Token Weather는 대화창이 얼마나 찼는지 맑음·소나기·폭풍으로 보여 줘요. 세 예제는 claude-code-playground 저장소에 있고, 지원 없이 ‘있는 그대로’ 공유된 거예요.
훅·스킬·MCP와 뭐가 달라요?

가장 큰 차이는 화면을 그릴 수 있느냐예요. 훅·스킬·MCP는 클로드 코드 밖에서 돌아서 창을 못 띄워요. 막기·허용만 필요하면 훅, 반복 지시면 스킬, 외부 서비스 연결이면 MCP로 충분하고, 창·명령어가 필요할 때 Mod를 고르면 돼요. 창·버튼은 터미널과 데스크톱 앱에서만 보이고, VS Code 채팅 패널에서는 동작만 하고 화면은 안 보여요.
설치 전에 꼭 확인할 것

Mod는 내 권한으로 도는 코드라 파일, 환경변수에 넣어 둔 API 키, 네트워크에 다 닿아요. 샌드박스 밖에서 돌기도 하고요. 그래서 공식 문서도 믿을 수 있는 곳의 Mod만 쓰라고 해요. 설치 전에 claude plugin validate <폴더>로 그 Mod가 무슨 일을 하는지 목록을 볼 수 있고, 이상하면 claude --safe-mode로 켜서 전부 끌 수 있어요. 다행히 권한 확인 창 내용은 Mod가 바꿀 수 없어요.
출처
· Claude Code 공식 문서 — Mods overview · Create a mod
· Claude Code 변경 기록 (2.1.287)
· Anthropic 공식 예제 claude-code-playground
(모두 2026년 10월 3일 확인)
컴퓨터가 고장 났다면 부산 컴퓨터수리 · 출장수리 부컴에 맡겨 주세요. 부산·울산·김해·양산 어디든 직접 방문합니다.
