Gemini CLI 免費教學｜取代 Claude Code 的最強 AI 終端助理（2026最新）

Gemini CLI 免費教學是 2026 年 AI 工程師最值得學習的技能之一。在 Claude Code 訂閱費用不斷上漲的今天，Google 推出的 Gemini CLI 提供完全免費的 Gemini 2.0 Flash 模型，讓你可以直接在終端機與 AI 對話、執行程式碼、分析檔案，甚至取代昂貴的 AI 開發工具。這篇文章將從零開始教你安裝、設定、使用 Gemini CLI，並透過實戰案例讓你立刻上手，真正體驗「免費但不妥協」的 AI 助理威力。

什麼是 Gemini CLI？為什麼 2026 年 AI 工程師都在用（預計 3 分鐘）

Gemini CLI 是 Google 官方推出的命令列工具，讓你可以直接在終端機（Terminal）呼叫 Gemini 2.0 Flash、Gemini 2.5 Pro 等 AI 模型。不需要打開瀏覽器、不需要複製貼上，只要一行指令就能讓 AI 幫你寫程式、解釋錯誤訊息、分析日誌檔、甚至翻譯文件。

對比 Claude Code 每月 20 美元的訂閱費用，Gemini CLI 使用 Gemini 2.0 Flash 模型是完全免費的，而且速度極快（平均回應時間 <2 秒），支援繁體中文輸出，並且可以與你的本地檔案系統整合。

為什麼 2026 年 AI 工程師都在用 Gemini CLI？

• 完全免費：Gemini 2.0 Flash 無用量限制，不需綁定信用卡
• 速度極快：回應時間比 ChatGPT 快 3-5 倍
• 終端整合：直接在 Terminal 執行，不需切換視窗
• 多模態支援：可以分析圖片、PDF、程式碼檔案
• 中文友善：支援繁體中文輸入與輸出
• 開發者優先：專為程式設計師設計，支援 Markdown、JSON 輸出格式

Gemini CLI 完整安裝教學（macOS / Windows）

依照你的作業系統選擇安裝方式，完整步驟如下：

🍎 macOS 安裝步驟

1. 鍵盤按住 Command + 空白鍵，出現 Spotlight 搜尋列，輸入「終端機」，連按 2 下 Enter
2. 在終端機畫面，將以下指令貼到 ~ % 符號後面並按 Enter：

   brew install gemini-cli

   安裝完成後會回到 ~ % 符號，即可繼續輸入指令
   （~ 代表 /Users/你的帳號/，% 代表系統已準備好接受指令）

3. 驗證安裝成功，貼上以下指令，出現版本號（例如 0.38.2）即確認完成：

   gemini --version

4. 登入 Google 帳號，貼上以下指令後照畫面指示完成授權：

   gemini auth login

   若達到免費額度上限，連按 Ctrl + C 可離開回到 ~ %

5. （進階）改用免費 API Key：先執行登出，再切換認證方式

   gemini auth logout

   登出後輸入 /auth，用鍵盤上下鍵選擇「Use Gemini API Key」，貼上你在 Google AI Studio 申請的免費 API Key 即可

🪟 Windows 安裝步驟

1. 安裝 Node.js 環境：以系統管理員身分開啟 PowerShell，貼上以下指令並選擇「是」：

   winget install OpenJS.NodeJS.LTS

   安裝完後貼上 node -v，出現版本號代表環境就緒

2. 安裝 Gemini CLI：

   npm install -g @google/gemini-cli

   安裝完後直接輸入 gemini 啟動

3. 選擇信任層級（非常重要！）：啟動後用鍵盤上下鍵選擇：
   ✅ 選 1. Trust folder（建議）：只允許 AI 存取當前資料夾，最安全
   ❌ 不要選 2. Trust parent folder (Users)：權限過高，會讓 AI 存取整個使用者目錄
4. 建議先建立專屬資料夾再啟動（像 Claude Code 的使用方式）：

   mkdir my_project
   cd my_project
   gemini

   在此資料夾選 Trust folder，AI 就成為這個專案的專屬管家

5. 選擇登入方式：
   • 1. Sign in with Google（最推薦）：像登入 Gmail 一樣簡單
   • 2. Use Gemini API Key：適合有 Google AI Studio 金鑰的開發者
   • 3. Vertex AI：企業用，一般人跳過
6. 正式登入：確認選中「Sign in with Google」→ Enter → 選「Yes」→ 瀏覽器選帳號點「允許」→ 看到 Authentication Successful → 按 R 鍵重啟載入登入資訊

Gemini CLI 第一次啟動與 Google 帳號登入（預計 3 分鐘）

安裝完成後，第一次使用 Gemini CLI 需要進行 Google 帳號授權。這是一次性操作，完成後就能隨時使用。

步驟 1：執行登入指令

gemini auth login

步驟 2：瀏覽器授權

系統自動開啟瀏覽器 → 選擇 Google 帳號 → 點擊「允許」→ 回到終端機。

步驟 3：測試第一個指令

gemini "請用繁體中文介紹自己"

gemini --model gemini-2.0-flash "請用繁體中文說明你可以幫我做什麼？"

Gemini CLI 核心指令大全（預計 8 分鐘）

掌握以下核心指令，就能發揮 Gemini CLI 90% 的功能：

基本對話指令

# 基本問答
gemini "你的問題"

# 指定模型
gemini --model gemini-2.5-pro "複雜的問題"

# 輸出為 JSON 格式
gemini --format json "請列出 Python 虛擬環境建立步驟"

# 輸出為 Markdown 格式
gemini --format markdown "請寫一個 README.md 範本"

檔案分析指令

# 分析程式碼檔案
gemini --file app.py "這段程式碼有什麼問題？"

# 分析圖片
gemini --file screenshot.png "這個截圖顯示什麼錯誤？"

# 分析 PDF 文件
gemini --file report.pdf "請摘要這份報告的重點"

Gemini CLI 核心指令 ASCII 表

Gemini CLI vs Claude Code 完整比較表（預計 5 分鐘）

許多開發者在考慮是否從 Claude Code 轉換到 Gemini CLI。以下是兩者在 8 個關鍵面向的詳細比較：

Gemini CLI 實戰案例：5 個讓你馬上省時的使用場景（預計 10 分鐘）

案例 1：快速除錯錯誤訊息（省時 70%）

# 直接把錯誤訊息傳給 Gemini
python app.py 2>&1 | gemini "這個錯誤要怎麼修？請用繁體中文回答"

# 分析錯誤日誌檔
gemini --file error.log "請找出最關鍵的 3 個錯誤並提供解決方案"

實測效果：原本 5-10 分鐘的 Google 搜尋，現在 30 秒內得到答案。

案例 2：自動生成 Git Commit 訊息（省時 50%）

# 根據 git diff 生成 commit 訊息
git diff | gemini "請根據這些程式碼變更，寫一個簡潔的英文 commit 訊息"

案例 3：批次重新命名檔案（省時 90%）

# 生成批次重新命名的 Bash 腳本
gemini "請寫一個 Bash 腳本，把目前目錄下所有 .jpg 重新命名為 photo_001.jpg 格式" > rename.sh
bash rename.sh

案例 4：快速生成測試資料（省時 80%）

# 生成 100 筆使用者測試資料
gemini --format json "請生成 100 筆測試用使用者資料（姓名/Email/年齡/城市），輸出為 JSON" > users.json

案例 5：分析伺服器日誌找出異常（省時 95%）

# 分析 Nginx 日誌
gemini --file /var/log/nginx/error.log "請列出前 10 個最常出現的錯誤類型，並統計次數"

alias ask="gemini --model gemini-2.0-flash"
alias askpro="gemini --model gemini-2.5-pro"
alias analyze="gemini --file"

Gemini CLI 進階設定（中文輸出、API Key 自訂）（預計 6 分鐘）

設定 1：強制繁體中文輸出

建立設定檔 ~/.gemini/config.yaml：

default_model: gemini-2.0-flash
language: zh-TW
system_prompt: "請一律使用繁體中文回答，除非使用者明確要求其他語言。"
temperature: 0.7
max_tokens: 2048
stream: true
format: markdown

設定 2：使用自己的 API Key（突破免費限制）

1. 前往 Google AI Studio 申請免費 API Key
2. 執行：export GEMINI_API_KEY="你的API Key"
3. 永久設定：echo 'export GEMINI_API_KEY="KEY"' >> ~/.bashrc

設定後呼叫額度提升至每分鐘 1500 次（免費方案）。

常見錯誤與解決方法（預計 4 分鐘）

❌ command not found: gemini

export PATH="$HOME/.local/bin:$PATH"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

❌ Authentication failed

gemini auth logout && gemini cache clear && gemini auth login

❌ Rate limit exceeded

等待 60 秒後重試，或申請自己的 API Key 提升至 1500 次/分鐘。

❌ 回答中斷或不完整

gemini --max-tokens 4096 "你的長問題"
# 或切換到 Pro 模型
gemini --model gemini-2.5-pro "你的長問題"

FAQ 常見問題

專注於 AI 工具實戰教學，每週更新最新 AI 技術應用。網站：AI 教學基地

每組序號第一裝置限一用・不可轉讓或分享