> ## Content Index
> Fetch the complete content index at: https://www.hubwiz.com/blog/llms.txt
> Use this file to discover other available public pages before exploring further.

# 通过 Vertex AI 使用 Claude Code
- URL: https://www.hubwiz.com/blog/use-claude-code-via-vertex-ai/
- Published: 2026-05-15T21:45:55.000Z
- Updated: 2026-10-13T15:51:51.000Z
- Description: 通过Vertex AI运行Claude Code，你可以使用IAM管理访问，使用现有凭据进行身份验证，将计费合并到你的Google Cloud账户下，并应用与任何其他GCP服务相同的合规和审计控制。
- Author: admin
- Tags: AGENT, CLAUDE CODE, #Import 2026-10-14 14:41

作为我工作的一部分，我大量使用Google AI开发工具，如Gemini Code Assist、Gemini CLI和Antigravity，来帮助我们的客户充分利用这些工具。

最近在Google Cloud客户中出现的一个使用场景是通过Vertex AI使用Claude Code，这样做的一些原因是：

- 通过Google Cloud的企业基础设施使用Claude模型
- 利用现有的Google Cloud额度和计费
- 受益于Google Cloud的合规和安全特性
- 将所有内容保持在组织的GCP环境内

Anthropic模型可以通过[Vertex AI Model Garden](https://docs.cloud.google.com/vertex-ai/generative-ai/docs/model-garden/explore-models?ref=hubwiz.com)获取，这是Google Cloud中来自Google和第三方提供商的基础模型目录。Model Garden提供了一个单一位置来发现、测试和部署模型，包括Anthropic的Claude家族，直接在你的GCP项目内。通过Model Garden访问的模型在Google Cloud基础设施上提供服务，并与IAM、计费和Cloud Logging等标准GCP服务集成。

由于Anthropic最近还在Claude Code中提供了`/setup-vertex`向导，使这个设置更加简单，我想分享一个关于如何配置Claude Code使用来自Vertex AI Model Garden的Anthropic模型的快速指南。

在开始之前，确保你有：

- 一个启用了计费的Google Cloud账户
- 创建项目和启用API的适当IAM权限
- 在你的机器上安装了Claude Code（[从Anthropic下载](https://docs.anthropic.com/claude-code?ref=hubwiz.com)）
- 安装并配置了gcloud CLI

## 1、Google Cloud设置

### 步骤1：创建或选择Google Cloud项目

首先，创建一个新项目或选择一个现有项目：

```
# 创建一个新项目
gcloud projects create claude-code-project --name="Claude Code"

# 将其设置为你的活动项目
gcloud config set project claude-code-project

```

### 步骤2：启用必需的API

启用Vertex AI API和相关服务：

```
# 启用Vertex AI API
gcloud services enable aiplatform.googleapis.com

# 启用其他必需的API
gcloud services enable cloudresourcemanager.googleapis.com
gcloud services enable serviceusage.googleapis.com

```

### 步骤3：请求Claude模型访问权限

1. 在Google Cloud控制台中导航到[Vertex AI Model Garden](https://console.cloud.google.com/vertex-ai/model-garden?ref=hubwiz.com)
2. 在模型目录中搜索"Claude"
3. 选择你想使用的Claude模型（例如Claude Sonnet 4.5）
4. 点击"启用"并填写请求表单

![None](https://www.hubwiz.com/blog/content/images/2026/05/1-9YJ0Z8pzQ-Xh3fUJ5oiG3A.png)

为了给Claude Code最大的灵活性，你可能至少需要启用Claude Sonnet（Claude Code的主要模型）和Claude Code使用的Claude Haiku的默认版本（撰写本文时为4.5）。没有Haiku，Claude Code会尝试对所有操作使用Sonnet，这对简单操作来说更慢且更昂贵。没有Sonnet，Claude Code将没有主要模型，可能根本无法启动。

我的建议是也启用Opus，这样你在需要处理更复杂的任务时可以使用它。

### 步骤4：设置身份验证

Google Cloud提供多种访问Vertex AI的身份验证方法，你可以在开发者工作站上本地运行的Claude Code中使用的通常是：

- 应用默认凭据（ADC）
- API密钥（服务账户绑定的）
- 服务账户密钥文件

在这个例子中，我将使用ADC，因为简而言之，它是最安全的，也更容易实现，因为不需要服务账户或API密钥：

```
# 使用你的Google Cloud账户进行身份验证
gcloud auth application-default login

# 授予你的用户账户Vertex AI用户角色
gcloud projects add-iam-policy-binding claude-code-project \
    --member="user:YOUR_EMAIL@example.com" \
    --role="roles/aiplatform.user"

```

## 2、Claude Code配置

### 步骤5：使用/setup-vertex向导配置Claude Code

从**Claude Code v2.1.98**开始，Claude Code包含一个内置的交互式设置向导，可以自动化整个Vertex AI配置。这是大多数用户的**推荐方法**。

- **首次设置：** 你需要设置一个环境变量来切换Vertex集成，这样Claude Code就不会尝试直接向Anthropic进行身份验证，你可以临时为一次会话设置：

```
export CLAUDE_CODE_USE_VERTEX=1

```

- **启动Claude Code：**

```
claude

```

- **一旦聊天启动，输入：**

```
/setup-vertex

```

- **向导会要求你选择身份验证方法，选择ADC：**

![None](https://www.hubwiz.com/blog/content/images/2026/05/1-lb3AcJuZaCI78JJ8qlUsEg.png)

- **向导会要求你选择一个Google Cloud项目，默认为你的gcloud配置中的项目：**

![None](https://www.hubwiz.com/blog/content/images/2026/05/1-YItf7KtQ1qVChch-UdjVpA.png)

- **接下来，它会要求你选择一个区域：**

![None](https://www.hubwiz.com/blog/content/images/2026/05/1-CuUHuIToDV8C5QZ-kwY1CA.png)

- **然后它会检查默认模型是否已启用，它会从Haiku开始，然后也测试Sonnet和Opus（至少在撰写本文时）。**

![None](https://www.hubwiz.com/blog/content/images/2026/05/1-4jzZ0GjXtiomsvDxIY0ikQ.png)

- 如上所述，我的建议是在Vertex AI Model Garden中启用所有3个模型，这样Claude就有使用Haiku处理简单任务的灵活性，你也可以在需要时手动利用Opus。
- 然后你必须选择是固定工作模型还是使用Claude Code默认模型。使用前者可以避免Claude Code想要使用一个新模型而该模型在Model Garden中未启用时出现错误。
- 最后一步是你的设置摘要和确认保存：

![None](https://www.hubwiz.com/blog/content/images/2026/05/1-9INqiXj3EeCZs08DmsahJw.png)

Claude Code重启后，你将能够利用Vertex AI使用它。

通过Vertex AI运行Claude Code，你可以使用IAM管理访问，使用现有凭据进行身份验证，将计费合并到你的Google Cloud账户下，并应用与任何其他GCP服务相同的合规和审计控制。此设置使团队能够将Claude Code作为开发工具采用，而无需引入单独的凭据系统或计费关系。本指南中的配置步骤应该能让你快速上手一个自然融入标准Google Cloud工作流程的设置。

---

原文链接：[Set up Claude Code with Vertex AI](https://freedium-mirror.cfd/https://medium.com/google-cloud/set-up-claude-code-with-vertex-ai-8e1c9d1c9a69?ref=hubwiz.com)

汇智网翻译整理，转载请标明出处

> **这是「AI 编程 / Vibe Coding」专题的一部分。**完整地图见：[AI 编程 / Vibe Coding 完全指南](https://www.hubwiz.com/blog/vibe-coding-stack/)