Claude Code插件默认跨worktree共享于全局路径~/.claude/skills(Linux/macOS)或%USERPROFILE%.claude\skills(Windows),所有实例自动加载;更新需覆盖该目录文件或用claude plugin build命令部署,避免放入worktree内导致版本错乱。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当你在多个 worktree 中同时运行 Claude Code 实例,每个 worktree 对应不同分支、不同功能开发环境时,插件(Skills)的更新必须确保所有实例都能加载最新逻辑,又不能因重复加载或路径冲突导致某个 worktree 加载失败或行为异常。
确认插件根目录是否跨 worktree 共享
默认情况下,Claude Code 的插件存放在项目根目录外的 ~/.claude/skills(Linux/macOS)或 %USERPROFILE%\.claude\skills(Windows),这是一个全局路径,与当前 worktree 所在目录无关。这意味着:所有 worktree 实例启动时都会自动从这个统一位置加载插件,无需为每个 worktree 单独复制或同步。
这一步是关键前提——如果手动把插件放进了某个 worktree 内部的 .claude/skills 子目录,那它只对该 worktree 有效,其他实例根本看不到,极易造成版本错乱。
更新插件的两种安全方式
方法一:直接覆盖全局 skills 目录下的文件
进入 ~/.claude/skills(macOS/Linux)或 %USERPROFILE%\.claude\skills(Windows),找到对应插件文件夹(如 my-linter),用新版本内容覆盖整个文件夹。所有正在运行的 Claude Code 实例会在下一次插件调用时自动读取更新后的代码——无需重启会话,也无需逐个 reload。
记录结构化的Claude Code轨迹、影子git diff,并在代理行为需要法医级调试而非临时转录审查时回放分支。
方法二:用 CLI 命令重建插件(推荐用于脚本化更新)
在任意终端中执行:claude plugin build --path /path/to/your/plugin。该命令会将插件编译后自动部署到全局 ~/.claude/skills 下同名目录中,并覆盖旧版本。注意:此操作会清空目标插件目录原有文件,【请确保插件源码已提交或备份,否则未 git add 的本地修改将永久丢失】。
验证更新是否生效
第一步:在任一 worktree 终端中执行 claude plugin list,检查插件状态列是否显示 active 且版本号匹配预期。
第二步:切换到另一个 worktree 目录,运行 claude /plugin my-linter --help,确认命令响应和参数说明已更新。
第三步:触发一次实际调用,比如 /plugin my-linter --fix src/utils.ts,观察输出日志中是否包含新版本特有的提示语或行为变化。
如果某 worktree 报错“Plugin not found”,大概率是该 worktree 启动时 ~/.claude/skills 尚未存在,Claude Code 自动创建了一个空目录并缓存了初始状态;此时只需退出该 worktree 的 Claude 实例,再重新运行 claude --worktree <name></name> 即可重新加载全局插件树。

















