Claude Code on Google Vertex AI

前置条件

在使用 Vertex AI 配置 Claude Code 之前，请确保您拥有：

• 启用了 Vertex AI 的 Google Cloud 项目
• 具有适当权限的服务账户或用户账户
• 访问 Claude 模型的权限

区域配置

Claude Code 可以与 Vertex AI 全局和区域端点一起使用。

设置

1. 启用 Vertex AI API

在您的 GCP 项目中启用 Vertex AI API：

gcloud services enable aiplatform.googleapis.com

2. 请求模型访问权限

1. 导航到 Vertex AI Model Garden
2. 搜索"Claude"模型
3. 请求访问所需的 Claude 模型
4. 等待批准（可能需要 24-48 小时）

3. 配置 GCP 凭证

Claude Code 使用标准的 Google Cloud 身份验证：

gcloud auth application-default login

4. 配置 Claude Code

设置以下环境变量：

export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

5. 模型配置

Claude Code 为 Vertex AI 使用这些默认模型：

模型类型	默认值
主要模型	claude-sonnet-4-5@20250929
小型/快速模型	claude-haiku-4-5@20251001

要自定义模型：

export ANTHROPIC_MODEL=claude-sonnet-4-5@20250929

IAM 配置

分配所需的 IAM 权限：

roles/aiplatform.user 角色包括所需的权限：

• aiplatform.endpoints.predict

对于更严格的权限，请创建仅包含上述权限的自定义角色。

100 万令牌上下文窗口

Claude Sonnet 4 和 Sonnet 4.5 在 Vertex AI 上支持 100 万令牌上下文窗口。

故障排除

如果遇到配额问题：

• 检查您的项目配额
• 请求增加配额

如果遇到"模型未找到"404 错误：

• 确保您已请求并获得模型访问权限
• 检查区域设置是否正确

如果遇到 429 错误：

• 这通常表示速率限制
• 等待一段时间后重试