如何安装 Claude Code Mods
安装 Claude Code mod 只需要一条终端命令。本指南说明安装前要检查什么、安装后怎么更新和卸载，以及常见报错的含义。
作者 ccmods.app 编辑部 · 更新于
安装 mod 需要什么？
需要终端里的 Claude Code v2.1.287 或更高版本。Desktop 应用自带一份 Claude Code，从 v2.1.286 起支持 mod。先检查版本：
$ claude --version版本过旧时，按 官方安装文档 更新。
第 1 步：确认访问能力
先看 mod 能访问什么，再决定是否安装。官方文档的说法是：
Mods aren't sandboxed.
— Claude Code 官方文档：Mods overview
本站每个 mod 页面都列出它挂载的 hook 和调用的接口，并换算成访问级别。你也可以克隆仓库后自己检查，输出中的 hooks: 和 calls: 两行就是它会做的事：
$ claude plugin validate ./some-mod第 2 步：执行安装命令
从 mod 页面复制安装命令，在终端执行。如果仓库根目录有 marketplace 文件，命令是这样的：
$ claude plugin install <mod> --marketplace <owner>/<repo>Claude Code 会询问是否添加该 marketplace，输入 y；然后选择作用域，看到 Installed <mod>. Plugin is now active. 即安装完成，当前会话立即生效。在已打开的会话里，也可以把同一行改成 /plugin install … 输入。
第 3 步：确认已加载
在会话里运行 /plugin，标签栏下方的灰色行会显示类似 1 mod active · <mod> 的内容。
该选哪个作用域？
| 作用域 | 适用场景 |
|---|---|
| user | 只给自己用、希望每个项目都加载。Desktop 应用的 Code 标签页也会加载。 |
| project | 写入项目设置，和团队共享，只在该项目加载。 |
| local | 只在当前项目、只给自己用，不提交到仓库。 |
作用域的完整说明见 官方 Install plugins 文档。
仓库没有 marketplace 文件怎么办？
克隆仓库，用 --plugin-dir 在单次会话里加载。关闭会话后不再加载，适合试用：
$ claude --plugin-dir ./path/to/mod如果 mod 位于包含多个 mod 的仓库（例如 Anthropic 的样例仓库），把 --marketplace 指向克隆目录里的 marketplace 所在文件夹即可。移动或删除克隆目录后 mod 会停止加载。
怎样更新、禁用和卸载？
| 操作 | 命令 |
|---|---|
| 更新 | claude plugin update <名称>，再在会话里 /reload-plugins |
| 禁用 | claude plugin disable <名称> |
| 卸载 | claude plugin uninstall <名称> |
| 本次会话关闭所有 mod | claude --safe-mode |
| 所有会话关闭所有 mod | 在 ~/.claude/settings.json 设置 "disableAllHooks": true |
常见报错是什么意思？
| 提示 | 原因与处理 |
|---|---|
Marketplace file not found at … | 该仓库根目录没有 .claude-plugin/marketplace.json。改用 --plugin-dir 加载，或请作者添加。 |
Plugin "<mod>" not found in marketplace … | 名称与 marketplace 中登记的不一致。使用 mod 页面给出的名称。 |
| Desktop 应用提示命令不可用 | /plugin install 只能在终端使用。在终端以 user 作用域安装。 |
| 安装了但没有效果 | 运行 /plugin 确认已加载；用 claude --debug 启动查看被跳过的 hook 及原因。 |
接下来
从 最受欢迎的 mod 开始挑选，或阅读 开发指南 自己写一个。
FAQ
怎样卸载一个 mod？
在终端运行 claude plugin uninstall <名称>，或在会话里打开 /plugin，在 Installed 标签页移除。
怎样更新 mod？
运行 claude plugin update <名称>，然后在已打开的会话里执行 /reload-plugins。
怎样只禁用不卸载？
运行 claude plugin disable <名称>，或在 /plugin 的 Installed 标签页禁用。
为什么 Desktop 应用里提示命令不可用？
/plugin install 是终端命令。请在终端安装并选择 user 作用域，Desktop 应用的 Code 标签页会自动加载它。