【Claude】Extra inputs / model 相关报错已解决（4合1）

【Claude】Extra inputs / model 相关报错已解决4合1关键词Claude Code、Extra inputs are not permitted、Theres an issue with the selected model、Claude Opus not available Pro plan、Model restricted、网关、anthropic-beta 标头、模型配置报错一Extra inputs are not permitted现象API Error: 400 ... Extra inputs are not permitted ... context_management API Error: 400 ... Extra inputs are not permitted ... tools.0.custom.input_examples API Error: 400 ... Unexpected value(s) for the anthropic-beta header根因网关删掉了 anthropic-beta 请求头Claude Code 会在请求里加上anthropic-beta请求头用来启用某些还在 Beta 阶段的字段如context_management、effort、工具的input_examples等。当你通过代理网关或 LLM 中继转发请求时如果这个网关转发了请求体但删除了anthropic-beta头API 就会看到请求体里有它不认识的字段因为没有 beta 标头来启用这些字段的解析于是报 Extra inputs are not permitted。解法方案一配置网关转发 anthropic-beta 头推荐在你的网关配置里明确允许anthropic-beta头通过。具体配置方式取决于你的网关产品参考官方功能传递Feature Passthrough文档了解 Claude Code 要求网关转发的完整头列表。方案二禁用需要 beta 头的特性后备方案如果网关无法配置转发设置export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS1这会禁用所有需要anthropic-beta头的 Beta 功能让请求通过无法转发该头的网关。代价是部分高级功能如上下文管理、工具 input_examples不可用。报错二Theres an issue with the selected model现象Theres an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.在非交互模式下提示 Run --model在 Agent SDK 里不含提示。根因配置的模型名称API 无法识别或者你的账户没有访问该模型的权限。常见原因使用了过时的、已下线的模型版本 ID如claude-3-opus-20240229格式的老 ID模型 ID 拼写错误Pro 计划试图使用 Max 专属模型。解法交互式 CLI运行/model从可用列表里选一个正确的模型。非交互模式用有效别名传--modelclaude -p 任务 --model sonnet清理过时的模型 ID如果 CLI 每次启动都报这个错按优先级检查以下位置是否有过时的 ID--model命令行标志ANTHROPIC_MODEL环境变量env | grep ANTHROPIC_MODEL.claude/settings.local.json里的model字段项目.claude/settings.json里的model字段全局~/.claude/settings.json里的model字段。删除过时值Claude Code 会回退到账户默认模型。最佳实践用别名sonnet、opus、haiku而不是完整版本号 ID——别名自动跟踪最新版本不会过时。报错三Claude Opus is not available with the Claude Pro plan现象Claude Opus is not available with the Claude Pro plan · Select a different model in /model根因Opus 是 Max 计划专属模型Pro 计划不包含。解法方案一切换到 Pro 计划支持的模型/model选择 Sonnet 或其他 Pro 计划包含的模型。方案二最近升级了计划但还是报错升级后要重新认证因为存储的 OAuth Token 反映的是登录时的计划状态/logout /login重新登录后 Token 里的计划权限更新Opus 变可用。报错四Model is restricted by your organizations settings现象Model claude-opus-4-8 is restricted by your organizations settings. Using claude-sonnet-4-6 instead.运行/model 被限制的模型名时Run /model to choose a different model.根因组织管理员在 Claude Console 里禁用了这个模型或者settings.json里的availableModels白名单里不包含它。重要行为通过--model、ANTHROPIC_MODEL或配置文件设置了受限模型时Claude Code 会静默替换为一个允许的模型并继续运行不中断但会显示提示消息通过/model name交互式选择受限模型时会被拒绝消息里会提示/model当前模型不变受限模型在/model选择器里不可见。解法运行/model从允许的模型中选择如果--model、ANTHROPIC_MODEL或配置文件model字段设置了受限模型更新或删除那个值如果你确实需要使用被限制的模型联系管理员在 Console 里解禁。总结对照报错根因解法Extra inputs / beta header网关删了 anthropic-beta 头配置网关转发该头或设置DISABLE_EXPERIMENTAL_BETASIssue with selected model模型 ID 无效/无权访问/model选有效模型用别名代替版本 ID清理过时配置Opus not available Pro planPro 计划不包含 Opus/model切 Sonnet或升级计划后/logout/loginModel restricted by org管理员禁用了该模型/model选允许的联系管理员解禁参考Claude Code 官方《错误参考》请求错误章节、官方模型配置文档、功能传递文档。