它到底是什么

claude plugin marketplace add 是 claude plugin 子命令组里的一条命令，用来把一个 marketplace（含 .claude-plugin/marketplace.json 的目录或仓库）注册到 Claude Code。注册之后，你可以用 claude plugin install <plugin>@<marketplace> 安装其中的插件。claude plugins 是 claude plugin 的别名。

官方文档写明，从 shell 运行的 claude plugin marketplace add 与会话内 /plugin marketplace add 接受相同的 source。

用法 / 语法

claude plugin marketplace add <source>

支持的 source 类型（来自官方文档）：

# 本地目录(官方示例)
claude plugin marketplace add ./my-marketplace

# GitHub 仓库
claude plugin marketplace add <owner>/<repo>

已核实的 flag:

示例：

claude plugin marketplace add --claudeai claudeai-organization-library

本次核查没有确认其他 flag（例如 --scope）是否适用于 marketplace add。请以 claude plugin marketplace add --help 的输出为准。

退出码 / 输出格式

claude plugin 各子命令共用的退出码（validate 和 eval 另有额外退出码）：

成功时，官方文档给出的输出是：

✔ Successfully added marketplace: my-marketplace (declared in user settings)

这说明该 marketplace 已记录在用户级 settings 文件中。

Shell 集成 / 自动化

• 在没人打开过交互式 Claude Code 会话的机器上，官方 marketplace 尚未注册。官方文档建议安装脚本在 claude plugin install 之前先运行：

claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install formatter@your-org --scope project

• claude -p 等非交互运行里 /plugin 不可用，要用 claude plugin 系列 shell 命令来安装和管理插件。
• 私有仓库使用同一条 add 命令，Claude Code 用机器上已有的 git 凭据 clone，并且从不弹出交互提示：
  • HTTPS：走 git credential helper，例如 gh auth login、macOS Keychain、git-credential-store。
  • SSH:host 必须已在 known_hosts 中，并且 key 不能需要 passphrase 提示。
  • GitHub owner/repo 简写：先检测 SSH key 能否认证 github.com，能则走 SSH，否则走 HTTPS。设置 CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1 可跳过检测，始终走 HTTPS。

与会话内同名命令的差异

会话内 /plugin marketplace add <source> 与 shell 中的命令注册方式相同，source 类型也相同。/plugin market 是 /plugin marketplace 的简写。

另有一个只在会话内存在的组合形式（官方文档标注需要 Claude Code v2.1.275 或更高版本）：

/plugin install deploy-helper --marketplace your-org/plugins

它一步完成"添加 marketplace + 安装插件"，并会在添加前显示解析出的 source 让你确认。

运行约束 / 限制

经典使用场景

• 本地开发 marketplace:claude plugin validate ./my-marketplace 通过后，add ./my-marketplace 再 install。用本地相对路径 source 时，Claude Code 直接读取 plugins/ 下的文件，修改后在下次会话启动或 /reload-plugins 时生效。
• 团队分发：把 marketplace 目录推到 git host，成员在 shell 里执行 claude plugin marketplace add <owner>/<repo>，或用完整仓库 URL。
• 固定版本：用 owner/repo#v1.2.0 固定到某个 tag 或分支。
• 配置脚本：在 setup 脚本里先 add 再 install。

常见坑

• 忘了给相对路径加 ./，结果被当成 GitHub 仓库。
• 忘了给 URL 加 https://，同样被当成简写并被拒绝。
• 私有仓库在 CI 中失败：没有配置好非交互的 git 凭据或 known_hosts。
• 本地 marketplace 默认不自动更新。官方文档写明，第三方和本地开发的 marketplace 默认关闭 auto-update，官方 marketplace 和从 claude.ai 添加的默认开启。
• 移除 marketplace 会卸载从它安装的所有插件，并清除对应的 enabledPlugins 条目。

配套的管理命令（shell / 会话内）：

来源

• Create and distribute a plugin marketplace
• Install and manage plugins
• Plugin commands reference