從 Gemini CLI 遷移
Google 已把 Gemini CLI 整併進 Antigravity CLI。如果你原本用 gemini 指令，本頁說明什麼時候必須換、換的時候要處理哪些設定。沒用過 Gemini CLI 的讀者可以直接跳過，改看 安裝與登入。
重要日期
| 日期 | 內容 |
|---|---|
| 2026-05-19 | Antigravity CLI 對所有用戶開放 |
| 2026-06-18 | Gemini CLI 對 Google AI Pro／Ultra 用戶與免費的 Gemini Code Assist 個人用戶停止服務 |
已付費的 Gemini Code Assist Standard／Enterprise 授權，或透過 Google Cloud 整合 GitHub 的企業客戶，仍可繼續使用 Gemini CLI 並獲得更新。Antigravity CLI 也能搭配 Google Cloud 專案使用。
遷移步驟
- 依 安裝與登入 安裝
agy。 - 在有舊設定的機器上第一次執行
agy，CLI 會自動偵測既有的 Gemini CLI 設定，並讓你選擇要遷移哪些項目。 -
若當時沒遷移，可以之後手動轉換舊的擴充套件：
它會搜尋舊的本機目錄、解析擴充套件的 manifest，並轉成新的原生格式。
觀念與路徑對照
Gemini CLI 的「擴充套件（extensions）」在 Antigravity 稱為外掛（plugins），一個外掛可以打包 skills、agents、rules、MCP 伺服器與 hooks。
| 項目 | Gemini CLI | Antigravity CLI |
|---|---|---|
| 工作區 Skills | .gemini/skills/ |
.agents/skills/（必須搬移，否則代理不會載入） |
| 全域 MCP 設定 | 寫在 settings 內 | ~/.gemini/config/mcp_config.json |
| 工作區 MCP 設定 | 寫在 settings 內 | .agents/mcp_config.json |
| 遠端 MCP 伺服器網址欄位 | url／httpUrl |
serverUrl |
GEMINI.md、AGENTS.md |
沿用 | 沿用，不需修改 |
搬完之後，GEMINI.md 與工作區規則的行為與以前相同。MCP 設定格式見 MCP，Skills 見 Skills。
遷移後檢查清單
- 在專案裡執行
agy，用/skills確認 Skills 都有被載入。 - 用
/mcp確認 MCP 伺服器連線正常；遠端伺服器記得已改用serverUrl。 - 用
/permissions看一下目前的權限設定，確認符合你的預期。
推薦影音
簡述：繁體中文實際遷移紀錄（約 15 分鐘）：包含轉移指令、登入流程、系統詢問是否轉移舊設定檔，以及作者對 Antigravity CLI 常用指令的使用心得。