Gemini CLI 安裝教學：是什麼、怎麼裝、免費額度多少，沒登入能做到哪我實際試了

你想在終端機裡用 Gemini，讓它直接看你資料夾裡的東西、幫你改檔案，不用一直複製貼上。Google 做的 Gemini CLI 就是這個用途。

這篇照順序講：它是什麼、裝之前要有什麼、怎麼裝、怎麼登入、免費能用多少，還有裝好之後常用的幾樣東西。

先交代我做到哪。安裝我在測試機上實際做了兩次，不用登入的指令也都跑過。但我沒有登入 Google 帳號，所以登入之後的對話和操作，是照官方文件寫的，會標明。

Gemini CLI 是什麼

它是一個在終端機裡跑的 AI 工具，Google 做的，開源，授權是 Apache-2.0。我查的時候它在 GitHub 上有十萬七千多顆星。

跟網頁版的 Gemini 最大的差別是它裝在你的電腦上。它的說明列的內建工具有：讀寫檔案、執行指令、搜尋、抓網頁。也就是說，你在一個資料夾裡啟動它，它可以自己去看裡面的檔案、動手改。

這種會自己動手的 AI 是什麼，我寫在 AI Agent 是什麼。同一類的工具還有 Claude Code 和 Codex。

裝之前要有什麼

官方文件列的建議規格是這樣：

系統要 macOS 15 以上、Windows 11 24H2 以上，或 Ubuntu 20.04 以上。

記憶體，一般使用 4 GB 以上，長時間處理大型專案 16 GB 以上。

Node.js 20.0.0 以上。

要連得上網路。可以使用的地區，文件指向 Gemini Code Assist 的支援地區清單，那份清單我沒有逐一核對。

安裝

官方的標準做法是用 npm：

npm install -g @google/gemini-cli

npm 是跟著 Node.js 一起來的。電腦上還沒有 Node.js 的話要先裝，這一步比裝 Gemini CLI 本身花時間。我的測試機是乾淨的 Ubuntu，第一次用系統的套件管理程式裝 Node.js，等了一分多鐘；第二次改成下載 Node.js 官方的壓縮檔解開，1 秒多就好了。

Gemini CLI 這一步很快。我裝了兩次，npm 回報的時間一次 5 秒、一次 2 秒，測試機在機房裡，網路很快。裝完佔 98 MB。

確認有沒有裝好：

gemini --version

我看到的是 0.64.0。

官方還列了其他裝法，這幾種我沒有試。不想安裝、只想跑一次的話可以用 npx @google/gemini-cli。Mac 上可以用 Homebrew 的 brew install gemini-cli，或是 MacPorts。

第一次啟動和登入

這一段是照官方文件寫的，我沒有登入。

在你要工作的資料夾裡打 gemini。第一次它會問你要用什麼方式登入，選 Sign in with Google，瀏覽器會跳出來讓你選帳號。

用哪一種帳號有差別。文件寫，個人的 Google 帳號原則上直接登入就能用。公司、學校或 Google Workspace 的帳號，要先設定一個 Google Cloud 專案。

另一條路是不登入帳號，改用 Gemini 的 API 金鑰，到 Google AI Studio 申請之後設成環境變數 GEMINI_API_KEY。

還沒登入就叫它回話會怎樣，這個我試了。我打 gemini -p 加一句話，它沒有回答，印出來的是請先設定登入方式，並列出可以用的三個環境變數。

免費額度

官方文件的額度頁寫的數字：

README 另外寫，個人帳號每分鐘上限是 60 次。API 金鑰那一列，README 寫的數字跟額度頁不一樣，我以額度頁為準。

要留意「請求」不等於你講了幾句話。你交代一件事，它中間可能會讀好幾個檔、跑好幾個指令，來回好幾次。實際一天能做多少事，我沒有登入，沒辦法告訴你。

沒登入能做的事

設定類的指令不用登入，這些我都實際跑過。

管理 MCP 伺服器。MCP 是把外面的工具接給 AI 的規格，我寫在 MCP 是什麼。加一台伺服器的寫法是：

gemini mcp add --transport http --scope user 名稱 網址

我加了一台之後它回 MCP server "ccdocs" added to user settings.，設定寫進了 ~/.gemini/settings.json。

列出擴充功能和技能，分別是 gemini extensions list 和 gemini skills list。我放了一個自己寫的擴充功能和一個技能進去，兩個都列得出來。

還有兩個我只看了說明、沒有執行的。gemini hooks migrate 的說明寫的是把 Claude Code 的 hooks 搬過來。gemini gemma 是設定用本機的 Gemma 模型，底下有 setup、start、stop 這幾個子指令。

常用的啟動參數

下面是我從 gemini --help 的實際輸出裡挑的，後面的說明是照它寫的意思翻的。

--approval-mode 有四個選項要認得。default 是每個動作都問你。auto_edit 是改檔案不問、其他照問。plan 是只讀不改。yolo 是全部自動同意，另外有一個 -y 是同樣的意思。

最後那個要小心。全部自動同意代表它刪檔案、跑指令都不會先問你。AI 沒照指示做而闖禍的例子，我整理在 Vibe Coding 翻車案例與缺點。

進到對話之後常用的

這一段照官方文件，我沒有登入所以沒有實際打過。

斜線開頭的是指令。文件列了三十幾個，先記這幾個就夠：

• /help，列出所有指令。
• /init，分析目前的資料夾，幫你產生一份 GEMINI.md。
• /model，換模型。
• /stats，看這次對話用了多少。
• /compress，把前面的對話濃縮成摘要，省用量。
• /clear，清掉對話重新開始。
• /mcp，管理接上的 MCP 伺服器。
• /quit，離開。

@ 是把檔案拉進來。打 @README.md 這份文件在講什麼，它會把那個檔案的內容一起送出去。

! 是直接執行終端機的指令。打 !git status，它跑完把結果顯示出來，不用離開對話。

GEMINI.md：先講好的規矩

文件寫，GEMINI.md 是給它看的說明檔，每一次對話都會自動帶上。專案的背景、你要它遵守的寫法，寫在這裡就不用每次重講。

它會讀好幾個地方的 GEMINI.md。放在 ~/.gemini/GEMINI.md 的對所有專案都有效，放在專案資料夾裡的只對那個專案有效。

Claude Code 有一樣的設計，檔名叫 CLAUDE.md。

我看到的一個跟文件不一樣的地方

Gemini CLI 有一個「信任資料夾」的機制，沒被信任的資料夾裡，專案的設定不會載入。

官方文件寫這個功能預設是關的。但我什麼設定都沒動，列 MCP 伺服器的時候，它把我剛加的那一台標成 Disabled，還附了一句：在不受信任的資料夾裡，使用者層級的伺服器也會被停用。列技能的時候也有一句，說專案的 hooks 因為資料夾不受信任而停用。

我的測試機沒有互動式的終端機，有可能跟這個有關，我沒有再查。你裝好之後如果發現加的東西沒有生效，可以先往這個方向看。啟動參數裡有一個 --skip-trust，說明寫的是這一次先信任目前的資料夾。

更新和移除

README 寫，穩定版每週二更新一次。要更新就再裝一次最新版：

npm install -g @google/gemini-cli@latest

移除，文件寫的是：

npm uninstall -g @google/gemini-cli

這兩行我沒有實際跑。移除之後，~/.gemini 這個放設定的資料夾還會不會留著，文件那一頁沒有講。

跟其他幾個工具的關係

Google 另外有一個 Antigravity CLI，也是在終端機裡用的。兩個我裝在同一台機器上比過，還跑了官方的搬家指令，寫在 Gemini CLI 和 Antigravity CLI 差在哪。

Claude Code 和 Codex 是別家做的同類工具。這兩個沒有 Gemini CLI 這種寫明每天次數的免費額度，費用和差別在 Claude Code 跟 Codex 怎麼選。

還沒決定要用哪一種的話，各家免費能用到哪，整理在免費方案速查表。

這篇沒有測的

登入之後的所有操作。對話、斜線指令、它實際改檔案的過程，都是照官方文件寫的。

免費額度實際能用多久。

Mac 和 Windows 上的安裝。我只在 Linux 上裝。

npx、Homebrew、MacPorts 這三種裝法。

用 API 金鑰的那條路。

更新和移除的指令。