Bedrock、Vertex、Foundry 上的模型设置改为从签名文件加载:CLAUDE_CODE_MODEL_CATALOG 是什么
如果你的团队通过云平台使用 Claude Code,CLI 2.1.311 里有一条容易被忽略、但对运维很重要的变化。
变化内容
更新说明原文的意思是:Claude Code 在 Bedrock、Mantle、Vertex 和 Foundry 上,会从 downloads.claude.ai 上的一个签名文件加载模型设置;设置 CLAUDE_CODE_MODEL_CATALOG=off 可以关闭这一行为。
这里的「模型设置」可以理解为一份模型目录:有哪些模型可用、各自的参数和能力等。以前这些信息更多是跟着客户端版本走,现在改成从官方托管的文件拉取,并且文件带签名,用来确认内容没有被篡改。
对你意味着什么
好处:新模型上线或模型参数调整时,云平台用户不一定要等下一次升级 CLI 才能拿到正确的设置,目录更新会更及时。签名机制也保证了拉到的内容来自官方。
需要留意的地方:
- 多了一个外网请求。Claude Code 需要访问
downloads.claude.ai。对选择 Bedrock 或 Vertex 的团队来说,一个常见原因就是希望流量尽量留在自家云内,这一点要提前评估。 - 防火墙和代理。如果你的环境有出站白名单,要么放行
downloads.claude.ai,要么显式关闭这项功能。 - 合规审查。新增的外部依赖可能需要走一遍内部审批流程。
如何关闭
在启动 Claude Code 的环境里设置:
bash
export CLAUDE_CODE_MODEL_CATALOG=off也可以写进团队统一下发的 settings 文件的 env 字段里(这是我们的推荐做法,具体以你们现有的配置管理方式为准)。关闭后,Claude Code 会回到不从远端加载模型目录的行为。
建议
- 能联网的团队:保持默认即可,享受更及时的模型设置更新。
- 严格隔离或内网环境:统一设置
CLAUDE_CODE_MODEL_CATALOG=off,避免启动时出现无法访问的请求。 - 升级前先测:在一台测试机上用你们的真实网络环境跑一遍,确认没有因为访问失败导致启动变慢或报错。
小结
这条变化不会影响直连 Anthropic API 的用户,但对走云平台的企业很关键:它多了一个外部依赖,也提供了一个关闭开关。把它记进你们的升级检查清单里。