# 使用 Vertex AI

> 配置项目与区域，选择 ADC、服务账号 JSON 或 Google Cloud API key。

- 网址：https://funcoding.ai/agents/gemini-cli/getting-started/vertex-ai/
- 核实日期：2026-10-08（命令、配置和价格以官方文档为准）
- 官方来源：[Gemini CLI 官方文档：Authentication](https://geminicli.com/docs/get-started/authentication)

---
Vertex AI 认证都需要启用了 Vertex AI API 的 Google Cloud 项目，以及资源或任务运行区域：

```bash
export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
export GOOGLE_CLOUD_LOCATION="YOUR_PROJECT_LOCATION"
```

PowerShell 用 `$env:GOOGLE_CLOUD_PROJECT` 和 `$env:GOOGLE_CLOUD_LOCATION` 赋值。不要把 AI Studio 的 `GEMINI_API_KEY` 与 Google Cloud 的 `GOOGLE_API_KEY` 混为同一个后端凭据。

## ADC

已安装 Google Cloud CLI 时可用 Application Default Credentials。先清除会干扰选择的 API key：

```bash
unset GOOGLE_API_KEY GEMINI_API_KEY
gcloud auth application-default login
gemini
```

然后选择 **Vertex AI**。Windows 清除变量的官方方式是：

```powershell
Remove-Item Env:\GOOGLE_API_KEY, Env:\GEMINI_API_KEY -ErrorAction Ignore
```

## 服务账号 JSON

适用于非交互、CI 或限制用户认证的组织。创建服务账号并分配 Vertex AI User 角色，下载 JSON 后，清除前述两个 API key 变量，并指向文件绝对路径：

```bash
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/keyfile.json"
gemini
```

启动时选择 Vertex AI，项目与区域仍需设置。JSON 文件本身是凭据，应由 CI/组织的秘密管理机制保管，不能作为仓库配置提交。

## Cloud API key

取得 Google Cloud API key 后设置：

```bash
export GOOGLE_API_KEY="YOUR_GOOGLE_API_KEY"
gemini
```

选择 Vertex AI。如果出现 API keys are not supported by this API，可能是组织限制该服务使用 key，按管理员允许的 ADC 或服务账号方式配置，而非反复更换模型名。