Claude Code 2.1.265 支持文件夹批量加载插件了

Claude Code 2.1.265 的 plugin-dir 现在可以指向一个文件夹,里面每个带 manifest 的子文件夹自动加载为插件,运行中增删即时生效。

Claude Code 2.1.265 支持文件夹批量加载插件了

Claude Code 2.1.265(2026 年 9 月 8 日发布)给 --plugin-dir 加了一个实用功能:现在可以指向一个文件夹,文件夹里每个包含 manifest 文件的子目录自动加载为插件。运行期间在这个目录里新增或删除子目录,Claude Code 会即时感知变化。

作者CodePass 技术编辑

之前怎么用、现在怎么用

之前 --plugin-dir 只接受单个插件的路径,要加载多个插件需要多次指定。现在只需要指向一个父目录:

claude --plugin-dir ./my-plugins

my-plugins/ 下的目录结构可以是:

my-plugins/
  plugin-a/
    manifest.json
    index.js
  plugin-b/
    manifest.json
    index.js

每个带 manifest.json 的子目录自动加载。不含 manifest 的子目录被忽略,不会报错。

运行中在 my-plugins/ 里新增一个带 manifest 的子目录,Claude Code 会在下一次需要调用插件时发现它。删除一个子目录同理。不需要重启 Claude Code。

同版本的其他变更

2.1.265 还带了两个值得注意的改动:

工具结果磁盘存储上限 1 GB。当 Agent 执行命令时,stdout/stderr 的完整输出会保存到磁盘。2.1.265 给这个存储加了 1 GB 上限,超过后截断,并在对话预览里标注"文件已截断"。之前没有上限,长时间运行的任务可能产生几十 GB 的输出文件。

subagent 恢复和 prompt-cache 修复。前台生成的 subagent 和被中断的工具调用之前存在 resume 失败和 prompt-cache 无法复用的问题,2.1.265 修复了这两个问题。对于频繁使用 subagent 的工作流,这意味着中断后恢复的可靠性提升,缓存命中率也会改善。

升级注意事项

npm install -g @anthropic-ai/claude-code@latest
claude --version  # 确认 ≥ 2.1.265

如果你的团队使用自定义 AI 网关(通过 ANTHROPIC_BASE_URL 代理请求),升级到 2.1.265 后可能会遇到 CLAUDE_CODE_USE_GATEWAY 环境变量导致的认证失败问题。这是 2.1.265 引入的一个回退 bug,已在 2.1.266 中修复。建议直接升级到 2.1.266。

参考资料