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
- 打开作品页,阅读原始来源、README 与权限等级。
- 在 Claude Code 内运行
/plugin浏览 marketplace 与已安装的插件,或使用命令行:
claude plugin marketplace add owner/repo
claude plugin install plugin-name@marketplace-name
- 将
owner/repo、plugin-name、marketplace-name换成作者文档中的值。不是每个仓库都有 marketplace;没有的话请按 README 操作,或用当前 CLI 支持的--plugin-dir选项试用本地目录。 - 若作者要求,请重启或重新加载会话,确认行为后再加入下一个 mod。移除方式请参考
claude plugin --help与 README。
更多细节:如何安装 mod。
Mod、插件、hook、skill 的区别
| 名词 | 是什么 | 常见用途 |
|---|---|---|
| 插件(Plugin) | 你安装的包,可包含 skills、hooks、mods 等。 | 通过 marketplace 或仓库分享一组工具 |
| Mod | 提供 hooks module(function hooks)的插件:处理会话事件,并可附带界面。 | 状态栏、仪表板、计数器、通知、小游戏 |
| 传统 hook | 事件触发时执行的配置动作,通常是 shell 命令。 | 验证变更、运行格式化、发送通知 |
| Skill | 教 Claude 一套可重复流程的说明与资源。 | 发布检查、团队风格、检查清单 |
更完整的比较见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:注册事件与界面的代码。
一个仓库可能包含多个插件,不要默认仓库根目录就是要安装的作品。入口文件之外,依赖也要检查。
从小实验开始
在可丢弃的项目里试用只读显示功能。需要持续信息时仪表板很合适;一次性的固定动作用传统 hook 可能更简单。若干扰其他插件,应能立即停用,也不要授予自己无法解释的权限。
评估目录里的作品
先按用途分类,再查看原始来源与维护状态。星数反映关注度,不等于安全;扫描结果只描述看得到的代码模式,可能遗漏动态加载的代码。记录安装的版本与移除方式。想自己做一个?请看用 TypeScript 写 Claude Code mod。
热门 Claude Code mods
已发布的作品,按社区票数再按 GitHub 星数排序,自动更新。
- token-optimizer★ 2,981
- savvy-progress★ 380
- pixel-crew★ 4
- agent-flow★ 30
- 边工作边和 Claude 下国际象棋★ 33,441
- rainbow-week★ 2
- 我刚把 'npx RuFlo' 移植到新的 Claude Code Mod 系统。太上一层了。我★ 81,451
- ruflo-music★ 81,451
- cache-warmer★ 100
- 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 文档。
可以用 TypeScript 写 Claude Code mod 吗?
可以。一个 mod 由三个文件组成:.claude-plugin/plugin.json、hooks/hooks.json,以及 hooks/register.tsx 这样的入口。入口从 claude-code 导入 Register 类型,并为 session.start、command.run 等事件注册处理函数。用 claude plugin validate 检查,并以你所安装的 Claude Code 版本生成的类型声明为准。
什么时候该用 MCP 而不是 mod?
MCP 把 Claude 连接到独立的工具或数据服务,缺少的能力在另一个服务里时再考虑它。Mod 处理 Claude Code 内的会话事件与界面;skill 适合说明流程,传统 hook 适合固定动作,它们可以在同一个工作流里组合。
怎样安全地试用 mod?
在可丢弃的项目里,先试只读的显示类 mod。先阅读源码与 L0–L3 等级,并确认能立即停用或移除。不要授予自己无法解释的权限,并记录安装的版本与移除方式。