繼 Anthropic 於 2025 年 3 月推出高階工程師用的 AI coding 代理 Claude Code 後, 谷歌也在 2025 年 6 月 25 日推出了命令列 AI 代理工具 Gemini CLI, 最主要的差別是, Claude Code 採商業付費訂閱制, 而 Gemini CLI 則是開放原始碼專案, 可免費使用.
Gemini CLI 的主要目標是將谷歌的 Gemini AI 模型 (尤其是 Gemini 2.5 Pro 推理模型) 直接整合到開發者的終端機 (terminal) 上, 讓開發者能以最直接的方式在終端機中呼叫 AI 來生成程式碼與一般內容, 具有如下特點 :
- 支援超大 context, 適合處理大型軟體, 可整倉分析與進行一次性複雜重構 (refactor).
- 插件豐富, 可自訂插件並輕易整合在腳本與自動化流程中.
- 速度快, 適合快速原型生成, 無需訂閱費用.
- 整合了 Gemini Code Assist 與 Model Context Protocol (MCP) 等技術.
- 支援多種內建指令例如 /bug, /chat, /tools, !shell 等, 可直接控制 CLI 本身行為, 儲存歷史, 或執行系統命令, 提高終端機互動性與控制力.
詳情請參考 Gemini CLI 官網, GitHub repo, 與教學文件 :
中文教學文件參考 :
Gemini CLI 原始碼是用 Node.js 寫的, 安裝 Gemini CLI 必須要有 Node.js 18 版以上的執行環境, 我在前一篇安裝 Claude Code 時使用 scoop 套件管理工具, 所以下面安裝程序先使用 scoop 安裝 Node.js 的版本管理工具 nvm, 然後再用 nvm 安裝最新版的 Node.js, 參考 :
1. 安裝 Node.js :
為了管理不同版本的 Node.js, 先用 scoop 安裝 Node 版本管理工具 nvm (Node Version Manager) :
PS C:\Users\tony1> scoop install nvm
Updating Scoop...
Updating Buckets...
INFO Converting 'main' bucket to git repo...
The main bucket was removed successfully.
Checking repo... OK
The main bucket was added successfully.
Scoop was updated successfully!
Installing 'nvm' (1.2.2) [64bit] from 'main' bucket
nvm-noinstall.zip (6.0 MB) [==================================================================================] 100%
Checking hash of nvm-noinstall.zip ... ok.
Extracting nvm-noinstall.zip ... done.
Running pre_install script...done.
Linking ~\scoop\apps\nvm\current => ~\scoop\apps\nvm\1.2.2
Adding ~\scoop\apps\nvm\current to your path.
Adding ~\scoop\apps\nvm\current\nodejs\nodejs to your path.
Persisting nodejs
Persisting elevate.cmd
Persisting elevate.vbs
Persisting settings.txt
'nvm' (1.2.2) was installed successfully!
Notes
-----
You'll need to restart powershell/cmd to have it reload Environment Variables so nvm will work correctly
安裝完須關閉 Power Shell 視窗重啟, 檢視 nvm 版本 :
PS C:\Users\tony1> nvm --version
1.2.2
接下來就可以用 nvm install 來安裝指定版本的 Node.js 了, 指令格式如下 :
nvm install <version | node | --lts>
其中 version 為版本號碼例如 25.2.1, 用 node 表示安裝最新版, lts 表示安裝長期支援的穩定版本. 注意, 這三個參數只能擇一使用.
PS C:\Users\tony1> nvm install node
25.2.1
Downloading node.js version 25.2.1 (64-bit)...
Extracting node and npm...
Complete
Installation complete.
If you want to use this version, type:
nvm use 25.2.1
透過 nvm 可以在電腦中安裝多個不同版本的 Node.js, 然後用 nvm use 指令啟用指定的版本 (這就是 nvm 版本管理的功能), 指令格式如下 :
nvm use <version | node | --lts>
PS C:\Users\tony1> nvm use node
25.2.1
Now using node v25.2.1 (64-bit)
檢視目前使用中的 Node.js 版本 :
PS C:\Users\tony1> node --version
v25.2.1
2. 安裝 Gemini CLI :
確認 Node.js 已安裝完成後便可用下列指令安裝 Gemini CLI :
npm install -g @google/gemini-cli
PS C:\Users\tony1> npm install -g @google/gemini-cli
npm warn deprecated node-domexception@1.0.0: Use your platform's native DOMException instead
added 577 packages in 2m
npm notice
npm notice New minor version of npm available! 11.6.2 -> 11.7.0
npm notice Changelog: https://github.com/npm/cli/releases/tag/v11.7.0
npm notice To update run: npm install -g npm@11.7.0
npm notice
這樣就安裝成功了 (只要沒有 ERR/failed/permission denied 等致命錯誤即可, 那個 deprecated 警告是 Gemini CLI 的某個相依套件將來會被淘, 不影響目前使用 Gemini CLI).
3. 啟動互動式 Gemini CLI :
在 PS 視窗輸入 gemini 就會啟動互動式 Gemini CLI, 這樣是執行 Gemini CLI 的主程式, 進入一個類似於聊天室的介面, 可讓使用者輸入提示詞 (prompt), 模型會即時回應 :
PS C:\Users\tony1> gemini
中間出現黃框提示 " You are running Gemini CLI in your home directory. It is recommended to run in a project-specific directory." 是因為目前在作業系統的主目錄下執行 gemini CLI, 它建議應在一個專案目錄 (例如虛擬環境) 下執行為宜, 但目前只是測試, 在哪個路徑都沒關係.
接下來是要選擇一個方式來授權 Gemini CLI 存取此專案資料夾, 預設是使用 Google 帳號登入, a此方式免費帳戶每分鐘可向 Gemini 請求 60 次, 每天最多請求 1000 次, 選 1 按 Enter 後在彈出視窗按 "允許" 移除防火牆對 Node.js 之封鎖 :
然後選擇一個 Google 帳號登入 :
完成 Google 登入後, PS 視窗底下會出現一個交談框讓我們輸入指令或提示詞 :







沒有留言 :
張貼留言