它到底是什么

claude plugin marketplace update 是 claude plugin marketplace 子命令组（add / list / update / remove）中的一员。它从 marketplace 的来源重新拉取一个或全部 marketplace，以获取新增的插件和新版本。官方文档的描述：

• 如果 marketplace 是用分支或 tag ref 添加的，它会更新到该 ref 的最新 commit，而不是仓库默认分支。
• 文档在 remove 的警告中明确建议：想刷新 marketplace 又不想丢失其插件，用 plugin marketplace update，不要先 remove 再 add。
• claude plugins 是 claude plugin 的别名。

--json 选项需要 Claude Code v2.1.287 或更高版本（官方文档标注）。

用法 / 语法

claude plugin marketplace update [name] [options]

官方文档说明，表中只列常用选项。完整选项以 claude plugin marketplace update --help 为准。

示例：

claude plugin marketplace update your-marketplace

退出码 / 输出格式

文档规定：marketplace 子命令遵循 claude plugin 命令的通用约定，成功退出 0，失败退出 1。

--json 的具体字段结构在文档中指向"JSON result format"章节，本文未单独核实其字段，不在此展开。

Shell 集成 / 自动化

官方文档只给出了单个 marketplace 的刷新示例。基于上述语法，在脚本中可以这样用：

# 刷新全部 marketplace
claude plugin marketplace update

# 刷新指定 marketplace,并取得机器可读结果(需要 v2.1.287+)
claude plugin marketplace update your-marketplace --json

文档规定退出码为 0（成功）/1（失败）。

与会话内同名命令的差异

运行约束 / 限制

常见坑

• 刷新 marketplace ≠ 插件内容立刻变化。 文档说明，用户只有在插件的"计算后版本"变化时才会获得新副本。如果作者在 plugin.json 里写死了 "version": "1.0.0"，即使推送了新 commit、你也运行了 marketplace update，缓存副本仍不变。作者需要每次发布提升 version，或者省略 version 让用户跟踪 commit。
• 刷新后还需更新插件。 文档给出的非自动更新路径是：会话内 /plugin marketplace update <name>，或 shell 中 claude plugin update <plugin>@<name>。
• 不要用 remove 再 add 代替 update。 文档警告：从最后一个声明它的 scope 移除 marketplace 时，会删除其缓存、卸载从中安装的所有插件，并尽可能删除这些插件保存的选项、密钥和数据。
• 名称写 marketplace 名，不是来源。 remove 的文档明确 <name> 是 plugin marketplace list 显示的名称，而非 add 时传入的来源。
• 私有仓库 + HTTPS 凭据助手需要交互时会失败。 见上方约束。后台自动更新场景下，文档称更新会静默失败并保留现有 checkout。

来源

• Plugin commands reference（plugin marketplace update 章节）
• Host and maintain a marketplace(Keep users up to date / Grant access to a private marketplace)
• Create a marketplace