2026 GEMINI
CLI_TRUST_
CRISIS_
MAC.

終端開發與 AI CLI 工具鏈

2025 年 6 月,Google 以 Apache 2.0 發布 Gemini CLI,一年內 GitHub Star 突破 10 萬、合併社群 PR 超 6,000;2026 年 5 月 19 日 Google I/O 卻宣布:自 6 月 18 日 起,免費用戶及 Google AI Pro/Ultra 訂閱者將無法再透過官方認證使用 Gemini CLI,須遷移至閉源 Antigravity CLI,且免費日額度從約 1,000 次/天 驟降至 20 次/天(約縮水 98%)。痛點:你在 Mac 上已深度客製 ~/.gemini/、Skills 與 Agent 工作流,卻可能在兩週內遭遇「認證牆」。結論:授權條款開源 ≠ 服務可用;個人開發者應優先評估自備 API Key、競品 CLI 與本機/遠端 Mac 分流,而非被動等待遷移工具。 下文含時間線、受影響人群對照、Antigravity 陷阱、五步自救、三檔分流矩陣與驗收清單。

1. 痛點拆解:為何社群稱之為「釣魚式圈套」

1)勞動力與品牌被「借用」:倉庫仍 Apache 2.0,但認證與配額由 Google 控制;個人用戶 6 月 18 日後請求不再被服務。貢獻者 Andrea Alberti 在合併 27-commit PR 當天收到政策公告,質問是否「在為只服務企業客戶的程式庫免費打工」。2)「技術必要性」雙重標準:官方稱要聚焦「多智慧代理統一平台」,但企業 Standard/Enterprise 授權用戶可同時保留 Gemini CLI 與 Antigravity——個人被強制,企業可選。3)替代產品體驗斷層:Antigravity 為閉源 Go 二進位(指令 agy),Reddit 回饋 Pro 訂閱僅 6~7 個 Prompt 即觸頂;ACP、專案記憶體(Markdown 上下文)、文件完整度均弱於 Gemini CLI 成熟期。4)Mac 工作流連帶損傷:與 Cursor Agent Skills、OpenClaw、SKILL.md 跨工具目錄 綁定的開發者,需在一週內重配認證與 Base URL。

若你把「開源」理解成「可 fork、可改、可長期依賴」,這次事件會特別刺痛:程式碼邊界清晰,服務邊界模糊。社群在 2025 年投入的文件、外掛、MCP 與 Skills 適配,多數假設 OAuth 個人訂閱能持續;政策一轉,變成「倉庫還在、登入失效」。對台港 Mac 開發者而言,還要額外注意帳單幣別、Cloud 專案區域與公司資安政策是否允許個人 Google 帳號接生產 API——這些都不是 git clone 能解決的。建議團隊立刻在 Wiki 新增一欄:基礎設施擁有者(誰付費、誰可撤銷、誰可改配額),避免 6 月 18 日當天才发现「CLI 還能裝,但 token 全紅」。

2. 事件時間線(2025–2026)

時間事件
2025-06Apache 2.0 發布 Gemini CLI,開放社群貢獻
2025-06~2026-05100k+ Star、6,000+ 合併 PR
2026-05-19Google I/O:發布 Antigravity CLI,公告 Gemini CLI 即將限制個人存取
2026-05-23爭議發酵;GitHub Discussion #27274 大量反對票
2026-05-29Linux Foundation 在峰會以該案例推廣 isitopen.ai 評估工具
2026-06-18個人/Pro/Ultra 及 Gemini Code Assist Individuals 停止服務請求

時間線的關鍵不是「哪一天發布 Antigravity」,而是個人 OAuth 路徑與企業授權路徑的分叉日。6 月 18 日前仍有緩衝視窗做 API Key 申請、替代 CLI 驗證與 CI 路由調整;錯過這個窗口,你會被迫在「20 次/天的 agy」與「突然開通的 Cloud 帳單」之間二選一,且往往沒有完整遷移 Runbook。建議把 5/19、5/23、6/18 寫進團隊行事曆,並為每個日期定義可交付物(例如:5/23 前完成認證盤點、6/10 前完成 API Key 煙測、6/17 前完成備份與回滾演練)。

3. 政策對照:誰被 cutoff,誰不受影響

用戶類型6 月 18 日後 Gemini CLI備註
Google AI 免費用戶❌ 停止服務需遷 Antigravity 或自備 Key
Google AI Pro / Ultra❌ 停止服務同上
Gemini Code Assist Individuals❌ 停止服務含 IDE 外掛路徑
Code Assist for GitHub(個人 org)❌ 新安裝禁止,隨後停服企業 Cloud 路徑除外
Code Assist Standard / Enterprise✅ 不變可繼續用 Gemini CLI
付費 Gemini / Enterprise API Key✅ 仍可用 Gemini CLI個人自救主路徑

FOSS Force 記者 Christine Hall 的概括值得寫入你的團隊 Wiki:「Google 並沒有改授權條款,而是關掉了讓工具有用的基礎設施。」 Fork 程式碼可行,但沒有模型 API,fork 只剩空殼。個人開發者若無企業採購管道,付費 API Key + 多 CLI 分流通常比「苦等官方遷移精靈」更符合成本與可控性;訂閱 Pro/Ultra 並不能自動換取 CLI 存續,這點在社群討論中被反覆誤解。

4. Gemini CLI vs Antigravity CLI:決策矩陣

維度Gemini CLI(個人路徑即將關閉)Antigravity CLI
授權條款Apache 2.0 開源閉源
免費日額度(社群觀測)~1,000 次/天~20 次/天
多模型 / ACP社群外掛生態成熟部分能力缺失或存疑
專案記憶體Markdown 上下文檔早期版本缺失
企業並行使用授權用戶可保留與 Gemini CLI 可並存(企業)

決策時不要只看「Google 官方推薦哪個」,要看你的任務形態:短互動重構、長上下文 Agent、夜間 CI 批次、還是需 Google Cloud 資源的 scaffold。Antigravity 若僅剩 20 次/天,對「終端常駐 Agent」幾乎不可用;Gemini CLI 在 API Key 路徑下仍可保留 Apache 客戶端與既有 ~/.gemini/ 習慣。閉源 agy 還意味著除錯與供應鏈審計回到黑箱,對受監管產業的 Mac 團隊尤其不利。

5. Mac 開發者五步自救 Runbook(6 月 18 日前)

Step 1 — 盤點認證類型

執行 gemini auth status(或查看 ~/.gemini/ 設定),確認目前是 OAuth 個人訂閱還是 API Key。僅後者在 cutoff 後仍可走 Gemini CLI 開源客戶端。請把結果貼進工單附件,避免「以為是 Key、實際是 OAuth」的常見誤判。

Step 2 — 評估 API Key 路徑

在 Google AI Studio / Cloud 申請付費 Gemini 或 Gemini Enterprise Agent Platform API Key,寫入環境變數或 settings.json,避免 6 月 18 日 OAuth 牆。記錄預估 $/1M tokens,與 Claude Code、OpenRouter 對照;為台港團隊額外確認發票、專案 IAM 與金鑰輪替責任人。

Step 3 — 匯出並備份設定

備份 ~/.gemini/、專案內 .agents/skills/、自訂 MCP;若遷移 Antigravity,官方稱 agy 可互動匯入,但不要在未驗證前刪除舊目錄。建議用 tar 打時間戳封存,並在 README 註明還原步驟。

Step 4 — 並行驗證替代 CLI

在 Mac 上並行安裝 Claude Code、Codex CLI、或繼續用 Cursor 內建模型;本機 MLX/Ollama 作離線兜底(見本站 OpenRouter 與本機分流 文)。每條路徑至少跑通一條「端到端 refactor」煙測,而不是只測 --version

Step 5 — 寫入團隊「基礎設施依賴」清單

對新開源 AI 工具標註:授權條款、認證方式、配額擁有者、是否可 fork 獨立運行——提交 PR 前用 isitopen.ai(Linux Foundation 推廣)做透明度自檢。把「6/18 後仍可用」寫成明確布林欄位,供採購與值班查閱。

6. 開源信任的邊界:誰控制執行環境

傳統開源:fork + 自建即可運行。AI 時代「雲原生開源 CLI」:程式碼在 GitHub,大腦在廠商 API。Dynatrace、Elastic、Figma、Shopify、Stripe 等曾與 Gemini CLI 深度整合的企業,同樣面臨遷移溝通成本——個人開發者更不是唯一受害者。Google「終止產品」的前科(Reader、+、Stadia)加深了長期承諾疑慮。可引用數字:① GitHub 100,000+ Star。② 合併 PR 6,000+。③ 免費額度變化 1,000 → 20 次/天量級。④ GitHub 討論帖頂部評論獲 31 個反對反應(社群情緒指標)。

「偽開源」在此不是指授權條款造假,而是指治理與運行時不對稱:社群無法投票決定配額、無法保證 OAuth 路徑存續、也難以在無 API 的情況下維持功能對等。Linux Foundation 在 2026 年 5 月底峰會借本案推 isitopen.ai,本質是提醒企業與個人:評估時要問「誰能關掉我的執行環境」,而不只是「倉庫是不是 MIT/Apache」。對 Mac 團隊,還要把「本機 CLI + 雲端模型 + 遠端節點」畫成一張依賴圖,避免單點失效時整條 Agent 鏈癱瘓。

7. 深度案例:獨立開發者的「雙棧」遷移週

「一名在 MacBook Pro 上用 Gemini CLI 維護三個 SaaS 倉庫的獨立開發者,5 月 20 日收到 I/O 公告後執行:Day1 申請 Cloud API Key 並限制日預算 $15;Day2 將最重 refactors 遷到 Claude Code;Day3 把 nightly CI 裡的 gemini 呼叫改為 OpenRouter 路由;Day4 在遠端 Mac 節點部署 Ollama+MLX 作離線 diff 預覽;Day6 僅把 Antigravity 用於需要 Google Cloud 資源的 scaffold。6 月 17 日 OAuth 失效當日,終端工作流零中斷——總遷移耗時約 9 小時,Antigravity 免費層在 Day5 因 20 次/天上限放棄日常使用。」

案例說明:不要把「官方推薦的遷移」等同於「唯一解」;Mac 上更可持續的組合往往是 API Key + 多 CLI + 遠端算力節點,而非單點依賴閉源 agy。若你維護多個客戶 repo,建議為每個 repo 標註「主 CLI / 備援 CLI / 離線兜底」,並在 cutoff 前一週做乾跑演練:故意停用 OAuth,確認 API Key 與 OpenRouter 路由是否真能扛住一整晚 CI。

8. Mac 三檔分流矩陣:本機 MLX、API Key、遠端 Mac

檔位適用任務典型工具風險
本機 MLX / Ollama離線 diff、敏感草稿、小模型對照MLX、Ollama、LM Studio統一記憶體與散熱壓力
API Key(雲端)日常 refactor、長上下文 AgentGemini CLI+Key、Claude Code、OpenRouter帳單與配額由廠商決定
遠端 Mac 節點通宵回歸、OpenClaw Gateway、批次 codegen遠端 SSH、launchd、MACGPU網路與維運 SLA

三檔不是互斥,而是同一條 Agent 鏈上的不同段:本機 Cursor 做編排與 Skills 觸發,API Key 負責高品質推理,遠端 Mac 跑長任務與對照測試。6 月 18 日後,若你把所有呼叫都擠在 Antigravity 免費層,等於用 20 次/天綁死整條鏈;若提前拆檔,cutoff 當週只需改認證,不必改工作流哲學。與 Agent Skills 指南 連讀時,記住 Skills 標準化的是「怎麼做」,分流矩陣標準化的是「在哪跑」。

9. 成本與授權路徑對照(個人決策用)

路徑前期成本可預測性6/18 後 CLI 存續
OAuth 個人 Pro/Ultra訂閱費低(政策已變)❌ Gemini CLI
付費 API Key按 token中高✅ Gemini CLI
Antigravity 免費$0極低(~20/天)閉源 agy
競品 CLI + OpenRouter按路由與 Gemini 脫鉤
本機 MLX硬體/電高(離線)不依賴 Google OAuth

成本表的目的不是幫你選最便宜的,而是避免隱性訂閱陷阱:以為 Pro 訂閱能換 CLI,實際上 6/18 後仍要另開 API 帳單。請在試算表裡同時列出「每日 Agent 呼叫次數 × 單次 token」與「夜間 CI 峰值」,再對照 API Key 與 OpenRouter 報價;若日呼叫遠超 20 次,Antigravity 免費層只適合偶發 scaffold,不適合主工作流。

10. 驗收清單、FAQ 與整合者備忘

驗收: 已確認認證類型 □ | API Key 在 6/18 前可用 □ | 設定已備份 □ | 至少一套替代 CLI 跑通 □ | 團隊 Wiki 已記錄基礎設施依賴 □ | 日額度與成本上限已設 □ | 遠端/本機分流已文件化 □ | 三檔分流矩陣已評審 □
Q:企業授權個人能買嗎? 視組織政策;個人通常走 API Key 或競品。
Q:Gemini CLI 倉庫會刪嗎? 官方未宣布刪庫,但個人 OAuth 路徑關閉。
Q:與 Cursor Agent Skills 關係? Skills 是標準,換 CLI 只需改呼叫端;見 Skills 指南
整合者備忘: 若你的產品文件寫「支援 Gemini CLI」,請在 6/18 前區分「OAuth 個人」與「API Key / Enterprise」,並給出遷移樣例;否則客服會在 cutoff 當週被 OAuth 失效工單淹沒。

11. 與 OpenClaw、Cursor 編排連動(cutoff 週實務)

許多 Mac 團隊並非「只用一個 CLI」,而是 Cursor 負責編輯與 Agent Skills 觸發,OpenClaw Gateway 負責多渠道與定時任務,Gemini CLI 負責終端批次重構。6 月 18 日後,若 Gateway 仍指向 OAuth 個人 token,會出現表面成功、實際 401的幽靈故障:本機 Cursor 可能已切到 API Key,但 launchd 上的 OpenClaw 仍讀舊環境變數。建議用同一張「認證來源表」覆蓋三層:IDE、CLI、daemon,並在 cutoff 前夜做一次冷啟動演練(重開機後只跑 doctor/probe 類檢查,不手動補 token)。

對使用 SKILL.md 的團隊,Skills 規範的是操作流程,不是模型供應商;因此 cutoff 週的最小變更是替換呼叫端環境變數與 Base URL,而不是重寫整套 Skills。請在 repo 的 .agents/skills/.cursor/skills/ 旁新增 MIGRATION-2026-0618.md,記錄:主 CLI、備援 CLI、離線兜底、誰能在 6/18 前簽核通過。這份文件應比「再寫一篇口頭說明」更能降低交接成本。

12. 安全、金鑰治理與合規備忘

API Key 自救路徑意味著秘密管理回到你自己:不要把 Key 寫進截圖、不要提交到公開 fork、不要在 Slack 貼全碼。Mac 上建議用 Keychain 或 1Password CLI 注入短期環境變數,並為 Cloud 專案啟用預算告警與 IP/服務帳戶限制。台港團隊若客戶資料不得出境,還需對照 Google 區域與模型日誌政策,而不是只看「CLI 還能不能裝」。Antigravity 閉源則讓供應鏈審計更難:若你是受監管行業,應把「可審計的呼叫鏈」寫進採購條款,而不是默認接受黑箱二進位。

金鑰輪替要與 cutoff 日曆對齊:6/10 前建立新 Key 並跑通 CI,6/15 前讓舊 OAuth 路徑失效的影響面可預測,6/17 完成最後一次備份。若同時輪替 OpenRouter 與 Gemini Key,請分兩張變更單,避免「一次改五個變數」導致無法回滾。對個人開發者,至少做到:Key 只放 ~/.gemini/ 或 env,不寫進 shell history;用 chmod 600 限制設定檔權限。

13. 常見錯誤與排錯(cutoff 當週)

現象常見原因優先動作
gemini 命令仍在,但全紅 401OAuth 已停、仍無 API Key確認 auth status;切換 Key
agy 很快觸頂20/日免費層勿當主 CLI;改 Key 或 OpenRouter
CI 夜間才失敗Secrets 未更新對照 GitHub Actions 變數
本機可跑、Gateway 不行launchd 環境不同檢查 plist EnvironmentVariables
MLX 很慢統一記憶體壓力長任務改遠端 Mac 節點

排錯時先分層:認證層 → 路由層 → 模型層 → 硬體層。cutoff 當天最常見的是只修認證卻忽略路由(例如仍指向已失效的 OAuth endpoint)。若你已接入 OpenRouter,請保留一份「模型別名對照表」,避免 nightly job 在 Google 側失敗後沒有 fallback。社群數字再次提醒風險規模:Star 100k+ 代表採用面極廣,6k+ PR 代表整合深度極深,而 1,000→20 的額度落差代表「免費替代」幾乎不可用。

14. 從「終端 OAuth」到 Mac 算力節點

純筆電跑長會話 Agent、批次測試或本機 MLX 對照時,統一記憶體與溫控常先於「用哪個 CLI」成為瓶頸。Windows/Linux 也能接 API Key,但與 Xcode、FCP、ComfyUI 及 launchd 常駐 Gateway 並行的圖形/多媒體 AI 工作流,macOS 仍更順暢。若你把 Gemini/Claude/OpenRouter 編排留在本機 Cursor,而把通宵評測、OpenClaw Gateway、大批量 codegen 回歸放到遠端 Mac,可在 cutoff 當週避免「本機又熱又斷網、雲端 CLI 又限額」的雙殺。

政策爭議無法短期改變,但你可以改變依賴結構:程式碼開源由社群守護,算力與 7×24 運行由可租用的 Apple Silicon 節點承接。 若需要穩定遠端 Mac 跑 Agent 與對照測試,可考慮 MACGPU 節點——本機保留輕量 CLI 與 Skills,機房 Mac 承接長任務,避免 6 月 18 日之後「工具換了、算力仍擠在一台筆電上」。最後自問:cutoff 之後,你的瓶頸是「認證」還是「算力」?若是後者,分流比換 CLI 更急。

15. 決策樹:cutoff 前兩週該做什麼

若你只剩 14 天,請用決策樹壓縮選項:第一問——今天 gemini auth status 是否 OAuth 個人?是 → 必須在 6/18 前取得付費 API Key 或切換 Claude Code/OpenRouter 主路徑;否 → 驗證 Key 是否在 CI 與 Gateway 同步。第二問——每日 Agent 呼叫是否 > 20 次?是 → Antigravity 免費層只能當實驗,不能當生產;否 → 可把 agy 當輔助 scaffold。第三問——夜間是否有長任務?是 → 規劃遠端 Mac 或 MACGPU 節點,不要把 MLX 與雲端 CLI 全塞在同一台 M 系列筆電。第四問——是否受客戶合約約束資料出境?是 → 在申請 Cloud Key 前先做法務對照,而不是 cutoff 當天臨時開專案。

決策樹的輸出應是一份可執行清單,而不是「再觀望」。觀望的成本在 2026 年 5 月已被社群用數字說明:10 萬 Star 代表大量教學、外掛與 CI 範本都假設 Gemini CLI 個人 OAuth 存在;6000+ PR 代表企業整合與個人腳本交織在同一倉庫敘事裡;當配額從 1000 次/天降到 20 次/天,等於告訴你「即使用 agy,也無法複製原先的免費生產力」。因此 Mac 開發者的理性選擇不是賭 Google 回滾政策,而是把可控制的變數(Key、路由、遠端算力)握在自己手上。

16. 與 Claude Code、OpenRouter 的並行策略

API Key 路徑能延續 Gemini CLI 客戶端,但不代表你應把所有任務都綁在單一模型上。實務上,團隊常在 cutoff 週採「雙主路」:白天重構用 Claude Code 或 Cursor 內建強模型,夜間 CI 用 OpenRouter 按榜單路由到性價比模型,Gemini Key 只保留在需要 Google 生態工具鏈的任務(例如某些 scaffold、Vertex 整合)。這與本站 OpenRouter 部署決策矩陣 一致:榜單是流量信號,不是宗教;cutoff 週更要每週複查路由,而不是鎖死單一模型。

並行策略還包括離線對照:MLX/Ollama 跑小模型做 diff 語法檢查、風格檢查或敏感資料草稿,雲端 Key 跑高品質邏輯推理。這樣即使 Google 側再次調價或限流,你仍保留兩層兜底。記住:Antigravity 的閉源不只是「看不到程式碼」,而是無法在社群 fork 上疊加修補;當 agy 行為與文件不符時,你只能等官方更新,而 Gemini CLI 在 API Key 路徑下仍可享受 Apache 社群的外掛與修正節奏(雖然個人 OAuth 已死)。

17. 給 PR 貢獻者與整合者的長期啟示

若你曾向 Gemini CLI 提交過 PR,這次事件應促使你更新個人貢獻政策:在 README 或 CONTRIBUTING 中要求新貢獻者標註「服務依賴」與「可 fork 運行條件」;在合併大功能前詢問維護者:個人 OAuth 路徑是否存在單點關閉風險。Linux Foundation 推 isitopen.ai 不是學術裝飾,而是把「誰能關你的執行環境」變成可審計問卷。對整合者(寫 SDK、CLI 外掛、CI Action 的你),請在 6/18 前發布遷移公告,並提供最小可複製範例:如何用 API Key 啟動、如何改 OpenRouter 路由、如何在 Mac 上把長任務 offload 到遠端節點。

長期看,AI 工具評估應從「Star 數」轉向「服務條款 + 認證路徑 + 配額曲線 + fork 空洞化風險」四元組。Gemini CLI 用 10 萬 Star 證明瞭社群動員能力,也用 6 月 18 日 cutoff 證明瞭雲端 OSS CLI 的脆弱性。Mac 開發者的優勢在於:同一台機器可同時承載 Xcode 多媒體管線、終端 Agent、本機 MLX 與 SSH 到遠端 Mac——只要把這些能力寫進 Runbook,而不是賭某一個官方 CLI 會永遠免費。當你完成本文驗收清單時,應能向同事回答:我們的主認證是什麼、備援 CLI 是哪個、夜間算力在哪、6/18 後誰 on-call——這比「已安裝 agy」更能代表工程成熟度。