多目录装插件：CLAUDE_CODE_PLUGIN_DIRS 和 edit-skill-overrides

CLI 2.1.280 在表面能力上加了一项很多人早就想要的东西：环境变量 CLAUDE_CODE_PLUGIN_DIRS，用来声明额外的插件目录。同一批还露出 edit-skill-overrides、edit-chrome-settings、edit-sandbox-settings 等编辑入口，并修了几处「技能被误丢进垃圾桶」「marketplace 名撞保留字」的坑。

插件总览仍可看 插件指南；Skills 基础见站内 Skills 相关文。下面只盯「多目录 + 覆盖 + 最近踩坑」。

CLAUDE_CODE_PLUGIN_DIRS 解决什么

默认布局里，插件多半落在用户目录或 marketplace 装好的路径。团队若要把内网打包的插件树、只读挂载的共享盘、或与家目录分离的 CI 工件一并挂进会话，以前往往只能拷进约定目录或改安装流程。

设上 CLAUDE_CODE_PLUGIN_DIRS 之后：

• 会话启动时会多扫你列出的目录（具体分隔符与优先级以当前 --help / 文档为准，常见是系统路径分隔）。
• 适合「公司统一发一版插件包，本机只挂路径、不反复 plugin install」。
• 不替代信任模型：多目录等于多攻击面。只挂你信任、可审计的树。

最小验证：

export CLAUDE_CODE_PLUGIN_DIRS="/path/to/team-plugins"
claude
# 在 /plugin 或 /skills 里确认预期条目出现

CI / 无头会话同样可以在环境里注入该变量，避免把插件拷进每个 runner 的家目录。

三个 edit-*：改覆盖，而不是改教程截图

changelog 的 CLI surface 里新增（或露出）：

命令	大致用途
edit-skill-overrides	改技能覆盖项（开/关、覆盖策略等，以界面为准）
edit-chrome-settings	编辑 Claude in Chrome 相关设置
edit-sandbox-settings	编辑沙箱相关设置

VS Code 侧同窗口也加了 /sandbox、/chrome 对话框，和面板菜单入口对齐。终端里用这些 edit 命令，IDE 里用斜杠命令，改的是同一类偏好，别两边各改一套还以为没生效。

技能在 /plugin、/skills 里关闭时，2.1.280 起用暗色 ◯ 表示「关掉」，不再和「插件加载失败」的红 ✘ 长得一样——少一次误判。

两个真实踩坑

1. ~/.claude/skills/ 被扫进 .trash

修过一版：若 ~/.claude/skills/ 下的 manifest.json 列出了某些技能名，这些技能曾被挪到 ~/.claude/skills/.trash/。升级后不应再「无声搬家」。若你发现技能消失，先查 .trash，再查 manifest 是否误列。

2. 仿冒保留 marketplace 名

名字长得像官方 / 保留 marketplace 的源，添加时会被拒绝；已经加上的也会停止加载。内网镜像请用不会撞保留字的名字，别图省事抄官方 marketplace 字符串。

相关修复还包括：从 GitHub / git URL 按分支或标签更新插件后，installed_plugins.json 不再卡在安装时的旧 commit；官方 marketplace 快照异常时，plugin update 不再把版本写成 unknown。私有 marketplace 的后台自动更新也会尊重 git credential helper，减少「每次重克隆」。

和账号同步的关系

若终端登录的是 Claude.ai 账号，技能与插件还可能从账号侧同步下来（可用 syncClaudeAiSkills / syncClaudeAiPlugins 关掉）。CLAUDE_CODE_PLUGIN_DIRS 是本机/CI 额外挂载；账号同步是另一条线。两边同时开时，先弄清「这条技能到底从哪来」，再用 edit-skill-overrides 做覆盖，避免改 A 目录、生效的却是 B。

建议工作流

1. 团队插件打成只读目录 → 机器设 CLAUDE_CODE_PLUGIN_DIRS。
2. 个人偏好用 edit-skill-overrides（或 /skills）微调，不改共享树。
3. Chrome / 沙箱偏好分别走对应 edit 或 /chrome、/sandbox。
4. marketplace 命名避开保留字；更新后看 /plugin 里的版本与来源是否仍对。

多目录是便利，不是免审。挂得进会话的，都要当生产依赖管。