Gemini CLI 怎麼用：安裝、登入、常用命令，以及 2026-06-18 之後官方改用 Antigravity CLI

本文根據 Gemini CLI 官方文檔、Google 開發者網誌和 Antigravity 官方文檔整理，資料核對於 2026-10-25。官方 2026-06-18 對 Gemini CLI 的服務範圍做了調整，下文先說清現狀，再講怎麼用。命令與安裝方式以官方頁面為準，本站沒有逐項運行驗證。

適用於誰

• 搜「gemini cli 如何使用」「gemini cli 怎麼安裝」的人；
• 按舊教學裝了 Gemini CLI，卻登入不了或沒有響應的人；
• 想知道 Gemini CLI 和 Antigravity CLI 是什麼關係的人。

結論先說

1. 先看你的帳號類型。官方網誌（2026-05-19）說，2026-06-18 起，Gemini CLI 對 Google AI Pro、Ultra 和 Gemini Code Assist 個人版免費用戶不再服務請求。Gemini CLI 文檔站頁頂也寫：免費檔和 Google One 用戶的 Gemini CLI 已於 2026-06-18 被 Antigravity CLI 取代。
2. 企業和付費 API 不受影響：官方說，通過 Gemini Code Assist 標準或企業許可的企業用戶，訪問不變；Gemini CLI 仍可通過付費的 Gemini API Key 和 Vertex AI（Gemini Enterprise Agent Platform）使用。
3. 官方建議的替代品是 Antigravity CLI：官方稱它用 Go 編寫、更快，支持後台異步多智能體，共用 Antigravity 2.0 的智能體框架，保留 Agent Skills、Hooks、Subagents、擴展（改稱插件）。
4. 想用 Gemini 4 Argon：官方文檔提示 Gemini CLI 沒有針對 Argon 優化，請使用 Antigravity。Argon 是什麼見 /guides/gemini-4-argon-what-is-release-date。
5. 訂閱差別：Pro 和 Ultra 是 Google 的訂閱，見 /guides/gemini-ultra-vs-pro-difference；需要谷歌帳號相關服務可看 /chongzhi/google-zhanghao。

圖：本站根據 Google 開發者網誌 與 Gemini CLI 文檔 整理的示意圖

一、Gemini CLI 怎麼裝、怎麼登入（仍可用的情況）

官方快速入門：

1. 安裝：npm install -g @google/gemini-cli；
2. 運行：gemini；
3. 第一次會問「How would you like to authenticate for this project?」，官方說大多數情況選 Sign in with Google，選 Google 帳號並登入。

官方的認證選擇表：

用 API Key 的做法：在 Google AI Studio 獲取 Key，設定環境變量 GEMINI_API_KEY，啟動 gemini 後選 Use Gemini API key。Key 怎麼拿見 /guides/gemini-api-key。

二、常用命令（官方速查頁）

交互模式裏常用的斜槓命令包括 /help、/quit、/memory reload（重新加載 GEMINI.md）、/skills reload、/mcp reload。/stats model 可以查看當前會話的 token 用量和各模型的配額。

幾個官方參數：-m 選模型、--sandbox 沙箱運行、--approval-mode 設定工具執行審批方式（default、auto_edit、yolo、plan）。項目上下文寫在 GEMINI.md。Skills 的用法見 /guides/gemini-cli-skills-install-create，使用前請先對照本文說明的帳號類型限制。

三、配額：官方文檔裏的表

圖：本站根據 Gemini CLI 配額與價格頁 整理的示意圖

官方配額頁的主要數字（每用戶每日請求上限）：

• Gemini API Key 免費層：250 次，僅 Flash 模型；
• Google 帳號：Code Assist 個人版 1,000 次、Google AI Pro 1,500 次、Google AI Ultra 2,000 次；
• Workspace：Code Assist 標準版 1,500 次、企業版 2,000 次；
• 付費 API Key 和 Vertex AI：按用量計費，限額因檔位而異。

再次提醒：這張表裏的「Google 帳號」幾行，與官方網誌和文檔站頁頂「個人帳號已於 2026-06-18 改用 Antigravity CLI」的說法不一致，請以官方最新頁面為準，不要僅憑這張表判斷自己還能不能用。免費 API 的限額和計費見 /guides/gemini-api-free-tier-rate-limits。

四、改用 Antigravity CLI

官方給的安裝命令（antigravity.google/download，當前 CLI 版本 v1.4.0）：

• macOS / Linux：curl -fsSL https://antigravity.google/cli/install.sh | bash
• Windows PowerShell：irm https://antigravity.google/cli/install.ps1 | iex

啟動命令是 agy。官方遷移文檔說：

• 第一次運行時，如果檢測到舊的 Gemini CLI 配置，會彈出清單讓你選擇遷移哪些內容；
• 可以用 agy plugin import gemini 把舊的擴展轉成 Antigravity 插件；
• GEMINI.md、AGENTS.md 和全局的 ~/.gemini/GEMINI.md 照常生效；
• 技能路徑變了：全局從 ~/.gemini/skills/ 變為 ~/.gemini/antigravity-cli/skills/，項目內從 .gemini/skills/ 變為 .agents/skills/；
• MCP 配置從 settings.json 裏拆出來，放進獨立的 mcp_config.json，遠程伺服器的地址字段從 url 或 httpUrl 改為 serverUrl。

安裝前請先確認你的系統和帳號滿足官方下載頁的要求。

常見問題

Q：我的 Gemini CLI 登入後沒有響應，是怎麼回事？

如果你用的是個人 Google 帳號（免費、AI Pro 或 Ultra），按官方說法，該路徑已於 2026-06-18 停止服務，建議改用 Antigravity CLI；用 Gemini API Key 或企業許可的另當別論。

Q：Gemini CLI 能接別的模型或 Codex 嗎？

官方文檔沒有這類說明，見 /guides/gemini-codex-third-party-clients。

Q：Gemini CLI 免費嗎？

官方配額頁列的免費層是 API Key 免費層（250 次，僅 Flash）；個人 Google 帳號的免費路徑見上文說明。

參考資料

• Google 開發者網誌：Transitioning Gemini CLI to Antigravity CLI — https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli
• Gemini CLI 文檔：快速入門 — https://geminicli.com/docs/get-started
• Gemini CLI 文檔：認證 — https://geminicli.com/docs/get-started/authentication
• Gemini CLI 文檔：CLI 速查 — https://geminicli.com/docs/cli/cli-reference
• Gemini CLI 文檔：配額與價格 — https://geminicli.com/docs/resources/quota-and-pricing
• Antigravity：Antigravity CLI — https://antigravity.google/blog/introducing-google-antigravity-cli
• Antigravity：從 Gemini CLI 遷移 — https://antigravity.google/docs/gcli-migration
• Antigravity：下載 — https://antigravity.google/download