# Gemini CLI

來源: https://docs.aicentos.com/zh-TW/clients/gemini-cli

Language: zh-TW

> 在 Gemini CLI 中使用 aicentos —— 透過環境變數設定自訂閘道

Gemini CLI 是 Google 官方推出的命令列工具，支援透過環境變數設定自訂閘道來接入 Codex Proxy 服務，在終端機中與 Gemini 模型進行互動對話。

## 準備工作

Gemini CLI 透過 npm 全域安裝，需要先準備好 Node.js 18+ 和 npm 環境。

### 安裝 Node.js

* 前往 Node.js 官網下載頁面：[https://nodejs.org/en/download](https://nodejs.org/en/download)
* macOS/Windows：下載並安裝 LTS 版本
* Linux：依頁面提供的發行版方式安裝
* macOS（Homebrew 使用者）：執行 `brew install node`

### 驗證安裝

```bash
node -v
npm -v
```

## 安裝 Gemini CLI

使用 npm 全域安裝 Gemini CLI：

```bash
npm install -g @google/gemini-cli
```

驗證安裝：

```bash
gemini --version
```

## 設定環境變數

Gemini CLI 支援透過以下三個環境變數接入自訂閘道：

| 環境變數                     | 說明                     |
| ------------------------ | ---------------------- |
| `GOOGLE_GEMINI_BASE_URL` | 閘道服務根位址，替換 Google 預設端點 |
| `GEMINI_API_KEY`         | 你的 API Key             |
| `GEMINI_MODEL`           | 預設使用的模型                |

### 設定範例

```bash
export GOOGLE_GEMINI_BASE_URL="https://aicentos.com"
export GEMINI_API_KEY="your_api_key_here"
export GEMINI_MODEL="gemini-2.0-flash"
```

### 注意事項

* `GOOGLE_GEMINI_BASE_URL` 填寫服務根位址，不需要帶具體介面路徑
* 臨時測試：直接在目前 shell 工作階段中執行上述 export 指令
* 永久生效：將 export 語句加入 `~/.zshrc` 或 `~/.bashrc`，然後執行 `source ~/.zshrc` 使其生效

## 啟動 Gemini CLI

設定完成後，直接執行以下指令啟動：

```bash
gemini
```

啟動後即可在終端機中與 Gemini 模型進行互動對話。

## 驗證接入

在 Gemini CLI 中發起一次對話，如果能正常收到回覆，表示接入成功。

### 常見問題排查

* 如果遇到驗證錯誤，請確認 `GEMINI_API_KEY` 是否正確
* 檢查 `GOOGLE_GEMINI_BASE_URL` 是否指向正確的服務位址

## 注意事項

* 目前服務已支援 Gemini 相容介面，可直接用於 Gemini CLI
* 環境變數設定建議加入 shell 設定檔以實現永久生效
* Gemini CLI 會自動串接 API 路徑，無需在 BASE\_URL 中加入具體介面路徑

## 相關連結

* 官方文件：[https://docs.aicentos.com/clients/gemini-cli.html](https://docs.aicentos.com/clients/gemini-cli.html)