Skip to content

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 才能拿到正确的设置,目录更新会更及时。签名机制也保证了拉到的内容来自官方。

需要留意的地方:

  1. 多了一个外网请求。Claude Code 需要访问 downloads.claude.ai。对选择 Bedrock 或 Vertex 的团队来说,一个常见原因就是希望流量尽量留在自家云内,这一点要提前评估。
  2. 防火墙和代理。如果你的环境有出站白名单,要么放行 downloads.claude.ai,要么显式关闭这项功能。
  3. 合规审查。新增的外部依赖可能需要走一遍内部审批流程。

如何关闭 ​

在启动 Claude Code 的环境里设置:

bash
export CLAUDE_CODE_MODEL_CATALOG=off

也可以写进团队统一下发的 settings 文件的 env 字段里(这是我们的推荐做法,具体以你们现有的配置管理方式为准)。关闭后,Claude Code 会回到不从远端加载模型目录的行为。

建议 ​

  • 能联网的团队:保持默认即可,享受更及时的模型设置更新。
  • 严格隔离或内网环境:统一设置 CLAUDE_CODE_MODEL_CATALOG=off,避免启动时出现无法访问的请求。
  • 升级前先测:在一台测试机上用你们的真实网络环境跑一遍,确认没有因为访问失败导致启动变慢或报错。

小结 ​

这条变化不会影响直连 Anthropic API 的用户,但对走云平台的企业很关键:它多了一个外部依赖,也提供了一个关闭开关。把它记进你们的升级检查清单里。

Claude-cn.org,专注于 Claude Code 中文教程