AWS Claude 报 400，先保留完整的错误代码和消息，再判断请求经过了哪条调用链。如果 Claude Code 提示 extra inputs are not permitted，需要检查实验功能字段与通道是否匹配；如果直接调用 Amazon Bedrock，则先核对接口、请求体和模型标识。只凭 400 或 ValidationException，无法确定要修改哪一项。
400 也不等于“肯定没有权限问题”。AWS 的错误列表中，签名不完整、请求过期、部分授权错误同样可能返回 400；官方排障文档也列出了调用权限导致 ValidationException 的情况。不要把反复重试、切地区或换密钥当成统一处理办法。AWS API 错误说明、ValidationException 排查说明
先找到真正需要修改的地方
记下这四项信息：使用的客户端及版本、实际请求端点或 SDK 操作、模型 ID 与地区、完整错误消息。通过代理或兼容网关调用时，还要区分页面上显示的错误和上游 AWS 返回的错误；有些通道会重新包装错误响应。
| 错误原文中的线索 | 优先核对什么 | 可以怎样验证 |
|---|---|---|
extra inputs are not permitted、extraneous key | 消息所指的字段是否属于当前接口；Claude Code 的 beta 字段与请求头是否匹配 | 去掉对应可选字段，或按下文停用实验功能后重新启动客户端 |
invalid model identifier | 当前地区可用的模型 ID、ARN 或推理配置文件 | 从实际账户与地区的可用列表重新确认，别直接套用别人的标识 |
on-demand throughput 与 inference profile | 该模型调用是否需要推理配置文件 | 使用账户和地区支持的配置文件 ID 或 ARN |
not authorized、access denied、签名或过期提示 | 调用身份、授权范围、签名及时间 | 让管理员针对报错检查权限；保留 AWS 请求 ID |
| 消息提到 thinking、token 或上下文长度 | 模型支持的思考模式、输出上限、实际历史内容 | 用一条普通短消息验证，再逐项加回参数和历史 |
| 消息明确提到 data retention | 模型要求与账户在该地区生效的数据保留设置 | 先确认允许的模式和账户资格，再由管理员决定是否调整 |
这张表用于确定排查方向，不代表英文片段只有一种含义。完整错误中如果还给出了字段路径、模型名称或所需操作，应优先按那部分信息处理。
Claude Code：何时使用关闭实验功能的开关
如果请求经兼容网关转发，而且错误明确拒绝 beta 工具字段，可以先用下面的方式启动一次 Claude Code：
bashCLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 claude
这是终端中的临时启动方式：结束原来的进程，在同一环境中启动新进程，再重试一条短消息。桌面启动器、容器和远程开发环境不会自动继承另一个终端里的设置，需要在真正启动 Claude Code 的地方设置变量。
截至 2026 年 9 月 21 日，官方文档说明该开关会去掉 Anthropic 专有 beta 请求头及工具定义中的 beta 字段，保留标准的 name、description、input_schema 和 cache_control。它还会停用 MCP 工具搜索，改为提前载入工具；受管设置在特定版本上有例外。因此，不能把这个开关解释为“关闭提示缓存”。Claude Code 环境变量参考
开关奏效，只能说明本次请求与实验功能有关，不能证明所有 AWS Claude 通道都不支持 beta。官方错误参考还指出一种网关问题：请求体保留了 beta 字段，但转发时丢失 anthropic-beta 请求头。如果上游支持该功能，应由网关维护者检查头部透传；否则才考虑停用相应实验能力。Claude Code 字段校验错误说明
如果你使用的是老张 API 的 AWS Claude 通道，可按该通道的 400 排错文档检查启动设置。在已有配置文件里添加 env 时，应合并原有内容，避免整段替换后丢失其他配置。这份通道文档不负责修复你自己 AWS 账户的 IAM 权限。
如果新会话正常，只有旧会话提示 tool_use、tool_result 或 thinking 块不匹配，问题可能出在历史消息衔接。官方建议使用 /rewind 或连续按两次 Esc，回退到损坏的轮次之前。模型 ID 错误、权限不足或数据保留错误不应靠清空历史解决。Claude Code 历史消息错误说明
自己调用 Bedrock：先确认接口，再改请求体
同样是 AWS 上的 Claude，请求格式也不只有一种。最容易漏掉的步骤，是把实际调用的 SDK 方法或 URL 与对应文档对上。
| 实际调用方式 | 模型放在哪里 | 关键字段示例 |
|---|---|---|
Bedrock Converse | SDK 操作的 modelId | messages[].content[].text、inferenceConfig.maxTokens |
Claude 原生 InvokeModel | SDK 操作的 modelId，不混入 Claude 消息体 | 请求体中的 anthropic_version、max_tokens、messages |
AWS 的 Anthropic 兼容 /anthropic/v1/messages | JSON 请求体的 model | anthropic-version HTTP 请求头，遵循兼容接口格式 |
| 第三方兼容网关 | 以该网关端点文档为准 | 不能只凭上游是 AWS 就套用 InvokeModel 格式 |
前两种接口中的参数不能直接互换：Converse 的 maxTokens 位于 inferenceConfig 中；Claude 原生 InvokeModel 的 max_tokens 位于序列化后的请求体中。原生消息请求还需要 anthropic_version: "bedrock-2023-05-31"，系统提示词放在独立的 system 字段，而不是写成 role: "system" 的消息。Converse API 参考、Claude Messages 请求格式
AWS 也提供 Anthropic 兼容 Messages API，因此“所有 Bedrock 请求都必须在 JSON 里写 anthropic_version”并不准确。使用兼容端点时，要看它要求的 HTTP 请求头与消息体，而不是照搬原生 InvokeModel 示例。AWS Anthropic 兼容 Messages API
用最小 Converse 请求确认调用链
下面的 Python 示例需要已有 AWS 凭据和 boto3，并由你为 AWS_REGION、BEDROCK_MODEL_ID 设置真实可用值。模型值可以是当前接口支持的模型标识或推理配置文件。示例未连接 AWS 实测，不代表任意账户、地区或模型都可直接使用。
pythonimport os import boto3 from botocore.exceptions import ClientError client = boto3.client( "bedrock-runtime", region_name=os.environ["AWS_REGION"], ) try: response = client.converse( modelId=os.environ["BEDROCK_MODEL_ID"], messages=[{ "role": "user", "content": [{"text": "请只回复：连接成功"}], }], inferenceConfig={"maxTokens": 64}, ) print(response["output"]["message"]) except ClientError as exc: error = exc.response.get("Error", {}) meta = exc.response.get("ResponseMetadata", {}) print({ "code": error.get("Code"), "message": error.get("Message"), "http_status": meta.get("HTTPStatusCode"), "request_id": meta.get("RequestId"), }) raise
最小请求仍失败时，继续根据返回消息处理模型、地区、权限或账户要求。最小请求成功时，再逐项加回原来的系统提示词、历史消息、工具、思考参数和其他可选字段。在哪一步重新报错，就重点检查那一步引入的内容。一次只改变一项，才能判断改动是否有效。
如果业务实际使用 InvokeModel，应在该接口上做同样的最小验证；不要因为另一个接口成功，就认定原请求体没有问题。与同事或支持人员分享日志前，删除密钥、会话令牌、提示词及客户数据，保留错误代码、消息中的必要字段和请求 ID 即可。
模型 ID 看起来正确，为什么仍然报错
模型名字、API 模型标识和推理配置文件不是同一个概念。控制台中看到一个模型名称，不代表把名称填进 modelId 就能调用；某个标识在其他地区或账户可用，也不代表当前调用条件相同。
如果错误要求使用 inference profile，应在当前账户和地区确认支持的推理配置文件，再使用它的 ID 或 ARN。不要把网上示例的地区前缀机械地拼到模型名上。Converse 允许多种 modelId 形式，但具体可用对象仍取决于当前环境。Converse 的 modelId 参数
如果 Claude Code 使用的是 Mantle，也不能把 Invoke 路径下的推理配置文件 ID 当作 Mantle 模型 ID。可以通过 /status 确认当前提供方；us.、global. 等前缀不是任何模型都能使用的通行证，地区前缀偏好也不能代替实际可用性确认。Claude Code 的 Bedrock 配置说明
同时检查调用身份是否有对应的模型调用权限。AWS 官方将错误模型标识、地区不支持、缺少调用授权等列为不同排查分支；所以“请求体没问题”不等于“账户配置没问题”。错误如果明确涉及账户所在地或使用资格限制，随意改地区也不能替代资格核验。AWS ValidationException 排障
thinking、上下文和数据保留要按具体错误处理
思考模式报错时，应先看模型支持哪种模式，再决定改什么。AWS 当前文档明确列出部分新模型应使用 adaptive thinking，继续发送 enabled 或 disabled 会返回 400。传统扩展思考的预算通常要求低于 max_tokens，但 interleaved thinking 有明确例外，不能把这一关系套到全部模式。也不要把“关掉 thinking”写成所有模型的修复方法。AWS 扩展思考说明
如果报错与输入和输出总长度有关，应减少历史消息、工具结果或请求的输出上限；只有缩短本轮提问，未必能明显减少整个请求。若错误点名 assistant 预填充，则应按模型限制单独处理，可参考Claude 预填充报错排查。
数据保留错误需要账户管理员参与。截至 2026 年 9 月 21 日，AWS 当前文档建议新配置使用 aws_review；旧的 provider_data_share 名称仍可能出现，但文档说明当前并不会因此把内容发送给模型提供商。相关审查留在 AWS 内，保留期限和可用模式取决于模型；已获批准的特定 ZDR 账户可能允许 none。不要套用旧帖子中“必须分享给 Anthropic”的解释。AWS 数据保留文档
对于 bedrock-runtime，这些设置按地区生效，适用范围是账户，不是项目。先核对目标模型允许的模式、当前生效设置及组织要求，再决定是否调整；不要为了消掉一条 400 错误，直接修改整个账户的数据处理策略。inherit 或默认设置也不能单凭名称理解成零数据保留。
怎样确认修复完成
至少需要看到原来失败的调用在相同模型和地区下成功，再验证业务实际使用的功能。短消息成功只证明基本调用可行；如果原场景依赖工具或长历史，还要验证这些内容恢复后是否正常。
修复后的错误如果变成 429，应转向限流与重试策略；如果是 403，应根据访问拒绝消息检查授权。Converse 的官方错误定义分别列出 400、403 与 429，不能把它们混作同一类问题。Converse 错误定义 另一个容易混淆的例外是 InvokeModel 的 ServiceQuotaExceededException：它也返回 HTTP 400，但表示账户服务配额超限，官方说明可以稍后重新提交。因此，应先识别异常类型；已确认的请求格式错误通常需要改请求，不能据此推导“所有 400 都不该重试”。InvokeModel 错误定义
关于哪些失败适合重试，可继续阅读API 重试与模型切换的判断方法。
仍未解决时，提交一份能复现的最小请求、客户端版本、调用接口、模型标识、地区、错误原文和请求 ID。这样支持人员才能判断要修改客户端、网关还是 AWS 账户设置，也能避免在无关配置上反复尝试。
