Skip to content

claude plugin install 新增 --marketplace:一条命令加市场并装插件 ​

给新同事配环境、写团队初始化脚本时,装插件一直是两步:先把插件市场(marketplace)加进来,再从里面安装插件。少跑一步就会报「找不到插件」。

CLI 2.1.292 把这两步合成了一步:claude plugin install 新增 --marketplace <source> 参数。

以前怎么装 ​

插件来自市场。一个市场就是一份插件目录,通常是一个 Git 仓库或一个路径。以前的流程是:

bash
# 第一步:添加市场
claude plugin marketplace add <市场来源>

# 第二步:从市场安装插件
claude plugin install <插件名>@<市场名>

问题在于:

  • 文档、README 里得写两条命令,读者常常只复制了第二条;
  • 脚本里要先判断市场是不是已经加过,避免重复添加;
  • 市场名和来源地址不是一回事,新手容易搞混。

插件的基本概念和目录结构,可以先看站内的 插件怎么装、怎么自己做。

2.1.292 的新写法 ​

bash
claude plugin install <插件名> --marketplace <市场来源>

它做的事情是:

  1. 检查这个市场是否已经添加;没有就自动添加;
  2. 添加时走的是和 claude plugin marketplace add 相同的策略检查;
  3. 然后直接从这个市场安装指定插件。

市场已经存在时,它不会重复添加,只负责安装。所以同一条命令可以放心地反复执行。

适合用在哪 ​

  • 团队初始化脚本:一条命令装好团队插件,不用先写判断逻辑。
  • 项目 README:「安装本项目推荐的插件」只需要贴一行。
  • 新机器 / 容器环境:配合 dotfiles 或启动脚本,开箱就能用。

一个脚本示意(插件名和来源请换成你自己的):

bash
#!/usr/bin/env bash
set -e
claude plugin install team-review --marketplace your-org/claude-plugins
claude plugin install team-commit --marketplace your-org/claude-plugins

注意事项 ​

  • 策略检查不会被绕过。组织用托管设置限制了允许的市场时,--marketplace 同样受约束;不被允许的来源加不进来,插件也装不上。
  • 同一版本还修复了一个问题:首次运行时,marketplace add、install 等插件命令可能在组织托管设置加载完成之前就执行了。升级到 2.1.292 后,这类命令会等策略就绪再跑。
  • 来源请只填你信任的市场。插件能带 skills、hooks、agents,等于在你的环境里运行别人的逻辑。如果某个市场名字看起来像 Anthropic 官方市场,但来源不是官方,新版本给出的提示也更清楚了,看到时多留个心眼。
  • 想从额外的本地目录加载插件,可以看 CLAUDE_CODE_PLUGIN_DIRS 多目录装插件。

小结 ​

  • 2.1.292 起,claude plugin install <插件> --marketplace <来源> 一步完成「加市场 + 装插件」。
  • 市场已存在就跳过添加,适合写进可重复执行的脚本。
  • 添加市场时的策略检查与 marketplace add 一致,组织限制仍然有效。

升级后用 claude --version 确认版本 ≥ 2.1.292,再把团队文档里的两步安装改成一行。

Claude-cn.org,专注于 Claude Code 中文教程