什么是 Claude Code Mods,它们如何工作 #ClaudeCode #Tutorial
一个 3 分钟的上手教程,涵盖什么是 Claude Code mods、使用 /plugin 安装和禁用它们、用 claude plugin validate 验证、用 Claude 编写一个 mod,以及用 claude plugin test 离线测试。
关于这个 mod
在版本 2.1.296 上对 Claude Code mods 的上手演练:一个用量计量 mod,显示 5 小时、7 天和上下文用量,在 80% 时弹出提示,在 97% 时发出声音。说明 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。
安装
安装方法请查看原始来源。
原文 / 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
