# @core-ai/anthropic-vertex 中文文档

规范地址：https://npmcn.com/package/%40core-ai/anthropic-vertex/

版本：0\.38\.0
npm 元数据更新时间：2026-11-06T13:56:07.872Z
中文译文更新时间：2026-11-10T18:49:17.947Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40core-ai/anthropic-vertex
原文对照：https://npmcn.com/package/%40core-ai/anthropic-vertex/?lang=original
项目主页：https://github.com/agdevhq/core-ai#readme
源码仓库：https://github.com/agdevhq/core-ai

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：10.5 kB，5 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2026-07-13T23:17:42.903Z
- 最新版本发布：2026-11-06T13:56:07.386Z
- 近 30 天下载量：4509（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：30（近 12 个月 30 个）

## 中文简介

Vertex AI Anthropic(克劳德)供应商软件包,用于 @core-ai/core-ai

## 安装

```sh
npm install @core-ai/anthropic-vertex
```

也可以使用：`pnpm add @core-ai/anthropic-vertex`、`yarn add @core-ai/anthropic-vertex`、`bun add @core-ai/anthropic-vertex`

## README

# @core-ai/人类顶点

[![npm](https://img.shields.io/npm/v/@core-ai/anthropic-vertex.svg)](https://www.npmjs.com/package/@core-ai/anthropic-vertex)

Vertex AI Anthropic(克洛德)供应商软件包 `@core-ai/core-ai`它使用 [`@anthropic-ai/vertex-sdk`](https://www.npmjs.com/package/@anthropic-ai/vertex-sdk) 客户端并分享其请求、流线、工具调用、结构化输出和推理行为 `@core-ai/anthropic`。 。 。 .

## 安装

```bash
npm install @core-ai/core-ai @core-ai/anthropic-vertex zod
```

## 使用量

```ts
import { generate } from '@core-ai/core-ai';
import { createAnthropicVertex } from '@core-ai/anthropic-vertex';

const anthropicVertex = createAnthropicVertex({
    projectId: process.env.GOOGLE_VERTEX_PROJECT,
    region: 'europe-west1',
});
const model = anthropicVertex.chatModel('claude-sonnet-4-6');

const result = await generate({
    model,
    messages: [{ role: 'user', content: 'Hello!' }],
});

console.log(result.content);
```

## 认证

默认情况下,提供者使用 [Google 应用程序默认证书( ADC)](https://cloud.google.com/docs/authentication/application-default-credentials)数字 :

```ts
const anthropicVertex = createAnthropicVertex({
    projectId: process.env.GOOGLE_VERTEX_PROJECT,
    region: 'europe-west1',
});
```

使用明确的服务账户进行认证,将其 JSON 密钥解析后作为 `credentials`数字 :

```ts
const rawCredentials = process.env.GOOGLE_APPLICATION_CREDENTIALS_JSON;
const credentialsJson = rawCredentials?.trim().startsWith('{')
    ? rawCredentials
    : Buffer.from(rawCredentials ?? '', 'base64').toString('utf8');

const anthropicVertex = createAnthropicVertex({
    projectId: process.env.GOOGLE_VERTEX_PROJECT,
    region: 'europe-west1',
    credentials: JSON.parse(credentialsJson),
});
```

您也可以插入预配置客户端( 例如自定义) `AnthropicVertex` 例如,或用窃听器进行测试:

```ts
import { AnthropicVertex } from '@anthropic-ai/vertex-sdk';

const anthropicVertex = createAnthropicVertex({
    client: new AnthropicVertex({ projectId: 'my-project', region: 'eu' }),
});
```

## 示范身份证和区域

通过 Vertex 型号 ID (如 [Vertex AI 模拟花园](https://console.cloud.google.com/vertex-ai/publishers/anthropic/model-garden)改为: `chatModel()`. 模型的可用性和命名因地区而异——例如,一些克洛德模型只发布到Vertex AI的 `eu` 多区域,而其他的则发布到特定区域的终点,例如: `europe-west1`。由于一个供应商实例针对一个单一区域,如果需要访问不同区域托管的模型,则创建单独的供应商:

```ts
const anthropicVertexEu = createAnthropicVertex({
    projectId: process.env.GOOGLE_VERTEX_PROJECT,
    region: 'eu',
});
const anthropicVertexEuWest1 = createAnthropicVertex({
    projectId: process.env.GOOGLE_VERTEX_PROJECT,
    region: 'europe-west1',
});
```

此软件包仅支持聊天模式 .

> **洞穴:** 通过未转换的Vertex模型id(例如. `claude-sonnet-4-6`)而不是一个版本被固定的id(例如. `claude-sonnet-4-6@20250929`合理努力和限制采样能力检测(`getAnthropicModelCapabilities` 还有朋友 `@core-ai/anthropic`)只识别出今天未被转录的形式,因此一个版本被固定的id默默地倒回了标准的能力而不是模型的实际能力.

## 供应商选项和模型能力

此提供者分享其请求、流线和推理行为 `@core-ai/anthropic`. 供求办法`anthropicGenerateProviderOptionsSchema`),推理元数据类型(`AnthropicReasoningMetadata`)和示范能力帮助者(`getAnthropicModelCapabilities`可从下列网址获取: `@core-ai/anthropic` 并同样适用于由Vertex公司托管的克洛德模型.

## 常见问题

### @core-ai/anthropic-vertex 是什么？

Vertex AI Anthropic\(克劳德\)供应商软件包,用于 @core-ai/core-ai

### 如何安装 @core-ai/anthropic-vertex？

在项目目录运行 npm install @core-ai/anthropic-vertex，或使用 pnpm add / yarn add / bun add。

### @core-ai/anthropic-vertex 支持 TypeScript 吗？

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

### @core-ai/anthropic-vertex 支持 ESM 还是 CommonJS？

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

### @core-ai/anthropic-vertex 可以商用吗？

@core-ai/anthropic-vertex 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @core-ai/anthropic-vertex 的下载量有多少？

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

### @core-ai/anthropic-vertex 还在维护吗？

最新版本 0\.38\.0 发布于 2026/11/06（4 天前）；至今共发布 30 个版本，其中过去 12 个月发布了 30 个；首次发布于 2026/07/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。