步驟一:安裝 Node.js
Gemini CLI 是基於 Node.js 開發的,所以我們需要先安裝它。
前往 Node.js 官網下載頁面。
點擊下載最新版的 LTS (長期支援版)。
下載後開啟安裝檔,基本上只需要一直點「下一步」即可完成安裝。
安裝完成後,可以打開命令提示字元 (或 Terminal),輸入 node -v,如果成功顯示版本號,就代表 Node.js 已安裝成功。
步驟二:安裝 Gemini CLI
# 直接运行(我是先科学上网,再执行命令安装的,重启就没有了)
npx https://github.com/google-gemini/gemini-cli
# 或全局安装(重启后还在)
npm install -g @google/gemini-cli
步驟三:首次啟動與驗證
安裝完畢後,只需在命令提示字元輸入 gemini 就可以開啟 Gemini CLI 的互動介面。
第一次開啟時,它會詢問登入方式:
Google 帳號登入:推薦一般使用者選擇此項,可以直接享受到免費的 Gemini 2.5 Pro 額度。
API Key:適合有大量需求且願意付費的使用者。
如果之後想切換驗證方式,可以在 Gemini CLI 介面中輸入 /auth 指令。
接著它會讓你選擇終端機的主題風格,挑一個自己喜歡的就好。一切就緒後,就可以開始使用了!
基本使用與指令
在開始下達任務前,有幾個重點需要知道:
工作目錄:Gemini CLI 的工作範圍,取決於你在哪個資料夾路徑下輸入 gemini 指令。所以,請先 cd 到你的專案資料夾再啟動它。
常用指令:
/help:查看所有指令與基本用法。
/auth:更改驗證方式。
@:後面接檔名,可以讓 Gemini CLI 讀取特定檔案的內容。
/memory:管理專案記憶功能 (後面會介紹)。
Ctrl + C (按兩下):退出 Gemini CLI 介面,並顯示該次任務的 Token 用量。