Claude Code 'mods' 입문 — 에이전트를 내 규칙대로 바꾸는 법

지난 9월, Claude Code로 에이전틱 코딩 첫걸음을 함께 떼어봤는데요. 써보신 분들은 이런 생각 한 번쯤 하셨을 겁니다.

"위험한 명령어는 실행 전에 한 번 더 알려주면 좋겠는데…"
"지금 대화가 얼마나 쌓였는지 화면에 보이면 좋겠는데…"

이제 이런 바람을 직접 이룰 수 있습니다. 10월 1일, Anthropic이 Claude Code를 내 입맛대로 개조할 수 있는 mods(모드) 기능을 공개했거든요. 오늘은 mods가 무엇인지, 어떻게 시작하는지, 그리고 무엇을 조심해야 하는지 정리해드리겠습니다.

mods는 Claude Code의 '확장 프로그램'입니다

크롬 브라우저에 광고 차단기나 번역기 같은 확장 프로그램을 설치해보셨죠? 브라우저 자체는 그대로인데, 확장 프로그램 하나로 쓰는 경험이 완전히 달라집니다.

mods가 바로 그런 역할입니다. Claude Code 안에서 특정 순간에 실행되는 작은 TypeScript(또는 JavaScript) 함수인데요, 예를 들어 이런 순간에 끼어들 수 있습니다.

• Claude가 도구(명령어 실행, 파일 수정 등)를 쓰려고 할 때
• 내가 프롬프트를 입력했을 때
• 화면의 일부가 새로 그려질 때

그 순간에 mod가 상황을 지켜보거나, 내용을 바꾸거나, 아예 다른 동작으로 대체할 수 있습니다.

기존 hooks와 다른 점

Claude Code에는 원래 hooks, 스킬, MCP 같은 확장 방법이 있었습니다. 차이를 비유로 정리하면 이렇습니다.

구분기존 hooksmods

작동 위치	Claude Code 바깥	Claude Code 안쪽
방식	외부 스크립트·요청 실행	Claude Code가 직접 함수 호출
화면 꾸미기	불가	가능 (패널, 버튼 등)
비유	문밖에서 쪽지 전달	사무실 안에 자리 하나 마련

바깥에서 신호만 주고받던 방식에서, 안쪽에 들어와 함께 일하는 방식으로 바뀐 셈입니다.

mods로 할 수 있는 일 5가지

① 나만의 화면 추가 — 대화창 옆에 패널을 띄우거나, 입력창 위에 버튼·탭을 달 수 있습니다.

② 기존 화면 바꾸기 — 도구 실행 표시, 로딩 아이콘, 질문 창의 모양을 바꿀 수 있습니다.

③ 도구 실행에 끼어들기 — 실행 전에 잠깐 멈추고 사용자에게 묻거나, 도구를 실제로 돌리지 않고 답하거나, 특정 요청만 다른 모델로 보낼 수 있습니다.

④ 나만의 명령어 — 슬래시 명령어를 입력하면 Claude의 답변을 기다리지 않고 바로 내 함수가 실행됩니다.

⑤ 기능끼리 데이터 공유 — 한쪽에서 도구 사용 횟수를 세고, 다른 쪽에서 그 숫자를 화면에 띄우는 식입니다.

공개된 예시로 감 잡기

Anthropic이 소개한 예시를 보면 활용법이 바로 그려집니다.

Token Weather — 대화창(컨텍스트)을 얼마나 썼는지, 최근 12번의 대화 동안 어떻게 변했는지 작은 그래프로 보여줍니다. 지난번 비용 관리 편에서 다룬 "토큰 아끼기"를 눈으로 확인할 수 있는 셈이죠.

Blast Radius — 위험할 수 있는 셸 명령어를 실행 전에 표시하고, 그 명령이 영향을 줄 파일과 자원을 옆 패널에 보여줍니다. 이름 그대로 '폭발 반경'을 미리 보여주는 안전장치입니다.

참고로 Claude Code의 /diff 명령어와 AGENTS.md를 프로젝트 지침으로 읽어오는 기능도 이제 mod로 만들어져 기본 탑재돼 있습니다.

시작하는 방법

1단계: 버전 확인 — Claude Code v2.1.287 이상이 필요합니다. mods는 기본으로 켜져 있습니다.

2단계: 설치 — mods는 플러그인 안에 담겨 배포됩니다. Claude Code에서 /plugin 명령어로 설치하면 됩니다.

3단계: 직접 만들기 — 코드를 몰라도 괜찮습니다. Claude Code에게 "이런 mod 만들어줘"라고 말로 부탁할 수 있거든요. 예를 들면 이렇게요.

• "rm이나 force push 같은 명령어는 실행 전에 빨간 경고를 띄우는 mod 만들어줘"
• "오늘 수정한 파일 개수를 입력창 위에 보여주는 mod 만들어줘"

화면 표시는 터미널과 Claude 데스크톱 앱의 Code 탭에서 볼 수 있습니다.

반드시 알아야 할 보안 수칙

여기가 오늘 글에서 가장 중요한 부분입니다. mod는 내 권한 그대로 실행되는 코드이고, 샌드박스(격리 공간)에 갇혀 있지 않습니다.

즉 설치된 mod는 내 파일을 읽고 쓰고, API 키가 담긴 설정 파일을 보고, 모든 프롬프트를 들여다보고, 심지어 도구 실행을 나 대신 승인할 수도 있습니다. 다행히 권한 확인 창 자체는 mod가 바꿀 수 없지만, 승인 권한이 있는 mod라면 확인 창이 뜨기 전에 먼저 승인해버릴 수 있습니다.

그래서 이 수칙만큼은 꼭 지켜주세요.

• 믿을 수 있는 출처의 mod만 설치하기
• 설치 전 claude plugin validate 명령으로 먼저 점검하기
• 이상하면 --safe-mode로 실행하거나, disableAllHooks 설정으로 mod 전체 끄기
• 회사에서 쓴다면 관리자 설정으로 허용된 mod만 불러오게 하기

지난 가드레일 편에서 말씀드린 "연결하기 전에 출처를 확인하라"는 원칙이 mods에서는 몇 배로 중요해집니다.

📌 오늘의 핵심 요약

• mods는 Claude Code 안에서 실행되는 작은 TypeScript 함수로, 브라우저 확장 프로그램처럼 동작과 화면을 바꿉니다.
• 화면 추가, 도구 실행 중간 개입, 나만의 명령어 등 기존 hooks보다 훨씬 깊게 개조할 수 있습니다.
• v2.1.287 이상에서 /plugin으로 설치하며, Claude Code에게 직접 만들어달라고 부탁할 수도 있습니다.
• mod는 내 권한 그대로, 격리 없이 실행됩니다. 신뢰할 수 있는 출처만 설치하세요.
• 설치 전 점검(validate), 문제 시 안전 모드(--safe-mode)를 기억해두세요.

💡 낯선 용어가 있으셨나요? 👉 AI·IT 용어사전 · IT비즈니스 용어사전 · 블로그·웹 용어사전