@anthropic-ai/google-cloud-sdk

中文文档
1.1.3发布于 2026/11/05Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 4195

Claude Models在Google Cloud上的官方TypeScript库(Anthropic管理)

中文使用文档
文档目录8 节
  1. 安装
  2. 使用量
  3. 配置
  4. 认证
  5. 应用程序默认证书
  6. 自定义 Google 证书
  7. 持卡人代号提供者
  8. 认证前代理

谷歌云上的克洛德模型的Anthropic SDK(Anthropic管理)

NPM version

这个图书馆在Google Cloud(英语:Anthropic managed)上为克洛德模型公司提供方便访问——第一党克洛德API通过Google Cloud服务. 它暴露出整个Anthropic API表面,并用谷歌无记名标志认证.

关于直接Claude API at api.harmic.com,参见 @anthropic-ai/sdk。用于 :rawPredict 出版商-模型 API,见 @anthropic-ai/vertex-sdk。 。 。 .

安装

npm install @anthropic-ai/google-cloud-sdk

使用量

import { AnthropicGoogleCloud } from '@anthropic-ai/google-cloud-sdk';

const client = new AnthropicGoogleCloud({
  project: 'my-gcp-project', // or ANTHROPIC_GOOGLE_CLOUD_PROJECT
  workspaceId: 'wrkspc_...', // or ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID
});

const message = await client.messages.create({
  model: 'claude-haiku-5-5',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Hello, Claude!' }],
});

console.log(message.content);

见 examples/ 用于可运行的基本和流出的例子.

配置

选项环境变量页:1
projectANTHROPIC_GOOGLE_CLOUD_PROJECTGCP project id,用于出自基础URL. 当两者皆无时(否) baseURL 在第一次请求时或之前,从您的Google证书中懒得解决.
locationANTHROPIC_GOOGLE_CLOUD_LOCATIONGCP地点. 可选的——默认 global。 。 。 .
workspaceIdANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID除了组织级路线(/v1/organizations/* 编辑 /v1/user_profiles 路线,不需要.
baseURLANTHROPIC_GOOGLE_CLOUD_BASE_URL覆盖来源于 project + 键 location + 键 workspaceId。 。 。 .
skipAuth—— 说跳过无记名标志, 对于认证上游的网关.

当项目懒散解决时,等待 client.ready 无法在配置错误时快速失败, 而不是等待第一个请求.

认证

认证使用 Google 无记名符号, 以优先解决 bearerTokenProvider,然后是一个 google-auth-图书馆 googleAuth 编号 : authClient,则 应用程序默认证书。 。 。 .

这个客户端从未使用 SDK 的基础 Anthropic 证书来源 : ANTHROPIC_API_KEY, (中文(简体) ), ANTHROPIC_AUTH_TOKEN,则配置配置文件全部被忽略,唯一的 Authorization 它发出的信头是Google无记名标志.

应用程序默认证书

设立ADC(如:. gcloud auth application-default login),客户端为您获取并刷新了无记名符号,不需要认证选项.

自定义 Google 证书

传出 a GoogleAuth 或者说 AuthClient 以覆盖默认的证书链( 例如使用冒用证书) :

import { AnthropicGoogleCloud } from '@anthropic-ai/google-cloud-sdk';
import { GoogleAuth } from 'google-auth-library';

const client = new AnthropicGoogleCloud({
  project: 'my-gcp-project',
  workspaceId: 'wrkspc_...',
  googleAuth: new GoogleAuth({ scopes: 'https://www.googleapis.com/auth/cloud-platform' }),
});

持卡人代号提供者

如果您已经将 Google 访问符记上, 请提供 bearerTokenProvider在每项请求中都援引这一原则,并优先于 googleAuth 编号 : authClient 和ADC:

const client = new AnthropicGoogleCloud({
  project: 'my-gcp-project',
  workspaceId: 'wrkspc_...',
  bearerTokenProvider: async () => myTokenSource.getAccessToken(),
});

认证前代理

如果一个网关或代理机代表您在上游认证, 设置 skipAuth 以跳过无记名符号( 带有明确 baseURL,没有 workspaceId 需要:

const client = new AnthropicGoogleCloud({
  baseURL: 'https://my-proxy.example.com',
  skipAuth: true,
});

版本与发布记录

@anthropic-ai/google-cloud-sdk 共发布 24 个版本,首次发布于 2026/07/17;过去 12 个月发布了 24 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.1.3latest2026/11/051 天前
1.1.22026/11/033 天前
1.1.12026/10/2413 天前
1.1.02026/10/2313 天前
1.0.02026/10/2115 天前
0.2.02026/10/2116 天前

关于 @anthropic-ai/google-cloud-sdk 的常见问题

@anthropic-ai/google-cloud-sdk 是什么?

Claude Models在Google Cloud上的官方TypeScript库(Anthropic管理)

如何安装 @anthropic-ai/google-cloud-sdk?

在项目目录运行 npm install @anthropic-ai/google-cloud-sdk,或使用 pnpm add / yarn add / bun add。

@anthropic-ai/google-cloud-sdk 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@anthropic-ai/google-cloud-sdk 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@anthropic-ai/google-cloud-sdk 可以商用吗?

@anthropic-ai/google-cloud-sdk 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@anthropic-ai/google-cloud-sdk 的下载量有多少?

根据 npm 官方下载统计,@anthropic-ai/google-cloud-sdk 在 2026/10/06 – 2026/11/04 这 30 天内被下载 4,195 次,日均约 140 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@anthropic-ai/google-cloud-sdk 还在维护吗?

最新版本 1.1.3 发布于 2026/11/05(1 天前);至今共发布 24 个版本,其中过去 12 个月发布了 24 个;首次发布于 2026/07/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。