cli/authentication - Gemini CLI 文档

身份验证设置

Gemini CLI 要求您向 Google 的 AI 服务进行身份验证。在首次启动时，您需要配置以下一种身份验证方法：

使用 Google 登录 (Gemini Code Assist):
- 使用此选项可使用您用于 Gmail、Google 相册和 Google 云端硬盘等个人服务的标准个人帐户登录（例如 your-name@gmail.com）。
- 在首次启动期间，Gemini CLI 会将您定向到一个网页进行身份验证。身份验证后，您的凭据将缓存在本地，以便在后续运行时可以跳过网页登录。
- 请注意，网页登录必须在可以与运行 Gemini CLI 的计算机通信的浏览器中完成。（具体来说，浏览器将被重定向到 Gemini CLI 将侦听的 localhost URL）。
Gemini API 密钥:
- 从 Google AI Studio 获取您的 API 密钥：https://aistudio.google.com/app/apikey
- 设置 GEMINI_API_KEY 环境变量。在以下方法中，将 YOUR_GEMINI_API_KEY 替换为您从 Google AI Studio 获取的 API 密钥：
  - 您可以使用以下命令在当前 shell 会话中临时设置环境变量：
```
export GEMINI_API_KEY="YOUR_GEMINI_API_KEY"
```
  - 要重复使用，您可以将环境变量添加到您的 .env 文件（位于项目目录或用户主目录中）或您的 shell 配置文件（如 ~/.bashrc、~/.zshrc 或 ~/.profile）中。例如，以下命令将环境变量添加到 ~/.bashrc 文件中：
```
echo 'export GEMINI_API_KEY="YOUR_GEMINI_API_KEY"' >> ~/.bashrc
source ~/.bashrc
```
使用 Google Workspace 登录
- 使用此选项可使用 Google Workspace 帐户登录。这是一项面向企业和组织的付费服务，提供一套生产力工具，包括自定义电子邮件域（例如 your-name@your-company.com）、增强的安全功能和管理控制。这些帐户通常由雇主或学校管理。
  - Google Workspace 帐户必须首先配置要使用的 Google Cloud 项目 ID，启用 Gemini for Cloud API 并配置访问权限。您可以使用以下命令在当前 shell 会话中临时设置环境变量：
```
export GOOGLE_CLOUD_PROJECT_ID="YOUR_PROJECT_ID"
```
  - 要重复使用，您可以将环境变量添加到您的 .env 文件（位于项目目录或用户主目录中）或您的 shell 配置文件（如 ~/.bashrc、~/.zshrc 或 ~/.profile）中。例如，以下命令将环境变量添加到 ~/.bashrc 文件中：
```
echo 'export GOOGLE_CLOUD_PROJECT_ID="YOUR_PROJECT_ID"' >> ~/.bashrc
source ~/.bashrc
```
- 启动期间，Gemini CLI 会将您定向到一个网页进行身份验证。身份验证后，您的凭据将缓存在本地，以便在后续运行时可以跳过网页登录。
- 请注意，网页登录必须在可以与运行 Gemini CLI 的计算机通信的浏览器中完成。（具体来说，浏览器将被重定向到 Gemini CLI 将侦听的 localhost URL）。
Vertex AI:
- 如果不使用快速模式：
  - 确保您拥有一个 Google Cloud 项目并已启用 Vertex AI API。
  - 使用以下命令设置应用程序默认凭据 (ADC)：
```
gcloud auth application-default login
```
    有关更多信息，请参阅为 Google Cloud 设置应用程序默认凭据。
  - 设置 GOOGLE_CLOUD_PROJECT、GOOGLE_CLOUD_LOCATION 和 GOOGLE_GENAI_USE_VERTEXAI 环境变量。在以下方法中，将 YOUR_PROJECT_ID 和 YOUR_PROJECT_LOCATION 替换为您的项目的相关值：
    - 您可以使用以下命令在当前 shell 会话中临时设置这些环境变量：
```
export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
export GOOGLE_CLOUD_LOCATION="YOUR_PROJECT_LOCATION" # e.g., us-central1
export GOOGLE_GENAI_USE_VERTEXAI=true
```
    - 要重复使用，您可以将环境变量添加到您的 .env 文件（位于项目目录或用户主目录中）或您的 shell 配置文件（如 ~/.bashrc、~/.zshrc 或 ~/.profile）中。例如，以下命令将环境变量添加到 ~/.bashrc 文件中：
```
echo 'export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"' >> ~/.bashrc
echo 'export GOOGLE_CLOUD_LOCATION="YOUR_PROJECT_LOCATION"' >> ~/.bashrc
echo 'export GOOGLE_GENAI_USE_VERTEXAI=true' >> ~/.bashrc
source ~/.bashrc
```
- 如果使用快速模式：
  - 设置 GOOGLE_API_KEY 环境变量。在以下方法中，将 YOUR_GOOGLE_API_KEY 替换为快速模式提供的 Vertex AI API 密钥：
    - 您可以使用以下命令在当前 shell 会话中临时设置这些环境变量：
```
export GOOGLE_API_KEY="YOUR_GOOGLE_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true
```
    - 要重复使用，您可以将环境变量添加到您的 .env 文件（位于项目目录或用户主目录中）或您的 shell 配置文件（如 ~/.bashrc、~/.zshrc 或 ~/.profile）中。例如，以下命令将环境变量添加到 ~/.bashrc 文件中：
```
echo 'export GOOGLE_API_KEY="YOUR_GOOGLE_API_KEY"' >> ~/.bashrc
echo 'export GOOGLE_GENAI_USE_VERTEXAI=true' >> ~/.bashrc
source ~/.bashrc
```