요약
- Mods는 hooks 모듈을 실은 Claude Code 플러그인입니다——Claude Code 안에서 도는 JavaScript로 이벤트를 관찰·다시 쓰기·응답할 수 있죠.
- v2.1.287 이상이면 mods는 기본으로 동작합니다: /plugin install name@marketplace로 설치하고 세션을 다시 시작하면 살아 있습니다.
- 내장 You Should Know는 옵트인입니다: /plugin enable cc-plugin-you-should-know@builtin을 한 번 실행하면 끝.
- 끄려면: /plugin에서 개별 mod 비활성화, --safe-mode로 한 세션 시작, 또는 "disableAllHooks": true로 설치된 모든 mod를 끕니다.
Claude Mods Make Claude Code 10x More Powerful
채널: Firecrawl4:40
Claude Code v2.1.287 — Claude Mods and Agent Plugins
채널: Claude Code Changelog2:13
Mods overview — official docs (function hooks)
문서: code.claude.com/docs
스크린샷은 위의 두 영상에서 가져왔습니다. 깨끗한 화면 구간과 타이포그래피 체인지로그 슬라이드만 썼고 진행자가 나오는 구간은 모두 뺐습니다. 사실 관계는 영상이 아니라 공식 mods 문서와 대조해 검증했습니다.
프레임 타임스탬프는 원본 영상으로 딥링크되어 제작자에게 방문을 돌려줍니다. Claude Code는 Anthropic의 상표입니다. 이 가이드는 독립적인 콘텐츠로 공식과 제휴 관계가 없습니다.
첫 Claude Code mod 설치하고 쓰기
mod가 무엇인지 이해하기
- 1
mod가 무엇을 바꾸는지 알기
Claude Code 2.1.287이 mods를 도입했습니다: 에이전트 자신의 더 깊은 동작을 바꾸는 플러그인입니다. Mod는 세션 이벤트에 반응하고 자기 상태를 유지하고 인터페이스에 직접 그릴 수 있습니다——모델에 주는 지시문 한 줄이 아니라, 터미널을 확장하는 작은 프로그램입니다.
v2.1.287 릴리스 노트: mods를 Claude Code 안의 더 깊은 동작을 바꾸는 플러그인으로 소개.영상 0:30 보기 - 2
다른 확장 계층 사이에 mods 자리 잡기
Skills는 모델 행동을 이끌고, MCP 서버는 외부 도구를 노출하고, shell hooks는 라이프사이클 이벤트에 명령을 실행합니다. Mods는 네 번째 계층입니다: 프로세스 안에서 돌고, 인터페이스를 바꾸고, 이벤트의 전후를 가로채는 코드죠. 다섯 계층 비교는 워크스루 바로 아래 치트시트에.
- 3
Claude Code 버전 확인하기
Mods에는 Claude Code v2.1.287 이상이 필요하고, 이 버전부터 기본으로 켜져 있습니다. claude --version으로 확인하세요. 뒤처져 있다면 우리 Claude Code 업데이트 튜토리얼을 따라 올리고 다시 오세요. 개별 mod는 더 새 빌드를 요구할 수도 있습니다.
v2.1.287 릴리스 노트의 범위: Claude Mods, You Should Know 플러그인, agent view 필터링, 백그라운드 작업 관리.영상 0:09 보기
하나 설치해서 돌아가는 걸 보기
- 4
구식 활성화 플래그는 건너뛰기
오래된 가이드는 CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1을 설정하라고 합니다——초기 액세스 프리뷰용이었죠. 2.1.287부터 mods는 기본으로 켜져 있고 이 환경 변수는 무시되니 설정에서 지워도 됩니다. mods를 켜는 데 필요한 추가 절차는 없습니다.
- 5
마켓플레이스에서 mod 설치하기
세션 안에서는 /plugin install mod-name@marketplace. 터미널에서는 claude plugin install mod-name@marketplace를 실행하고, 이미 열려 있는 세션이 있다면 /reload-plugins를 이어서. 서드파티 코드를 넣기 전이라면 claude plugin validate ./some-mod로 검사할 수 있습니다.
- 6
mod의 정체 읽어 내기
Mod의 실체는 hooks 모듈입니다: register(on) 진입점이 엔진 이벤트에 핸들러 함수를 구독시킵니다. 각 핸들러는 mods API와 이벤트와 next() 이어짐을 받습니다——Express 미들웨어와 같은 형태로, 이벤트를 관찰·다시 쓰기·응답한 뒤 넘길 수 있습니다.
실제 mod의 register.tsx: on('ui.render') 핸들러가 AbovePrompt 컴포넌트를 다시 그려 텍스트 한 줄을 추가하고 있다.영상 2:35 보기 - 7
세션 돌려서 확인하기
Claude Code를 띄우고 증거를 확인합니다: mod가 등록한 슬래시 명령이 도움말 목록에 나타나고, /plugin에는 탭 아래 "1 mod active" 같은 줄이 보입니다. 아무것도 안 보이면 mod 설명을 다시 읽으세요——그리기 mod는 터미널과 데스크톱 앱의 Code 탭에서만 효과가 있습니다.
도움말 목록의 /hello 명령은 설치된 mod에서 온 것——mod는 Claude 턴을 소비하지 않고 즉시 실행되는 자체 명령을 등록할 수 있습니다.영상 2:32 보기
내장 mods
- 8
내장 mods 만나기
/plugin을 열고 Built-in 섹션을 보세요: cc-plugin-agents-md는 AGENTS.md를 로드하고, cc-plugin-diff는 /diff 페인을 떠받치고, cc-plugin-plugin-authoring은 플러그인 작성 스킬이며, cc-plugin-sec-default는 조직 정책을 지키고, cc-plugin-telemetry는 애널리틱스를 맡습니다. 소스는 Claude Code 저장소의 mods 디렉터리에 있습니다.
- 9
You Should Know 켜기
You Should Know는 Claude Code 내장 사이드 에이전트입니다: 한 번 켜면 세션을 지켜보다가 놓치기 쉬운 것을 짚어 줍니다. 기본은 꺼져 있어요——/plugin enable cc-plugin-you-should-know@builtin을 한 번 실행하면 이후 세션에서도 켜진 채로 있습니다.
공식 you-should-know 카드: 세션을 감시하는 사이드 에이전트. 활성화는 /plugin enable cc-plugin-you-should-know@builtin.영상 0:48 보기 - 10
세 개의 끄기 스위치 알아 두기
개별 mod는 /plugin의 Installed 탭에서 비활성화합니다. claude --safe-mode로 mod 없는 세션을 한 번만 띄울 수도 있고요. 또는 ~/.claude/settings.json에 "disableAllHooks": true를 넣으면 되돌릴 때까지 설치된 모든 mod가 꺼져 있습니다. 내장 mod는 세 경우 모두 계속 돕니다——의도된 설계입니다.
주도권 지키기
- 11
보안 모델 존중하기
Mods는 당신의 권한으로, 샌드박스 없이 돕니다: 환경 변수와 시크릿을 읽고, 프롬프트를 다시 쓰고, 도구 호출을 미리 승인하고, 사용량을 쓸 수 있어요. 당신의 머신에서 맨 코드로 돌려도 괜찮을 것만 설치하고, /plugin으로 세션이 실제로 뭘 로드했는지 감사하세요.
- 12
mod가 어디에 그릴 수 있는지 알기
Mod UI——대화 옆 페인, 프롬프트 위 띠, 자체 탭——은 터미널과 데스크톱 앱의 Code 탭에 렌더링됩니다. WSL 세션, VS Code 채팅 패널, claude -p 실행, Agent SDK, 클라우드 세션에는 그리지 않고, Claude Code의 UI는 다시 꾸밀 수 있어도 권한 확인창만은 절대 못 만집니다.
Mods vs plugins vs skills vs MCP vs hooks
Claude Code에는 이제 확장 계층이 다섯 개고, 이름은 금방 섞입니다. 짧은 버전——코드가 어디서 돌고 뭘 만질 수 있는가:
- 1Skills는 markdown 지시 패키지입니다. 호출될 때 모델의 행동을 이끌죠——스스로 코드를 실행하지는 않습니다.
- 2MCP 서버는 Model Context Protocol로 외부 도구와 데이터 소스를 연결합니다——프로세스 밖에서, 도구로 노출됩니다.
- 3Shell hooks는 설정 파일에 적어 둔 명령을 라이프사이클 이벤트에 실행하는 장치입니다. 도구 호출 전후 같은.
- 4Plugins는 이 모두——명령, 에이전트, MCP 서버, hooks——을 설치 가능한 패키지 하나로 묶습니다.
- 5Mods는 hooks 모듈을 프로세스 안에서 도는 플러그인입니다: TypeScript 함수로 UI를 다시 그리고, 이벤트를 도중에 가로채고, 이벤트 사이에 상태를 유지할 수 있습니다.
경험칙: 지시는 skills, 연동은 MCP, 자동화는 shell hooks, 포장은 plugin——그리고 Claude Code 자체의 생김새나 이벤트의 귀결을 바꾸고 싶을 때, 그게 mod입니다.