Claude Code WebFetch 缓存 TTL 怎么改
2.1.233 新增 CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS:会话内 URL 缓存默认 15 分钟,可按环境变量调整。

Claude Code 2.1.233 增加环境变量 CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS,用来配置 WebFetch 在会话内的 URL 缓存 TTL。Changelog 写明:默认不变,仍是 15 分钟。
它管哪一层
WebFetch 拉过的页面会在同会话里短缓存,避免 Agent 反复打同一 URL。TTL 到期后下次再拉才走网络。这与 prompt cache(模型侧前缀缓存)不是一回事:一个省重复下载,一个省重复 prefill。
何时改大、何时改小
- 改小:盯实时状态页、价格、CI 徽章,15 分钟太「旧」。
- 改大:文档/RFC 类静态页,减少对目标站的重复压力。
- 保持默认:大多数编码会话够用。
export CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS=60000 # 示例:1 分钟,按需求改
claude
合法取值与上限以当前版 help / 发行说明为准;Changelog 只给变量名与默认 15 分钟。改完开新会话再验:先 Fetch 一次,TTL 内应命中缓存,过期后再 Fetch 应看到新鲜内容。
排障提示
若「明明改了线上文案 Agent 还念旧版」,先查是不是还在 TTL 内,再查 CDN。不要和 MCP 资源缓存、浏览器插件缓存混为一谈。