---
title: "Claude Code Mods란 무엇이며 어떻게 작동하는가 #ClaudeCode #Tutorial"
url: "https://claudemods.dev/ko/builds/what-are-claude-code-mods-and-how-do-they-work-claudecode-tu-2d0f79"
source: "https://www.youtube.com/watch?v=ORSNig1cdsg"
source_type: "resource"
author: "DIY Smart Code"
author_handle: "DIY Smart Code"
stars: 0
category: "워크플로 및 CI"
categories: ["workflow"]
tags: ["cli", "hooks", "mods", "plugins", "tutorial"]
permission_level: null
scan_complete: false
added: "2026-10-15T02:06:17.471Z"
updated: "2026-10-13T10:00:39.000Z"
locale: "ko"
content_locale: "ko"
---

# Claude Code Mods란 무엇이며 어떻게 작동하는가 #ClaudeCode #Tutorial

Claude Code mods가 무엇인지, /plugin으로 설치 및 비활성화, claude plugin validate로 검증, Claude로 작성, claude plugin test로 오프라인 테스트를 다루는 3분 실습 튜토리얼.

## Description

버전 2.1.296에서 Claude Code mods 실습 워크스루: 5시간, 7일, 컨텍스트 사용량을 표시하고 80%에서 팝업, 97%에서 소리를 내는 사용량 미터 mod. mod는 JS/TS 이벤트 핸들러를 가진 플러그인이며 hooks/hooks.json의 modules 키로 구별되고, mod만 인터페이스에 그릴 수 있다는 것을 설명합니다. /plugin install로 설치, Space로 비활성화, 깨끗한 세션을 위한 --safe-mode, claude plugin validate로 mod 확인($.process.run 같은 호출 주의), 플러그인 작성 스킬로 Claude가 mod를 ~/.claude/dev-mods/에 작성하게 하고 핫 리로딩, 로그인이나 네트워크 없이 claude plugin test를 오프라인으로 실행하는 것을 다룹니다.

## Original README

What Are Claude Code Mods and How Do They Work #ClaudeCode #Tutorial

Claude Code mods, hands-on: the four mods running on my own Claude Code, how to install one and switch it off, how to check a mod with claude plugin validate before you install it, and how to have Claude write one for you. A mod is a plugin with code that Claude Code runs inside itself, so it can draw in the interface where a settings hook can't.
----
Higgsfield AI — Create AI Videos & Visuals
Get 10% OFF here: https://higgsfield.ai?fpr=thomas-dccf7e

🚀 DYNAMOUS AI COMMUNITY

Want to learn agentic coding with live daily events and workshops?
Check out Dynamous AI: https://dynamous.ai/?code=646a60
Get 10% off here 👉 https://shorturl.smartcode.diy/dynamous_ai_10_percent_discount

⚡ HOSTINGER — RELIABLE HOSTING FOR YOUR PROJECTS (10% OFF)

Whether you're shipping a portfolio, a side project, n8n flows, or AI agents — I use Hostinger for fast, affordable VPS + web hosting.

Get 10% off here 👉 https://hostinger.com/DIYSMARTCODE

n8n: https://n8n.partnerlinks.io/diysmartcode

(Affiliate links — costs you nothing, supports the channel.)
----

What you will see in this 3-minute breakdown:
→ A real run on Claude Code 2.1.296: /plugin shows "4 mods active", and my usage-meter mod writes 5-hour, 7-day and context usage under the prompt, with a pop-up at 80% and a sound at 97%
→ What a mod is: a plugin with JavaScript or TypeScript event handlers that Claude Code calls on a tool call, a submitted prompt, or a part of the interface being drawn. One "modules" key in the plugin's hooks/hooks.json makes it a mod
→ Mods vs settings hooks: a settings hook runs as a command outside Claude Code and can stop a tool call, but only a mod can add a pane or a band to the screen. My studio-hud band picked up a render check the moment Claude ran it
→ Install with /plugin install plugin-name@marketplace (mods need Claude Code v2.1.287 or later). Switch one off in the Installed tab of /plugin with Space. For one session without installed mods, start with --safe-mode, which turns off your other customizations too
→ Check before you install: claude plugin validate lists every event a mod hooks and every call it makes, without running it. Look for calls like $.process.run, which starts programs as you
→ Let Claude write one: describe the mod in a session, Claude writes it with the built-in plugin-authoring skill into ~/.claude/dev-mods/, you enable hot reloading for the session, and you copy the folder out to keep it
→ Test it offline: claude plugin test runs a mod's tests with no session, sign-in or network. All five usage-meter tests pass

Claude Code docs, Mods overview (install, /plugin, --safe-mode, validate): https://code.claude.com/docs/en/plugins/mods/overview
Claude Code docs, Create a mod (modules key, plugin-authoring, hot reloading, dev-mods): https://code.claude.com/docs/en/plugins/mods/create
Claude Code docs, Test a mod (claude plugin test): https://code.claude.com/docs/en/plugins/mods/test
Claude Code docs, Manage mods (the calls to look for): https://code.claude.com/docs/en/plugins/mods/admin
Claude Code docs, Mods reference (events): https://code.claude.com/docs/en/plugins/mods/reference
Claude Code docs, Install plugins (enable or disable with Space): https://code.claude.com/docs/en/plugins/install
Claude Code docs, CLI reference (--safe-mode): https://code.claude.com/docs/en/cli-reference
Claude Code docs, Status line (5-hour and 7-day usage): https://code.claude.com/docs/en/statusline
Claude Code changelog (2.1.287, Claude Mods): https://code.claude.com/docs/en/changelog
Our Claude Code mods launch Short: https://youtu.be/tTe7GOJuc0E

Which would you build first: a usage warning, or a slash command of your own?

#ClaudeCode #Claude #ClaudeCodeMods #ClaudeMods #ClaudeCodePlugins #ClaudePlugins #ClaudeCodeTutorial #ClaudeCodeTips #ClaudeCodeSetup #ClaudeCodeForBeginners #ClaudeCodeHooks #Anthropic #AICoding #AIAgents #AgenticCoding #DeveloperTools #CodingWithAI #VibeCoding #DevTips #Shorts