服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- Code Mode 是实验性、主动选择加入的工具调用能力;官方开启和组织关闭指南在 2026 年 11 月 13 日核对时返回 404,不能据此补写步骤或判断普遍可用性。
- 仅通过 ALL_PROXY 指定代理的组织设置与策略请求不再使用该代理;这些请求需要代理时,应按组织批准方式设置 HTTPS_PROXY。
- plugin.json 的 engines["claude-code"] 版本范围会影响插件是否安装、更新或加载;安装和更新会选择最新的兼容版本。
- claude plugin validate 会检查 TypeScript hooks 模块;发现项默认显示为警告,添加 --strict 后验证命令会以失败结束。
Code Mode 是实验性功能,开启步骤尚未核验
Claude Code 2.1.323 的发布说明日期为 2026 年 11 月 12 日。新增的 Code Mode 是实验性、主动选择加入的功能,由 Claude 编写 JavaScript 来调用可用工具。
发布说明链接到开启及组织关闭功能的官方指南,但该准确页面在 2026 年 11 月 13 日核对时返回 HTTP 404。个人开启和组织禁用步骤、账号资格、地区与价格因此仍未核验。
这一观察不能判断所有账号的开放情况或服务整体可用性。发布说明也没有提供速度、Token 用量或费用收益的测量;Code Mode 与 Manual、Auto 权限模式的替代关系尚未核验。
ALL_PROXY 的变化只针对组织设置与策略请求
2.1.323 对代理行为的说明范围很窄:组织设置和策略请求不再使用仅由 ALL_PROXY 指定的代理;如果这些请求所在的网络需要代理,版本说明要求设置 HTTPS_PROXY。这里点名的是组织设置与策略请求,不是对 Claude Code 所有网络流量的统一改写。不能把它解释成其他请求也必然忽略 ALL_PROXY,或都必须走 HTTPS_PROXY。
排查时先确认失败的具体请求是否属于组织设置或策略请求,再看该运行入口实际从哪里读取代理设置。若这类请求失败且环境只提供 ALL_PROXY,应让管理员按已批准的网络策略检查 HTTPS_PROXY 配置。不要把这条变化套用到模型 API、工具调用或全部桌面流量;API Gateway 的 ANTHROPIC_BASE_URL 是另一项路由设置,不能与代理变量混为一谈。
插件版本范围会影响安装、更新和加载
本版为 plugin.json 增加 engines["claude-code"] 版本范围门槛。超出插件声明 Claude Code 版本范围的插件不会被安装、更新或加载;执行安装或更新时,系统选择符合该范围的最新插件版本。开发者遇到插件缺失或未加载时,应同时核对运行中的 Claude Code 版本和插件声明的支持范围,不能只看插件市场显示的最新版本。
核对本地入口、校验结果和代理设置来源
先在出现问题的命令行入口执行 claude --version,并记录终端、编辑器或桌面会话等实际启动方式。若问题发生在桌面或其他由宿主管理的会话中,还要单独确认该宿主是否已包含 2.1.323;命令行版本本身不能证明嵌入式会话也在运行同一版本。插件维护者可运行 claude plugin validate 查看 TypeScript hooks 模块的类型检查结果:默认情况下发现项是警告,使用 --strict 时发现项会令校验命令失败。
记录错误发生时间、失败请求类别、实际生效的设置来源和原始错误信息,并遮去密钥、代理凭据及其他敏感值。官方网络配置说明指出,shell 导出的变量在启动时读取,修改后应启动新的相关会话;由 Claude Desktop 管理提供方连接的会话,则从托管设置和 ~/.claude/settings.json 读取代理设置。按实际入口核对组织批准的配置,不要通过关闭 TLS 校验来掩盖证书或代理错误。 官方文档还明确说明 Claude Code 不支持 SOCKS 代理;不要把 SOCKS 地址当作可直接使用的 HTTPS_PROXY 配置。
资料来源
常见问题
所有插件都应该把 Claude Code 最低兼容版本设为 2.1.323 吗?
不应仅因新字段出现就统一抬高最低版本。engines["claude-code"] 应反映插件实际支持的 Claude Code 版本;声明范围会参与安装、更新和加载判断,发布说明没有规定适用于所有插件的版本区间。
claude plugin validate --strict 失败,就表示该插件一定无法加载吗?
不能单凭校验命令的失败得出加载结论。2.1.323 将 --strict 下的类型检查发现项定义为校验失败;同一版本说明另行定义了插件版本范围门槛对安装、更新和加载的影响,并没有说两种结果等同。应分别记录 CI 校验结果和运行时兼容状态。