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 <市场来源>它做的事情是:
- 检查这个市场是否已经添加;没有就自动添加;
- 添加时走的是和
claude plugin marketplace add相同的策略检查; - 然后直接从这个市场安装指定插件。
市场已经存在时,它不会重复添加,只负责安装。所以同一条命令可以放心地反复执行。
适合用在哪
- 团队初始化脚本:一条命令装好团队插件,不用先写判断逻辑。
- 项目 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,再把团队文档里的两步安装改成一行。