驗證設定

Gemini CLI 需要您向 Google 的 AI 服務進行驗證。首次啟動時，您需要設定下列其中一種驗證方法：

使用 Google 帳戶登入 (Gemini Code Assist)：
- 使用此選項以您的 Google 帳戶登入。
- 首次啟動時，Gemini CLI 會將您導向一個網頁進行驗證。驗證完成後，您的憑證將會被快取在本地，以便後續執行時可以跳過網頁登入。
- 請注意，網頁登入必須在能夠與執行 Gemini CLI 的機器進行通訊的瀏覽器中完成。(具體來說，瀏覽器將被重新導向到 Gemini CLI 正在監聽的 localhost url)。
- 在下列情況下，使用者可能需要指定 GOOGLE_CLOUD_PROJECT：
  1. 您擁有 Google Workspace 帳戶。Google Workspace 是一項付費服務，為企業和組織提供一套生產力工具，包括自訂電子郵件網域 (例如 your-name@your-company.com)、增強的安全性功能和管理控制。這些帳戶通常由雇主或學校管理。
  2. 您已透過 Google 開發者計畫 (包括合格的 Google 開發者專家) 獲得免費的 Code Assist 授權。
  3. 您已被指派目前 Gemini Code Assist 標準版或企業版訂閱的授權。
  4. 您在免費個人使用的支援地區之外使用本產品。
  5. 您是未滿 18 歲的 Google 帳戶持有人。
  - 如果您屬於上述任何一種類別，您必須先設定要使用的 Google Cloud 專案 ID，啟用 Gemini for Cloud API 並設定存取權限。
  您可以使用下列指令在目前的 shell 工作階段中暫時設定環境變數：
```
export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
```
  - 若要重複使用，您可以將環境變數新增至您的 .env 檔案或 shell 的設定檔 (例如 ~/.bashrc、~/.zshrc 或 ~/.profile)。例如，下列指令會將環境變數新增至 ~/.bashrc 檔案：
```
echo 'export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"' >> ~/.bashrc
source ~/.bashrc
```
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
```
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" # 例如 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

使用 `.env` 檔案保存環境變數

您可以在專案目錄或主目錄中建立一個 .gemini/.env 檔案。建立一個純文字的 .env 檔案也可以，但建議使用 .gemini/.env 以將 Gemini 變數與其他工具隔離。

Gemini CLI 會使用下列搜尋順序，自動從找到的第一個 .env 檔案載入環境變數：

從目前目錄開始，向上移動至 /，針對每個目錄檢查：
1. .gemini/.env
2. .env
如果找不到檔案，則會退回到您的主目錄：
- ~/.gemini/.env
- ~/.env

重要事項：搜尋會在遇到第一個檔案時停止——變數不會在多個檔案之間合併。

範例

專案特定覆寫 (當您在專案內部時優先)：

mkdir -p .gemini
echo 'GOOGLE_CLOUD_PROJECT="your-project-id"' >> .gemini/.env

使用者全域設定 (在每個目錄中都可用)：

mkdir -p ~/.gemini
cat >> ~/.gemini/.env <<'EOF'
GOOGLE_CLOUD_PROJECT="your-project-id"
GEMINI_API_KEY="your-gemini-api-key"
EOF

驗證設定

使用 .env 檔案保存環境變數

範例

使用 `.env` 檔案保存環境變數