클로드 코드 Mods 사용법, 말로 띠·패널·위험 명령 차단 만들기

클로드 코드 Mods는 Claude Code의 화면과 동작을 내 방식대로 바꾸는 기능입니다. 원하는 것을 말로 부탁하면 클로드가 직접 Mod를 만들어 줍니다. 입력창 위 띠, 오른쪽 패널, 위험한 명령 붙잡기 세 가지를 만드는 15단계와 함께, 만든 Mod를 끄고 남기는 방법과 보안 주의점까지 정리했습니다.

클로드 코드 Mods란 무엇인가

Mod는 클로드 코드의 모양과 동작을 바꾸는 플러그인입니다. 안에는 자바스크립트나 타입스크립트로 쓴 이벤트 처리 함수가 들어 있습니다. 클로드가 도구를 쓰려 할 때, 내가 프롬프트를 보낼 때, 화면의 한 부분을 그릴 때 같은 순간에 클로드 코드가 이 함수를 불러 줍니다. 함수는 그 일을 지켜보기만 할 수도, 바꿀 수도, 대신 처리할 수도 있습니다.

새 기능이 수시로 붙는 클로드 코드에서 다 알아 둘 필요는 없지만, Mods는 눈여겨볼 만한 변화입니다. 클로드 코드를 만든 앤트로픽의 보리스 체르니가 직접 소개했고, 이 기능을 써 본 개발자들도 큰 변화라고 평가합니다. 지금까지는 클로드 코드를 주어진 그대로 썼다면, 이제는 일하는 방식에 맞게 고쳐 쓸 수 있게 된 것입니다.

공식 문서가 꼽는 Mod의 쓰임은 이렇습니다.

• 대화 옆에 패널을 붙이거나 입력창 위에 띠를 띄운다. 탭, 버튼, 입력칸도 넣을 수 있다.
• 클로드 코드가 원래 그리는 부분(도구 실행 줄, 진행 표시 등)을 바꿔 그린다.
• 도구 실행을 붙잡는다. 예를 들어 위험한 명령을 실행 전에 멈추고 사용자에게 묻는다.
• 클로드를 거치지 않고 바로 실행되는 나만의 슬래시 명령(/명령)을 만든다.

비슷한 기능과의 차이도 알아 두면 고르기 쉽습니다. 설정 파일에 적는 훅(settings hook)은 셸 명령으로 도구 실행을 막거나 허용하는 정도까지이고, 화면에 무언가를 그릴 수는 없습니다. 스킬은 클로드가 읽는 지시문, MCP 서버는 외부 시스템과 연결하는 통로입니다. 화면에 패널이나 띠를 띄우고 싶다면 Mod가 맞습니다.

시작 전에: 버전과 준비물

버전 조건

Mods는 아래 버전부터 기본으로 켜져 있습니다.

• 터미널판 Claude Code 2.1.287 이상
• 데스크톱 앱(Code 탭) 2.1.286 이상

터미널에서는 아래 명령어로 버전을 확인합니다. 데스크톱 앱은 Code 탭의 로컬 세션에서 /status를 입력하고 Claude Code 줄의 숫자를 봅니다.

claude --version

버전이 낮으면 클로드 코드를 먼저 업데이트합니다. VS Code 확장의 채팅 패널이나 claude -p 같은 비대화형 실행에서는 Mod가 화면에 아무것도 그리지 못하니, 터미널이나 데스크톱 앱에서 따라 합니다.

준비물과 예상 시간

• 위 버전 조건을 만족하는 Claude Code
• 지워져도 괜찮은 시험용 프로젝트 폴더. 4장의 지우기 시험에 쓸 build 폴더가 그 안에 있어야 합니다. 없으면 시험용 폴더에서 아래 명령으로 만듭니다.

mkdir -p build && touch build/test.txt

• 비용: Mods 자체는 별도 요금이 없습니다. Mod를 만드는 동안 클로드가 일하므로 쓰는 요금제의 사용량이 그만큼 줄어듭니다.

예상 시간은 10분 정도입니다. 한 번 시험해 본 사례로는 띠 Mod가 17초, 패널 Mod가 1분 14초, 위험 명령 붙잡기 Mod가 35초 만에 만들어졌습니다.

요청 문장은 내 말로 바꿔도 된다

아래 코드블록의 요청 문장은 예시입니다. 원하는 것을 말로 설명하면 클로드가 Mod를 만들어 주므로, 문장은 내 말로 바꿔 써도 됩니다. 클로드는 plugin-authoring이라는 내장 스킬을 보고 Mod를 어디에 어떻게 쓸지 정합니다.

Mod를 만들면 어디에 저장되고 어떻게 켜지나

클로드가 쓴 Mod는 ~/.claude/dev-mods/세션ID/Mod이름/ 폴더에 저장됩니다. ~/.claude는 보호된 경로라서, 기본 권한 모드에서는 클로드가 Mod 파일을 하나 만들 때마다 승인 창이 뜹니다. 하나씩 승인하면 됩니다.

첫 파일이 저장될 때 클로드 코드가 이번 세션에서 핫 리로드(파일이 바뀌면 바로 다시 불러오기)를 켤지 묻습니다.

• Enable for this session: 이번 세션에서 클로드가 만든 Mod가 그 턴이 끝날 때 바로 켜지고, 고칠 때마다 다시 불러옵니다.
• Not now: 지금은 켜지지 않습니다. 파일은 남아 있다가 그 세션을 다음에 다시 열 때 켜집니다.

따라 하기에서는 Enable for this session을 고릅니다.

클로드 코드 Mods 따라 하기 15단계

1. 클로드 코드 열기

1단계. 시험용 프로젝트 폴더에서 Claude Code를 실행합니다

터미널판은 그 폴더로 이동해 claude를 입력하고 엔터를 누릅니다. 데스크톱 앱은 앱을 열고 Code 탭에서 그 폴더를 고릅니다.

확인: Claude Code 입력창이 보입니다.

2. 입력창 위에 "오늘 목표" 띠 띄우기

2단계. 입력창에 아래 요청을 입력합니다

입력창 위에 오늘 목표를 띄워 줘

띄울 목표 문장을 함께 적어도 됩니다. 예를 들어 "입력창 위에 오늘 목표를 띄워 줘. 목표는 로그인 화면 완성"처럼 씁니다.

확인: 입력창에 요청 문장이 들어가 있습니다.

3단계. 엔터 키를 누릅니다

파일 생성 승인 창이 뜨면 승인하고, 핫 리로드를 물으면 Enable for this session을 고릅니다.

확인: 클로드가 Mod를 만들고 응답을 마칩니다.

4단계. 입력창 위쪽을 봅니다

확인: 입력창 위에 오늘 목표 띠가 떠 있습니다.

3. 오른쪽 패널 붙이기

5단계. 입력창에 아래 요청을 입력합니다

오른쪽에 패널을 붙여서 클로드가 쓰는 도구와 고친 파일을 실시간으로 보여 줘

확인: 입력창에 요청 문장이 들어가 있습니다.

6단계. 엔터 키를 누릅니다

1분 넘게 걸릴 수 있습니다. 중간에 멈추지 말고 응답이 끝날 때까지 기다립니다.

확인: 오른쪽에 패널이 생깁니다.

7단계. 입력창에 파일 두 개를 고쳐 달라는 요청을 입력합니다

시험용 폴더의 중요하지 않은 파일로 합니다. 예를 들면 "README.md 맨 아래에 한 줄 추가하고, test.txt 파일을 새로 만들어 줘"처럼 씁니다.

확인: 입력창에 요청 문장이 들어가 있습니다.

8단계. 엔터 키를 누릅니다

확인: 클로드가 파일 수정을 진행합니다.

9단계. 오른쪽 패널을 봅니다

확인: 고친 파일과 쓴 도구가 패널에 바로 기록돼 있습니다.

4. 위험한 명령 붙잡기

순서 고정: 10~12단계(붙잡는 Mod 만들기)를 먼저 끝낸 뒤 13~15단계(지우기 시험)를 합니다. 순서를 바꾸면 폴더가 실제로 지워질 수 있습니다.

10단계. 입력창에 아래 요청을 입력합니다

rm -rf 같은 위험한 명령은 실행 전에 붙잡아 줘

rm -rf는 폴더와 그 안의 파일을 확인 없이 통째로 지우는 명령입니다.

확인: 입력창에 요청 문장이 들어가 있습니다.

11단계. 엔터 키를 누릅니다

확인: 클로드가 Mod를 만듭니다.

12단계. Mod가 켜졌는지 확인합니다

클로드 응답이 끝나면 /plugin을 입력하고 Tab 키로 Installed(설치됨) 탭으로 갑니다.

확인: 방금 만든 Mod가 목록에 있습니다. 확인한 뒤 Esc로 닫습니다.

13단계. 입력창에 빌드 폴더를 지워 달라는 요청을 입력합니다

빌드 폴더 지워 줘

꼭 지워져도 되는 시험용 폴더에서 합니다.

확인: 입력창에 요청 문장이 들어가 있습니다.

14단계. 엔터 키를 누릅니다

확인: 실행 직전에 멈추고, 무엇이 지워지는지 보여 주며, 진행할지 묻습니다.

15단계. "취소"를 누릅니다

진행 여부를 묻는 창에서 취소(Cancel)에 해당하는 버튼이나 선택지를 고릅니다. 모양은 클로드가 만든 Mod마다 조금씩 다릅니다.

확인: 명령이 실행되지 않고, build 폴더가 그대로 남아 있습니다.

마지막 점검

• Claude Code 버전이 터미널 2.1.287 이상(앱 2.1.286 이상)이다.
• 입력창 위에 오늘 목표 띠가 보인다.
• 오른쪽 패널에 고친 파일과 쓴 도구가 기록된다.
• 폴더 지우기 요청 때 실행 직전에 멈추고 진행 여부를 묻는다.
• 취소하면 폴더가 그대로 남는다.

만든 Mod 끄기, 지우기, 다른 세션에서 쓰기

클로드가 대화 중에 만든 Mod는 그 세션에서만 켜집니다. 세션 폴더는 cleanupPeriodDays 설정 기간이 지나면 클로드 코드가 지웁니다.

• 하나만 끄기: /plugin의 Installed 탭에서 그 Mod를 끕니다.
• 아예 안 켜지게 하기: ~/.claude/dev-mods/세션ID/ 아래의 그 Mod 폴더를 지웁니다.
• 이번 세션만 모든 Mod 끄기: 클로드 코드를 claude --safe-mode로 실행합니다. 다른 사용자 설정도 함께 꺼집니다.
• 모든 세션에서 내가 설치한 Mod 끄기: ~/.claude/settings.json에 "disableAllHooks": true를 넣습니다. 설정 파일 훅과 상태 표시줄도 같이 멈춥니다.

마음에 드는 Mod를 계속 쓰려면 폴더를 내 자리로 복사해 둡니다. 예를 들어 ~/mods/goal-band로 옮긴 뒤 아래처럼 실행하면 그 세션에서 Mod가 켜집니다.

claude --plugin-dir ~/mods/goal-band

막힐 때

요청해도 Mod가 만들어지지 않는다

버전부터 확인합니다(터미널 2.1.287 이상, 앱 2.1.286 이상). 그다음 이런 경우인지 봅니다. 폴더를 처음 열 때 뜨는 신뢰 확인(trust)을 수락하지 않았거나, --safe-mode·--bare로 실행했거나, disableAllHooks를 켜 두었거나, 회사 관리 설정이 Mod를 막고 있으면 클로드가 쓴 Mod는 켜지지 않습니다.

만들었는데 화면에 아무것도 안 보인다

핫 리로드 질문에 Not now를 골랐을 수 있습니다. 그 경우 파일만 저장되고 Mod는 켜지지 않습니다. VS Code 확장의 채팅 패널처럼 Mod가 그림을 그리지 못하는 곳에서 실행 중인지도 봅니다.

패널이 바로 안 생긴다

패널처럼 큰 Mod는 1분 정도 걸립니다. 응답이 끝날 때까지 기다립니다.

지우기 시험 때 바로 실행될까 걱정된다

붙잡는 Mod를 만들기 전에 시험하면 막아 줄 것이 없습니다. 10~12단계를 먼저 끝내고 12단계에서 Mod가 켜졌는지 확인한 다음, 지워져도 되는 시험용 폴더로만 시험합니다.

그 밖의 쓰임과 공식 샘플 Mod

작업이 끝나면 알림을 띄우는 Mod, 나만의 슬래시 명령을 만드는 Mod도 같은 방식으로 부탁하면 됩니다. 다른 개발자들은 사용량 한도를 화면에 띄우는 Mod, 캐시 만료를 알려 주는 Mod도 만들었습니다.

앤트로픽이 공개한 샘플 Mod도 있습니다. claude-code-playground 저장소의 claude-code/mods 폴더에 들어 있고, 지원 없이 있는 그대로 공유됩니다.

• token-weather: 컨텍스트 창이 얼마나 찼는지 입력창 위에 날씨 예보처럼 보여 준다.
• blast-radius: rm -rf나 강제 푸시 같은 위험한 명령을 붙잡고, 무엇이 바뀌는지 보여 준 뒤 진행·취소 버튼을 띄운다. 위 4장에서 만든 Mod와 같은 일을 한다.
• replay-theater: /replay 명령으로 클로드가 직전 턴에 고친 파일을 차례로 다시 보여 준다.

샘플을 써 보려면 저장소를 내려받은 뒤 그 Mod 폴더를 --plugin-dir로 지정해 클로드 코드를 실행합니다.

Mod를 깔기 전에 알아 둘 보안

Mod는 내 권한으로 돌아가는 코드입니다. 공식 문서 기준으로 Mod는 내 계정이 접근할 수 있는 파일을 읽고 쓰고, 프로그램을 실행하고, 네트워크 요청을 보낼 수 있습니다. 환경 변수와 설정 파일에 든 API 키도 읽을 수 있고, 도구 실행을 내 대신 승인할 수도 있습니다. 샌드박스를 켜도 Mod가 띄운 프로세스는 그 밖에서 돕니다.

그래서 남이 만든 Mod는 믿을 수 있는 작성자와 마켓플레이스에서만 받습니다. 설치하기 전에 내려받은 폴더에 아래 명령을 실행하면, 그 Mod가 어떤 이벤트를 다루고 무엇을 하려는지 코드를 돌리지 않고 볼 수 있습니다.

claude plugin validate ./some-mod

출력의 hooks: 줄은 Mod가 다루는 이벤트, calls: 줄은 Mod가 요청하는 동작(파일 읽기, 네트워크 요청 등)입니다. 한 가지 안심할 점은, Mod가 화면 대부분을 바꿀 수 있어도 권한 확인 창은 바꾸지 못한다는 것입니다.

• 공식 문서: code.claude.com/…
• 공식 샘플 Mod: github.com/…