Claude Code 报错 invalid_request_error 解决

Generated by claude-sonnet-4-6

问题原因

2026 年 1 月，Anthropic 在原生 API 中引入了一个 Beta 特性：prompt-caching-scope-2026-01-05，即在 cache_control 中新增了 scope 字段。Claude Code 在发送请求时会附带这个 scope 字段，但某些后端（如 Vertex AI、AWS Bedrock）的 schema 校验不认识它，直接返回 Extra inputs are not permitted。

解决方案

禁用实验性 Beta，阻止 Claude Code 发送 Vertex AI / Bedrock 不支持的 Beta 字段：

export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

加到 ~/.bashrc 里永久生效。

参见：

• LLM gateway configuration | Claude Code Docs
• claude -p fails with "tools.3.custom.input_examples: Extra inputs are not permitted" | GitHub