CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1,关闭实验性 Beta 请求字段。
Claude 模型已于 2026 年 10 月 18 日重新上架(见公告)。Claude Code 使用 Claude 模型遇到本页的 400 错误时,同样按下面的步骤排查;Claude Code 的完整配置见 Claude Code 接入老张API。
适用场景
- Claude Code 使用 AWS Claude 官方通道或 Bedrock 相关通道
- 终端、日志或报错里出现
400 ValidationException - 错误信息包含
Extra inputs are not permitted - 错误信息指向
cache_control.scope、cache_control、scope或类似额外请求字段 - API Key、余额和模型 ID 看起来正常,但 Claude Code 仍在请求阶段被拒绝
这类错误通常是请求字段兼容性问题,不一定代表账户余额不足、模型下线或 API Key 失效。不要先反复更换密钥,先按下面步骤关闭实验性 Beta 请求字段。
临时生效:启动前设置环境变量
1
退出正在运行的 Claude Code
如果 Claude Code 已经启动,先退出当前进程。环境变量需要在启动前设置,启动后再设置通常不会影响已经运行的进程。
2
在同一个终端执行 export
在准备启动 Claude Code 的终端里执行:
3
重新启动 Claude Code
在同一个终端进入项目目录并启动:如果 400 错误消失,说明问题大概率与 Claude Code 实验性 Beta 请求字段和 AWS Claude / Bedrock 通道兼容有关。
推荐做法:写入 settings.json
为了避免每次打开终端都重新设置,建议把环境变量写入~/.claude/settings.json 的 env 块(用法见 Claude Code 官方设置说明):
~/.claude/settings.json 里配置了老张API地址、密钥和模型,只需要把这一项合并到现有 env 中,不要删除原来的配置:
ANTHROPIC_MODEL 填写模型与价格总表中「兼容端点」包含 Anthropic Messages 的模型 ID,例如 glm-5.2。
为什么这个设置能解决 400
Claude Code 可能会在请求中带上anthropic-beta 请求头和部分测试版工具字段(例如 defer_loading、eager_input_streaming)。
AWS Claude 官方通道或 Bedrock 相关通道通常会严格校验请求体,遇到不接受的额外字段时,就可能返回:
400 ValidationExceptionExtra inputs are not permittedcache_control.scope相关错误
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 让 Claude Code 不再发送这些请求头和测试版字段,使请求结构更接近通道可接受的标准格式。
该设置主要解决字段兼容问题,不能替代模型权限、余额、API Key 或模型 ID 的排查。
开启后,Claude Code 会关闭 MCP 工具搜索,所有 MCP 工具在启动时一次性加载,可能占用更多上下文。
仍然报错时怎么排查
- 确认已经重新打开终端或重新启动 Claude Code。
- 确认
~/.claude/settings.json中的env没有写错层级。 - 升级 Claude Code 到当前可用版本后重试。
- 检查模型 ID 的「兼容端点」是否包含 Anthropic Messages,且令牌分组可以调用。
- 确认使用的是老张API密钥,并且令牌分组适合 Claude Code。
- 查看调用日志,确认错误是在请求校验阶段、模型权限阶段,还是余额/额度阶段。
需要联系客服时提供什么
如果关闭实验性 Beta 字段后仍然无法解决,请提供以下信息:- 账号邮箱或用户名
- Claude Code 版本
- 操作系统和终端类型
- 使用的模型 ID
- 是否使用 AWS Claude 官方通道
- 完整错误信息,尤其是
ValidationException后面的字段名 - 老张API控制台调用日志中的请求时间、状态和 Request ID
- 打码后的
~/.claude/settings.json,不要包含完整 API Key 或 AccessToken
官方来源
- Claude Code 官方文档:环境变量 —
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS的作用与副作用 - Claude Code 官方文档:设置文件 —
settings.json与env配置
相关问题
- 如果不确定模型是否可用,请查看如何确认模型是否可用
- 如果需要创建或更换 API Key,请查看API Key 如何创建、保存、轮换和撤销
- 如果需要核对错误时间和请求状态,请查看如何查看和使用调用日志
- Claude 协议的请求格式见 Claude 协议文档