ClaudeMods
☰
ZH-CN
● — 人在线 · 浏览 — 次
赞助提交作品
我们的指南 / 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 的区别

名词是什么常见用途
插件(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 星数排序,自动更新。

  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 系统。太上一层了。我★ 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 文档。

可以用 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 等级,并确认能立即停用或移除。不要授予自己无法解释的权限,并记录安装的版本与移除方式。

继续探索

浏览所有 Claude Code mods

按分类浏览 Claude Code mods

学习指南