SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

Claude Code 如何接入 Bedrock 或 Vertex AI?

了解在 Amazon Bedrock 或 Google Vertex AI 上运行 Claude Code 的环境变量、凭据来源、账单归属,以及请求不再经过 Anthropic 后会失去哪些功能。

使用您自己的云账户运行 Claude Code 时有哪些变化

您可以在 Amazon Bedrock 或 Google Vertex AI 上运行 Claude Code。切换过程只需设置两三个环境变量,并使用团队已有的云凭据。本地行为均保持不变:CLI、子代理、钩子、技能、MCP 服务器和 CLAUDE.md 文件都不会变化。只有模型调用会迁移到云端,同时还有以下四项会随之变化:请求经过的网络、支付费用的账户、您获准调用的 Claude 模型,以及服务端实际提供的功能。

问题通常不是能否运行。它可以正常运行。真正需要确定的是,这四项中哪一项对您最重要。

三种路由,以及每种路由的成本

直接使用 Anthropic 订阅。 使用 Pro、Max、Team 或 Enterprise 计划登录 claude.ai 账户。请求会发送到 Anthropic 的 API。Pro、Max 和 Team 按席位付费,使用量受计划限额限制,而不是按 token 计量。当前的 Enterprise 计划是例外:席位费用不包含使用量,每个 token 都会按标准 API 费率另行计费;旧的按席位计费 Enterprise 合同会在续约时转为这种模式。这是唯一能访问基于该账户构建的功能入口的路由,例如 Web 版 Claude Code、移动应用和 Remote Control。对于团队,Team 计划已经包含单点登录,以及由服务器管理的组织级 Claude Code 配置;Claude Enterprise 计划在此基础上增加审计日志、SCIM、自定义数据保留控制和 Compliance API。

直接使用 Anthropic API key。 在 Anthropic Console 中创建 key,并按 token 付费。基础设施和区域与订阅方式相同,但不按席位收费,使用量会显示在 Anthropic 自己的控制面板中。哪种方式更便宜,取决于代理每天实际运行多少小时;这正是API 与订阅成本对比以及Claude Code 的实际成本所讨论的主题。

使用 Bedrock 或 Vertex 上的第三方端点。 使用您自己的 AWS 或 Google Cloud 账户提供模型服务。推理时,Anthropic 不在请求路径中。token 会计入您已经收到的云账单,并受您现有的 IAM(身份和访问管理)策略及审计日志管理。还有两个第三方选项:Microsoft Foundry 和 AWS 上的 Claude Platform。它们的工作方式相同:通过一个环境变量选择提供商,由云账户承担费用。

名称说明,截至 2026 年 10 月:Google 已将 Vertex AI 更名为 Google Cloud 的 Agent Platform。Anthropic 的文档使用新名称,但 Claude Code 登录提示仍显示 Google Vertex AI,环境变量仍使用 VERTEX。

数据驻留才是团队这样做的真正原因

在 Bedrock 上,请求会发送到您选择的 AWS 区域中的 Bedrock 端点,且位于您自己的账户内。静态数据使用 AES-256 通过 AWS 管理的密钥加密;您也可以通过 AWS KMS(密钥管理服务)提供自己的密钥。在 Vertex 上,对应的机制是 Google 管理的加密密钥,也支持 CMEK(客户管理的加密密钥)。访问权限由您现有的 IAM 角色控制,调用会像其他 API 调用一样记录在 CloudTrail 或 Cloud Audit Logs 中。对于受监管的团队,这就是完整的理由,而且理由很充分。

有两个细节使实际情况没有宣传所说的那么绝对。

跨区域推理配置文件并不对应单个区域。 在 Bedrock 上,Claude Code 会将其内置默认模型解析为跨区域推理配置文件 ID,并根据解析到的区域选择首选前缀:在 us-* 区域使用 us.,在 eu-* 区域使用 eu.,在 ap-* 区域使用 apac.,在 GovCloud 中使用 us-gov.。跨区域配置文件可以从同一地理范围内的其他区域处理请求,因此它提供的保证是地理范围,而不是某个城市。如果您的要求指定单个区域,请通过您控制的应用推理配置文件路由,并将 ANTHROPIC_MODEL 设置为其 ARN。

部分流量仍会到达 Anthropic,但其中不包含您的代码。 在 Bedrock 和 Vertex 上,遥测、错误报告和 /feedback 命令默认均处于关闭状态;/feedback 会在您自己的计算机上的 ~/.claude/feedback-bundles/ 下写入存档,而不会上传任何内容。每个提供商都会运行两个例外流程。在获取 URL 之前,WebFetch 工具会将主机名(仅主机名)发送到 api.anthropic.com,以检查安全阻止列表。会话质量调查也仍会显示。您可以在设置文件中使用 skipWebFetchPreflight 关闭前者,并使用 CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1 关闭后者。设置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 还会停止调查,并关闭其他非必要流量,但不会影响 WebFetch 检查;该检查有自己的退出设置。

关于训练:根据商业条款,Anthropic 不会使用通过 Claude Code 发送的代码或提示训练模型,第三方平台的使用也属于商业用途。Development Partner Program 是允许训练的选择加入计划,但完全不向 Bedrock 或 Vertex 用户提供。这些端点的零数据保留取决于您与 AWS 或 Google 签订的协议。

将 Claude Code 指向 Amazon Bedrock

在客户端配置生效前,每个 AWS 账户都必须完成两项操作。打开 Amazon Bedrock 控制台,从模型目录中选择 Anthropic 模型,然后提交使用案例表单:提交后会立即授予访问权限。接着附加一项 IAM policy,允许 Claude Code 发起所需的调用。

  • bedrock:InvokeModel
  • bedrock:InvokeModelWithResponseStream
  • bedrock:ListInferenceProfiles
  • bedrock:GetInferenceProfile

ListInferenceProfiles允许 Claude Code 在启动时检查账户实际可以调用哪些模型。GetInferenceProfile允许它将应用程序推理配置文件 ARN 解析回其对应的基础模型,以便选择正确的请求格式。缺少该权限时,请求仍会成功,因为 Claude Code 会使用另一种格式重试一次。表现为每个新模型多进行一次往返请求,而不是报错。Anthropic 发布的 policy 还允许通过 Bedrock 调用 aws-marketplace:ViewSubscriptions 和 aws-marketplace:Subscribe,这涵盖了模型订阅步骤。

最快的客户端配置方式是使用向导。运行 claude,选择 3rd-party platform,然后选择 Amazon Bedrock;也可以在已登录的会话中输入 /setup-bedrock。它会读取 ~/.aws 目录中的配置文件,验证可以调用哪些模型,并将结果写入 ~/.claude/settings.json 的 env 块中,因此不依赖 shell profile。

对于脚本化部署,请自行设置这些变量。

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

凭据来自标准 AWS SDK 凭据链,因此对 aws CLI 已经有效的方式在这里同样有效:aws configure、SSO profile、assumed role 或 Bedrock API key。

aws sso login --profile=your-profile-name
export AWS_PROFILE=your-profile-name
export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

Bearer token 是最简单的选项,但必须谨慎处理,因为它是存放在环境变量中的密钥。AWS 签发的短期密钥最长有效 12 小时;长期密钥则持续有效,直到达到你设置的日期。AWS 建议长期密钥只用于探索。在共享构建服务器上,优先使用会过期的 role。相同原则适用于 agent 可以读取的其他所有凭据,详见避免让 AI agent 接触密钥。

区域陷阱。 Claude Code 按以下顺序解析区域:AWS_REGION,然后是 AWS_DEFAULT_REGION,再然后是当前 AWS profile 中的 region,最后是 us-east-1。最后一步使用的是默认值,不会报错。因此,如果团队没有在任何位置设置区域,却以为请求会经欧洲区域路由,请求就会在没有任何提示的情况下发送到美国区域。在 Claude Code 中运行 /status,查看最终解析出的区域及其来源。要确认账户在某个区域可以调用哪些内容,请运行 aws bedrock list-inference-profiles --region your-region。

在 Google Vertex AI 上运行 Claude Code

启用 API 并获取凭据。

gcloud config set project YOUR-PROJECT-ID
gcloud services enable aiplatform.googleapis.com
gcloud auth application-default login

在 Model Garden 中申请所需的 Claude 模型访问权限。审批不会立即完成,请预留 24 到 48 小时。授予 roles/aiplatform.user,该角色包含模型调用和令牌计数所需的 aiplatform.endpoints.predict 权限。

然后选择提供商。

export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=global
export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID

CLOUD_ML_REGION接受 global、类似 eu 或 us 的多区域位置,或单个区域。全局端点可提供最佳可用性,但对请求实际处理位置的控制最少。因此,有数据驻留要求时,通常应直接指定位置。三种形式支持的模型范围不同。如果全局端点缺少所需模型,请仅使用该模型的 VERTEX_REGION_CLAUDE_* 变量将其固定到某个位置,其他设置继续使用全局端点。请查看当前的 Vertex AI 位置 页面,不要依赖已经过时的列表。

项目陷阱。 ANTHROPIC_VERTEX_PROJECT_ID 决定请求发送到哪个项目。即使 GCLOUD_PROJECT、GOOGLE_CLOUD_PROJECT 或 GOOGLE_APPLICATION_CREDENTIALS 指定的凭据文件包含不同的项目,Claude Code 仍会将请求发送到该项目。在一台 gcloud 指向某个项目、而残留的 ANTHROPIC_VERTEX_PROJECT_ID 指向另一个项目的计算机上,费用会计入后者,且会话中不会发出任何警告。

每次更改提供商后都要验证。运行 /status:API provider 行会显示 Google Vertex AI,GCP project、Default region 和 Model 行会显示 Claude Code 实际解析出的配置。如果缺少提供商行,说明这些变量没有传递给进程,因为它们是在启动 claude 的 shell 之外导出的。将它们移到设置文件的 env 块中,这样也能避免像 AWS_PROFILE 这样的值影响你启动的其他进程。

可用哪些模型,以及它们何时上线

sonnet 和 opus 这类别名不代表最新模型。在第三方端点上,它们会解析为 Claude Code 针对该提供商内置的默认模型。该模型可能落后于当前版本,也可能根本未在您的账户中启用。默认模型不可用时,Claude Code 会在本次会话中回退到更早版本或更低级别的模型,并显示提示。回退结果不会保存,因此下次会话会再次尝试,并再次显示提示。

如果要在团队范围内逐步发布,请固定模型版本。

# Copy the exact IDs from your provider's own model catalog.
export ANTHROPIC_DEFAULT_OPUS_MODEL='<provider model id>'
export ANTHROPIC_DEFAULT_SONNET_MODEL='<provider model id>'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='<provider model id>'

从模型概览和您的提供商目录中获取模型 ID,因为不同提供商的格式不同:Bedrock 要求推理配置文件 ID 或 ARN,Vertex 要求使用纯模型名称。不要从文章中复制这些 ID,包括本文。固定模型版本也有助于控制成本,因为默认主模型属于 Opus 级别,其每个 token 的费用高于 Sonnet。因此,不固定模型的部署会按更高费率计费。若要将某个模型固定为会话默认模型,请将 ANTHROPIC_MODEL 设置为其完整 ID。

模型上线时间是这项比较中最明显的差异。在 Anthropic 自有 API 上,模型发布当天即可使用。在 Bedrock 和 Vertex 上,只有云提供商已在您的区域启用该模型,并且您的账户已获授权访问后,才能使用。最早也要晚几天,有时会更久。如果有些工作必须使用最新模型,请保留一条能够访问该模型的路由。这正是将不同模型路由到不同任务的实际用途。

在 Bedrock 和 Vertex 上需要放弃的功能

所有本地功能在每个提供商上都可用:子代理、钩子、斜杠命令、技能、插件、检查点、沙箱、托管设置文件和 OpenTelemetry 指标。缺失项全部位于服务器端。

以下功能在两个端点上都不可用:快速模式、Advisor、Channels、分析面板、服务器托管设置,以及 /design-sync 和 /import 命令。所有需要 claude.ai 账户的功能也不可用,包括网页版 Claude Code、移动应用、Remote Control、例程和工件。

仅 Bedrock 不可用:Bedrock 不提供 WebSearch 工具,因此 Claude 无法从路由到 Bedrock 的会话中执行搜索。向它提供 URL 后,它仍可使用 WebFetch 读取页面。在 Vertex 上,网页搜索可以正常工作,但仅适用于 Claude 4 及更高版本的生成模型。

两者均为部分可用:自动模式只能运行于一组受限的新型号;跨会话消息只能发送到同一台机器上的其他会话;而由 /loop 自行选择间隔则需要 Claude Code v2.1.248 或更高版本。只能通过 3P 上的 Claude Desktop 访问桌面端;在 Vertex 上,还可以通过在托管设置中配置的 Enterprise 部署访问。向团队承诺某项功能前,请先查看 Anthropic 的功能可用性页面,因为此列表会变动。

费用由谁承担

订阅和第三方端点是两项独立购买的服务。两者不能相互替代。

这一点需要明确说明,因为这种错误不会立即显现。在同时登录 Max seat 的计算机上设置 CLAUDE_CODE_USE_BEDROCK=1 后,流量费用由 AWS 收取:按 Bedrock 的按需费率逐 token 计费,或者从账户已购买的预配置吞吐量中扣除。Max seat 仍会按月收费,但不承担任何这部分流量费用。两者也没有统一的费用视图:支出会显示在 AWS Cost Explorer 或 Google Cloud Billing 中,而 Anthropic analytics dashboard 在这两个云服务商中都不可用。/logout 命令也会消失,因为不存在需要结束的 Anthropic 会话。此时使用的是云凭据。

费率以服务商自己的页面为准,并且会变更。因此,请查看 Amazon Bedrock pricing 或 Vertex AI pricing,不要依赖文章中的任何数字。有一点不会改变:这些端点的按需推理按 token 计费,因此 agent 如果全天运行,费用会持续产生,不受套餐上限限制。两家云服务商还提供另一种方案:预配置吞吐量,即在持有期间按固定费用购买预留容量。AWS 按小时计费;设置预配置吞吐量 ARN 作为模型 ID 后,Claude Code 会使用该容量。究竟哪种方案比为所有人购买 seat 更划算,应在上线前评估,而不是等到收到第一张账单后再决定;Team 和 Enterprise 中 seat 与按 token 计费的比较会在团队规模下完成这项比较。

速率限制和配额在不同路由上的工作方式不同

订阅服务的限制归属于账户,并按计划重置。达到限制后通常需要等待,除非已启用用量额度:Pro 和 Max 订阅者,以及 Team 和较早的基于席位的 Enterprise 组织,可以在达到限制后继续工作,按标准 API 费率计费,直至达到支出上限。当前按用量计费的 Enterprise 计划没有会耗尽的内含额度,因为每个 token 都已单独计费。相关行为见用量限制的工作方式。

Anthropic API 密钥的限制归属于组织,以每分钟请求数和 token 数表示,并会随用量层级提高。

Bedrock 和 Vertex 的限制是云配额,与任何 Anthropic 计划都无关。Bedrock 按账户和区域设置这些配额,主要按模型设置,此外还有跨该账户的每日 token 配额。Vertex 按项目和位置设置配额。在全局端点和多区域端点上,2026 年 5 月 26 日之后发布的 Claude 模型按模型谱系共享一个配额:在指定位置,同一模型系列的每个版本都使用同一个配额桶;全局端点和每个多区域端点则各自使用独立的配额桶。429 通常表示其中一个配额已耗尽,但在共享的按需付费容量上,也可能表示提供商暂时缺乏容量,因此应先使用退避策略重试,再修改配置。如果耗尽的是你的配额,应在提供商的控制台中处理:申请提高配额,或迁移到仍有余量的位置。Bedrock 按token 消耗规则扣减配额,而不是按固定请求数计算;任一云平台上的预留容量都以预配置吞吐量的形式购买。在 Vertex 上,429 通常表示你的单区域端点无法同时服务主模型和小型快速模型,因此 CLOUD_ML_REGION=global 是文档建议的起点。Google 的配额页面介绍了配额提升申请。

故障模式及对应的错误信息

Could not load the default credentials,在 Vertex 上。 Application Default Credentials 缺失或已过期。运行 gcloud auth application-default login,或将 GOOGLE_APPLICATION_CREDENTIALS 指向服务账号密钥文件。

Vertex 返回命名模型的 404 错误。 该模型未在此项目的 Model Garden 中启用,或者所在位置不提供该模型。某些模型仅通过全局端点或类似 eu 的多区域位置提供,不能在特定区域使用。

on-demand throughput isn't supported,在 Bedrock 上。 您为只能通过推理配置文件提供的模型传入了基础模型 ID。请改用推理配置文件 ID。

AWS default-chain credential resolve timed out。 AWS 凭证链中的某个步骤卡住了,最常见的原因是 credential_process 辅助程序等待永远不会收到的输入。凭证链的每次解析都会在 60 秒后超时。如果凭证链确实需要更长时间,例如包装器后运行的带 MFA(多因素身份验证)浏览器 SSO 流程,请通过 CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS 以毫秒为单位提高限制。

启动 Bedrock streaming response has content-type 时出错。 Claude Code 与 Bedrock 之间的某个组件正在重写流。Bedrock 使用内容类型为 application/vnd.amazon.eventstream 的二进制事件流格式,因此将其重新输出为服务器发送事件的网关会返回 Claude Code 无法解码的响应体。请修复网关,使其原样透传响应体及其 Content-Type 标头。

AWS SSO 期间浏览器标签页循环打开。 企业 VPN 或检查 TLS 的代理中断了登录流程,Claude Code 将断开的连接识别为身份验证失败,重新运行 awsAuthRefresh 命令,然后无限重复。请从设置文件中删除 awsAuthRefresh,并在启动 Claude Code 前手动运行 aws sso login。

选择路由

如果您希望在新模型发布当天即可使用,并获得完整功能集,请选择 Anthropic 直连。如果您希望按 token 计费,而不购买席位,请使用 API key。如果要求推理过程在您已管理的云账户内执行,并且您接受模型发布流程较慢、功能列表较短这一代价,请选择 Bedrock 或 Vertex。建议收藏的设置页面包括 Anthropic 官方的 Amazon Bedrock 和 Google Vertex AI 页面,以及 AWS 的按区域列出的模型列表。

这三种方式都不会改变 agent 本身的执行位置。无论由哪个端点响应,Claude Code 都是在本地运行的进程,负责读取您的文件并执行您的命令。因此,如果团队希望将其运行在笔记本电脑以外的位置,可以将 coding agent 部署到 VPS,并在那里导出相同的变量。

FAQ

我的 Claude 订阅是否包含在 Bedrock 或 Vertex 上使用 Claude Code 的费用?

不包含。Pro、Max、Team 或 Enterprise 席位与第三方端点是两项独立购买,互不覆盖。设置 CLAUDE_CODE_USE_BEDROCK=1 或 CLAUDE_CODE_USE_VERTEX=1 后,网络流量由 AWS 或 Google Cloud 按其按需费率逐 token 计费,或从您购买的预置吞吐量中扣费,并计入对应的云账单;席位仍会按月为其覆盖的功能收费。费用跟踪也会转移到 AWS Cost Explorer 或 Google Cloud Billing,因为 Anthropic 分析面板在这两个提供商上均不可用。

Claude Code 会将请求发送到 Amazon Bedrock 的哪个区域?

发送到它解析出的区域,/status 会显示该区域。Claude Code 依次检查 AWS_REGION、AWS_DEFAULT_REGION,然后检查当前 AWS 配置文件中的 region;如果这些设置均不存在,则使用 us-east-1。其内置默认模型随后会解析为跨区域推理配置文件,前缀遵循该区域,例如 us. 或 eu.;跨区域配置文件可以在同一地理区域内的另一个区域处理请求。如果必须固定使用某个命名区域,请使用由您控制的应用程序推理配置文件,并将 ANTHROPIC_MODEL 设置为其 ARN。

为什么我的 Bedrock 或 Vertex 账户中没有最新的 Claude 模型?

因为各云提供商按自己的计划启用模型,而且您的账户还必须获得相应访问权限。在 Vertex 上,您需要在 Model Garden 中申请访问权限,审批可能需要 24 到 48 小时。在此之前,sonnet 和 opus 等别名会解析为 Claude Code 针对该提供商的内置默认模型;如果您的账户无法使用该默认模型,Claude Code 会在本次会话中回退到较早或较低级别的模型,并显示提示。请将 ANTHROPIC_DEFAULT_SONNET_MODEL 及其同类设置为您已确认启用的模型 ID。

Claude Code 在 Amazon Bedrock 上是否支持网页搜索?

不支持。Bedrock 上无法使用 WebSearch 工具,因此 Claude 无法从路由到 Bedrock 的会话中执行搜索。您仍可在提供 URL 后使用 WebFetch 读取指定页面。在 Google Vertex AI 上,网页搜索可用,适用于 Claude 4 生成模型及更高版本;这是少数对 Vertex 有利的功能差异之一。

在 Bedrock 或 Vertex 上运行 Claude Code 是否需要 Anthropic 账户?

不需要。身份验证使用您的 AWS 或 Google Cloud 凭据,因此 /logout 在这两个提供商上均不可用。无论使用哪个提供商,仍有一项连接会访问 Anthropic:WebFetch 工具在获取 URL 前,会将主机名且仅将主机名发送到 api.anthropic.com,以检查其是否位于安全阻止列表中。在设置文件中设置 skipWebFetchPreflight 可关闭此功能;如果您仍希望限制 Claude 可以访问的域名,请同时配置 WebFetch 权限规则。

这篇文章对您有帮助吗?