Skip to main content

​
📌 問題說明

部分使用者在使用 Claude Code 時，可能會遇到類似以下報錯：
  • 400 ValidationException
  • Extra inputs are not permitted
  • cache_control.scope 相關錯誤
該問題通常由 Claude Code 的實驗性 Beta 功能引數 引起，這些引數在 API易 所提供的官方亞馬遜 Claude API（即 AWS Claude / Bedrock）介面中不被支援。
本指南僅適用於通過 AWS Claude（Bedrock）官方通道 呼叫的場景。Anthropic 原生 API 通道支援這些 Beta 引數，無需做以下調整。

​
✅ 解決方案（推薦）

通過關閉 Claude Code 的實驗性 Beta 功能即可解決。

​
方法一：修改 settings.json（推薦）

在 Claude Code 的 settings.json 中新增環境變數：

​
方法二：臨時生效（當前終端會話）

在終端執行：
然後重新執行 Claude Code。
方法二僅對當前終端視窗有效，關閉終端後失效。如需長期使用，請採用方法一或方法三。

​
方法三：永久生效（推薦）

根據你使用的終端環境，將變數寫入配置檔案。

​
Mac / Linux（bash）

​
Mac（zsh，預設）

​
Windows（PowerShell）

然後重啟終端。

​
🔍 原理說明（給技術同學）

Claude Code 預設會啟用一些 Beta 特性，例如：
  • cache_control
  • tool 擴充套件欄位
  • scope 等額外引數
這些引數：
  • 👉 在 Anthropic 原生 API 支援
  • 👉 但在 AWS Bedrock Claude 中會被判定為非法欄位 → 返回 400
關閉該開關後：
  • ✔ 請求結構將變為標準格式
  • ✔ 與 AWS Claude 完全相容

​
🚨 適用場景

如果你符合以下情況，強烈建議開啟該變數：
  • 使用 Claude Code + AWS Bedrock Claude
  • 使用第三方代理（如 API 閘道 / 轉發服務）
  • 出現 400 / ValidationException 錯誤
參考資料：
  • Claude 官方文件 - 環境變數：code.claude.com/docs/zh-CN/env-vars
  • 相關 issue 說明：github.com/anthropics/claude-code/issues/21676

​
🔎 如何檢視模型支援的分組

不確定某個模型可以用在哪些分組？可以在模型定價頁面查詢： 開啟 API易 模型定價頁面，輸入模型名稱，即可檢視該模型的可用分組。 例如：ClaudeCode 分組 支援最新的 Claude 模型系列，並單獨配置了 glm-5.1 和 qwen3.7-max。

​
💡 補充建議

如果設定後仍然報錯，請檢查：
  • 環境變數是否真正生效（可在終端執行 echo $CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 確認輸出為 1）
  • 是否確實在使用 AWS Claude（Bedrock）通道
  • 修改配置後是否已重啟終端或 IDE

​
📞 支援

如果問題仍未解決，請提供以下資訊以便進一步排查：
  • 報錯截圖
  • 請求日誌（Request ID）
  • 使用的模型名稱
我們會協助你進一步排查。