Google Cloud 上的 Claude

用于在 Google Cloud's Agent Platform 上访问 Claude 的 API 与 Messages API 几乎完全相同，但在请求格式上有两个关键区别：

• 在 Agent Platform 上，model 不在请求体中传递，而是在 Google Cloud 端点 URL 中指定。
• 在 Agent Platform 上，anthropic_version 在请求体中传递（而不是作为请求头），并且必须设置为值 vertex-2023-10-16。

Anthropic 的官方 client SDKs（客户端 SDK）也支持 Agent Platform。本指南将引导您使用 Anthropic 的客户端 SDK 之一向 Agent Platform 上的 Claude 发出请求。

请注意，本指南假设您已经拥有一个能够使用 Agent Platform 的 Google Cloud 项目。有关所需设置的更多信息和完整演练，请参阅 Agent Platform 上的 Anthropic Claude 模型。

安装用于访问 Agent Platform 的 SDK

首先，为您选择的语言安装 Anthropic 的 客户端 SDK。

pip install -U "anthropic[vertex]"

访问 Agent Platform

模型可用性

请注意，Anthropic 模型的可用性因区域而异。请在 Model Garden 中搜索"Claude"，或前往 Anthropic Claude 模型 获取最新信息。

API 模型 ID

生命周期术语（Deprecated（已弃用）、Retired（已停用））在模型弃用中定义。合作伙伴运营平台上的生命周期日期由合作伙伴设定，可能与 Claude API 的时间表不同。有关 Agent Platform 上任何模型的当前停用日期，请参阅 Google Cloud 关于 Agent Platform 上 Claude 模型的文档。

发出请求

在运行请求之前，您可能需要运行 gcloud auth application-default login 以向 Google Cloud 进行身份验证。

以下示例展示了如何在 Agent Platform 上通过 Claude 生成文本：

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

有关更多详细信息，请参阅 客户端 SDK 和官方 Agent Platform 文档。

Claude 也可通过 Amazon Bedrock、Claude Platform on AWS 和 Microsoft Foundry 使用。

数据保留

此产品的数据处理由 Google Cloud 管理。有关详细信息，请参阅 Agent Platform 与零数据保留。

活动日志记录

Agent Platform 提供 请求-响应日志记录服务，允许您记录与您的使用相关的提示和补全内容。

Anthropic 建议您至少以 30 天滚动周期记录您的活动，以便了解您的活动情况并调查任何潜在的滥用行为。

功能支持

有关包含 Google Cloud 可用性的完整功能列表，请参阅功能概览。

支持的功能亮点

• Messages API
• 提示缓存
• 思考
• 工具使用，包括 Bash 工具、浏览器使用工具、计算机使用工具、记忆工具 和 文本编辑器工具
• 网页搜索工具
• 引用
• 结构化输出

不支持的功能

• 输入源（图像和文档的 URL 源、Files API）
• 服务器端工具（代码执行、网页抓取、advisor）
• 智能体基础设施（Agent Skills、MCP 连接器、程序化工具调用）
• API 端点（Message Batches、Models、Admin、Compliance、Usage and Cost）
• Claude Managed Agents
• 服务器端回退（fallbacks 参数；请改用客户端回退模式）

上下文窗口

Claude Fable 5.1、Claude Fable 5、Claude Opus 5、Claude Opus 4.8、Claude Opus 4.7、Claude Opus 4.6、Claude Sonnet 5 和 Claude Sonnet 4.6 在 Agent Platform 上拥有 100 万令牌的 context window（上下文窗口）。其他 Claude 模型，包括 Sonnet 4.5 和 Sonnet 4（已弃用），拥有 20 万令牌的上下文窗口。

Agent Platform 将请求负载限制为 30 MB。在发送大型文档或大量图像时，您可能会在达到令牌限制之前先达到此限制。

全球、多区域和区域端点

Agent Platform 提供三种端点类型：

• 全球端点： 动态路由以实现最大可用性
• 多区域端点： 在某一地理区域内（例如美国或欧盟）进行动态路由，在满足数据驻留要求的同时提供高可用性
• 区域端点： 保证数据通过特定地理区域路由

区域端点和多区域端点的定价比全球端点高出 10%。

何时使用各选项

全球端点（推荐）：

• 提供最大的可用性和正常运行时间
• 将请求动态路由到具有可用容量的区域
• 无定价溢价
• 最适合数据驻留要求灵活的应用
• 仅支持按需付费流量（预置吞吐量需要使用区域端点）

多区域端点：

• 在某一地理区域内（目前为 us 和 eu）跨区域动态路由请求
• 适用于需要在较大地理范围内满足数据驻留要求、但希望获得比单一区域更高可用性的场景
• 定价比全球端点高出 10%
• 仅支持按需付费流量（预置吞吐量需要使用区域端点）

区域端点：

• 通过特定地理区域路由流量
• 单区域数据驻留、严格合规要求或预置吞吐量所必需
• 同时支持按需付费和预置吞吐量
• 10% 的定价溢价反映了专用区域容量的基础设施成本

实现

使用全球端点（推荐）：

初始化客户端时，将 region 参数设置为 "global"：

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

使用多区域端点：

将 region 参数设置为多区域标识符："us" 表示美国，"eu" 表示欧盟。SDK 会将请求路由到相应的多区域端点（https://aiplatform.us.rep.googleapis.com 或 https://aiplatform.eu.rep.googleapis.com），该端点会在该地理范围内的各区域之间动态平衡流量。

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us"  # Multi-region identifier: "us" or "eu"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

使用区域端点：

指定一个特定区域，例如 "us-east5" 或 "europe-west1"：

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us-east5"  # Specify a specific region

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    # 特定区域端点支持 Claude Sonnet 4.6 及更早版本；较新的模型使用全球或多区域端点
    model="claude-sonnet-4-6",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

其他资源

• Agent Platform 定价： cloud.google.com 上的生成式 AI 定价
• Claude 模型文档： Agent Platform 上的 Claude
• Google 博客文章： Claude 模型的全球端点
• Anthropic 定价详情： 云平台定价