Elena Artemova(叶莲娜·阿尔捷莫娃 / Елена Артемова) · 发布 · 更新 · 该工具的目的 · 附应用实例.
为何挂起比错误更危险
无限等待响应的代理看起来仍在工作。任务既未完成,也未被拒绝,队列位置被占用,操作者不清楚是否需要介入。错误则相反,它把系统带回可理解的状态:原因已知,可以据此作出决定。
该版本把对外部地址的请求等待默认限制为 300 秒,而变量 CLAUDE_CODE_WEBFETCH_DEADLINE_MS 允许自行设定上限或将其关闭。意义并不在这个数字本身。按时间显式结束,把未知变成可观察的事件,从而可以对其开展工作。
2.1.268 版本改变了什么
除等待上限之外,该版本还新增了网关中允许网络列表为空时的警告(access_control.allow_cidrs),以及首次从公网地址访问时的一次性提示。同时出现了 gatewayInternalNetworks 设置:管理员可以为组织自身的公网地址段放行经由网关的访问。
版本还单独说明了自主执行器模式,即在结束后删除会话状态。在隔离方面则明确,禁止规则同样适用于通过符号链接可访问的目录。在头部会话中,用量与规模的统计现在会在退出时保存,而不是在恢复之后从零开始。
为何要在恢复时保留用量
用量上限只有在计数器能跨越中断时才成立。如果重启或恢复会话后总计被清零,限制就被悄无声息地放松了:二十次短运行看起来比一次长运行更便宜,尽管完成的工作量相同。
退出时保存总计,使报告恢复原本的意义。这样才有可能把用量与具体运行对应起来,发现偏离并说明其原因。这不是为报告而报告:没有它,既无法讨论预算,也无法讨论成本上升的原因与允许负载的边界。
哪些地方需要限制而不是指望
一条用同一路径的另一种写法即可绕过的禁止规则,算不上限制。因此关于符号链接的补充说明很重要:如果某个目录既能通过真实路径访问,又能通过链接访问,检查就必须在两种情况下都生效。
复合 shell 命令也带来同样的问题:如果排除规则只命中命令的一部分,而整个表达式仍被执行,边界就不再意味着任何东西。
等待上限与隔离规则在代理无人持续看护的地方才真正有用。对于有人盯着的单次调用,简单的错误处理已经足够。是否采用控制手段,应依据未完成操作的后果来判断,而不是依据配置的便利程度。
示例
对外部来源的请求无法结束
- 任务
- 在一个假想流程中,代理读取一份外部文档。服务器接受连接,但既不发送响应,也不关闭连接。
- 工具的作用
- 应用中设定了等待上限。上限到期后请求被终止,日志中记录下地址、等待时长与错误标记。会话的用量总计在退出时保存。
- 预期结果
- 预期结果是任务以一条可理解的错误结束,而不是无限停留在等待状态;用量把这份工作归属到具体的某次运行。
- 要检查什么
- 如果恢复之后计数器从零开始,用量上限就不再起限制作用。示例仅作说明,未进行测量。
Claude Code 在需要让等待以错误结束、让用量归属于具体运行的地方才有用。
来源及原因
发售日期:
主要来源描述了该仪器及其开发。关于选择的结论 - 实验室的编辑分析。 一个例子解释了该工具的用途;没有对其进行任何测量。 来源日期已验证为 2026 年 9 月 8 日。
关于主题的问题
Claude Code 会取代权限校验吗?
不会。它规定的是运行时的行为。数据构成、权限与访问规则由工具之外的部分另行确定。
为什么要提示允许网络列表为空?
空列表意味着网关的开放范围超出管理员原本的设想。警告让这一点在事故之前就变得可见。
每次调用都需要等待上限吗?
在外部系统可能不响应的地方它有用。对于快速的内部调用,上限仍是一道保险。