启动参数看官方文档从目录或ZIP存档加载插件Syntax--plugin-dir <path>示例claude --plugin-dir ./my-plugin全网调研整理典型场景开发阶段本地测试 plugin，无需发布到 marketplace 即可加载验证在 CI/CD 流水线中加载以 .zip 打包的构建产物，验证插件集成行为临时覆盖已安装的同名 marketplace plugin，测试本地修改而不卸载现有版本同时加载多个插件做联合集成测试，通过多次重复 flag 实现将 `.claude/` 目录下的独立配置迁移为 plugin 时，先用此 flag 验证迁移结果实用技巧重复多次 flag 可同时加载多个插件：`claude --plugin-dir ./a --plugin-dir ./b`，目录与 .zip 可混用v2.1.128+ 直接接受 .zip 存档，省去解压步骤，适合分发版本锁定的内部插件会话内修改 plugin 文件后运行 `/reload-plugins` 即可热更新，无需重启 Claude Code用环境变量控制是否加载：`PLUGIN_DEV=1 claude` 配合 shell 函数，方便 CI 条件启用headless 模式下 `init.plugin_errors` JSON 字段会上报 --plugin-dir 加载失败（含损坏 zip/缺失 manifest），CI 脚本可据此硬失败常见坑plugin 根目录必须含 `.claude-plugin/plugin.json` manifest，缺失则加载静默失败（v2.1.128 前无错误提示）`skills/`、`agents/`、`hooks/` 等目录须放在 plugin 根目录，误放进 `.claude-plugin/` 内部会导致组件无法识别无法覆盖被 managed settings 强制 enable/disable 的 plugin，即使本地同名 plugin 通过此 flag 加载也不生效.zip 支持仅在 v2.1.128 及以上版本有效，旧版本只接受解压后的目录路径来源Create plugins - Claude Code DocsClaude Code: Conditionally Loading Plugins with --plugin-dir · GitHub GistClaude Code v2.1.128: --plugin-dir ZIP Support & Worktree Fixanthropics/claude-code plugins/README.md · GitHub最早记录ⓘ≤v2.1.74最近更新v2.1.200变化次数3改进 2修复 1变化时间线(按版本倒序)修复v2.1.200· 2026/07/04 · 7 天前修复标志位置不正确导致插件代理和技能在代理视图中不显示的问题改进v2.1.128· 2026/05/05 · 2026/05/05现在接受 .zip 插件档案以及目录改进v2.1.74· 2026/03/12 · 2026/03/12修改为仅接受一个path支持subcommands，改为使用repeated --plugin-dir支持多个目录上一个--permission-prompt-tool回到命令字典下一个--plugin-url