← 此頁是「第 7 章 · Vibe Coding 入門」第 8 節的獨立版本
第 7 章 · 附錄頁

Gemini CLI 實戰:把 AI 裝進 Windows

自動整理資料夾、整本手冊翻譯與 PPTX 自動製作,免費 Google 帳號可用

← 返回 第 7 章 ↑ 課程目錄
時效提醒(2026-06)  Google 宣布 Gemini CLI 與 Gemini Code Assist 的個人免費版,自 2026 年 6 月 18 日起停止服務,免費個人需改用 Antigravity(Google 的免費 AI 編輯器,內建 agent)。本附錄的觀念與操作仍可參考,但若你是免費個人帳號,請改以 Antigravity 為主要的免費工具,做法見第 7 章 §4 的免費路徑。
這份附錄收錄第 7 章 §8 的完整內容。Gemini CLI 是 Google 官方推出的免費 CLI(Command Line Interface,命令列介面,用打字下指令的方式操作電腦)替代品,免費 Gmail 帳號每天有額度可用。本節以 Windows 學員為主視角,從零裝起,做兩個實戰:自動整理資料夾、翻譯整本手冊做成 PPTX(PowerPoint 簡報檔的副檔名)
8

Gemini CLI 實戰:把 AI 裝進 Windows

Claude Code 對複雜任務的支援度最高,但需付費方案;Gemini CLI 是 Google 官方推出的免費替代品,免費 Gmail 帳號每天有額度可用,足以做日常自動化。本節以 Windows 學員為主視角,從零裝起,做兩個實戰:自動整理資料夾、翻譯整本手冊做成 PPTX(PowerPoint 簡報檔的格式)。

為什麼要從網頁版搬到 CLI?

長時間互動

跟模型長時間對話不怕網頁逾時、不怕對話被砍,跑半小時的長任務也沒問題。

平行多任務

同時開 3、4 個 PowerShell 視窗(每個視窗就是一個獨立的指令交談室),每個視窗各跑一個 Gemini,互不干擾。

本機檔案直接處理

檔案就在電腦裡,不怕斷線、不怕雲端毀損;AI 直接讀檔、改檔、產檔。

什麼是 CLI(命令列介面)?

把它想像成 Windows 命令提示字元 (cmd)Windows PowerShell,用「打字下指令」的方式跟電腦溝通。Mac 上叫終端機 (Terminal),本質上一樣。一個小玩笑:圖形介面流行幾十年後,我們又要回去用「下指令」跟 AI 互動了,因為這是讓 AI 能直接動電腦檔案最直接的管道。

Windows 5 步驟:把 Gemini CLI 裝起來

以下流程在 Windows 11 上實測過。Mac 學員的差異主要在第 2、3 步(不需要系統管理員、也不需要設執行原則),其他步驟通用。

裝 Node.js(一行 winget 搞定)

Gemini CLI 跑在 Node.js(一個讓 JavaScript 程式能在電腦上跑的執行環境,很多現代開發工具都靠它)上,所以先裝 Node.js。Windows 11 內建 winget(Windows 官方的軟體安裝小幫手,類似手機的 App Store),開「PowerShell(一般權限即可)」貼下面這行:

winget install OpenJS.NodeJS.LTS

裝完關掉 PowerShell 再重開(讓環境變數生效,環境變數是電腦記錄「哪裡可以找到哪個程式」的清單,剛裝的新軟體要重開視窗才會被認得),輸入 node -v 應該回傳版本號,例如 v20.x.x

以「系統管理員身分」開 PowerShell

按 Windows 鍵,輸入「powershell」,右鍵點「Windows PowerShell」→「以系統管理員身分執行」。標題列會顯示「系統管理員:Windows PowerShell」就對了。

Windows 沒有 sudo(Mac / Linux 上用來臨時取得系統管理權限的指令),「系管 PowerShell」就是它的等價物。Mac 用 sudo npm install 的地方,Windows 改成「先把 PowerShell 用系管權限開起來,再跑 npm install」。

排雷:開啟指令碼執行原則(最常見的卡關點!)

Windows 預設禁止跑第三方指令碼,全域(global,意思是「全電腦都能用」,不只在某個資料夾內)npm(Node.js 的程式套件管理工具,用來下載別人寫好的程式套件)安裝的 gemini 命令會被擋下。在系管 PowerShell 跑這行,允許目前使用者執行已簽署的遠端指令碼:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

跳出確認時按 Y 即可。Mac 沒有這一步,這是 Windows 純粹的內建限制。沒做的話,後面跑 gemini 會看到「無法載入指令碼,因為這個系統上已停用指令碼執行」,這就是元兇。

安裝 Gemini CLI

同樣在系管 PowerShell(下方指令的 -g 是「global 全域安裝」的縮寫,讓 gemini 指令在電腦的任何資料夾都能用):

npm install -g @google/gemini-cli

第一次裝會下載一些東西,等個 1 - 2 分鐘。完成後輸入 gemini --version 應該回傳版本號。

建立 AI 專屬工作資料夾,首次登入綁 Google 帳號

千萬不要C:\Users\你的名字(這就是 PowerShell 裡的 $HOME 路徑,下方指令會用到)直接跑 gemini,AI 會看見你電腦裡所有檔案。一定要先建一個專屬資料夾:

cd $HOME mkdir gemini-cli cd gemini-cli gemini

第一次啟動會跳出 4 個提示:

  • ① Trust this folder → 按 Enter(信任這個資料夾)
  • ② Sign in with Google → 選擇登入方式
  • ③ Browser 自動開啟 → 選你的 Gmail 帳號授權
  • ④ Press R → 回 PowerShell 按 R 重啟

看到 > 提示符就可以開始下中文指令了。介面是英文,但模型完全支援中文,先用問句測試:「你看到資料夾當中有哪些檔案?

Windows 學員常見排雷清單

「無法載入指令碼,因為這個系統上已停用指令碼執行」,沒跑步驟 3 的 Set-ExecutionPolicy。回頭跑就好。

npm install 跳出 EACCES 或 EPERM 權限錯誤(這兩個都是「沒權限」的英文錯誤代碼,EACCES 是 Error ACCESs 拒絕、EPERM 是 Error PERMission 不足),PowerShell 不是用系統管理員開的。關掉重開,記得「右鍵 → 以系統管理員身分執行」。

輸入 gemini 後 PowerShell 說「無法辨識為 cmdlet 的名稱」(cmdlet 唸作「command-let」,是 PowerShell 對「一個可執行指令」的稱呼),Node.js 裝完沒重開 PowerShell(環境變數沒生效)。完整關閉所有 PowerShell 視窗後重開。

免費 vs 付費:免費 Gmail 帳號每天有額度可用,做日常工具完全夠;額度用完可升級付費,或改用 API Key(呼叫 Google AI 服務的密鑰,等同密碼)在 ~/.gemini/settings.json(Gemini CLI 的設定檔,.json 是純文字格式的副檔名)中設定。

實戰一:自動整理資料夾(最有感的入門)

裝好 Gemini CLI 後,下面用兩個實戰熟悉操作。這是最常被分享的入門玩法:把家裡的「下載」資料夾複製一份到 gemini-cli 內(避免動到原檔),然後跟 Gemini 講中文:

兩段 Prompt 完成自動分類

讓 AI 寫 Python 自動分類你的雜亂檔案

第一段先做基本分類,第二段加上時間維度。Gemini 會自動寫 Python 腳本並執行,把檔案搬到對應子資料夾。

第 1 段:請幫我把這個資料夾裡面的檔案分類整理一下。 第 2 段(看完結果後追問):很好,現在請在每個分類資料夾當中,再依照檔案下載日期的「年-月」進行分類。

預期結果:資料夾會被分成 Document / Presentation / Image / Archive / Others,每個底下又分 2026-04、2026-05……。如果系統還沒裝 Python,Gemini 會提示你裝(winget install Python.Python.3.12 一行搞定)。

實戰二:翻譯整本手冊 + 自動做 PPTX

把要翻譯的 PDF 或 Word 檔丟進 gemini-cli 資料夾,三段 prompt 完成翻譯與美化。

三段 Prompt 完成翻譯與美化

把整本中文手冊翻成英文,並排版成 PPTX

分章執行,避免一次塞太大檔案;最後一段 prompt 專門做美化。

第 1 段:幫我把資料夾裡的「公部門人工智慧手冊.pdf」第一章翻譯成英文,給我 Word 格式(.docx,Microsoft Word 文件的副檔名)。 第 2 段:幫我把第二章翻譯成英文,然後做成 PPTX 簡報。 第 3 段:剛才這份 PPTX 太醜了,請幫我美化、有科技感一點,深藍配淺藍,每頁放一張示意圖位置即可。

進階:開三個 PowerShell 視窗各跑一個 gemini,第 1 個視窗翻第一章、第 2 個翻第二章、第 3 個專門美化 PPTX,三件事平行進行,這就是 Gemini CLI 的「多視窗平行」核心優勢。

兩個實戰跑完,你會直覺發現 Gemini CLI 跟第 7 章主打的 Claude Code 各有所長。下面用一張對照表,幫你想清楚什麼時候用哪個。

Gemini CLI vs Claude Code:什麼時候用哪個?

Gemini CLI:免費起步、檔案搬運與批次處理、Google 生態整合好,適合日常自動化、家庭與個人小任務。
Claude Code:付費(Pro 訂閱起跳)、程式碼工程能力強、跨平台無縫、Agent SDK(Software Development Kit,軟體開發工具包,讓開發者打造自訂 AI 助理的程式介面)完整,適合做網頁 / App / 專案級的 Vibe Coding。
兩者可以同時裝、同時用,沒有衝突,選對工具做對的事,才是真本事。

接下來

讀完此節後,回到 第 7 章 · Vibe Coding 入門 繼續閱讀「第 9 節:課堂活動與應用情境」。

回到 第 7 章 · 第 9 節:課堂活動與應用情境 →