Anthropic이 10월 1일 Claude Code에 mods 기능을 내놓았습니다. mods는 Claude Code의 화면과 동작을 사용자가 직접 바꾸는 확장 기능으로, 자연어로 요청하면 Claude가 그 코드를 대신 만들어 줍니다. 핵심은 ’부탁’이 아니라 ’강제’라는 점입니다. 지시문은 모델이 가끔 무시할 수 있지만, mods는 Claude가 행동하기 직전에 코드로 끼어들어 정해 둔 규칙을 반드시 지키게 합니다. 다만 mods는 sandbox(외부와 격리된 실행 환경) 없이 사용자 권한 그대로 실행되므로, 편리한 만큼 보안 위험도 큽니다.
mods가 바꾸는 것: 세 가지 역할
Claude Code를 만든 Boris Cherny는 이제 자연어 prompt만으로 Claude Code의 화면과 동작을 바꿀 수 있다고 밝혔습니다. Anthropic의 공식 발표 글은 조회수 400만 회를, Boris Cherny의 글은 80만 회를 넘겼습니다. Claude Code 팀의 한 엔지니어는 소프트웨어가 사용자의 작업 방식에 맞춰 모양을 바꿀 수 있는 것이 되어 간다고 설명했습니다.
기존 Claude Code를 쓰는 일은 사무실을 빌려 쓰는 것과 비슷합니다. 파일을 들여오고 화이트보드에 규칙을 적을 수는 있어도, 벽을 허물거나 자물쇠를 다는 일은 건물주의 허락 없이는 못 합니다. mods가 생기면서 사용자는 건물을 소유한 쪽에 가까워졌습니다. mods가 하는 일은 크게 세 가지입니다.
- 화면에 요소 더하기: prompt 입력창 위에 상태 표시줄이나 패널을 그립니다.
- 나가는 요청 바꾸기: Claude가 실행하려는 작업을 실행 전에 손봅니다.
- 행동 붙잡기: 위험한 작업을 사용자가 허락할 때까지 멈춰 둡니다.
초기 사례로는 context window(모델이 한 번에 기억하는 대화 분량) 사용률과 turn별 token 사용량을 입력창 위에 보여 주는 표시줄, rm -rf 같은 삭제 명령을 실행하기 전에 지워질 파일 목록을 보여 주는 장치가 나왔습니다. Claude가 일하는 동안 터미널에서 Doom 게임을 돌리는 mod까지 등장했습니다.
prompt, skill, mod는 어떻게 다른가
세 가지는 Claude에게 무언가를 시킨다는 점에서 비슷해 보이지만 작동하는 층위가 다릅니다.
| 구분 | 하는 일 | 강제력 |
|---|---|---|
| prompt | 한 번 내리는 지시 | 그 요청 한 번에만 적용 |
| skill | 제안서 문체 같은 참고 지침과 지식을 담아 두면 Claude가 필요할 때 찾아 씀 | 모델이 따를지 판단 |
| mod | Claude Code 클라이언트 자체를 바꾸고 실행 직전에 코드로 끼어듦 | 매번 hook 코드가 자동 실행 |
Anthropic의 문서도 system prompt의 지시는 요청일 뿐 보장이 아니라고 설명합니다. ’묻지 않고 이메일을 보내지 마라’는 지시를 모델이 가끔 놓칠 수 있다는 뜻입니다. mods는 hook(특정 시점마다 자동으로 실행되는 코드)을 써서 이런 규칙을 프로그램으로 지키게 합니다. mods는 터미널의 Claude Code와 데스크톱 앱의 Claude Code 탭에서만 동작하고, Claude Code 2.1.287 이상이 필요합니다. 일반 Claude 웹 채팅에서는 쓸 수 없습니다.
▲ prompt·skill·mod의 차이
내게 맞는 mod 찾기: 지난 14일 기록부터
남이 만든 mod 목록에서 고르는 것보다 자신의 사용 기록을 분석하는 편이 쓸모 있는 결과를 얻기 쉬워 보입니다. Claude Code는 모든 대화 세션을 컴퓨터의 숨김 폴더 .claude/projects 안에 JSON 파일로 저장합니다. Claude에게 이 폴더에서 지난 14일 치 세션을 분석하라고 요청하면 다음 세 가지 패턴을 찾아 줍니다.
- 여러 세션에서 되풀이한 prompt
- 삭제나 전송처럼 위험하거나 되돌릴 수 없는 명령
- 사람이 직접 검토해 달라고 한 요청
Claude는 찾은 패턴마다 mod, skill, 지시문 한 줄 가운데 무엇으로 풀어야 할지 나누고, 아낄 수 있는 시간과 작업에 주는 도움을 기준으로 순위를 매긴 뒤에 코드를 씁니다. 실제 사용 방식에서 출발하기 때문에 개인에게 맞는 제안이 나옵니다.
직접 만들어 본 세 가지 mod
삭제 전에 묻는 장치
첫 번째는 파일 삭제 명령을 붙잡는 mod입니다. Claude에게 ’삭제 명령은 모두 붙잡고, 실행과 취소 두 버튼으로 먼저 내게 물어보는 mod를 만들어 줘’라고 요청하면 Claude가 TypeScript로 plugin hook을 짜고, 검증용 테스트를 쓰고, 테스트를 돌린 뒤에 넘겨줍니다. 이어 hot reloading(세션을 다시 시작하지 않고 새 코드를 바로 적용하는 기능)을 켤지 묻는데, 켜면 지금 세션에서 바로 시험할 수 있습니다.
바탕화면의 초안 폴더를 지워 달라고 하자 입력창 위에 확인 상자가 떠 실행, 취소, 기타 가운데 고르게 했습니다. 취소를 누르자 삭제 명령이 통째로 막혔고 폴더는 그대로 남았으며, Claude는 삭제가 거절됐다고 기록했습니다.
보내기 전에 묻는 장치
두 번째는 외부로 메시지를 보내기 전에 승인을 받는 mod입니다. Gmail에서는 초안만 쓰게 하는 규칙을 지시문으로 두어도 그것은 요청일 뿐이라 확실하지 않습니다. 이 mod는 도구 이름에 send, reply, forward, publish가 들어간 호출을 모두 붙잡아 확인 창을 띄우고, 취소하면 초안으로 저장하게 만든 것입니다.
시험 삼아 다른 Gmail 계정으로 메일을 보내 달라고 하자 바로 보내지 않고 대상 앱, 받는 사람, 제목과 보내기·취소 선택지를 보여 주었습니다. 보내기를 누르자 메일이 실제로 전달됐습니다. 도구 이름의 동사로 판단하므로 Slack, Microsoft Teams, SNS 게시 도구에도 똑같이 적용됩니다.
무엇을 보고 답했는지 보여 주는 표시줄
세 번째는 Claude가 답하기 전에 한 외부 행동을 입력창 위에 한 줄로 보여 주는 mod입니다. 방문한 웹 페이지 수, 검색 횟수, 읽은 파일 수, 그 밖의 도구 호출 수를 세어 줍니다. Claude Code mods 문서를 확인해 세 줄로 요약해 달라고 하자 웹 페이지 1개(docs.claude.com), 검색 1회, 읽은 파일 0개, 기타 도구 호출 0회로 표시됐습니다. 12 곱하기 12를 묻자 아무것도 열지 않았고 기억이나 앞선 대화에서 나온 답이라고 알려 주었습니다. 답의 근거가 어디서 왔는지 바로 확인할 수 있는 셈입니다.
한 세션용에서 모든 세션용으로
대화 중에 만든 mod는 기본적으로 그 세션에서만 불러옵니다. 마음에 들면 ’이 mod를 지금 세션뿐 아니라 새 세션마다 불러오도록 유지해 줘’라고 요청합니다. 그러면 Claude가 전역 설정의 hook을 고쳐 새로 여는 작업 탭마다 자동으로 적용됩니다.
화면을 다시 그리고 다른 agent를 붙이는 데까지
Anthropic의 문서를 보면 mods로 할 수 있는 일은 더 넓습니다.
- 생각 중 표시, 작업 알림 배너 같은 화면 요소를 새로 그리거나 옆 패널과 입력 위젯을 만듭니다.
- 실행 전에 끼어들어 가벼운 질문은 저렴한 모델로, 복잡한 작업은 최상위 모델로 보내도록 나눌 수 있습니다.
- Claude의 대화 처리를 거치지 않고 바로 터미널 코드나 정해 둔 작업을 실행하는 slash command를 만듭니다.
- 보조 agent를 함께 돌릴 수 있습니다. Anthropic이 내놓은 ’You Should Know’는 Claude가 쓰는 코드를 실시간으로 지켜봅니다. Claude가 결제 호출에 자동 재시도를 넣자 고객에게 두 번 청구될 수 있다는 경고를 끼워 넣었습니다.
Claude Code의 diff 보기 화면과 AGENTS.md 지시문을 불러오는 기능도 사실은 mods와 같은 구조로 만든 기본 mod입니다. Anthropic은 더 많은 기본 기능을 이런 방식으로 나눠, 개발자와 IT 관리자가 기능을 켜고 끄며 회사 정책을 한곳에서 적용할 수 있게 할 계획입니다.
▲ 사용자 권한으로 도는 mods의 위험
남이 만든 mod를 경계해야 하는 이유
mods는 skill보다 위험이 훨씬 큽니다. skill이 Claude가 참고하는 지침이라면, mods는 Claude Code 안에서 사용자 시스템 권한 그대로 실행되는 코드이기 때문입니다. sandbox가 없으니 악성 mod는 다음과 같은 일을 할 수 있습니다.
- 환경 변수, API 키, 개인 파일을 읽고 인터넷으로 내보내기
- 아무 프로그램이나 실행하기
- 대화를 바꾸거나 prompt를 몰래 고쳐 쓰기
- 사용자 대신 도구 실행을 승인하거나 API 사용량을 몰래 쓰기
mods는 Claude Code에 내장된 권한 확인 창은 바꾸지 못하지만, 입력창 위에 그럴듯한 버튼과 입력 상자를 그릴 수는 있습니다. 그래서 mod가 그린 입력 상자에는 비밀번호, API 키, 접근 키를 절대 입력하지 말아야 합니다. 앞서 skill이 인터넷에 퍼질 때 보안 기업 Snyk가 공개된 skill 4,000개 가까이를 분석했더니 3분의 1 넘게 심각한 취약점이 있거나 자격 증명을 빼돌리는 코드를 품고 있었습니다. mods도 같은 길을 걸을 수 있다는 우려가 나오는 이유입니다.
삭제 명령을 막는 mod도 완벽한 방화벽은 아닙니다. Anthropic은 이런 mod가 명령 패턴을 읽어 판단하는 안전망일 뿐이며, Claude가 흔치 않은 문법으로 삭제를 실행하면 걸러지지 않을 수 있다고 주의를 줍니다.
정리: 안전하게 mods를 쓰는 순서
mods는 지시문만으로는 보장할 수 없던 규칙을 코드로 확실히 지키게 하는 도구로 보입니다. 다만 사용자 권한으로 바로 실행되므로 직접 만들어 쓰는 것이 기본입니다. 다음 순서로 시작해 볼 수 있습니다.
- Claude Code를 2.1.287 이상으로 업데이트합니다.
- Claude에게 .claude/projects 폴더의 지난 14일 세션을 분석해 mod로 풀 만한 반복 작업과 위험 명령을 찾게 합니다.
- 삭제·전송 확인처럼 필요한 mod를 prompt로 요청하고, 테스트를 쓰고 돌린 뒤 넘겨 달라고 합니다.
- hot reloading을 켜고 지금 세션에서 시험한 뒤, 마음에 들면 모든 세션에 불러오도록 유지해 달라고 합니다.
- 남이 만든 mod는 설치 전에 터미널에서 claude plugin validate 명령으로 hook 선언과 쓰는 기능을 확인합니다. 이 명령은 코드를 실행하지 않고 설정과 hook 선언만 살피므로, 압축 파일 안에 따로 든 스크립트는 잡아내지 못합니다. 믿을 만한 제작자의 것만 씁니다.
- mod가 이상하게 움직이면 plugin 메뉴의 설치 목록에서 그 mod를 고르고 Space 키로 끕니다. 원인을 찾을 때는 모든 mod, 외부 skill, 연결된 도구를 끈 safe mode로 Claude Code를 실행합니다.
가장 안전한 방법은 Claude에게 mod 코드를 직접 만들게 하고 각 줄이 무엇을 하는지 설명해 달라고 하는 것입니다.