Claude Code 过去一周连着发了三个小版本，其中最值得团队用户关注的是 9 月 8 日的 v2.1.265：--plugin-dir 现在可以直接指向一个文件夹，文件夹里每个带 manifest 的子目录都会被当作独立插件加载，而且运行中添加或删除子目录会实时生效——不用再为装一个新插件而重启会话。
更有戏剧性的是，Anthropic 当天又紧急发了 v2.1.266，把自己在 265 里引入的一个网关回归修掉了。一天之内自己给自己擦屁股，这在 Claude Code 的发布史上也算少见。
一、–plugin-dir 文件夹化：团队插件库的日常彻底变了
以前用 --plugin-dir，一次只能指向单个插件路径。团队想分发一堆内部插件，要么启动命令写成长长一串，要么靠每个人都手动装一遍。
v2.1.265 之后，目录结构变成这样：
claude --plugin-dir ./team-plugins只要 ./team-plugins 下面每个子文件夹都带自己的 manifest（比如 plugin.json），它就会被识别为一个独立插件。比如：
team-plugins/
├── linter-helper/
│ └── plugin.json
├── deploy-checker/
│ └── plugin.json
└── code-reviewer/
└── plugin.json关键变化在热加载：会话运行期间，往 team-plugins/ 里新增或移除一个子文件夹，Claude Code 会立刻感知，不需要重启、不需要重开会话。
这对两类人最有用：
- 团队：把整套内部插件目录放进 monorepo，按子目录管理，哪个小组的插件都能随仓库走；
- 个人开发者：本地维护一个
plugins/根目录，按项目或按用途把插件分门别类，实验新插件时开个文件夹就行，不行就删掉，零成本切换。
二、1GB 工具结果上限与缓存复用修复：长任务的隐形改进
除了插件文件夹化，v2.1.265 还带了一堆对”跑长任务”的人很重要的细节修复：
1GB 工具结果落盘上限。 工具输出超出内联预览、需要存成文件让模型回读时，现在有 1GB 的硬上限。如果文件被截断，对话里的预览会明确提示”该文件已被截断”，模型就不会默默读一个残缺文件当完整结果用。对会抓大日志、生成大产物的 CI Agent 来说，这是个防呆设计。
Prompt-cache 复用修复。 两个修复都跟省钱直接相关：resume 前台启动的子 Agent 时，不再改变它的工具列表和系统提示前缀，缓存前缀保持稳定，下一轮直接命中；Agent teammates 和 resume 的子 Agent 也不再让 SubagentStart hook 上下文和预加载 skills 从前缀里挪走。说白了，就是恢复会话后 prompt-cache 不会断，长任务的成本不会悄悄翻倍。
崩溃恢复更稳。 上次进程在某个工具调用中途挂掉，resume 后不会再重写最后一条提示，被中断的工具调用会被保留并标记为 interrupted——你可以接着上次断点继续，而不是从头再来。
三、同天发布 2.1.266：自修网关回归，企业用户务必升级
v2.1.265 里有个改动给企业用户埋了个雷：Claude Desktop 和 Cowork 走 Claude apps gateway 时，telemetry 开始带上 user.email 和 user.groups——这个字段本身不算新，但对走网关的桌面端是新行为。
真正的雷在这：一个原本”设置了也不生效”的环境变量 CLAUDE_CODE_USE_GATEWAY，在 265 里开始单独起作用——只要设了它就会强制走 Cloud gateway 登录。结果就是所有使用自家 LLM 网关或代理（配了 API key、apiKeyHelper 或自定义 auth header）的团队，请求全部报 “Not signed in to the Cloud gateway”。
Anthropic 当天发布的 v2.1.266 把这个回归修掉了：变量恢复成必须和 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 同时设置才生效的旧行为。
给团队的建议很直接：如果你们把 Claude Code 接在自建网关或代理后面，确认已经升到 v2.1.266 或更高。哪怕 265 只短暂存在过，升上去就不用再折腾配置。
四、老达点评：插件工程化是 Agent 配置管理的下一站
这次更新看起来都是小改动，但串起来是一条很清晰的线：插件、技能、Agent 定义正在变成”代码化、可版本管理”的资产。
上周 Anthropic 刚发布 ant apply，把 Agent、技能、环境、部署全变成仓库文件走代码评审（我写过解读：ant apply：把 Agent 配成代码）。这周 --plugin-dir 文件夹化又补上了插件分发这一环——配合 Claude Code 默认模型换成 Fable 5.1 里提到的 1M 上下文和更便宜的缓存读取，团队把整套开发环境装进一个文件夹推给每个人，正在从”手动配置”变成”拉代码即用”。
对团队落地，我的上手建议是三步：
- 先升级：确认 Claude Code 在 v2.1.266+，网关/代理用户尤其别停在 265；
- 再建目录：在 monorepo 里开一个
team-plugins/，每个插件一个子目录、带上 manifest，用--plugin-dir指向根目录； - 最后立规矩：插件即代码，就该走代码评审——参考之前 GitSpawn 的教训（恶意 Git 仓库攻破 7 款 AI 编程工具），任何第三方插件进目录前都要过一遍 manifest 和 hooks，别让团队共享目录变成投毒入口。
适合人群：正在用 Claude Code 做团队开发的工程团队、维护多项目多插件配置的独立开发者、以及所有嫌”每加一个插件就要重启一次”麻烦的人。
局限也如实说：文件夹化解决的是”加载路径”问题，插件本身的权限边界、更新来源锁定（marketplace 的 commit SHA pinning）这些还得靠团队自己的供应链管理补上。插件管理从”能装”走向”能管”，Claude Code 才刚开了个头。
相关阅读：
