作为我工作的一部分，我大量使用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获取，这是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下载）
• 安装并配置了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
2. 在模型目录中搜索”Claude”
3. 选择你想使用的Claude模型（例如Claude Sonnet 4.5）
4. 点击”启用”并填写请求表单

为了给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：

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

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

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

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

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

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

原文链接：通过 Vertex AI 使用 Claude Code – 汇智网