Claude Code v2.1.312 发布：修复大文件误覆盖，调整自定义模型部署行为

Claude Code 于北京时间 10 月 28 日（UTC 10 月 27 日）发布 v2.1.312。根据官方更新记录，本次重点包括大文件写入保护、企业配置加载修复、自定义模型名称的处理规则，以及云端会话、Slack 和 Code Review 的稳定性改进。这是 AI agent 编程工具更新，不涉及新的基础模型版本发布。

大文件写入与项目配置修复

官方修复了 Claude 仅读取文件开头后，覆盖子目录中超大 CLAUDE.md、规则文件或通过 @ 引入文件的问题。现在，Write 工具会要求 Claude 先完整读取文件，或在原文件中编辑。

在 Git 仓库中通过 Bash 执行 cd 进入更深目录后，按目录配置的技能及带有 paths: 配置的技能无法被发现的问题也已修复。另一个修复针对无效命令名：此前，一个名称无效的命令可能阻止全部命令加载，导致 claude -p 没有输出。

企业用户方面，新版修复了从 VS Code 扩展登录后，本次会话余下时间不再获取托管设置和组织策略的问题。如果启动时组织设置加载失败或被拒绝，VS Code 标签页现在会说明原因，并提供 Retry 或重新登录选项。

自定义模型部署的默认行为变化

使用 Bedrock、Vertex、Foundry 或 Mantle 的用户需要注意：对于 Claude Code 无法识别的模型名称，例如自定义部署名和推理配置文件 ARN，现在会使用较短的系统提示词，即便其背后实际是 Sonnet 或 Haiku。如需保留完整系统提示词，可设置 CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0。

被标记消息触发的自动模型切换，也扩展到 Claude Code 无法识别的模型名称，包括自定义部署名。可通过 CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK=1 关闭这类自动切换。

prompt hooks 和 agent hooks 的并发上限也有调整：每个会话最多同时运行 24 个，包含子代理中的 hooks；另外最多允许 12 个等待时间已超过其事件超时时间的 hooks。小于 1 秒的 timeout 现在按 1 秒计算。

云端会话与协作功能改进

• 消息发送与 effort 显示：全屏模式下，可点击排队消息下方的“to send now”提示立即发送。任务中切换 effort 后，加载动画、OpenTelemetry 和会话记录现在显示实际生效的等级，避免提前显示尚未应用的新等级。
• 云端会话：创建或编辑在云端运行的 routine 时，模型选择器新增 effort 等级设置；云环境设置中的脚本输入框新增带语法着色、行号和复制按钮的 Bash 编辑器。发送失败后重发未修改消息，偶尔导致执行两次的问题也已修复。
• Slack 中的 Claude Tag：修复网络访问设为 None 的环境所关联频道无法获得回复，以及同一频道多个线程之间文件可能发错位置的问题。
• Code Review：GitHub 推送事件延迟送达时，现会审查拉取请求的当前提交，修复此前可能审查旧提交或没有审查任何提交的问题。

此外，Claude apps gateway 新增 oidc.user_id_claim，允许通过 id_token 中除 sub 之外的声明识别用户，例如 Microsoft Entra ID 的 oid。用量提示中的五小时窗口改称“5-hour limit”；VS Code 中的用量重置提示改为显示具体时刻。