Claude Code发布v2.1.312:新增OIDC用户标识配置,修复多项会话与工具问题
Anthropic的Claude Code发布v2.1.312版本,新增网关OIDC用户ID声明配置和全屏队列消息点击发送功能,并集中修复了组织策略加载、大文件覆盖、技能发现、PDF读取等十余项问题。
AI解读:这一版最值得关注的变化是Claude apps gateway新增oidc.user_id_claim配置,允许用id_token中sub以外的声明来标识用户,例如Microsoft Entra ID的oid。对于通过该网关接入企业身份系统的管理员,可以用既有目录里的用户标识对齐账号,而不必依赖sub。该说明来自发布说明,未给出具体部署示例。
另一项面向日常使用的是全屏模式下的“点击发送”:队列消息下方的“to send now”提示可以直接点击,效果与按对应快捷键相同。这是交互层面的新增,不改变消息排队逻辑本身。
修复项集中在容易造成实际工作损失的场景:Claude此前可能只读到超大CLAUDE.md、规则文件或 @ 引入文件的开头就整体覆盖,现在Write会要求先读完整或原地编辑;命令名无效曾导致所有命令无法加载,甚至让claude -p没有输出。这些修复只说明对应问题在该版本被处理,发布说明未披露影响范围或复现频率。
Anthropic的Claude Code于v2.1.312版本发布更新,发布说明由ashwin-ant在GitHub Releases页面列出。新增功能包括Claude apps gateway的oidc.user_id_claim配置,以及全屏模式下点击队列消息提示立即发送。
同一版本包含大量修复与行为调整,覆盖VS Code扩展登录后的组织策略获取、超大CLAUDE.md与规则文件的写入保护、按目录和paths: 声明的技能发现、终端会话恢复、PDF读取失败、effort等级显示、云会话和Slack集成等。
新增OIDC用户标识与队列消息点击发送
发布说明称,Claude apps gateway新增oidc.user_id_claim,用于按id_token中sub以外的声明识别用户,例如Microsoft Entra ID的oid。该配置面向使用该网关做身份识别的部署方。
全屏模式下,排队消息下方会出现“to send now”提示,点击即可立即发送,效果与对应按键一致。
修复覆盖、命令加载与工具读取问题
发布说明列出多项修复:从VS Code扩展登录后,托管设置和组织策略在本次会话剩余时间内未被获取的问题已修复;Claude在看到超大CLAUDE.md、规则文件或子目录中 @ 引入文件的开头后将其覆盖的问题已修复,Write现在会要求Claude读完全部内容或原地编辑。
按目录和paths: 声明的技能在Bash执行cd进入git仓库更深层后找不到的问题已修复;命令名无效导致所有命令无法加载、进而可能让claude -p没有输出的问题已修复;Read工具在旧会话文件清理同时运行时对PDF页面报“pdftoppm failed: Could not write image”的问题已修复。
effort显示、缓存提示与云会话调整
发布说明称,任务进行中切换effort等级时,加载指示器、OpenTelemetry的effort值和记录此前会提前显示新等级,现在显示实际生效的等级;/model和 /effort的缓存警告原先称重读要等到下一条消息,现在说明Claude工作中做出的更改可能更早触发重读。
云会话方面,从CLI启动的会话改为从服务器获取名称和分支名;提示与agent钩子每个会话最多同时运行 24 个(含子代理),另有最多 12 个等待超过事件超时时间的钩子,timeout小于 1 秒按 1 秒计。子代理的autoCompactWindow现在会下调CLAUDE_CODE_AUTO_COMPACT_WINDOW设定的窗口,但仍不会上调该窗口。
Bedrock等后端的系统提示与模型切换
发布说明称,Bedrock、Vertex、Foundry和Mantle对Claude Code不认识的模型名(如自定义部署名和推理配置文件ARN)改用较短的系统提示,即使这些名称实际指向Sonnet或Haiku;设置CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0 可保留完整提示。被标记消息后的自动模型切换也扩展到不认识的模型名,设置CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK=1 可关闭。
用量限制提示中的“session limit”改称“5-hour limit”。Claude Code停止发送claude_code.safety_event这一OpenTelemetry事件。
VS Code、Slack与代码审查的修复
VS Code扩展方面,组织设置无法加载或被拒绝时,会话不再以裸退出码结束,标签页会说明原因并提供Retry或重新登录;用量限制重置改为显示具体钟点时间,并使用“5-hour limit”说法。
Slack集成方面,Claude Tag的重试提示会说明所用模型或指出触发了速率限制;旧私有频道转为公开并获得新ID后,频道开关和agent设置回退到工作区默认值的问题已修复;环境网络访问设为None的频道中Claude不回复的问题已修复;在另一线程回答时文件发错线程的问题已修复。代码审查方面,GitHub延迟推送事件时审查过期提交或没有可审提交的问题已修复,现在审查拉取请求的当前提交。