22 claude plugin 命令22 claude plugin 命令
23</h2>23</h2>
24 24
25从 shell 或脚本中运行 `claude plugin <subcommand>`，在 Claude Code 会话外。这些子命令安装和管理 plugins，而不打开 [`/plugin`](#plugin-in-a-session) 面板。25从你的 shell 或脚本运行 `claude plugin <subcommand>`，在 Claude Code 会话外部。这些子命令安装和管理插件，无需打开 [`/plugin`](#plugin-in-a-session) 面板。
26 26
27`claude plugins` 是 `claude plugin` 的别名。27`claude plugins` 是 `claude plugin` 的别名。
28 28
29每个子命令共享这些退出代码、plugin 参数和作用域值：29每个子命令共享这些退出代码、插件参数和作用域值：
30 30
31* **退出代码**：成功时为 `0`，失败时为 `1`。`validate` 为意外错误添加退出 `2`，`eval` 添加 [其部分](#plugin-eval) 中列出的代码。31* **退出代码**：成功时为 `0`，失败时为 `1`。`validate` 为意外错误添加退出 `2`，`eval` 添加 [其部分](#plugin-eval) 中列出的代码。
32* **Plugin 参数**：`<plugin>` 参数是 plugin `name` 或 `name@marketplace`。当两个市场提供相同的名称时，使用限定形式。32* **插件参数**：`<plugin>` 参数是插件 `name` 或 `name@marketplace`。当两个市场提供相同的名称时，使用限定形式。
33* **作用域**：`--scope` 接受 `user`、`project` 或 `local`，并命名命令写入的设置文件。`update` 也接受 `managed`。33* **作用域**：`--scope` 接受 `user`、`project` 或 `local`，并命名命令写入的设置文件。`update` 也接受 `managed`。
34 34
35<h3 id="plugin-init">35<h3 id="plugin-init">
36 plugin init36 plugin init
37</h3>37</h3>
38 38
39在 `~/.claude/skills/<name>/` 处搭建新 plugin。它在您的下一个会话中作为 `<name>@skills-dir` 加载，无需安装步骤。39在 `~/.claude/skills/<name>/` 处搭建新插件。它在你的下一个会话中作为 `<name>@skills-dir` 加载，无需安装步骤。
40 40
41`new` 是 `init` 的别名。41`new` 是 `init` 的别名。
42 42
43对于以此命令开始的创建、测试和编辑工作流，请参阅 [创建 plugin](/docs/zh-CN/plugins/create)。43对于从此命令开始的创建、测试和编辑工作流，请参阅 [创建插件](/docs/zh-CN/plugins/create)。
44 44
45```bash theme={null}45```bash theme={null}
46claude plugin init <name> [options]46claude plugin init <name> [options]
47```47```
48 48
49`<name>` 成为 `~/.claude/skills/` 下的目录名称和 plugin 清单中的 `name`。49`<name>` 成为 `~/.claude/skills/` 下的目录名称和插件清单中的 `name`。
50 50
51该命令没有用于另一个位置的标志。要改为在项目内搭建，请参阅 [创建 plugin](/docs/zh-CN/plugins/create)。51该命令没有用于另一个位置的标志。要在项目内搭建，请参阅 [创建插件](/docs/zh-CN/plugins/create)。
52 52
53| 标志 | 描述 |53| 标志 | 描述 |
54| :- | :- |54| :- | :- |
58| `--with <components...>` | 也为 `skills`、`agents`、`hooks`、`mcp`、`lsp`、`output-style` 或 `channel` 搭建启动文件 |58| `--with <components...>` | 也为 `skills`、`agents`、`hooks`、`mcp`、`lsp`、`output-style` 或 `channel` 搭建启动文件 |
59| `-f, --force` | 覆盖目标处的现有 `.claude-plugin/` |59| `-f, --force` | 覆盖目标处的现有 `.claude-plugin/` |
60 60
61使用启动 skill 和 hook 文件搭建 plugin：61搭建带有启动 skill 和 hook 文件的插件：
62 62
63```bash theme={null}63```bash theme={null}
64claude plugin init my-helper --with skills hooks64claude plugin init my-helper --with skills hooks
65```65```
66 66
67Claude Code 验证其写入的内容并打印 `Created plugin "my-helper" at ~/.claude/skills/my-helper`，后跟它加载的 id 和关闭它的 `claude plugin disable` 命令。67Claude Code 验证它写入的内容并打印 `Created plugin "my-helper" at ~/.claude/skills/my-helper`，后跟它加载的 id 和关闭它的 `claude plugin disable` 命令。
68 68
69当 Claude Code 无法安全搭建时，它退出 `1` 而不写入，消息命名原因。这些是常见原因：69当 Claude Code 无法安全搭建时，它退出 `1` 而不写入，消息命名原因。这些是常见原因：
70 70
71* 未知的 `--with` 值71* 未知的 `--with` 值
72* 目标处的现有搭建，没有 `--force`72* 目标处的现有搭建，没有 `--force`
73* 阻止 skills-directory plugins 的托管设置73* 阻止 skills-directory 插件的托管设置
74 74
75<h3 id="plugin-install">75<h3 id="plugin-install">
76 plugin install76 plugin install
77</h3>77</h3>
78 78
79从您添加的市场安装 plugin。`i` 是 `install` 的别名。79从你添加的市场安装插件。`i` 是 `install` 的别名。
80 80
81```bash theme={null}81```bash theme={null}
82claude plugin install <plugin> [options]82claude plugin install <plugin> [options]
83```83```
84 84
85大多数 plugins 无需提示即可安装。对于其市场条目 [运行命令来安装它](/docs/zh-CN/plugins/host-marketplace) 或 [为其下载设置 `headersHelper`](/docs/zh-CN/plugins/host-marketplace#how-users-accept-a-headershelper-command) 的 plugin，Claude Code 首先打印命令并询问 `Run this command now? [y/N]`。85大多数插件无需提示即可安装。对于其市场条目 [运行命令来安装它](/docs/zh-CN/plugins/host-marketplace) 或 [为其下载设置 `headersHelper`](/docs/zh-CN/plugins/host-marketplace#how-users-accept-a-headershelper-command) 的插件，Claude Code 首先打印命令并询问 `Run this command now? [y/N]`。
86 86
87| 标志 | 描述 |87| 标志 | 描述 |
88| :- | :- |88| :- | :- |
89| `-s, --scope <scope>` | 安装作用域：`user`、`project` 或 `local`。默认为 `user` |89| `-s, --scope <scope>` | 安装作用域：`user`、`project` 或 `local`。默认为 `user` |
90| `--config <key=value>` | 设置 plugin 清单声明的 [`userConfig`](/docs/zh-CN/plugins/manifest-reference) 选项。为每个选项重复该标志。需要 Claude Code v2.1.147 或更高版本 |90| `--config <key=value>` | 设置插件清单声明的 [`userConfig`](/docs/zh-CN/plugins/manifest-reference) 选项。为每个选项重复该标志。需要 Claude Code v2.1.147 或更高版本 |
91| `-y, --yes` | 接受显示的安装命令，无需 `Run this command now?` 提示。当命令在 Claude Code 会话内运行时（例如从 Bash 工具或 hook）被忽略。需要 Claude Code v2.1.229 或更高版本 |91| `-y, --yes` | 接受显示的安装命令，无需 `Run this command now?` 提示。在 Claude Code 会话内运行命令时被忽略，例如从 Bash 工具或 hook。需要 Claude Code v2.1.229 或更高版本 |
92| `--accept-command <sha256>` | 接受显示的安装命令，其 `sha256` 之前的 [`--json` 运行](#plugin-json-result) 在 `shownCommand` 中报告，代替 `-y`。不能与 `-y` 组合。请参阅 [接受显示的安装命令](#accept-a-displayed-install-command)。需要 Claude Code v2.1.271 或更高版本 |92| `--accept-command <sha256>` | 接受显示的安装命令，其 `sha256` 之前的 [`--json` 运行](#plugin-json-result) 在 `shownCommand` 中报告，代替 `-y`。不能与 `-y` 组合。请参阅 [接受显示的安装命令](#accept-a-displayed-install-command)。需要 Claude Code v2.1.271 或更高版本 |
93| `--json` | 将结果作为一个 JSON 对象打印在 stdout 的最后一行，而不是人类可读的消息，供脚本使用。请参阅 [JSON 结果格式](#plugin-json-result)。需要 Claude Code v2.1.268 或更高版本 |93| `--json` | 将结果打印为 stdout 最后一行的一个 JSON 对象，而不是人类可读的消息，供脚本使用。请参阅 [JSON 结果格式](#plugin-json-result)。需要 Claude Code v2.1.268 或更高版本 |
94 94
95从您自己的终端传递 `-y` 以接受显示的命令而无需提示。以下是没有 TTY 和 Claude 运行命令时发生的情况：95从你自己的终端传递 `-y` 以接受显示的命令，无需提示。以下是没有 TTY 和 Claude 运行命令时发生的情况：
96 96
97* **stdin 或 stdout 不是 TTY，您既不传递 `-y` 也不传递 `--accept-command`**：安装被拒绝。输出说命令仅被显示，退出代码为 `1`97* **stdin 或 stdout 不是 TTY，且你既不传递 `-y` 也不传递 `--accept-command`**：安装被拒绝。输出说命令仅被显示，退出代码为 `1`
98* **Claude 通过其 Bash 工具运行命令**：`-y` 被忽略。改为从您自己的终端运行命令98* **Claude 通过其 Bash 工具运行命令**：`-y` 被忽略。改为从你自己的终端运行命令
99 99
100为克隆项目的每个人安装 plugin：100为克隆项目的每个人安装插件：
101 101
102```bash theme={null}102```bash theme={null}
103claude plugin install formatter@my-marketplace --scope project103claude plugin install formatter@my-marketplace --scope project
106Claude Code 打印 `Successfully installed plugin: formatter@my-marketplace (scope: project)`。当没有新内容被安装时，输出说明原因：106Claude Code 打印 `Successfully installed plugin: formatter@my-marketplace (scope: project)`。当没有新内容被安装时，输出说明原因：
107 107
108* **已在该作用域安装**：输出为 `Plugin "formatter@my-marketplace" is already installed (scope: project)`，退出代码为 `0`108* **已在该作用域安装**：输出为 `Plugin "formatter@my-marketplace" is already installed (scope: project)`，退出代码为 `0`
109* **您拒绝命令源提示**：输出为 `Aborted.`，退出代码为 `1`109* **你拒绝命令源提示**：输出为 `Aborted.`，退出代码为 `1`
110* **您拒绝 `headersHelper` 提示，或无法在没有 TTY 的情况下确认**：输出为 `Aborted — the command was not run.`，退出代码为 `1`110* **你拒绝 `headersHelper` 提示，或无法在没有 TTY 的情况下确认**：输出为 `Aborted — the command was not run.`，退出代码为 `1`
111 111
112<h4 id="plugin-json-result">112<h4 id="plugin-json-result">
113 JSON 结果格式113 JSON 结果格式
114</h4>114</h4>
115 115
116当您向 `plugin install` 传递 `--json` 时，stdout 的最后一行是一个 JSON 对象。仅解析该行，因为 Claude Code 在其前面打印市场声明的任何命令。116当你向 `plugin install` 传递 `--json` 时，stdout 的最后一行是一个 JSON 对象。仅解析该行，因为 Claude Code 在其前面打印市场声明的任何命令。
117 117
118三个字段始终存在：118三个字段始终存在：
119 119
123 123
124其他字段，例如 `pluginId`、`scope` 和 `failureCode`，仅在适用时出现。124其他字段，例如 `pluginId`、`scope` 和 `failureCode`，仅在适用时出现。
125 125
126`plugin uninstall`、`plugin update`、`plugin enable` 和 `plugin disable` 上的 `--json` 选项打印相同的对象，带有该子命令自己的字段。126`--json` 选项在 `plugin uninstall`、`plugin update`、`plugin enable` 和 `plugin disable` 上打印相同的对象，带有该子命令自己的字段。
127 127
128使用错误（例如无效的 `--scope`）不打印结果行，退出 `1`，原因在 stderr 上。128使用错误，例如无效的 `--scope`，不打印结果行，退出 `1`，原因在 stderr 上。
129 129
130<h4 id="accept-a-displayed-install-command">130<h4 id="accept-a-displayed-install-command">
131 接受显示的安装命令131 接受显示的安装命令
132</h4>132</h4>
133 133
134当 `--json` 运行显示市场声明的命令且不运行它时，`failed` 结果也带有 `shownCommand` 对象。其字段包括显示的命令、它所属的 plugin 和命令的 `sha256`。134当 `--json` 运行显示市场声明的命令且不运行它时，`failed` 结果也携带 `shownCommand` 对象。其字段包括显示的命令、它所属的插件和命令的 `sha256`。
135 135
136要接受完全相同的命令，从您自己的终端使用该 `sha256` 作为 `--accept-command` 重新运行，因为该标志在 Claude Code 会话内无效。需要 Claude Code v2.1.271 或更高版本。136要接受完全相同的命令，从你自己的终端使用该 `sha256` 作为 `--accept-command` 重新运行，因为该标志在 Claude Code 会话内无效。需要 Claude Code v2.1.271 或更高版本。
137 137
138`sha256` 计为完全相同的命令、plugin 和市场目录的接受。如果自命令显示以来其中任何一个发生了变化，Claude Code 不接受 `sha256` 并再次显示命令。运行自己的市场刷新获取的更改也计为此类更改。138`sha256` 计为对完全相同的命令、插件和市场目录的接受。如果自命令显示以来其中任何一个发生了变化，Claude Code 不接受 `sha256` 并再次显示命令。运行自己的市场刷新获取的更改也计为此类更改。
139 139
140如果 `shownCommand.acceptCommandMatched` 为 `false`，您传递的 `sha256` 与现在显示的命令不匹配。在使用其 `sha256` 重新运行之前查看该命令。140如果 `shownCommand.acceptCommandMatched` 为 `false`，你传递的 `sha256` 与现在显示的命令不匹配。在使用其 `sha256` 重新运行之前，查看该命令。
141 141
142<h3 id="plugin-uninstall">142<h3 id="plugin-uninstall">
143 plugin uninstall143 plugin uninstall
144</h3>144</h3>
145 145
146从一个作用域删除已安装的 plugin。`remove` 和 `rm` 是 `uninstall` 的别名。146从一个作用域移除已安装的插件。`remove` 和 `rm` 是 `uninstall` 的别名。
147 147
148```bash theme={null}148```bash theme={null}
149claude plugin uninstall <plugin> [options]149claude plugin uninstall <plugin> [options]
152| 标志 | 描述 |152| 标志 | 描述 |
153| :- | :- |153| :- | :- |
154| `-s, --scope <scope>` | 从作用域卸载：`user`、`project` 或 `local`。默认为 `user` |154| `-s, --scope <scope>` | 从作用域卸载：`user`、`project` 或 `local`。默认为 `user` |
155| `--keep-data` | 保留 plugin 的持久数据目录 `~/.claude/plugins/data/<id>/` |155| `--keep-data` | 保留插件的持久数据目录 `~/.claude/plugins/data/<id>/` |
156| `--prune` | 也删除自动安装的 [dependencies](/docs/zh-CN/plugins/dependencies)，没有剩余 plugin 需要 |156| `--prune` | 也移除自动安装的 [依赖项](/docs/zh-CN/plugins/dependencies)，没有剩余插件需要 |
157| `-y, --yes` | 跳过 `--prune` 确认提示。当 stdin 或 stdout 不是 TTY 时，`--prune` 需要 |157| `-y, --yes` | 跳过 `--prune` 确认提示。当 stdin 或 stdout 不是 TTY 时，与 `--prune` 一起需要 |
158| `--json` | 将结果作为一个 JSON 对象打印在 stdout 的最后一行，格式与 [`plugin install --json`](#plugin-json-result) 相同。不能与 `--prune` 组合。需要 Claude Code v2.1.268 或更高版本 |158| `--json` | 将结果打印为 stdout 最后一行的一个 JSON 对象，格式与 [`plugin install --json`](#plugin-json-result) 相同。不能与 `--prune` 组合。需要 Claude Code v2.1.268 或更高版本 |
159 159
160从项目作用域卸载 plugin：160从项目作用域卸载插件：
161 161
162```bash theme={null}162```bash theme={null}
163claude plugin uninstall formatter@my-marketplace --scope project163claude plugin uninstall formatter@my-marketplace --scope project
164```164```
165 165
166Claude Code 打印 `Successfully uninstalled plugin: formatter (scope: project)`。当 plugin 未在该作用域安装时，命令打印以 `Failed to uninstall plugin "formatter@my-marketplace":` 开头的行，退出 `1`。166Claude Code 打印 `Successfully uninstalled plugin: formatter (scope: project)`。当插件未在该作用域安装时，命令打印以 `Failed to uninstall plugin "formatter@my-marketplace":` 开头的行并退出 `1`。
167 167
168如果失败行继续显示 `"formatter" was not uninstalled:`，Claude Code 无法确认该作用域的设置不再打开 plugin，因此 plugin 保持安装状态，并保留其保存的所有内容。使用 `--json`，结果带有 `failureCode: "settings_still_on"`。此设置检查需要 Claude Code v2.1.282 或更高版本。168如果失败行继续为 `"formatter" was not uninstalled:` 并命名设置文件，Claude Code 无法确认作用域的设置不再打开插件，因此插件保持安装状态，保留其保存的所有内容。使用 `--json` 时，结果携带 `failureCode: "settings_still_on"`。此设置检查需要 Claude Code v2.1.282 或更高版本。
169 169
170<h4 id="what-an-uninstall-deletes-and-keeps">170<h4 id="what-an-uninstall-deletes-and-keeps">
171 卸载删除和保留的内容171 卸载删除和保留的内容
172</h4>172</h4>
173 173
174当您从最后一个安装 plugin 的作用域卸载它时，Claude Code 也删除 plugin 的存储 [options 和 secrets](/docs/zh-CN/plugins/manifest-reference#user-configuration) 及其数据目录 `~/.claude/plugins/data/<id>/`。有三个例外：174当你从最后一个安装它的作用域卸载插件时，Claude Code 也删除插件存储的 [选项和密钥](/docs/zh-CN/plugins/manifest-reference#user-configuration) 及其数据目录 `~/.claude/plugins/data/<id>/`。有三个例外：
175 175
176* 使用 `--keep-data`，数据目录保留176* 使用 `--keep-data` 时，数据目录保留
177* 当另一个已安装的 plugin 使用相同的文件夹时，例如其 ID 仅在字母大小写上与此不同的 plugin，数据目录保留177* 当另一个已安装的插件使用相同的文件夹时，例如其 ID 仅在字母大小写上与此不同的插件，数据目录保留
178* 当 Claude Code 无法在从该作用域删除 plugin 后读回已安装 plugins 的列表时，options、secrets 和数据目录都保留，因为 plugin 可能仍在另一个作用域安装。卸载仍然成功。消息列出保留的内容及如何删除它，使用 `--json` 结果带有 `savedKept: "install_records_unreadable"`178* 当 Claude Code 无法在从该作用域移除插件后读回已安装插件的列表时，选项、密钥和数据目录都保留，因为插件可能仍在另一个作用域安装。卸载仍然成功。消息列出保留的内容及如何删除它，使用 `--json` 时结果携带 `savedKept: "install_records_unreadable"`
179 179
180使用 `--json`，`keptData` 报告目录是否保留，`/plugin` 在保留时显示 `· data preserved`。对于在没有 `--keep-data` 的情况下保留的目录，此报告需要 Claude Code v2.1.281 或更高版本。`savedKept` 字段需要 Claude Code v2.1.282 或更高版本。180使用 `--json` 时，`keptData` 报告目录是否保留，`/plugin` 在保留时显示 `· data preserved`。对于在没有 `--keep-data` 的情况下保留的目录，此报告需要 Claude Code v2.1.281 或更高版本。`savedKept` 字段需要 Claude Code v2.1.282 或更高版本。
181 181
182<h3 id="plugin-enable">182<h3 id="plugin-enable">
183 plugin enable183 plugin enable
184</h3>184</h3>
185 185
186启用禁用的 plugin。对于 [从 claude.ai 同步的 plugin](/docs/zh-CN/plugins/loading#synced-plugins)，将 `<name>@synced` 作为 plugin 传递。186启用禁用的插件。对于 [从 claude.ai 同步的插件](/docs/zh-CN/plugins/loading#synced-plugins)，传递 `<name>@synced` 作为插件。
187 187
188```bash theme={null}188```bash theme={null}
189claude plugin enable <plugin> [options]189claude plugin enable <plugin> [options]
192| 标志 | 描述 |192| 标志 | 描述 |
193| :- | :- |193| :- | :- |
194| `-s, --scope <scope>` | 启用的作用域：`user`、`project` 或 `local`。省略时自动检测 |194| `-s, --scope <scope>` | 启用的作用域：`user`、`project` 或 `local`。省略时自动检测 |
195| `--json` | 将结果作为一个 JSON 对象打印在 stdout 的最后一行，格式与 [`plugin install --json`](#plugin-json-result) 相同。需要 Claude Code v2.1.268 或更高版本 |195| `--json` | 将结果打印为 stdout 最后一行的一个 JSON 对象，格式与 [`plugin install --json`](#plugin-json-result) 相同。需要 Claude Code v2.1.268 或更高版本 |
196 196
197不使用 `--scope`，命令按本地、项目、用户的顺序检查您的设置文件，并使用提及 plugin 的第一个作用域。197不使用 `--scope` 时，命令按本地、项目、用户的顺序检查你的设置文件，并使用第一个提及插件的作用域。
198 198
199如果您传递 plugin 未声明的 `--scope`，命令要么写入覆盖，要么失败：199如果你传递插件未声明的 `--scope`，命令要么写入覆盖，要么失败：
200 200
201* **[优先于](/docs/zh-CN/plugins/loading) 声明作用域的作用域**：Claude Code 在您传递的作用域处写入覆盖。例如，`claude plugin disable formatter --scope local` 仅为您关闭项目启用的 plugin201* **一个 [优先于](/docs/zh-CN/plugins/loading) 声明作用域的作用域**：Claude Code 在你传递的作用域处写入覆盖。例如，`claude plugin disable formatter --scope local` 仅为你关闭项目启用的插件
202* **任何其他作用域**：命令失败，显示 `Plugin "formatter" is installed at project scope, not user. Use --scope project or omit --scope to auto-detect.`202* **任何其他作用域**：命令失败，显示 `Plugin "formatter" is installed at project scope, not user. Use --scope project or omit --scope to auto-detect.`
203 203
204如果 plugin 已在解析的作用域启用，命令打印 `Plugin "formatter" is already enabled` 并退出 `1`。使用 `--json`，结果具有 `"failureCode": "already_in_goal_state"` 和 `"alreadyInGoalState": true`，因此脚本可以将该情况视为成功。204如果插件已在解析的作用域启用，命令打印 `Plugin "formatter" is already enabled` 并退出 `1`。使用 `--json` 时，结果有 `"failureCode": "already_in_goal_state"` 和 `"alreadyInGoalState": true`，所以脚本可以将该情况视为成功。
205 205
206当 plugin 声明 [dependencies](/docs/zh-CN/plugins/dependencies) 时，Claude Code 也启用它们。命令在这些情况下失败：206当插件声明 [依赖项](/docs/zh-CN/plugins/dependencies) 时，Claude Code 也启用它们。命令在这些情况下失败：
207 207
208* **dependency 未安装**：启用失败并为每个缺失的 dependency 打印 `claude plugin install` 命令208* **依赖项未安装**：启用失败并为每个缺失的依赖项打印 `claude plugin install` 命令
209* **dependency 被您组织的 plugin 策略阻止**：启用失败并命名被阻止的 dependency209* **依赖项被你的组织的插件策略阻止**：启用失败并命名被阻止的依赖项
210* **dependency 在优先级高于目标作用域的作用域处设置为 `false`**：启用失败。在该作用域启用 dependency，或传递 `--scope` 以在那里写入210* **依赖项在优先级高于目标作用域的作用域处设置为 `false`**：启用失败。在该作用域启用依赖项，或传递 `--scope` 以在那里写入
211 211
212在声明它的任何地方重新启用 plugin：212在声明它的任何地方重新启用插件：
213 213
214```bash theme={null}214```bash theme={null}
215claude plugin enable formatter215claude plugin enable formatter
221 plugin disable221 plugin disable
222</h3>222</h3>
223 223
224禁用 plugin 而不卸载它。对于 [从 claude.ai 同步的 plugin](/docs/zh-CN/plugins/loading#synced-plugins)，将 `<name>@synced` 作为 plugin 传递。224禁用插件而不卸载它。对于 [从 claude.ai 同步的插件](/docs/zh-CN/plugins/loading#synced-plugins)，传递 `<name>@synced` 作为插件。
225 225
226```bash theme={null}226```bash theme={null}
227claude plugin disable [plugin] [options]227claude plugin disable [plugin] [options]
229 229
230| 标志 | 描述 |230| 标志 | 描述 |
231| :- | :- |231| :- | :- |
232| `-a, --all` | 禁用每个启用的 plugin。不能与 plugin 名称或 `--scope` 组合 |232| `-a, --all` | 禁用每个启用的插件。不能与插件名称或 `--scope` 组合 |
233| `-s, --scope <scope>` | 禁用的作用域：`user`、`project` 或 `local`。省略时自动检测 |233| `-s, --scope <scope>` | 禁用的作用域：`user`、`project` 或 `local`。省略时自动检测 |
234| `--json` | 将结果作为一个 JSON 对象打印在 stdout 的最后一行，格式与 [`plugin install --json`](#plugin-json-result) 相同。需要 Claude Code v2.1.268 或更高版本 |234| `--json` | 将结果打印为 stdout 最后一行的一个 JSON 对象，格式与 [`plugin install --json`](#plugin-json-result) 相同。需要 Claude Code v2.1.268 或更高版本 |
235 235
236不使用 `--scope`，作用域以与 [`plugin enable`](#plugin-enable) 相同的本地、项目、用户顺序自动检测。236不使用 `--scope` 时，作用域按与 [`plugin enable`](#plugin-enable) 相同的本地、项目、用户顺序自动检测。
237 237
238如果您既不传递 plugin 名称也不传递 `--all`，Claude Code 打印 `Please specify a plugin name or use --all to disable all plugins` 并退出 `1`。禁用已禁用的 plugin 打印 `Plugin "formatter" is already disabled` 并退出 `1`，如 [`plugin enable`](#plugin-enable) 对已启用的 plugin 所做的那样。238如果你既不传递插件名称也不传递 `--all`，Claude Code 打印 `Please specify a plugin name or use --all to disable all plugins` 并退出 `1`。禁用已禁用的插件打印 `Plugin "formatter" is already disabled` 并退出 `1`，如 [`plugin enable`](#plugin-enable) 对已启用的插件所做的那样。
239 239
240命令对仍然需要的 plugin 失败：240命令对仍然需要的插件失败：
241 241
242* **另一个启用的 plugin [depends on](/docs/zh-CN/plugins/dependencies) 它**：命令失败并命名要首先禁用的依赖项242* **另一个启用的插件 [依赖于](/docs/zh-CN/plugins/dependencies) 它**：命令失败并命名要首先禁用的依赖项
243* **您的组织要求它作为同步 plugin**：命令失败并保存任何内容243* **你的组织要求它作为同步插件**：命令失败并不保存任何内容
244 244
245禁用一个 plugin：245禁用一个插件：
246 246
247```bash theme={null}247```bash theme={null}
248claude plugin disable formatter248claude plugin disable formatter
254 plugin update254 plugin update
255</h3>255</h3>
256 256
257将 plugin 更新到其市场提供的最新版本。新版本在您的下一个会话中加载，或在您在运行的会话中运行 `/reload-plugins` 后加载。257将插件更新到其市场提供的最新版本。新版本在你的下一个会话中加载，或在运行中的会话中运行 `/reload-plugins` 后加载。
258 258
259```bash theme={null}259```bash theme={null}
260claude plugin update <plugin> [options]260claude plugin update <plugin> [options]
263| 标志 | 描述 |263| 标志 | 描述 |
264| :- | :- |264| :- | :- |
265| `-s, --scope <scope>` | 更新的作用域：`user`、`project`、`local` 或 `managed`。省略时自动检测 |265| `-s, --scope <scope>` | 更新的作用域：`user`、`project`、`local` 或 `managed`。省略时自动检测 |
266| `-y, --yes` | 接受来自 [command-source](/docs/zh-CN/plugins/host-marketplace) plugin 的更改的安装命令，无需提示。当 stdin 或 stdout 不是 TTY 时需要，除非您传递 `--accept-command`。需要 Claude Code v2.1.229 或更高版本 |266| `-y, --yes` | 接受来自 [命令源](/docs/zh-CN/plugins/host-marketplace) 插件的更改的安装命令，无需提示。当 stdin 或 stdout 不是 TTY 时需要，除非你传递 `--accept-command`。需要 Claude Code v2.1.229 或更高版本 |
267| `--accept-command <sha256>` | 接受市场声明的命令，其 `sha256` 之前的 [`--json` 运行](#plugin-json-result) 在 `shownCommand` 中报告，代替 `-y`。不能与 `-y` 组合。需要 Claude Code v2.1.271 或更高版本 |267| `--accept-command <sha256>` | 接受市场声明的命令，其 `sha256` 之前的 [`--json` 运行](#plugin-json-result) 在 `shownCommand` 中报告，代替 `-y`。不能与 `-y` 组合。需要 Claude Code v2.1.271 或更高版本 |
268| `--json` | 将结果作为一个 JSON 对象打印在 stdout 的最后一行，格式与 [`plugin install --json`](#plugin-json-result) 相同。需要 Claude Code v2.1.268 或更高版本 |268| `--json` | 将结果打印为 stdout 最后一行的一个 JSON 对象，格式与 [`plugin install --json`](#plugin-json-result) 相同。需要 Claude Code v2.1.268 或更高版本 |
269 269
270如果您省略 `--scope`，命令在您当前项目安装的最具体作用域处更新 plugin，检查本地、项目、用户，然后托管。270如果你省略 `--scope`，命令在为你的当前项目安装它的最具体作用域处更新插件，检查本地、项目、用户，然后托管。
271 271
272在 v2.1.281 之前，当您省略 `--scope` 时命令使用 `user`，因此更新仅在项目或本地作用域安装的 plugin 失败，显示 `Plugin "<name>" is not installed at scope user`。在这些版本上，传递 `--scope`。272在 v2.1.281 之前，当你省略 `--scope` 时命令使用 `user`，所以更新仅在项目或本地作用域安装的插件失败，显示 `Plugin "<name>" is not installed at scope user`。在这些版本上，传递 `--scope`。
273 273
274`managed` 是您可以更新但不能安装的唯一作用域。对于管理员安装的 plugins，请参阅 [为您的组织管理 plugins](/docs/zh-CN/plugins/org)。274`managed` 是你可以更新但不能安装的唯一作用域。对于管理员安装的插件，请参阅 [为你的组织管理插件](/docs/zh-CN/plugins/org)。
275 275
276更新 plugin：276更新插件：
277 277
278```bash theme={null}278```bash theme={null}
279claude plugin update formatter@my-marketplace279claude plugin update formatter@my-marketplace
281 281
282Claude Code 打印 `Checking for updates for plugin "formatter@my-marketplace"…`，然后是结果。当没有更新时，它打印 `formatter is already at the latest version (1.0.0).` 并退出 `0`。282Claude Code 打印 `Checking for updates for plugin "formatter@my-marketplace"…`，然后是结果。当没有更新时，它打印 `formatter is already at the latest version (1.0.0).` 并退出 `0`。
283 283
284您可以传递裸 plugin 名称，命令将其与您安装的 plugins 匹配。当来自不同市场的已安装 plugins 共享名称时，命令拒绝更新并列出要运行的限定 `plugin-name@marketplace-name` 命令。按裸名称更新需要 Claude Code v2.1.246 或更高版本。284你可以传递一个裸插件名称，命令将其与你安装的插件匹配。当来自不同市场的已安装插件共享名称时，命令拒绝更新并列出要运行的限定 `plugin-name@marketplace-name` 命令。按裸名称更新需要 Claude Code v2.1.246 或更高版本。
285 285
286<h3 id="plugin-list">286<h3 id="plugin-list">
287 plugin list287 plugin list
288</h3>288</h3>
289 289
290列出已安装的 plugins，包括其版本、作用域和状态。290列出已安装的插件及其版本、作用域和状态。
291 291
292```bash theme={null}292```bash theme={null}
293claude plugin list [options]293claude plugin list [options]
296| 标志 | 描述 |296| 标志 | 描述 |
297| :- | :- |297| :- | :- |
298| `--json` | 将列表打印为 JSON |298| `--json` | 将列表打印为 JSON |
299| `--available` | 也列出您的市场提供但您未安装的 plugins。没有 `--json` 时无效 |299| `--available` | 也列出你的市场提供但你未安装的插件。没有 `--json` 时无效 |
300 300
301Claude Code 按每个 plugin 的加载方式对人类可读的输出进行分组：301Claude Code 按每个插件的加载方式对人类可读的输出进行分组：
302 302
303* **`Installed plugins:`**：您从市场安装的 plugins303* **`Installed plugins:`**：你从市场安装的插件
304* **`Session-only plugins (--plugin-dir / --plugin-url):`**：由同一命令中的这些标志加载的 plugins，如 `claude --plugin-dir ./my-plugin plugin list`304* **`Session-only plugins (--plugin-dir / --plugin-url):`**：由同一命令中的这些标志加载的插件，如 `claude --plugin-dir ./my-plugin plugin list`
305* **`Skills-directory plugins (.claude/skills/*):`**：Claude Code 在 skills 目录中找到的 plugins305* **`Skills-directory plugins (.claude/skills/*):`**：Claude Code 在 skills 目录中找到的插件
306* **`Synced from claude.ai`**：[从您的 claude.ai 账户同步的 plugins](/docs/zh-CN/plugins/loading#synced-plugins)306* **`Synced from claude.ai`**：[从你的 claude.ai 账户同步的插件](/docs/zh-CN/plugins/loading#synced-plugins)
307 307
308当任何组中都没有内容时，Claude Code 打印 ``No plugins installed. Use `claude plugin install` to install a plugin.``308当任何组中都没有内容时，Claude Code 打印 ``No plugins installed. Use `claude plugin install` to install a plugin.``
309 309
311 JSON 输出311 JSON 输出
312</h4>312</h4>
313 313
314使用 `--json`，Claude Code 打印一个数组，每个安装一个对象。每个对象都带有下面的字段。`id`、`version`、`scope`、`enabled` 和 `installPath` 始终存在，其他字段仅在适用时出现。314使用 `--json` 时，Claude Code 打印一个数组，每个安装一个对象。每个对象携带下面的字段。`id`、`version`、`scope`、`enabled` 和 `installPath` 始终存在，其他仅在适用时出现。
315 315
316| 字段 | 类型 | 描述 |316| 字段 | 类型 | 描述 |
317| :- | :- | :- |317| :- | :- | :- |
318| `id` | string | 安装为 `name@marketplace`，会话内 plugins 为 `name@inline`，skills-directory plugins 为 `name@skills-dir`，从 claude.ai 同步的 plugins 为 `name@synced` |318| `id` | string | 安装时为 `name@marketplace`，会话内插件为 `name@inline`，skills-directory 插件为 `name@skills-dir`，从 claude.ai 同步的插件为 `name@synced` |
319| `version` | string | 对于市场安装，[Claude Code 在安装时计算的](/docs/zh-CN/plugins/loading#versions-and-updates) 版本。对于会话内、skills-directory 或同步 plugin，清单的 `version`，或当它不声明任何内容时为 `unknown` |319| `version` | string | 对于市场安装，[Claude Code 在安装时计算的](/docs/zh-CN/plugins/loading#versions-and-updates) 版本。对于会话内、skills-directory 或同步插件，清单的 `version`，或当它不声明时为 `unknown` |
320| `scope` | string | 安装为 `user`、`project`、`local` 或 `managed`；skills-directory plugins 为 `user` 或 `project`；会话内 plugins 为 `session`；从 claude.ai 同步的 plugins 为 `synced` |320| `scope` | string | 安装时为 `user`、`project`、`local` 或 `managed`；skills-directory 插件为 `user` 或 `project`；会话内插件为 `session`；从 claude.ai 同步的插件为 `synced` |
321| `enabled` | boolean | plugin 在您的合并设置中是否启用 |321| `enabled` | boolean | 插件在你的合并设置中是否启用 |
322| `installPath` | string | plugin 加载的目录 |322| `installPath` | string | 插件加载的目录 |
323| `installedAt` | string | 安装的 ISO 时间戳。仅市场安装 |323| `installedAt` | string | 安装的 ISO 时间戳。仅市场安装 |
324| `lastUpdated` | string | 最后更新的 ISO 时间戳。仅市场安装 |324| `lastUpdated` | string | 最后更新的 ISO 时间戳。仅市场安装 |
325| `projectPath` | string | 安装所属的项目。仅 `project` 和 `local` 作用域 |325| `projectPath` | string | 安装所属的项目。仅 `project` 和 `local` 作用域 |
326| `mcpServers` | object | plugin 的 MCP 服务器定义，当市场安装的 plugin 有任何时 |326| `mcpServers` | object | 插件的 MCP 服务器定义，当市场安装的插件有任何时 |
327| `errors` | array of strings | 加载错误，当 plugin 加载失败时 |327| `errors` | array of strings | 加载错误，当插件加载失败时 |
328| `notes` | array of strings | plugin 加载并工作时的创作警告 |328| `notes` | array of strings | 插件加载并工作的创作警告 |
329| `errorDetails` | array of objects | 每个 `errors` 条目一个对象，给出其诊断 `type` 和它引用的名称，例如 plugin、市场、服务器或文件。需要 Claude Code v2.1.268 或更高版本 |329| `errorDetails` | array of objects | 每个 `errors` 条目一个对象，给出其诊断 `type` 和它引用的名称，例如插件、市场、服务器或文件。需要 Claude Code v2.1.268 或更高版本 |
330| `noteDetails` | array of objects | 每个 `notes` 条目的相同详细对象。需要 Claude Code v2.1.268 或更高版本 |330| `noteDetails` | array of objects | 每个 `notes` 条目的相同详细对象。需要 Claude Code v2.1.268 或更高版本 |
331 331
332使用 `--json --available`，Claude Code 打印一个对象而不是数组。其 `installed` 字段保存已安装 plugin 对象的数组，其 `available` 字段保存每个未安装市场 plugin 的一个对象，带有下面的字段。332使用 `--json --available` 时，Claude Code 打印一个对象而不是数组。其 `installed` 字段保存已安装插件对象的数组，其 `available` 字段保存每个未安装的市场插件的一个对象，带有下面的字段。
333 333
334| 字段 | 类型 | 描述 |334| 字段 | 类型 | 描述 |
335| :- | :- | :- |335| :- | :- | :- |
336| `pluginId` | string | `name@marketplace` |336| `pluginId` | string | `name@marketplace` |
337| `name` | string | plugin 在市场中的名称 |337| `name` | string | 插件在市场中的名称 |
338| `marketplaceName` | string | 提供它的市场 |338| `marketplaceName` | string | 提供它的市场 |
339| `source` | string or object | 市场条目的 [source](/docs/zh-CN/plugins/marketplace-reference)：相对路径为字符串，否则为对象 |339| `source` | string or object | 市场条目的 [source](/docs/zh-CN/plugins/marketplace-reference)：相对路径为字符串，否则为对象 |
340| `description` | string | 条目的描述，当它有时 |340| `description` | string | 条目的描述，当它有时 |
341| `version` | string | 条目的版本，当它声明时 |341| `version` | string | 条目的版本，当它声明时 |
342| `installCount` | number | 安装计数，当 Claude Code 有 plugin 的计数时 |342| `installCount` | number | 安装计数，当 Claude Code 有插件的时 |
343 343
344<h3 id="plugin-details">344<h3 id="plugin-details">
345 plugin details345 plugin details
346</h3>346</h3>
347 347
348显示 plugin 的组件清单及其预计令牌成本。348显示插件的组件清单及其预计令牌成本。
349 349
350plugin 必须被加载：已安装、在 skills 目录中找到，或在同一命令中使用 `--plugin-dir` 或 `--plugin-url` 传递。`<name>` 是 plugin `name` 或 `name@marketplace`。350插件必须被加载：已安装、在 skills 目录中找到，或在同一命令中使用 `--plugin-dir` 或 `--plugin-url` 传递。`<name>` 是插件 `name` 或 `name@marketplace`。
351 351
352```bash theme={null}352```bash theme={null}
353claude plugin details <name>353claude plugin details <name>
354```354```
355 355
356命令除了 `--help` 外不接受任何标志。356该命令除了 `--help` 外不接受标志。
357 357
358显示已安装 plugin 的贡献：358显示已安装插件贡献的内容：
359 359
360```bash theme={null}360```bash theme={null}
361claude plugin details formatter361claude plugin details formatter
362```362```
363 363
364Claude Code 打印 plugin 的名称、版本、描述和源，然后是这些部分：364Claude Code 打印插件的名称、版本、描述和源，然后是这些部分：
365 365
366* **`Component inventory`**：plugin 的 skills、agents、hooks、MCP 服务器和 LSP 服务器366* **`Component inventory`**：插件的 skills、agents、hooks、MCP 服务器和 LSP 服务器
367* **`Projected token cost`**：plugin 添加到每个会话的始终开启令牌367* **`Projected token cost`**：插件添加到每个会话的始终开启令牌
368* **`Per-component (rounded)`**：每个 skill、agent 和命令的始终开启和按调用估计。当 plugin 没有时省略368* **`Per-component (rounded)`**：每个 skill、agent 和命令的始终开启和按调用估计。当插件没有时省略
369 369
370对于两个成本数字的含义，请参阅 [测量 plugin 成本和使用](/docs/zh-CN/plugins/measure)。370对于两个成本数字的含义，请参阅 [测量插件成本和使用](/docs/zh-CN/plugins/measure)。
371 371
372对于未加载的 plugin，Claude Code 打印 ``Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.`` 并退出 `1`。372对于未加载的插件，Claude Code 打印 ``Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.`` 并退出 `1`。
373 373
374<h3 id="plugin-prune">374<h3 id="plugin-prune">
375 plugin prune375 plugin prune
376</h3>376</h3>
377 377
378删除自动安装的 [dependencies](/docs/zh-CN/plugins/dependencies)，没有已安装的 plugin 需要。命令永远不会删除您自己安装的 plugin。`autoremove` 是 `prune` 的别名。378移除自动安装的 [依赖项](/docs/zh-CN/plugins/dependencies)，没有已安装的插件需要。命令永远不会移除你自己安装的插件。`autoremove` 是 `prune` 的别名。
379 379
380```bash theme={null}380```bash theme={null}
381claude plugin prune [options]381claude plugin prune [options]
384| 标志 | 描述 |384| 标志 | 描述 |
385| :- | :- |385| :- | :- |
386| `-s, --scope <scope>` | 在作用域处修剪：`user`、`project` 或 `local`。默认为 `user` |386| `-s, --scope <scope>` | 在作用域处修剪：`user`、`project` 或 `local`。默认为 `user` |
387| `--dry-run` | 列出将被删除的内容而不删除它 |387| `--dry-run` | 列出将被移除的内容而不移除它 |
388| `-y, --yes` | 跳过确认提示。当 stdin 或 stdout 不是 TTY 时需要 |388| `-y, --yes` | 跳过确认提示。当 stdin 或 stdout 不是 TTY 时需要 |
389 389
390预览修剪将删除的内容：390预览修剪将移除的内容：
391 391
392```bash theme={null}392```bash theme={null}
393claude plugin prune --dry-run393claude plugin prune --dry-run
394```394```
395 395
396Claude Code 列出孤立的 dependencies 并以 `(dry run — nothing removed)` 结尾。当没有要删除的内容时，它打印以 `Nothing to prune` 开头的行。396Claude Code 列出孤立的依赖项并以 `(dry run — nothing removed)` 结尾。没有要移除的内容时，它打印以 `Nothing to prune` 开头的行。
397 397
398不使用 `--dry-run`，命令仅在您在提示处确认或传递 `-y` 后删除孤立的 dependencies。398不使用 `--dry-run` 时，命令仅在你在提示处确认或传递 `-y` 后移除孤立的依赖项。
399 399
400无论您在提示处的答案如何，退出代码都是 `0`。400无论你在提示处的答案如何，退出代码都是 `0`。
401 401
402`prune` 的作用取决于是否附加了终端以及您是否传递了 `-y`：402`prune` 的作用取决于是否附加了终端以及你是否传递了 `-y`：
403 403
404| 终端和标志 | 发生的情况 |404| 终端和标志 | 发生的情况 |
405| :- | :- |405| :- | :- |
406| 交互式终端，无 `-y` | 列出孤立的 dependencies 并询问 `Remove? [y/N]` |406| 交互式终端，无 `-y` | 列出孤立的依赖项并询问 `Remove? [y/N]` |
407| 任何终端，`-y` | 删除它们并打印 `Removed N auto-installed plugins: <names>` |407| 任何终端，`-y` | 移除它们并打印 `Removed N auto-installed plugins: <names>` |
408| 非 TTY stdin 或 stdout，无 `-y` | 打印列表和 ``Not a TTY — run `claude plugin prune -y` to remove.``，不删除任何内容 |408| 非 TTY stdin 或 stdout，无 `-y` | 打印列表并显示 ``Not a TTY — run `claude plugin prune -y` to remove.``，不移除任何内容 |
409 409
410<h3 id="plugin-eval">410<h3 id="plugin-eval">
411 plugin eval411 plugin eval
412</h3>412</h3>
413 413
414运行 plugin 的 [eval cases](/docs/zh-CN/plugin-evals) 并报告评分结果。需要 Claude Code v2.1.269 或更高版本。414运行插件的 [eval 案例](/docs/zh-CN/plugin-evals) 并报告评分结果。需要 Claude Code v2.1.269 或更高版本。
415 415
416每个案例是一个提示加评分器。Claude Code 在仅加载目标 plugin 的隔离会话中多次运行它，默认情况下也不使用 plugin 运行，以便报告显示差异。416每个案例是一个提示加评分器。Claude Code 在隔离的会话中运行它多次，仅加载目标插件，默认情况下也不加载插件，所以报告显示差异。
417 417
418有关案例格式、评分器、结果和 CI 使用，请参阅 [使用 evals 测试 plugins](/docs/zh-CN/plugin-evals)。418请参阅 [使用 evals 测试插件](/docs/zh-CN/plugin-evals) 了解案例格式、评分器、结果和 CI 使用。
419 419
420```bash theme={null}420```bash theme={null}
421claude plugin eval [target] [options]421claude plugin eval [target] [options]
422```422```
423 423
424可选的 `target` 默认为当前目录，采用以下任何形式：424可选的 `target` 默认为当前目录，并采用以下任何形式：
425 425
426* plugin 目录426* 插件目录
427* 单个 `prompt.md` 或 `case.yaml` 文件427* 单个 `prompt.md` 或 `case.yaml` 文件
428* 已安装的 plugin，如 `name` 或 `name@marketplace`428* 已安装的插件作为 `name` 或 `name@marketplace`
429* `name@skills-dir`429* `name@skills-dir`
430 430
431将目标放在 `--tag`、`--allow-tools` 和 `--json` 之前。这些选项中的每一个都将其后的单词作为其值，因此在其中一个之后写入的目标被读作标签、工具名称或 JSON 输出路径，而不是目标。431将目标放在 `--tag`、`--allow-tools` 和 `--json` 之前。这些选项中的每一个都将其后的单词作为其值，所以在其中一个之后写入的目标被读作标签、工具名称或 JSON 输出路径，而不是目标。
432 432
433此表列出大多数运行使用的选项。运行 `claude plugin eval --help` 以获取完整集合，包括 `--case`、`--tag`、`--output-dir`、`--report`、`--allow-real-servers`、`--keep-temp` 和 `--verbose`。433此表列出大多数运行使用的选项。运行 `claude plugin eval --help` 以获取完整集合，包括 `--case`、`--tag`、`--output-dir`、`--report`、`--allow-real-servers`、`--keep-temp` 和 `--verbose`。
434 434
435| 选项 | 描述 | 默认 |435| 选项 | 描述 | 默认 |
436| :- | :- | :- |436| :- | :- | :- |
437| `--runs <n>` | 每个 [arm](/docs/zh-CN/plugin-evals#compare-against-a-no-plugin-baseline) 中每个案例的运行 | 每个案例的 `runs`，否则 3 |437| `--runs <n>` | 每个 [arm](/docs/zh-CN/plugin-evals#compare-against-a-no-plugin-baseline) 中每个案例的运行 | 每个案例的 `runs`，否则 3 |
438| `-j, --concurrency <n>` | 一次运行的代理会话，1 到 8。它们共享您的速率限制 | `1` |438| `-j, --concurrency <n>` | 一次运行的代理会话，1 到 8。它们共享你的速率限制 | `1` |
439| `--model <model>` | 被测试代理的模型 | 每个案例的 `model`，否则 `ANTHROPIC_MODEL`（如果设置），否则 Claude Code 的默认值 |439| `--model <model>` | 被测试代理的模型 | 每个案例的 `model`，否则 `ANTHROPIC_MODEL` 如果设置，否则 Claude Code 的默认值 |
440| `--judge-model <model>` | `llm` 和 `baseline` 评分器的模型 | 一个小的快速模型 |440| `--judge-model <model>` | `llm` 和 `baseline` 评分器的模型 | 一个小的快速模型 |
441| `--ablation <mode>` | `none` 或 `with-without`。请参阅 [与无 plugin 基线比较](/docs/zh-CN/plugin-evals#compare-against-a-no-plugin-baseline) | 当 plugin 解析时为 `with-without`，否则为 `none` |441| `--ablation <mode>` | `none` 或 `with-without`。请参阅 [与无插件基线比较](/docs/zh-CN/plugin-evals#compare-against-a-no-plugin-baseline) | 当插件解析时为 `with-without`，否则 `none` |
442| `--threshold <0..1>` | 如果任何案例评分低于此，退出 1 | `1.0` |442| `--threshold <0..1>` | 如果任何案例评分低于此，退出 1 | `1.0` |
443| `--max-cost-usd <usd>` | 一旦支出达到此值，在下一次运行前停止，退出 2，并报告部分结果 | 无限制 |443| `--max-cost-usd <usd>` | 一旦支出达到此值，在下一次运行前停止，退出 2，并报告部分结果 | 无限制 |
444| `--allow-tools <tools...>` | 授予超出只读集合的工具，例如 `Bash`、`Write`、`Edit` 或 `"mcp__plugin_<plugin>_<server>__*"`。请参阅 [授予工具](/docs/zh-CN/plugin-evals#grant-tools) | |444| `--allow-tools <tools...>` | 授予超出只读集合的工具，例如 `Bash`、`Write`、`Edit` 或 `"mcp__plugin_<plugin>_<server>__*"`。请参阅 [授予工具](/docs/zh-CN/plugin-evals#grant-tools) | |
445| `--scaffold` | 运行每个案例的 [`scaffold_script`](/docs/zh-CN/plugin-evals#add-setup-or-history-with-case-yaml) | 关闭 |445| `--scaffold` | 运行每个案例的 [`scaffold_script`](/docs/zh-CN/plugin-evals#add-setup-or-history-with-case-yaml) | 关闭 |
446| `--trust-plugin` | 跳过首次运行信任提示，用于 CI。请参阅 [运行可以访问的内容](/docs/zh-CN/plugin-evals#security) | 关闭 |446| `--trust-plugin` | 跳过首次运行信任提示，用于 CI。请参阅 [运行可以访问的内容](/docs/zh-CN/plugin-evals#security) | 关闭 |
447| `--mocks <mode>` | `record` 或 `off`。请参阅 [Mock MCP 服务器](/docs/zh-CN/plugin-evals#mock-mcp-servers) | `record` |447| `--mocks <mode>` | `record` 或 `off`。请参阅 [模拟 MCP 服务器](/docs/zh-CN/plugin-evals#mock-mcp-servers) | `record` |
448| `--eval-dir <dir>` | plugin 下方保存案例的目录 | 清单的 `experimental.evals`，否则 `evals` |448| `--eval-dir <dir>` | 插件下方保存案例的目录 | 清单的 `experimental.evals`，否则 `evals` |
449| `--json [path]` | 将 [结果文档](/docs/zh-CN/plugin-evals#json-result) 打印到 stdout，或将其写入 `.json` 路径 | |449| `--json [path]` | 将 [结果文档](/docs/zh-CN/plugin-evals#json-result) 打印到 stdout，或写入 `.json` 路径 | |
450| `--no-publish` | 保持 HTML 报告本地 | |450| `--no-publish` | 保持 HTML 报告本地 | |
451 451
452退出代码报告运行如何结束。要在管道中对其进行操作，请参阅 [在 CI 中运行 evals](/docs/zh-CN/plugin-evals#run-evals-in-ci)。452退出代码报告运行如何结束。要在管道中对其进行操作，请参阅 [在 CI 中运行 evals](/docs/zh-CN/plugin-evals#run-evals-in-ci)。
454| 退出代码 | 含义 |454| 退出代码 | 含义 |
455| :- | :- |455| :- | :- |
456| `0` | 每个案例都满足阈值 |456| `0` | 每个案例都满足阈值 |
457| `1` | 失败的案例、加载错误或不受信任的 plugin 目录 |457| `1` | 失败的案例、加载错误或不受信任的插件目录 |
458| `2` | 部分运行 |458| `2` | 部分运行 |
459| `130` | 中断 |459| `130` | 中断 |
460| `143` | 终止 |460| `143` | 终止 |
463 plugin eval init463 plugin eval init
464</h3>464</h3>
465 465
466为当前目录中的 plugin 创建 eval 套件。需要 Claude Code v2.1.269 或更高版本。请参阅 [创建您的第一个 eval 套件](/docs/zh-CN/plugin-evals#create-your-first-eval-suite)。466为当前目录中的插件创建 eval 套件。需要 Claude Code v2.1.269 或更高版本。请参阅 [创建你的第一个 eval 套件](/docs/zh-CN/plugin-evals#create-your-first-eval-suite)。
467 467
468```bash theme={null}468```bash theme={null}
469claude plugin eval init [name] [options]469claude plugin eval init [name] [options]
470```470```
471 471
472在终端中，命令打开交互式 Claude Code 会话以进行创作访谈。在访谈中，Claude 执行以下操作：472在终端中，命令打开交互式 Claude Code 会话进行创作访谈。在访谈中，Claude 执行以下操作：
473 473
4741. 读取 plugin4741. 读取插件
4752. 询问您它应该做什么4752. 询问你它应该做什么
4763. 提议案例和评分器4763. 提议案例和评分器
4774. 写入案例文件4774. 写入案例文件
4785. 运行案例并与您一起查看评分，以检查评分器是否按您的方式评分4785. 运行案例并与你一起查看评分，以检查评分器是否按你的方式评分
479 479
480使用 `--bare` 或没有终端，命令改为写入空白单案例模板。当 Claude 从 Claude Code 会话内运行命令时，命令打印该会话要遵循的访谈说明，而不是写入模板。480使用 `--bare` 或没有终端时，命令改为写入空白单案例模板。当 Claude 从 Claude Code 会话内运行命令时，命令打印该会话要遵循的访谈说明，而不是写入模板。
481 481
482可选的 `name` 是案例名称。它对于 `--bare` 或没有终端是必需的，因为命令为该案例写入空白模板。访谈不需要。482可选的 `name` 是案例名称。它与 `--bare` 或没有终端时需要，因为命令为该案例写入空白模板。访谈不需要。
483 483
484命令接受这些选项：484命令接受这些选项：
485 485
487| :- | :- | :- |487| :- | :- | :- |
488| `--bare` | 为 `<name>` 写入空白 `prompt.md` 和 `graders/criteria.md`，而不是运行访谈 | |488| `--bare` | 为 `<name>` 写入空白 `prompt.md` 和 `graders/criteria.md`，而不是运行访谈 | |
489| `-i, --interactive` | 需要访谈。没有终端时失败，而不是写入模板 | |489| `-i, --interactive` | 需要访谈。没有终端时失败，而不是写入模板 | |
490| `--eval-dir <dir>` | 当前目录下方写入案例的目录 | 清单的 `experimental.evals`，否则 `evals` |490| `--eval-dir <dir>` | 当前目录下写入案例的目录 | 清单的 `experimental.evals`，否则 `evals` |
491 491
492<h3 id="plugin-tag">492<h3 id="plugin-tag">
493 plugin tag493 plugin tag
494</h3>494</h3>
495 495
496为 plugin 发布创建名为 `<name>--v<version>` 的带注释 git 标签。在标记之前，命令检查 plugin 的 `plugin.json` 和任何列出它的市场条目是否同意版本。496为插件发布创建名为 `<name>--v<version>` 的带注释 git 标签。在标记前，命令检查插件的 `plugin.json` 和任何列出它的市场条目在版本上是否一致。
497 497
498有关何时标记发布，请参阅 [发布 plugin](/docs/zh-CN/plugins/publish)。498关于何时标记发布，请参阅 [发布插件](/docs/zh-CN/plugins/publish)。
499 499
500```bash theme={null}500```bash theme={null}
501claude plugin tag [path] [options]501claude plugin tag [path] [options]
502```502```
503 503
504`[path]` 是 plugin 目录，默认为当前目录。命令通过从该目录向上走到列出 plugin 的 `.claude-plugin/marketplace.json` 来查找市场条目。504`[path]` 是插件目录，默认为当前目录。命令通过从该目录向上走到列出插件的 `.claude-plugin/marketplace.json` 来找到市场条目。
505 505
506| 标志 | 描述 |506| 标志 | 描述 |
507| :- | :- |507| :- | :- |
508| `--push` | 创建后将标签推送到 `--remote` |508| `--push` | 创建标签后推送到 `--remote` |
509| `--dry-run` | 打印将被标记的内容而不创建标签 |509| `--dry-run` | 打印将被标记的内容而不创建标签 |
510| `-f, --force` | 跳过脏工作树和标签已存在检查 |510| `-f, --force` | 跳过脏工作树和标签已存在检查 |
511| `-m, --message <msg>` | 标签注释消息。`%s` 代表版本。默认为 `<name> <version>` |511| `-m, --message <msg>` | 标签注释消息。`%s` 代表版本。默认为 `<name> <version>` |
512| `--remote <name>` | 使用 `--push` 推送到的远程。默认为 `origin` |512| `--remote <name>` | 使用 `--push` 推送到的远程。默认为 `origin` |
513 513
514预览市场检出中 plugin 的标签：514预览市场检出中插件的标签：
515 515
516```bash theme={null}516```bash theme={null}
517claude plugin tag plugins/formatter --dry-run517claude plugin tag plugins/formatter --dry-run
519 519
520Claude Code 打印计划：520Claude Code 打印计划：
521 521
522* plugin 名称522* 插件名称
523* 版本和它来自哪个文件523* 版本及其来自的文件
524* 匹配的市场条目，当有时524* 匹配的市场条目，当有时
525* 标签名称525* 标签名称
526* 它将运行的 `git tag` 和 `git push` 命令526* 它将运行的 `git tag` 和 `git push` 命令
527 527
528不使用 `--dry-run`，Claude Code 打印 `Created tag formatter--v1.0.0` 和 `Pushed to origin` 或您自己运行的推送命令。如果推送失败，标签仍在本地创建，命令以错误退出。528不使用 `--dry-run` 时，Claude Code 打印 `Created tag formatter--v1.0.0` 并打印 `Pushed to origin` 或你自己运行的推送命令。如果推送失败，标签仍在本地创建，命令以错误退出。
529 529
530当它无法安全标记时，命令退出 `1` 并打印原因。常见原因是：530当命令无法安全标记时，它退出 `1` 并打印原因。常见原因是：
531 531
532* `plugin.json` 或市场条目中没有 `version`532* `plugin.json` 或市场条目中没有 `version`
533* 标签已存在533* 标签已存在
537 plugin validate537 plugin validate
538</h3>538</h3>
539 539
540验证 plugin 清单、市场清单或目录中的 skills、agents 和命令，并以 CI 作业可以操作的代码退出。对于创建、测试和编辑工作流，请参阅 [创建 plugin](/docs/zh-CN/plugins/create)。对于验证器在每个清单中检查的内容，请参阅 [plugin 清单参考](/docs/zh-CN/plugins/manifest-reference) 和 [市场参考](/docs/zh-CN/plugins/marketplace-reference)。540验证插件清单、市场清单或目录中的 skills、agents 和命令，并以 CI 作业可以操作的代码退出。对于创建、测试和编辑工作流，请参阅 [创建插件](/docs/zh-CN/plugins/create)。对于验证器在每个清单中检查的内容，请参阅 [插件清单参考](/docs/zh-CN/plugins/manifest-reference) 和 [市场参考](/docs/zh-CN/plugins/marketplace-reference)。
541 541
542```bash theme={null}542```bash theme={null}
543claude plugin validate <path> [options]543claude plugin validate <path> [options]
545 545
546| 标志 | 描述 |546| 标志 | 描述 |
547| :- | :- |547| :- | :- |
548| `--strict` | 将警告视为错误，因此运行时容忍的未识别字段和缺失元数据失败。需要 Claude Code v2.1.145 或更高版本 |548| `--strict` | 将警告视为错误，所以运行时容忍的未识别字段和缺失元数据失败。需要 Claude Code v2.1.145 或更高版本 |
549| `--json` | 将验证报告输出为一个 JSON 对象，具有相同的退出代码。需要 Claude Code v2.1.259 或更高版本 |549| `--json` | 将验证报告输出为一个 JSON 对象，具有相同的退出代码。需要 Claude Code v2.1.259 或更高版本 |
550 550
551在提交前验证 plugin：551在提交前验证插件：
552 552
553```bash theme={null}553```bash theme={null}
554claude plugin validate ./my-plugin --strict554claude plugin validate ./my-plugin --strict
567 * 名为 `.claude` 的目录：其中的 `skills`、`agents` 和 `commands` 目录567 * 名为 `.claude` 的目录：其中的 `skills`、`agents` 和 `commands` 目录
568 * 任何其他目录：其 `.claude` 下的这三个目录568 * 任何其他目录：其 `.claude` 下的这三个目录
569 569
570Claude Code 不跟随您命名的目录内的符号链接。它的作用取决于链接的位置：570Claude Code 不跟随你命名的目录内的符号链接。它的作用取决于链接的位置：
571 571
572* **plugin 或 `.claude` 根下的链接 `skills`、`agents` 或 `commands` 目录**：Claude Code 警告其中的任何内容都未被读取。572* **插件或 `.claude` 根下的链接 `skills`、`agents` 或 `commands` 目录**：Claude Code 警告其中的任何内容都未被读取。
573* **`skills`、`agents` 或 `commands` 目录内的链接条目**：Claude Code 跳过它并警告，每个目录，它跳过了多少条目，会话会加载。573* **`skills`、`agents` 或 `commands` 目录内的链接条目**：Claude Code 跳过它并警告，每个目录，它跳过了多少条目，会话会加载。
574* **您命名的 `skills`、`agents` 或 `commands` 目录本身是符号链接，或其父 `.claude` 目录是**：Claude Code 报告错误并检查其中的任何内容。改为命名真实目录。574* **你命名的 `skills`、`agents` 或 `commands` 目录本身是符号链接，或其父 `.claude` 目录是**：Claude Code 报告错误并检查其中的任何内容。改为命名真实目录。
575 575
576验证运行不读取几个文件：576少数文件不被验证运行读取：
577 577
578* **plugin 根处的 `SKILL.md`**：当您针对 plugin 目录运行 `claude plugin validate` 时，Claude Code 不检查 plugin 根处的 `SKILL.md`578* **插件根处的 `SKILL.md`**：当你针对插件目录运行 `claude plugin validate` 时，Claude Code 不检查插件根处的 `SKILL.md`
579* **plugin 根处的 `CLAUDE.md`**：在 plugin 运行中，Claude Code 也警告 plugin 根处的 `CLAUDE.md`579* **插件根处的 `CLAUDE.md`**：在插件运行中，Claude Code 也警告插件根处的 `CLAUDE.md`
580* **市场运行中的 Plugin 文件**：从市场目录，Claude Code 不打开 plugins 的 skill、agent、command 或 hook 文件。要在这些文件中查找错误，验证每个 plugin 目录580* **市场运行中的插件文件**：从市场目录，Claude Code 不打开插件的 skill、agent、command 或 hook 文件，或它们捆绑的 MCP 服务器文件。要在这些文件中找到错误，验证每个插件目录
581 581
582<h4 id="output-and-exit-codes">582<h4 id="output-and-exit-codes">
583 输出和退出代码583 输出和退出代码
587 587
588| 退出代码 | 判决行 | 含义 |588| 退出代码 | 判决行 | 含义 |
589| :- | :- | :- |589| :- | :- | :- |
590| `0` | `Validation passed` 或 `Validation passed with warnings` | 清单加载。使用 `--strict`，也没有警告 |590| `0` | `Validation passed` 或 `Validation passed with warnings` | 清单加载。使用 `--strict` 时，也没有警告 |
591| `1` | `Validation failed` 或 `Validation failed (--strict treats warnings as errors)` | 错误，或 `--strict` 下的警告 |591| `1` | `Validation failed` 或 `Validation failed (--strict treats warnings as errors)` | 错误，或 `--strict` 下的警告 |
592| `2` | `Unexpected error during validation: <reason>` | 验证器本身失败，例如在不可读的路径上 |592| `2` | `Unexpected error during validation: <reason>` | 验证器本身失败，例如在不可读的路径上 |
593 593
594使用 `--json`，Claude Code 将报告作为一个 JSON 对象写入 stdout，具有这些顶级字段：594使用 `--json` 时，Claude Code 将报告作为一个 JSON 对象写入 stdout，具有这些顶级字段：
595 595
596* `success`：退出代码给出的相同判决596* `success`：退出代码给出的相同判决
597* `strict`：运行是否将警告视为错误597* `strict`：运行是否将警告视为错误
598* `target`：Claude Code 验证的解析路径598* `target`：Claude Code 验证的解析路径
599* `manifest`：清单自己的结果，或没有清单的运行为 `null`599* `manifest`：清单自己的结果，或对没有清单的运行为 `null`
600* `contents`：每个文件的结果，命名其 `file` 并携带 `errors`、`warnings` 和 `notes` 数组600* `contents`：每个文件的结果，命名其 `file` 并携带 `errors`、`warnings` 和 `notes` 数组
601 601
602在退出 `2` 时，命令不向 stdout 写入任何内容。错误消息转到 stderr。602在退出 `2` 时，命令不向 stdout 写入任何内容。错误消息转到 stderr。
709从你的设置中移除市场的声明。`rm` 是 `remove` 的别名。709从你的设置中移除市场的声明。`rm` 是 `remove` 的别名。
710 710
711<Warning>711<Warning>
712 当你从最后一个声明市场的作用域中移除市场时，Claude Code 也会删除其缓存并卸载你从中安装的每个插件。不使用 `--scope` 时，命令从每个作用域中移除声明。要在不丢失其插件的情况下刷新市场，请改为运行 `plugin marketplace update`。712 当你从最后一个声明市场的作用域中移除市场时，Claude Code 也会删除其缓存并卸载你从中安装的每个插件。它也会删除它们保存的[选项和密钥](/docs/zh-CN/plugins/manifest-reference#user-configuration)和[数据](/docs/zh-CN/plugins/components#path-variables-and-persistent-data)（如果可以的话）。
713
714 要在不丢失其插件的情况下刷新市场，请改为运行 `plugin marketplace update`。
713</Warning>715</Warning>
714 716
715```bash theme={null}717```bash theme={null}
728claude plugin marketplace remove your-marketplace730claude plugin marketplace remove your-marketplace
729```731```
730 732
731Claude Code 打印 `Successfully removed marketplace: your-marketplace`，当你限定作用域时添加 `(from project settings)`。如果你限定作用域到不声明市场的设置文件，命令失败，显示 `Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes.`733Claude Code 打印 `Successfully removed marketplace: your-marketplace`。当命令卸载插件时，输出在诸如 `Also uninstalled 2 plugins from this marketplace:` 的行下列出它们。要再次使用其中一个，请添加市场并重新安装插件。
734
735如果你限定作用域到不声明市场的设置文件，命令失败，显示 `Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes.`
732 736
733<h3 id="plugin-marketplace-update">737<h3 id="plugin-marketplace-update">
734 plugin marketplace update738 plugin marketplace update
