先看结论
- Mods 是带 hooks 模块的 Claude Code 插件——JavaScript 代码直接跑在 Claude Code 进程内，可以观察、改写或应答事件。
- v2.1.287 及以上版本默认启用，无需任何开关：/plugin install 名称@市场 装完重启会话即生效。
- 内置的 You Should Know 是选择加入的：/plugin enable cc-plugin-you-should-know@builtin 一次即长期开启。
- 想关掉：单个 mod 在 /plugin 里禁用；单次会话用 --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：能修改 agent 深层行为的插件。它可以响应会话事件、维护自己的状态、直接在界面上作画——是扩展终端本身的小程序，而不是喂给模型的又一段提示词。
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 默认开启，这个环境变量已被忽略，可以从 settings 里删掉了。开启 mods 不需要任何额外步骤。
- 5
从插件市场安装 mod
会话内用 /plugin install mod名@市场；终端里用 claude plugin install mod名@市场，装完如果已有会话开着，再跑一次 /reload-plugins。装第三方代码前，可以先用 claude plugin validate ./某个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 可以注册即时执行的自定义命令，不需要消耗一轮对话。看原片 2:32 处
内置 mods
- 8
认识六个内置 mod
打开 /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 内置的侧边 agent：启用后会盯着你的会话，把你可能错过的东西标出来。它默认关闭——/plugin enable cc-plugin-you-should-know@builtin 开一次，之后的会话都保持开启。
官方 you-should-know 卡片：一个监视会话、标记疏漏的侧 agent，启用命令为 /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 的界面——会话旁的面板、提示符上方的横幅、自定义标签页——只在终端和桌面端 Code 标签渲染。WSL 会话、VS Code 聊天面板、claude -p 无头运行、Agent SDK 和云端会话都不画；mod 可以给 Claude Code 的界面换肤，但权限确认框永远动不了。
Mods、插件、技能、MCP、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。