mods가 바꾸는 것
2026년 10월 1일자 Anthropic 제품 글은 mods를, CLI와 데스크톱 앱에서 Claude Code가 동작하는 방식을 바꾸는 짧은 TypeScript 함수로 소개합니다. 글은 개발자들이 Anthropic이 기능을 내놓기까지 기다리지 않고 더 많은 제어를 요청해 왔다고 말합니다. 훅은 이미 그 제어의 일부를 제공했습니다. Anthropic은 훅이 이벤트를 다시 쓰거나, 새 UI를 그리거나, 기능을 대체할 수 없고, mods는 할 수 있다고 말합니다. 글은 출시 전에 설계를 GitHub에 공유해 피드백을 받았다고 하면서, 그 논의의 링크는 밝히지 않습니다. mod는 프롬프트를 다시 쓰거나, UI를 더하거나, 기본 기능을 대체하거나, 새 동작을 더할 수 있습니다. 배포 단위는 플러그인입니다. Claude Code가 확장을 설치하고 나누는 데 이미 쓰는 패키지입니다. ClaudeDevs는 같은 날, TypeScript 몇 줄을 쓰거나 Claude에게 mod를 만들게 한 뒤 CLI나 데스크톱 앱에서 /plugin으로 설치한다고 올렸습니다. 그 포스트는 "A few examples:"라는 줄로 끝납니다. ClaudeDevs의 후속 글은 팀이 /diff와 AGENTS.md 지원에 mods를 썼고, 미리 만든 샘플 mod를 Claude Code Playground 저장소에 더하는 중이라고 말합니다.
제품 글은 Claude Code가 하는 일마다 이벤트를 내보낸다고 말합니다. 예는 도구 호출, 권한 요청, 화면 일부 그리기입니다. mod는 그 이벤트 전, 후, 대신 연결하거나, 앞과 뒤에서 코드가 돌도록 감쌉니다. 함수 하나로 프롬프트가 모델에 닿기 전에 다시 쓰거나, 도구 호출을 막거나 다시 쓰거나 재시도하거나, 권한 요청을 승인하거나 거부하거나, Claude가 도구 출력을 읽기 전에 비밀 값을 가릴 수 있습니다. 시작 가이드의 이벤트에는 제출된 프롬프트, 턴의 시작과 끝, 세션의 시작과 끝, 슬래시 명령, 그리고 인터페이스의 각 조각이 그려질 때의 ui.render도 들어 있습니다. 그 가이드에서 훅은 미들웨어처럼 체인을 이룹니다. 훅은 next를 호출하고 돌아온 값을 읽어 관찰하거나, 바뀐 이벤트와 함께 next를 호출해 다시 쓰거나, next를 호출하지 않고 응답합니다. 예를 들면 deny를 반환하는 경우입니다. mod는 터미널, 데스크톱 앱, 또는 둘 다를 대상으로 할 수 있습니다. 여러 mod가 같은 이벤트에 연결되면 로드 순서대로 실행됩니다. 먼저 로드된 mod가 이벤트를 다른 mod보다 먼저 보고, 그들이 끝난 뒤의 결과를 봅니다. 서로 다른 작성자의 mod가 겹쳐 쌓이는 방식입니다.
시작 가이드의 샌드박스 문장은, 모듈이 DOM도 Node도 없는 자기 샌드박스에서 돌고 바깥의 모든 것은 $ 호스트 API를 거친다는 뜻입니다. 제품 글에서 mods가 샌드박스되어 있지 않다고 한 줄은, 그 API를 통해 Claude Code와 같은 머신 접근을 가진다는 뜻입니다. 신뢰하는 출처에서만 설치합니다. 가이드는 모듈이 JavaScript 또는 TypeScript이고 세션 동안 로드된 채로 남는다고 말합니다. settings 훅은 이벤트마다 셸 명령을 실행하고 stdin과 stdout으로 JSON을 주고받습니다. mod는 한 번 로드되고, 상태를 유지할 수 있고, 갱신되는 UI를 그릴 수 있고, Claude Code를 다시 호출할 수 있습니다.
누가 쓸 수 있고, 어떤 통제가 따르는가
시작 가이드는 Claude Code 2.1.287 이상을 요구합니다. mods는 기본으로 켜져 있고, API는 릴리스 사이에 바뀔 수 있습니다. 로드할 때마다 그 빌드의 타입 선언을 .claude-plugin/types/에 쓰며, 가이드는 이것을 해당 버전의 기준이라고 부릅니다. Claude Code changelog는 추가를 한 줄로 적습니다. "Added Claude Mods: plugins may now modify deeper behavior." 2.1.287이라는 최소 버전은 시작 가이드에 나옵니다. 제품 글, 가이드, changelog는 mods의 가격을 밝히지 않습니다. 제품 글은 CLI와 데스크톱 앱을 지목합니다.
플러그인 마켓플레이스의 허용과 차단 통제는 그대로 적용됩니다. Team 또는 Enterprise 소유자가 관리 콘솔에서 설정합니다. Claude API와 서드파티 API 플랜에서는 관리자가 사용자 머신에 managed settings를 푸시합니다. Team과 Enterprise 플랜, 그리고 managed settings가 있는 모든 머신에서는 sec-default("security default")라는 기본 제공 mod가 먼저 로드됩니다. 이것은 사용자가 설치한 mod가 권한 거부 규칙을 덮어쓰는 것과 같은 위험한 동작을 하지 못하게 막습니다. 제품 글은 무엇이 제한되는지 소스를 볼 수 있다고 말하고, 그 목록은 소스에 남겨 둡니다. 관리자는 자기 mod를 먼저 로드할 수 있고, 목록에 sec-default를 유지하라는 안내를 받습니다. 기본 제공 /diff는 이제 mod로 배포되므로 /plugin에서 끄거나 교체할 수 있습니다. 가이드는 AGENTS.md 지원과 /diff 창이 mod이며, 소스와 테스트가 공개 anthropics/claude-code 저장소의 mods/ 아래에 있다고 말합니다. Anthropic은 시간이 지나며 더 많은 기본 기능을 mods로 옮길 계획이라고 합니다. 제품 글의 팀 예는 CI/CD 상태 창, 명령이 프로덕션 설정을 건드리기 전의 확인, 먼저 로드되는 mod가 남기는 감사 로그입니다. 그 프로덕션 확인은 밑그림입니다. 가이드의 Blast Radius 예가 구체적으로 작성된 명령 검사이고, 거기에서 텍스트 일치는 안전망이며 권한 규칙이 실제 차단입니다.
하나 시험하는 방법
제품 글은 mods를 오늘부터 쓸 수 있다고 말합니다. mods가 들어 있는 플러그인을 Claude 디렉터리에서 설치하거나, CLI에서 /plugin을 실행합니다. Claude에게 mod를 만들라고 하면 TypeScript를 작성하고, 설치하고, 세션 안에서 핫 리로드할 수 있습니다. 가이드는 그 지름길이 현재 세션에만 로드되고 폴더는 나중에 정리된다고 말합니다. 남기려면 폴더를 밖으로 복사해 플러그인으로 설치합니다. 가이드는 설치 명령을 실행하기 전에는 아무것도 설치되지 않으며, mod가 Claude Code의 접근 권한을 가진 게시자 작성 코드이므로 게시자의 저장소를 먼저 읽으라고도 말합니다.
세션 안에서 가이드의 순서는 /plugin marketplace add, /plugin install, /reload-plugins입니다. 셸에서는 가이드가 claude plugin marketplace add, claude plugin install, claude plugin validate, claude plugin test를 문서화합니다. 빌드는 claude --version으로 확인합니다. 가이드의 첫 완성 예인 Token Weather는 약 80줄입니다. 세션 시작 뒤와 main-loop 턴 뒤에 $.session.usage()를 호출하고, 상태 줄과 같은 수치를 읽어 프롬프트 위에 한 줄 예보를 그립니다. 가이드는 토큰 수 내역을 요청하지 않는 한 그 호출이 무료라고 말합니다. 핫 리로드가 모듈 변수를 처음부터 다시 시작하므로 측정값은 $.state에 두라고도 말합니다. 데모 화면은 200k 창의 18%, 이어서 67%, 이어서 81%에 띠가 있는 모습을 보여 줍니다.
가이드는 이어서 더 큰 mod 두 개를 둘러봅니다. Blast Radius는 rm -rf, git reset --hard, git clean, force push, 또는 데이터베이스 마이그레이션으로 분류한 Bash 호출을 붙잡고 Proceed와 Cancel을 제시합니다. 가이드의 그림에서는 rm -rf build를 붙잡고 파일 9개(1.1 MB)를 나열합니다. 가이드는 이것을 명령 텍스트를 읽는 안전망이라고 부르므로, 명령 치환, 별칭, rm을 호출하는 스크립트는 통과합니다. 실제 차단을 제공하는 것은 권한 규칙입니다. 가이드는 훅이 디스패치마다 자기 시간 10초를 갖고, $ 호출 안에서 기다리는 시간은 세지 않는다고 말합니다. Blast Radius는 그 규칙으로 사용자가 고를 때까지 짧은 sleep 호출을 기다리며 사용합니다. Replay Theater는 main-loop 턴 동안 Edit와 Write를 기록하고, Write가 반영되기 전에 $.fs.read로 이전 파일을 읽으며, 편집을 막거나 바꾸지 않습니다. 그다음 힌트가 r 또는 /replay로 그 턴의 diff를 단계별로 보게 합니다. 가이드의 그림은 파일 3개에 걸친 편집 5번의 이름 바꾸기입니다.
| 사용한 컨텍스트 | 예보 |
|---|---|
| 25% 미만 | Clear |
| 25–49% | Cloudy |
| 50–74% | Showers |
| 75–89% | Storm |
| 90% 이상 | Compact soon |
공식 페이지 두 곳이 열어 둔 것
공유는 두 가지로 설명됩니다. 제품 글은 mod를 플러그인으로 묶어 Claude 디렉터리에 제출하라고 말합니다. 시작 가이드는 Claude 디렉터리가 mods를 포함한 플러그인을 받기 시작하면 claude.ai/directory/manage에서 제출할 수 있게 된다고 말합니다. 어느 출처도 그 전환의 날짜를 적지 않습니다. ClaudeDevs는 샘플 mod를 Claude Code Playground 저장소에 더하는 중이라고 말합니다. 제품 글과 시작 가이드는 그 저장소의 이름을 밝히지 않습니다.
출처
함께 본 출처
자료 및 작성 기준
이 기사는 2026년 10월 1일에 올라온 ClaudeDevs 발표와 샘플 mod 후속 글, 같은 날짜의 Anthropic 제품 글 Customize Claude Code with mods, claude.dev 가이드 Getting started with Claude Code mods, 그리고 2026년 10월 1일 기준 Claude Code changelog에 근거합니다. 도구 호출, 권한 요청, 화면 그리기 예는 제품 글에서 가져왔습니다. $.session.usage() 호출과 훅의 10초 예산은 시작 가이드에서 가져왔습니다. Claude Mods를 적은 changelog 한 줄은 버전을 밝히지 않습니다. 가이드는 최소 버전으로 2.1.287을 적습니다. 별도의 mods API 레퍼런스와 Claude Code Playground 저장소는 여기서 다루지 않습니다. 제품 글, 가이드, changelog는 mods의 가격을 적지 않습니다.