ClaudeMods
☰
KO
● — 명 접속 중 · 조회 — 회
후원프로젝트 제출
가이드 / LEARN · 업데이트 2026년 11월 18일 · 작성자 ClaudeMods

Claude Code mods란

Claude Code mod란?

Claude Code mod(흔히 "Claude mod")는 hooks module을 제공하는 플러그인입니다. 모듈은 세션 이벤트 핸들러를 등록하고, 실시간 패널이나 상태 줄 같은 인터페이스를 추가하거나 도구 호출 처리 방식을 바꿀 수 있습니다. 카운터, 비용 확인, 작업 흐름을 설명하는 명령이 작은 예입니다. Mod라는 이름은 새 모델, 구독 업그레이드, 품질 보증을 뜻하지 않습니다.

세션 안의 작은 도구라고 생각하면 됩니다. 비용 확인, 작업 완료 알림, 에이전트 상태 보기, 대기 중 미니게임 등에 사용할 수 있습니다.

공식 문서

Claude Code API는 버전에 따라 바뀌므로 설치한 버전의 공식 문서를 따르세요: Mods 개요, Mod 만들기, 플러그인 설치 및 관리, Claude Code 문서 홈. ClaudeMods는 커뮤니티 작품의 독립 디렉터리이며 Anthropic이 제공하거나 보증하는 사이트가 아닙니다.

/plugin으로 mod 설치하기

  1. 작품 페이지에서 원본 소스, README, 권한 등급을 확인합니다.
  2. Claude Code 안에서 /plugin을 실행해 marketplace와 설치된 플러그인을 보거나 명령줄을 사용합니다.
claude plugin marketplace add owner/repo
claude plugin install plugin-name@marketplace-name
  1. owner/repo, plugin-name, marketplace-name은 작성자가 문서에 적은 값으로 바꿉니다. 모든 저장소에 marketplace가 있는 것은 아닙니다. 없다면 README를 따르거나 현재 CLI가 지원하는 --plugin-dir 옵션으로 로컬 디렉터리를 시도하세요.
  2. 작성자가 안내하면 세션을 다시 시작하거나 다시 불러오고, 동작을 확인한 뒤 다음 mod를 추가합니다. 제거 방법은 claude plugin --help와 README를 참고하세요.

자세한 내용: mod 설치 방법.

Mod·플러그인·hook·skill의 차이

용어설명대표적인 용도
플러그인설치하는 패키지. skills, hooks, mods 등을 함께 담을 수 있습니다.marketplace나 저장소로 도구 모음 공유
Modhooks module(function hooks)을 제공하는 플러그인. 세션 이벤트를 처리하고 인터페이스를 추가할 수 있습니다.상태 줄, 대시보드, 카운터, 알림, 미니게임
기존 hook이벤트가 발생할 때 실행되도록 설정한 동작. 보통 shell 명령입니다.변경 검증, 포매터 실행, 알림 전송
SkillClaude에게 반복 가능한 절차를 알려 주는 지침과 자료.릴리스 검토, 스타일 가이드, 체크리스트

더 자세한 비교는 Mod·hook·skill·MCP 차이를 보세요.

권한 등급 L0–L3

ClaudeMods는 작품마다 스캔 등급을 표시합니다. 이는 이 디렉터리의 스캔 분류이며 Anthropic 권한 모드, 샌드박스, 인증이 아닙니다.

등급감지 기능
L0표시와 순수 로직
L1파일과 환경 읽기
L2쓰기, 실행, 도구 동작 변경
L3네트워크와 모델 접근

낮은 등급이라고 코드가 무해하다는 증거는 아니며, 스캔되지 않은 작품은 추가 점검이 필요합니다. Mod 보안: L0–L3 설명을 읽고 권한 스캐너도 사용해 보세요.

확인할 파일 세 가지

  • .claude-plugin/plugin.json: 플러그인 이름, 버전 등의 정보.
  • hooks/hooks.json: modules 배열로 불러올 함수 모듈 선언.
  • register.tsx: 이벤트와 인터페이스를 등록하는 실제 코드.

한 저장소에 여러 플러그인이 있을 수 있으므로 루트 전체가 mod라고 가정하지 말고 의도한 디렉터리를 설치하세요. 진입 파일뿐 아니라 의존성도 확인합니다.

작은 실험부터 시작하기

버려도 되는 프로젝트에서 읽기 전용 표시부터 시도하세요. 작업 중 정보가 계속 필요하면 대시보드가 유용하고, 일회성 자동화는 기존 hook이 더 간단할 수 있습니다. 다른 플러그인과 충돌하면 바로 끌 수 있어야 하며, 설명할 수 없는 권한은 부여하지 마세요.

후보를 찾고 평가하기

카테고리를 둘러보고 원본 소스와 최근 유지보수 상태를 확인하세요. 스타 수는 관심도일 뿐 안전을 뜻하지 않습니다. 스캔 결과는 보이는 코드 패턴만 설명하며 동적으로 불러오는 코드는 놓칠 수 있습니다. 설치한 버전과 제거 방법을 기록해 두세요. 직접 만들고 싶다면 TypeScript로 Claude Code mod 작성하기를 보세요.

인기 Claude Code mods

게시된 작품을 커뮤니티 투표 수, 그다음 GitHub 스타 수 순으로 보여 줍니다. 자동으로 갱신됩니다.

  1. token-optimizer★ 2,981
  2. savvy-progress★ 380
  3. pixel-crew★ 4
  4. agent-flow★ 30
  5. 작업하면서 Claude와 체스★ 33,441
  6. rainbow-week★ 2
  7. 'npx RuFlo'를 새로운 Claude Code Mod 시스템으로 포팅했다. 차원이 다르다. I★ 81,451
  8. ruflo-music★ 81,451
  9. cache-warmer★ 100
  10. cache-warmer★ 24

FAQ

Claude Code mod란 무엇인가요?

Claude Code mod는 hooks module을 제공하는 플러그인입니다. 세션 이벤트 핸들러를 등록하고, 실시간 패널이나 상태 줄 같은 인터페이스를 추가하거나 도구 호출 처리 방식을 바꿀 수 있습니다. 새 모델이나 구독 업그레이드가 아닙니다.

Claude Code mod는 어떻게 설치하나요?

먼저 작품의 소스와 권한 등급을 확인하세요. 그런 다음 Claude Code 안에서 /plugin을 실행하거나 명령줄에서 claude plugin marketplace add owner/repo 후 claude plugin install plugin-name@marketplace-name을 실행합니다. marketplace가 없는 저장소도 있으므로 작성자가 안내한 이름을 사용하세요.

Mod, hook, skill의 차이는 무엇인가요?

플러그인은 설치하는 패키지입니다. Mod는 세션 이벤트를 처리하고 인터페이스를 추가할 수 있는 hooks module을 제공하는 플러그인입니다. 기존 hook은 이벤트 시 실행되는 설정된 동작(보통 shell 명령)이고, skill은 Claude에게 반복 가능한 절차를 알려 주는 지침입니다.

Claude Code mod는 안전한가요? L0–L3은 무슨 뜻인가요?

ClaudeMods는 각 작품을 스캔해 L0(표시 또는 순수 로직), L1(파일·환경 읽기), L2(쓰기·실행·도구 동작 변경), L3(네트워크·모델 접근)로 표시합니다. 이는 이 디렉터리의 스캔 등급이며 인증이 아닙니다. 낮은 등급이 무해함을 보장하지 않으므로 설치 전에 소스를 읽으세요.

ClaudeMods는 Anthropic 공식 사이트인가요?

아니요. ClaudeMods는 커뮤니티 작품의 독립 디렉터리이며 Anthropic이 제공하거나 보증하지 않습니다. 공식 안내는 code.claude.com/docs의 Claude Code 문서를 참고하세요.

Claude Code mod를 TypeScript로 만들 수 있나요?

네. mod는 .claude-plugin/plugin.json, hooks/hooks.json, hooks/register.tsx 같은 진입 파일, 이렇게 세 파일로 구성됩니다. 진입 파일에서 claude-code의 Register 타입을 가져와 session.start, command.run 등 이벤트의 핸들러를 등록합니다. claude plugin validate로 확인하고, 설치된 Claude Code가 생성한 타입 선언을 따르세요.

mod 대신 MCP를 써야 하는 경우는 언제인가요?

MCP는 Claude를 별도의 도구나 데이터 서비스에 연결합니다. 부족한 기능이 다른 서비스에 있을 때 검토하세요. mod는 Claude Code 안의 세션 이벤트와 인터페이스를 다루고, skill은 지침, 기존 hook은 고정된 동작에 적합합니다. 한 워크플로에서 함께 쓸 수도 있습니다.

mod를 안전하게 시험해 보려면 어떻게 하나요?

버려도 되는 프로젝트에서 읽기 전용 표시 mod부터 시작하세요. 소스와 L0–L3 등급을 먼저 읽고, 바로 비활성화하거나 제거할 수 있는지 확인합니다. 설명할 수 없는 권한은 주지 말고, 설치한 버전과 제거 방법을 기록해 두세요.

더 둘러보기

모든 Claude Code mods 보기

카테고리별 Claude Code mods

학습 가이드