Google Cloud 的 Agent Platform 上的 Claude Code

​

前置条件

• 启用了计费的 Google Cloud Platform (GCP) 账户
• 启用了 Google Cloud 的 Agent Platform API 的 GCP 项目
• 对所需 Claude 模型的访问权限（例如，Claude Sonnet 4.6）
• 已安装并配置的 Google Cloud SDK (gcloud)
• 在所需 GCP 区域中分配的配额

​

使用 Agent Platform 登录

​

区域配置

​

手动设置

​

1. 启用 Agent Platform API

# 设置您的项目 ID
gcloud config set project YOUR-PROJECT-ID

# 启用 Agent Platform API
gcloud services enable aiplatform.googleapis.com

​

2. 请求模型访问权限

1. 导航到 Google Cloud 的 Agent Platform Model Garden
2. 搜索”Claude”模型
3. 请求访问所需的 Claude 模型（例如，Claude Sonnet 4.6）
4. 等待批准（可能需要 24-48 小时）

​

3. 配置 GCP 凭证

​

高级凭证配置

{
  "gcpAuthRefresh": "gcloud auth application-default login",
  "env": {
    "ANTHROPIC_VERTEX_PROJECT_ID": "your-project-id"
  }
}

​

4. 配置 Claude Code

# 启用 Agent Platform 集成
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=global
export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID

# 可选：为自定义端点或网关覆盖 Agent Platform 端点 URL
# export ANTHROPIC_VERTEX_BASE_URL=https://aiplatform.googleapis.com

# 可选：如果需要，禁用 prompt caching
export DISABLE_PROMPT_CACHING=1

# 可选：请求 1 小时的 prompt cache TTL 而不是 5 分钟的默认值
export ENABLE_PROMPT_CACHING_1H=1

# 当 CLOUD_ML_REGION=global 时，为不支持全局端点的模型覆盖区域
export VERTEX_REGION_CLAUDE_HAIKU_4_5=us-east5
export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1

​

5. 固定模型版本

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-5'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5@20251001'

• 当您使用 --model、ANTHROPIC_MODEL 或 model 设置选择主模型时，后台任务使用该模型。设置 ANTHROPIC_DEFAULT_OPUS_MODEL 而不设置 ANTHROPIC_DEFAULT_SONNET_MODEL 也算作一个选择，因为内置的 Sonnet 模型可能在引导自己的 Opus 的项目中未启用。
• 要为后台任务使用 Haiku，请将 ANTHROPIC_DEFAULT_HAIKU_MODEL 设置为在您的项目中可用的模型 ID。

export ANTHROPIC_MODEL='claude-opus-4-8'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5@20251001'

​

启动模型检查

​

IAM 配置

• aiplatform.endpoints.predict - 模型调用和令牌计数所需

​

1M token context window

​

故障排除

• 运行 gcloud auth application-default login 来设置应用默认凭证
• 将 GOOGLE_APPLICATION_CREDENTIALS 设置为服务账户密钥文件路径
• 查看 配置 GCP 凭证 了解所有选项

• 通过 Cloud Console 检查当前配额或请求增加配额

• 确认模型在 Model Garden 中已启用
• 验证该模型在您指定的位置可用。某些模型仅在 global 或多区域位置（如 eu 和 us）上提供，而不是在特定区域
• 如果使用 CLOUD_ML_REGION=global，请检查您的模型是否在 Model Garden 中的”支持的功能”下支持全局端点。对于不支持全局端点的模型，请执行以下任一操作：
  • 通过 ANTHROPIC_MODEL 或 ANTHROPIC_DEFAULT_HAIKU_MODEL 指定支持的模型，或
  • 使用 VERTEX_REGION_<MODEL_NAME> 环境变量设置区域或多区域位置

• 对于区域端点，请确保主模型和小型/快速模型在您选择的区域中受支持
• 考虑切换到 CLOUD_ML_REGION=global 以获得更好的可用性

​

其他资源

• Google Cloud 的 Agent Platform 文档
• Google Cloud 的 Agent Platform 定价
• Google Cloud 的 Agent Platform 配额和限制