Claude Models on Google Cloud (Anthropic managed)
Claude Models on Google Cloud (Anthropic managed) 是由 Anthropic 运行、通过您的 Google Cloud 项目访问的 Claude API。
Google Cloud 负责处理 Claude Models on Google Cloud (Anthropic managed) 的访问和计费。要比较这两种 Google Cloud 产品,或查看您使用的是哪一种,请参阅 Claude Models on Google Cloud。
设置您的账户
要为 Claude Models on Google Cloud (Anthropic managed) 设置账户,您需要具备以下条件:
- 在您的结算账户上于 Google Cloud Marketplace 中进行购买的权限
- 在项目上启用服务的权限
- 一个允许您打开 Claude Console 的 IAM 角色,第 4 步需要用到
这些步骤会为您的 Google Cloud 项目创建一个新的 Anthropic 组织。它独立于您公司已有的任何 Anthropic 组织,包括 Claude Enterprise 组织。要从现有组织迁移,请参阅从现有 Anthropic 组织迁移。
如果您已有折扣,请在开始这些步骤之前联系您的 Anthropic 或 Google Cloud 客户代表。折扣无法应用于过去的使用量。
在 Marketplace 中订阅
- 打开 Google Cloud Marketplace,找到 Claude Models on Google Cloud (Anthropic managed) 商品页面。
- 选择 Subscribe 并完成购买流程。
- 返回商品页面并选择 Manage on Console。这会在 Google Cloud 控制台中打开 Claude 页面。
以后要返回 Claude 页面,请在 Google Cloud 控制台中选择您的项目。然后前往 Agent Platform > Models > Claude Platform 并选择 Anthropic managed。
启用服务
在每个调用 Claude Models on Google Cloud (Anthropic managed) 的项目上启用两项服务:
claude.googleapis.com提供 Claude Models on Google Cloud (Anthropic managed) 的 API。该服务还定义了 IAM 权限。没有它,调用会失败。anthropic-managed-claude.cloudpartnerservices.goog是将项目的使用量归属到您的订阅的 Marketplace 服务。
CLIgcloud services enable claude.googleapis.com \ anthropic-managed-claude.cloudpartnerservices.goog \ --project=my-project-id将
my-project-id替换为您的项目 ID。您也可以从 Claude 页面或 APIs & Services 启用这两项服务。每个项目只需启用一次。要检查两项服务是否都已启用,请运行
gcloud services list --enabled --project=my-project-id并查找这两个名称。设置您的 Anthropic 组织
- 在 Claude 页面上,选择 Activate。
- 在 Anthropic 设置流程中,输入联系电子邮件地址。
- 打开发送到该地址的设置链接。
- 填写组织名称、实体类型、国家/地区和预期用途。
- 接受 Anthropic 的商业服务条款和使用政策。
联系地址仅用于设置和服务通知。关于设置完成后用户如何打开 Claude Console,请参阅使用 Claude Console。
打开 Claude Console
当您的 Anthropic 组织处于活动状态时,Claude 页面上的按钮会变为 Open Claude Console。选择它。Google Cloud 会检查您的 IAM 访问权限,然后将您的浏览器重定向到
platform.claude.com。您将登录到新组织。在 Claude Console 中,找到您的工作区 ID 并复制它。每个调用 Claude Models on Google Cloud (Anthropic managed) 的人都需要它。请将其转交给您的开发人员。
要添加另一个项目,请在该项目中从第 2 步开始重复这些步骤。
账户设置故障排除
如果您在设置 Claude Models on Google Cloud (Anthropic managed) 时遇到以下问题之一,请应用相应的解决方法:
gcloud services enable找不到anthropic-managed-claude.cloudpartnerservices.goog: 使用完成 Marketplace 购买的账户运行该命令,或联系您的 Anthropic 客户代表。- 首次 API 调用时出现权限错误: 检查您调用的项目上是否已启用
claude.googleapis.com。检查调用方在该项目上是否拥有roles/claude.user或roles/claude.admin。关于每个角色允许的操作,请参阅 IAM 角色。新授予的权限或新启用的服务可能需要片刻才能生效。 - 点击设置链接后显示"Signed in as a different account": 选择 Log out and continue。然后使用您在第 3 步中输入的电子邮件地址。
- 按钮显示"Finish Setup"而不是"Open Claude Console": 您的 Anthropic 组织已存在,但其设置尚未完成。管理员需要填写完组织详细信息表单。
- 首次 API 调用后 Usage 页面没有显示数据: 使用数据可能需要几分钟才会出现在 Claude Console 中。
管理访问权限
IAM 角色
Claude Models on Google Cloud (Anthropic managed) 有三个预定义的 IAM 角色。请在项目上授予角色。
| 角色 | 显示名称 | 允许的操作 |
|---|---|---|
roles/claude.viewer | Claude Viewer | 工作区资源上的所有 get 和 list 权限此角色为只读。 |
roles/claude.user | Claude User | roles/claude.viewer 允许的所有操作,以及创建和更改工作区资源这包括发送消息和计算令牌数,还包括管理批处理、文件、技能和 Claude Managed Agents 资源。 |
roles/claude.admin | Claude Admin | roles/claude.user 允许的所有操作,以及在您的 Anthropic 组织上检查的权限组织级路由作用于整个 Anthropic 组织,而不是单个工作区。 |
例如,以下命令允许服务账号调用 Claude Models on Google Cloud (Anthropic managed):
gcloud projects add-iam-policy-binding my-project-id \
--member="serviceAccount:my-app@my-project-id.iam.gserviceaccount.com" \
--role="roles/claude.user"关于权限、预定义角色和审计日志类型,请参阅 Claude Models on Google Cloud (Anthropic managed) 的 IAM 权限。
启用 claude.googleapis.com 会为项目创建一个服务代理。请勿移除其角色授权。移除它们会导致 Claude Models on Google Cloud (Anthropic managed) 在该项目中停止工作。
使用 Claude Console
使用 Claude Models on Google Cloud (Anthropic managed) 时,您无法使用电子邮件地址登录您的 Anthropic 组织。相反,请在 Google Cloud 控制台的 Claude 页面上选择 Open Claude Console。Google Cloud IAM 控制谁可以打开 Claude Console。在三个预定义的 IAM 角色中,只有项目上的 roles/claude.admin 允许您打开 Claude Console。
工作区
在 Claude Models on Google Cloud (Anthropic managed) 中,设置过程会创建带有一个工作区(即 Default Workspace)的 Anthropic 组织。要创建更多工作区,请打开 Claude Console 并前往 Settings > Workspaces。在同一页面上,您可以重命名或归档除 Default Workspace 之外的任何工作区。每个工作区都有自己的工作区 ID。文件、技能、批处理、Claude Managed Agents 会话和其他工作区资源属于您为请求设置的 ID 所对应的工作区。
您在项目上授予 IAM 角色,因此一个角色适用于该项目中的每个工作区。当团队需要独立的访问权限时,请为每个团队提供各自的 Google Cloud 项目。每个项目都有自己的 Anthropic 组织,因此请在每个项目中从第 2 步开始重复设置步骤。
进行 API 调用之前
要调用 Claude Models on Google Cloud (Anthropic managed),您需要具备以下条件:
- 一个拥有有效订阅且 Anthropic 组织已完成设置的 Google Cloud 项目。请参阅设置您的账户。
- 已安装 gcloud CLI,用于本地开发。
- 在项目上授予进行调用的身份的
roles/claude.user角色。 - 该身份的 Application Default Credentials。请参阅身份验证。
- 您的项目 ID 和工作区 ID。
要为本地开发向您自己的账户授予该角色,请运行以下命令。您需要拥有更改项目 IAM 策略的权限。
gcloud projects add-iam-policy-binding my-project-id \
--member="user:you@example.com" \
--role="roles/claude.user"将 my-project-id 替换为您的项目 ID。将 you@example.com 替换为您的 Google 账户电子邮件地址。要查看 gcloud 正在使用的项目,请运行 gcloud config get-value project。关于服务账号和其他角色,请参阅 IAM 角色。
找到您的工作区 ID
要找到 Claude Models on Google Cloud (Anthropic managed) 的工作区 ID,请打开 Claude Console 并前往 Settings > Workspaces。该 ID 以 wrkspc_ 开头。如果您无法打开 Claude Console,请让能够打开它的人将 ID 发送给您。
将项目和工作区设置为环境变量,以便 SDK 客户端和 ant CLI 能够读取它们:
export ANTHROPIC_GOOGLE_CLOUD_PROJECT="my-project-id"
export ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID="wrkspc_01AbCdEf23GhIj"安装 SDK
Claude Models on Google Cloud (Anthropic managed) 的 SDK 客户端是 AnthropicGoogleCloud。该客户端会解析您的 Google 凭据,还会根据您的项目、位置和工作区 ID 构建基础 URL。
安装提供该客户端的软件包:
pip install -U "anthropic[google_cloud]"如果要改用 ant CLI,请将其安装或更新到最新版本。不支持 Claude Models on Google Cloud (Anthropic managed) 的版本会忽略 ANTHROPIC_GOOGLE_CLOUD_* 变量,然后执行以下操作之一:
- 使用您设置的任何其他凭据将请求发送到 Claude API
- 因身份验证错误而失败
发出请求
Claude Models on Google Cloud (Anthropic managed) 在一个包含您的项目、位置和工作区的基础 URL 下提供 Claude API 端点:
https://claude.googleapis.com/v1/projects/{project}/locations/global/workspaces/{workspace}/invoke组织级路由(其路径以 /v1/organizations/ 开头)使用不含工作区的基础 URL:
https://claude.googleapis.com/v1/projects/{project}/locations/global/claudeOrganization/invoke如果您没有设置基础 URL,SDK 客户端会为每个请求在这两者之间进行选择。
将 Claude API 路径附加到基础 URL 之后。例如,Messages API 位于 .../invoke/v1/messages。与 Claude API 请求相比,有三处不同:
- 基础 URL: 使用前面所示的项目范围 URL,而不是
https://api.anthropic.com。 - 身份验证: 使用带有 Google 访问令牌的
Authorization: Bearer标头。不要发送x-api-key标头。 - 工作区: 工作区 ID 是 URL 的一部分。不要发送
anthropic-workspace-id标头。
其他一切都与 Claude API 相同,包括以下内容:
anthropic-version和anthropic-beta标头- 请求正文
- 流式传输
- 响应
本文档其他地方的代码示例会创建 Claude API 客户端并读取 API 密钥。要在 Claude Models on Google Cloud (Anthropic managed) 上运行这些示例,请将其导入语句和客户端构造函数替换为以下示例中的内容。对于 cURL 示例,请应用前面列出的三处不同。
在运行这些示例之前,请完成进行 API 调用之前中的步骤。
from anthropic import AnthropicGoogleCloud
client = AnthropicGoogleCloud()
message = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello, Claude"}],
)
print(message)cURL 示例会向 gcloud 请求一个 Application Default Credentials 令牌。访问令牌的有效期很短。请为每个会话生成一个令牌,而不是存储它。
API 模型 ID
Claude Models on Google Cloud (Anthropic managed) 使用与 Claude API 相同的模型 ID,例如 claude-opus-5-5。关于模型及其 ID,请参阅模型概览。
在 Claude Models on Google Cloud (Anthropic managed) 中,请求您的 Anthropic 组织无法使用的模型会返回错误。错误消息为 Model {model} is not available for this organization's inference configuration.
项目、位置和工作区解析
Claude Models on Google Cloud (Anthropic managed) 的客户端接受下表中的设置。创建客户端时传入的值优先于环境变量。要显式设置项目和工作区 ID,请传入 project 和 workspace_id。
| 设置 | 环境变量 | 未设置时 |
|---|---|---|
| 项目 ID | ANTHROPIC_GOOGLE_CLOUD_PROJECT,然后是 GOOGLE_CLOUD_PROJECT | Application Default Credentials 报告的项目(当凭据类型包含项目时) |
| 工作区 ID | ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID | 除非您设置了基础 URL,否则客户端会引发错误。组织级路由不需要工作区 ID。 |
| 位置 | ANTHROPIC_GOOGLE_CLOUD_LOCATION | global |
| 基础 URL | ANTHROPIC_GOOGLE_CLOUD_BASE_URL | 根据项目、位置和工作区 ID 派生 |
请将位置保留为 global。位置与推理运行的地点无关,因此如需仅在美国进行推理,请在每个请求上设置 inference_geo: "us",如数据驻留中所述。
ant CLI 以标志的形式接受相同的设置:
- 项目 ID:
--google-cloud-project - 工作区 ID:
--google-cloud-workspace-id - 位置:
--google-cloud-location - 基础 URL:
--google-cloud-base-url
当设置了项目、工作区 ID 或位置时,CLI 会使用 Claude Models on Google Cloud (Anthropic managed)。仅设置 GOOGLE_CLOUD_PROJECT、基础 URL 或两者是不够的。
身份验证
发往 Claude Models on Google Cloud (Anthropic managed) 的每个请求都在 Authorization: Bearer 标头中携带一个 Google OAuth 2.0 访问令牌。该令牌具有 https://www.googleapis.com/auth/cloud-platform 范围。
Google Cloud 负责处理访问。其位于 claude.googleapis.com 的网关会对每个请求执行以下操作:
- 检查您的 Google Cloud 凭据。
- 检查调用方是否拥有请求所需的 IAM 权限。如果没有,Google Cloud 会返回 HTTP 403 错误。
- 将请求转发给 Anthropic。Anthropic 会验证该请求。
要授予权限,请参阅 IAM 角色。
SDK 客户端从 Application Default Credentials(ADC)获取令牌。ADC 支持的任何凭据来源都可以使用:
- 本地开发: 运行
gcloud auth application-default login。 - 在 Google Cloud 上: 客户端会自动使用附加到工作负载的服务账号,例如在 Compute Engine、GKE 或 Cloud Run 上。
- 服务账号密钥文件: 将
GOOGLE_APPLICATION_CREDENTIALS设置为其路径。 - Workload Identity Federation 和服务账号模拟: 按照配置任何 Google Cloud API 的方式进行配置。
检查 ADC 是否正常工作:
gcloud auth application-default print-access-tokenClaude Models on Google Cloud (Anthropic managed) 不使用 API 密钥。在 Claude Console 中,您无法为设置过程创建的 Anthropic 组织创建 API 密钥。Claude Models on Google Cloud (Anthropic managed) 的 SDK 客户端会忽略以下环境变量:
ANTHROPIC_API_KEYANTHROPIC_AUTH_TOKENANTHROPIC_BASE_URL
凭据优先级
Claude Models on Google Cloud (Anthropic managed) 的 SDK 客户端按以下顺序检查凭据,并使用找到的第一个:
- 创建客户端时以
token_provider传入的令牌提供程序。它是一个返回访问令牌的函数或令牌源。客户端会在每个请求时向它请求令牌。令牌的缓存和刷新由您负责。 - 创建客户端时以
credentials传入的 Google 凭据对象。Go SDK 没有此选项。 - Application Default Credentials。
Go 和 Java 与其他 SDK 有所不同:
- Go: 对于选项 1,客户端接受一个
oauth2.TokenSource。它会缓存令牌直到令牌过期。 - Java: 使用
GoogleCloudBackend.fromEnv()读取 Application Default Credentials 以及项目、位置和工作区解析中的环境变量。
客户端没有用于凭据的专属环境变量。请改用 ADC 的 GOOGLE_APPLICATION_CREDENTIALS。
如果您的请求经过一个会为您附加令牌的代理,请设置 skip_auth。这样客户端就不会发送 Authorization 标头。此设置不能与前面的凭据选项组合使用。
当 ant CLI 使用 Claude Models on Google Cloud (Anthropic managed) 时,它始终从 Application Default Credentials 获取令牌。它不接受令牌提供程序、凭据对象或跳过身份验证的设置。
在将 ant 与 Claude Models on Google Cloud (Anthropic managed) 一起使用之前,请确保以下各项均未设置:
- API 密钥
- 身份验证令牌
--profile或ANTHROPIC_PROFILE(如果它指定了 CLI 可用于身份验证的配置文件)- Anthropic 的任何联合身份变量:
ANTHROPIC_FEDERATION_RULE_IDANTHROPIC_ORGANIZATION_IDANTHROPIC_SERVICE_ACCOUNT_IDANTHROPIC_IDENTITY_TOKENANTHROPIC_IDENTITY_TOKEN_FILE
如果设置了其中任何一项,CLI 会使用该凭据,而不是找到您的工作区 ID 中的 Google Cloud 设置。如果只设置了部分联合身份变量,CLI 会报错并停止。当设置了多个凭据时,CLI 会打印一条说明,指出它使用的是哪一个。
此外,请不要设置 ANTHROPIC_WORKSPACE_ID 和 --workspace-id 标志。CLI 仍会将该值作为 anthropic-workspace-id 标头发送,而发往 Claude Models on Google Cloud (Anthropic managed) 的请求不得携带该标头。请改用 --google-cloud-workspace-id 或 ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID 设置工作区。
与 SDK 客户端一样,CLI 不会将 Claude Models on Google Cloud (Anthropic managed) 的请求发送到 --base-url 或 ANTHROPIC_BASE_URL。
功能支持
本节列出了在 Claude Models on Google Cloud (Anthropic managed) 上可用的功能以及不受支持的功能。它并未列出所有 Claude API 功能,也不说明未列出的功能是否可用。
以下功能在 Claude Models on Google Cloud (Anthropic managed) 上的工作方式与在 Claude API 上相同:
- Fast mode(快速模式): 适用于 Claude Opus 5.5 的快速模式。
- Beta 功能: 如果某个 beta 功能在 Claude API 上仅限特定组织使用,则设置过程创建的 Anthropic 组织需要具有相同的访问权限。
- 工具: 工具使用,包括:
- 网络搜索
- 网页获取
- 代码执行
- 记忆工具
- 顾问工具
- MCP 连接器
- 技能和文件: Agent Skills 和 Files API。
- 模型能力:
- 批处理和模型: Message Batches API 和 Models API。
要为设置过程创建的 Anthropic 组织开启或关闭 Compliance API,请打开 Claude Console,前往 Settings > Compliance,然后使用 Compliance API 开关。
"Customer-managed encryption keys"(客户管理的加密密钥),即 CMEK,可与 Google Cloud KMS 密钥一起使用。要为设置过程创建的 Anthropic 组织激活 CMEK,请参阅客户管理的加密密钥。要设置密钥,请按照为 CMEK 配置 Google Cloud KMS 操作。然后按照设置页面的 Claude Console 选项卡中的说明,在 Claude Console 中注册、验证并附加密钥。
Claude Managed Agents
Claude Managed Agents 可通过 Claude Models on Google Cloud (Anthropic managed) 使用,包括以下内容:
访问权限在创建会话或部署时检查,而不是在其运行期间检查:
- 正在运行的会话会继续运行。 如果您撤销了创建会话的身份的 Google Cloud 访问权限,会话不会停止。要停止它,请单独向其发送一个
user.interrupt事件。会话变为idle后,您可以将其归档或删除。 - 计划部署会继续运行。 部署不会在每次计划运行时重新检查其创建者的访问权限。要停止它,请暂停、更新或归档它。
当您移除用户或轮换服务账号时,请检查该身份创建的会话和部署。
不支持的功能
Claude Models on Google Cloud (Anthropic managed) 不支持以下内容:
- API 密钥: 仅通过 Google Cloud 凭据进行身份验证。
- MCP 隧道: MCP 隧道在 Claude Models on Google Cloud (Anthropic managed) 上不可用。
- 自托管环境上的记忆存储: 自托管环境上的会话不支持记忆存储。
- 预构建的自托管沙箱工作器:
antCLI 以及 Python、TypeScript 和 Go SDK 中的自托管工作器不支持 Claude Models on Google Cloud (Anthropic managed)。请改为实现您自己的工作器,直接调用 Environments Work 端点。有关您的工作器所需的角色和权限,请参阅环境的 IAM 权限。
上下文窗口
Claude Models on Google Cloud (Anthropic managed) 上的"context window"(上下文窗口)大小与 Claude API 上相同。关于每个模型的限制,请参阅上下文窗口。
计费、速率限制和日志记录
速率限制
Anthropic 管理 Claude Models on Google Cloud (Anthropic managed) 的"rate limit"(速率限制)。要申请更高的限制,请联系您的 Anthropic 客户代表或联系销售。关于速率限制的衡量和报告方式,请参阅速率限制。
计费
Claude Models on Google Cloud (Anthropic managed) 通过 Google Cloud Marketplace 计费。Anthropic 计量您的使用量,并以 Claude Consumption Units 向 Google Cloud 报告使用量。费用会显示在您的 Google Cloud 账单上。Anthropic 不会单独开具发票。
在 Claude Console 的 Usage 和 Cost 页面上查看使用量和费用数据。
如果您有 Google Cloud 支出承诺,使用量会像其他 Marketplace 购买一样计入该承诺。
数据保留
Anthropic 是 Claude Models on Google Cloud (Anthropic managed) 的数据处理者。一些支持服务(例如 Anthropic 的信任与安全系统)会在 Google Cloud 之外处理数据。
Claude Models on Google Cloud (Anthropic managed) 遵循与 Claude API 相同的数据保留政策。请参阅 API 和数据保留。"Zero Data Retention"(零数据保留),即 ZDR,可应要求提供。请联系您的 Anthropic 客户代表。
其他 Anthropic 组织上的 ZDR 安排不会延续到您用于 Claude Models on Google Cloud (Anthropic managed) 的组织。
监控和日志记录
Cloud Audit Logs 会记录您项目中 Claude Models on Google Cloud (Anthropic managed) 的 API 活动。这些条目显示在 claude.googleapis.com 服务下。每个 API 路由属于以下两种日志类型之一:
- Data Access 日志: 涵盖大多数路由,包括消息、批处理、文件、技能、模型以及大多数 Claude Managed Agents 资源。默认处于关闭状态。
- Admin Activity 日志: 涵盖其他路由,包括加密密钥路由和大多数凭据保管库路由。例外是
vaults.verify的路由,它属于 Data Access。Admin Activity 日志始终处于开启状态。
要保留请求记录,请在项目的审计日志设置中为 claude.googleapis.com 开启 Data Access 日志。
关于各路由的审计日志类型,请参阅 Claude Models on Google Cloud (Anthropic managed) 的 IAM 权限。
请求 ID
来自 Claude Models on Google Cloud (Anthropic managed) 的成功响应会携带 request-id 标头。
从现有 Anthropic 组织迁移
您无法将现有的 Anthropic 组织转换为 Claude Models on Google Cloud (Anthropic managed) 的组织,包括您直接用于 Claude API 的组织。
请将迁移规划为切换到新组织:
- 先创建新组织。 按照设置您的账户操作。
- 重新创建访问权限和配置。 API 密钥、工作区和 Claude Console 设置不会延续。请在项目上授予 IAM 角色,而不是创建 API 密钥。要重新创建工作区,请参阅工作区。关于 ZDR 安排,请参阅数据保留。
- 规划已存储的资源。 文件、技能、批处理和 Claude Managed Agents 资源会保留在现有组织中。
- 更新您的集成。 关于哪些内容会改变、哪些保持不变,请参阅发出请求。关于不受支持的功能,请参阅不支持的功能。
- 按您自己的时间表进行切换。 两个组织相互独立,可以并行处理流量。您可以逐步迁移工作负载。现有组织保持其当前的计费方式。在转移生产流量之前,请检查速率限制。
从 Claude Models on Google Cloud (Google managed) 迁移
要迁移到 Claude Models on Google Cloud (Anthropic managed),请完成以下步骤。在迁移依赖 ZDR 安排的工作负载之前,请参阅数据保留。有关迁移时会发生哪些变化,请参阅两种 Google Cloud 产品的区别。
设置您的账户
完成设置您的账户中的每个步骤。
设置访问权限
向每个调用 Claude Models on Google Cloud (Anthropic managed) 的身份授予
roles/claude.user。将您的项目和工作区 ID 设置为环境变量。有关这两项操作,请参阅在进行 API 调用之前。安装 SDK 包
安装为 Claude Models on Google Cloud (Anthropic managed) 提供客户端的包。请参阅安装 SDK。
替换导入和客户端
修改导入和创建客户端的代码。使用
AnthropicGoogleCloud代替AnthropicVertex。在 cURL 请求中,修改 URL、请求头和请求体。您当前的代码会为 Claude Models on Google Cloud (Google managed) 创建客户端。例如,以下代码使用全局端点创建该客户端:Pythonfrom anthropic import AnthropicVertex project_id = "MY_PROJECT_ID" region = "global" client = AnthropicVertex(project_id=project_id, region=region)以下代码为 Claude Models on Google Cloud (Anthropic managed) 创建客户端:
Pythonfrom anthropic import AnthropicGoogleCloud client = AnthropicGoogleCloud()新客户端会从您在查找您的工作区 ID 中设置的环境变量读取项目和工作区 ID。创建客户端时无需传入它们。除了下一步中的模型 ID 和功能之外,您的 Messages API 调用保持不变。
检查模型 ID 和功能
- 模型 ID: 如果您使用的是早于 Claude 4.6 的模型,请将其 ID 中快照日期前的
@替换为连字符。例如,claude-haiku-4-5@20251001变为claude-haiku-4-5-20251001。有关模型及其 ID,请参阅 API 模型 ID。 - 功能: 针对您的代码使用的每项功能,查看功能支持。
- 位置: 如果您目前使用多区域或区域端点,请检查 Claude Models on Google Cloud (Anthropic managed) 使用哪个位置。请参阅项目、位置和工作区解析。
- 模型 ID: 如果您使用的是早于 Claude 4.6 的模型,请将其 ID 中快照日期前的
后续步骤
探索 Claude 的功能。
查找权限、角色和审计日志类型。
随着更安全、更强大的模型推出,Anthropic 会定期停用较旧的模型。查看所有 API 弃用信息以及推荐的替代模型。
管理您的订阅和账单。
Was this page helpful?