# **Gemini CLI 安裝教學**

### **Gemini CLI 是什麼？**
Gemini CLI 這一兩個月很紅的「開發者工具」
它讓使用者可以透過文字指令，在終端機（Terminal 或 Command Prompt）裡直接跟Google Gemini AI模型互動。現在一方面透過C語言學習程式設計，一方面也想跟上AI的應用，對即將要進入高中的我要學的東西真的很多。這裡就把自己這幾天設定安裝在Win11上可以執行Gemini CLI的方式整理如下。

## 第一步 : 安裝 Node.js
### 為什麼執行 Gemini CLI 需要安裝 Node.js？

Node.js 是一個能讓你在電腦上執行 JavaScript 的環境，不只是瀏覽器能跑 JavaScript，Node.js 讓你可以用 JavaScript 來寫後端程式、開發工具和命令列工具。

它的特點是快速、輕量，適合做伺服器、CLI 工具、API 或像 Gemini CLI 這種命令列應用程式。

簡單說：**Gemini CLI 是一個基於 Node.js 的工具，所以你必須先安裝 Node.js。**

### 安裝教學

1. 前往官方網站： [https://nodejs.org](https://nodejs.org)
2. 點選「最新版本（LTS）」並下載
3. 安裝過程一路按「下一步」即可
4. 記得勾選「**Add to PATH**」選項

#### 安裝畫面參考：

點選下載

一直按下一步即可

### 驗證是否安裝成功

開啟你的終端機（Terminal / CMD / PowerShell）輸入：

node -v
npm -v

若看到版本號，表示安裝成功：

v20.11.1
10.2.4

畫面會像這樣：

---

## 第二步 : 安裝 Gemini CLI

接著，我們要用 npm 安裝官方的 Gemini CLI。

輸入以下指令：

npm install -g @google/gemini-cli

這條指令會全域安裝 `gemini` 指令，之後你就可以在任何地方打 `gemini` 啟動 Gemini 對話介面。

安裝畫面範例：

### 驗證是否安裝成功

輸入：

gemini --version

若成功會看到類似：

v0.x.x

---

## 第三步 : 登入 Gemini CLI（兩種方式）

你有兩種方式登入 Gemini CLI：

### 方法一：使用 Google 帳號登入（推薦）

gemini login

這會開啟 Google 登入頁面，登入你的 Google 帳號。

登入畫面如下：

登入成功後，終端機會顯示：

✔ Successfully authenticated as [e-mail]


> 若你使用個人 Gmail 但出現 `This account requires setting the GOOGLE_CLOUD_PROJECT` 的錯誤。
>### 我用的是個人 Gmail，但登入時出現 `GOOGLE_CLOUD_PROJECT` 錯誤怎麼辦？
>這代表你的 Gmail 帳號「曾經被加入 Google Cloud 專案或 Workspace 組織中」，Gemini >CLI 會要求你設定 `GOOGLE_CLOUD_PROJECT`。
>#### 解法：設定環境變數 `GOOGLE_CLOUD_PROJECT`
>1. 到 [Google Cloud Console](https://console.cloud.google.com/projectcreate) 建立新專案
>2. 記下專案 ID（例如：`gemini-cli-test-1234`）
>3. 在終端機設定環境變數：
> * macOS/Linux：
> ```bash
> export GOOGLE_CLOUD_PROJECT=你的專案ID
> ```
>* Windows PowerShell：
>
> ```powershell
>$env:GOOGLE_CLOUD_PROJECT="你的專案ID"
>```
>4. 然後重新執行 `gemini login`

---

>### 執行 `gemini` 指令時出現「因為執行政策」錯誤？
>如果你在 PowerShell 中看到錯誤訊息像這樣：
>```
>因為這個系統上已停用指令碼執行，所以無法載入 gemini.ps1 檔案
>```
>這是 PowerShell 的「執行政策」阻擋了指令碼的執行。
>#### 解法：
>1. 以「系統管理員身分」開啟 PowerShell
>2. 執行以下指令：
>```powershell
>Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
>```
>3. 出現提示請輸入 `Y` 並按 Enter
>4. 再執行一次：
>```powershell
>gemini
>```

### 方法二：使用 Gemini API 金鑰登入

1. 前往取得 key：[https://makersuite.google.com/app/apikey](https://makersuite.google.com/app/apikey)
2. 複製你產生的金鑰
3. 回到終端機輸入：

gemini login --api-key=你的API金鑰

---

## 第四步 : 開始與 Gemini 對話

輸入：

gemini

你會看到互動式的 CLI 介面，像這樣：

就能成功啟動 Gemini CLI 了！

---

## CLI 常用功能與指令

以下為 Gemini CLI 常用的指令：

| 指令 | 說明 |
| -------- | ---------------------- |
| `/help` | 顯示所有支援的指令 |
| `/exit` | 離開 CLI |
| `/clear` | 清除對話紀錄 |
| `↑ / ↓` | 切換歷史對話紀錄 |
| `!` | 執行本機 Shell 指令，例如 `!ls` |

---

---