v2.1.248（2026-08-27）。

受限模式

`--restricted`（或 `CLAUDE_CODE_RESTRICTED=1`）：

• 移除内置的运行命令或代码的工具，以及 WebFetch（除非在 --tools 里点名）；
• 文件工具限制在工作目录内；
• 拒绝 `bypassPermissions`；
• 忽略用户、项目和本地设置文件。

适合把 Claude Code 放进不完全受信任的上下文里跑。

其他新增

• `experimental.cacheTtl`（`"5m"` 或 `"1h"`）可写进 agent frontmatter：没有配置子智能体 TTL 设置时，按 agent 生效的 prompt 缓存 TTL。
• claude self-hosted-runner --client-label <label>：覆盖 runner 注册用的标签（默认主机名）。
• 服务端托管设置诊断：加载失败时给出启动警告，/doctor 和 /status 说明失败原因或为何没有抓取。
• /web-setup 在 GitHub CLI token 缺少 workflow scope 时给出警告。
• 为 AWS Marketplace 计费等 Enterprise 组织新增 /usage-credits。
• 跨会话消息（`SendMessage` / `ListAgents`）扩展到 Bedrock、Vertex、Foundry 以及关闭遥测的场景。

修复

• 修复长会话里大约每小时一次的 prompt 缓存未命中（以及随之丢失的扩展思考上下文），根因是 OAuth token 刷新后工具定义被重新渲染。