VS Code 已經是歷史？Google Antigravity 入門：2026 新世代 Agentic IDE 安裝與配置完全指南

嗨，我是 Eric，浪花科技的資深工程師。如果你還在用 VS Code 安裝一堆 Extension，然後手動切換視窗問 ChatGPT 為什麼你的 Code 跑不動，那我得說句實話：你可能已經活在「程式碼的石器時代」了。

現在是 2026 年，開發工具的典範轉移（Paradigm Shift）已經發生。我們不再只是需要一個「編輯器」，我們需要的是一個「代理人（Agent）」。這就是 Google Antigravity 橫空出世的原因。它不只是一個 IDE，它是一個住在你電腦裡的資深架構師團隊。

今天這篇文章，我不談虛無縹緲的 AI 理論，我們要來點硬核的。我會帶你手把手完成 Google Antigravity 的環境建置、安裝配置，並且針對我們最熟悉的 WordPress 開發環境進行優化。準備好丟掉你的舊工具了嗎？我們開始吧。

什麼是 Agentic IDE？為什麼 2026 年它是標配？

在 2024 年以前，我們說的「AI 輔助寫 code」通常是指 GitHub Copilot 那種「你寫一行，它猜下一行」的自動補全功能。但在 2026 年，這種模式被稱為「被動式輔助（Passive Assistance）」。

Agentic IDE（代理型整合開發環境） 的核心概念是「主動代理」。當你打開 Google Antigravity，你不是在對一個文字編輯器下指令，你是在指揮一群 AI Agents。

• Context Awareness (情境感知)： 它讀的不只是當前的檔案，而是你整個專案的歷史、Git Log、甚至是你的 Linear/Jira ticket。
• Autonomous Execution (自主執行)： 它可以自己開 Terminal，自己跑測試，發現報錯後自己修復，然後問你：「Eric，測試過了，要不要幫你 Commit？」
• Environment Simulation (環境模擬)： Antigravity 自帶微型容器技術，不用你自己在那邊 Docker Compose up 半天。

簡單來說，VS Code 是讓你能「打字更快」，而 Google Antigravity 是讓你「少打很多字」。

Google Antigravity 安裝前置作業

雖然 Google 宣稱 Antigravity 是「一鍵安裝」，但身為工程師，我們都知道這通常是行銷話術。為了讓它在你的開發環境（特別是 Mac M4/M5 或高階 Windows 工作站）跑得順暢，有些地基得先打好。

系統需求檢查

Antigravity 雖然是雲端協作優先，但在本地端它依賴強大的 NPU 進行即時推論（Edge Inference），以減少 API 延遲。

• OS: macOS Sequoia (15.5+) 或 Windows 12 (25H2+)
• RAM: 建議 32GB 以上（因為本地 LLM 模型會吃掉不少記憶體）
• Runtime: Node.js 24.0+ (LTS) 和 Python 3.13+

步驟一：透過 CLI 下載與驗證

雖然官網有 GUI 安裝檔，但我強烈建議使用 CLI 安裝，這樣可以確保你的 PATH 環境變數不會被弄亂，而且方便日後自動更新。打開你的 Terminal（或者你還在用的 iTerm2），輸入以下指令：

# 安裝 Google Antigravity CLI 工具
npm install -g @google/antigravity-cli

# 驗證安裝並檢查系統相容性
antigravity doctor

如果 antigravity doctor 回傳全是綠色的 Check，恭喜你，你的機器體質不錯。如果有紅字，通常是 Docker 權限或是 Python 虛擬環境的問題，照著它給的建議修復即可。

步驟二：初始化與登入

安裝完成後，我們需要登入 Google Cloud 帳號來連結你的 Gemini 3.0 Pro 配額（Quota）。

# 啟動初始化流程
antigravity init

# 登入並綁定專案
antigravity login --auth-browser

這裡有個小技巧（Engineer’s Tip）：如果你是公司團隊使用，記得在登入時加上 --org-id 參數，這樣你可以直接繼承公司的 Shared Context（共用知識庫），不用讓 AI 從頭學習你們公司的 Coding Style。

配置你的第一個 Antigravity 專案 (WordPress 為例)

Antigravity 最強大的地方在於它的 gravity.config.json 設定檔。這就像是給 AI 的「員工手冊」。如果你不設定這個，它就只是一個比較聰明的記事本；設定好了，它就是懂你公司業務邏輯的資深員工。

假設我們現在要開發一個 WordPress 客製化專案，請在專案根目錄建立 gravity.config.json：

{
  "projectType": "wordpress",
  "language": ["php", "javascript", "react"],
  "agentRole": "senior-fullstack",
  "context": {
    "docs": "./docs",
    "databaseSchema": "./database/schema.sql",
    "styleGuide": "@wordpress/scripts"
  },
  "permissions": {
    "fileSystem": "read-write",
    "terminal": "allow-with-confirmation",
    "network": "allow-local"
  },
  "plugins": [
    "@antigravity/plugin-wordpress",
    "@antigravity/plugin-woocommerce"
  ]
}

設定檔關鍵解析：

• agentRole: 設定為 senior-fullstack，AI 在寫 Code 時會更注重架構與安全性，而不只是讓 code 能跑就好。
• context: 這是 2026 年開發的關鍵。我們告訴 Antigravity 去哪裡讀我們的資料庫結構和文檔。這樣當你叫它「寫一個查詢訂單的 API」時，它不會瞎編欄位，而是會根據 schema.sql 寫出正確的 SQL。
• permissions: 安全性設定。allow-with-confirmation 表示當 AI 想要執行刪除檔案或重啟伺服器的指令時，必須先經過你點頭。這是一個保命設定，相信我，你不會希望 AI 在半夜三點自動把正式機資料庫 Drop 掉。

實戰：啟動 Agent 進行開發

配置好之後，在專案目錄下輸入 ag code . (Antigravity 的啟動指令)。

你會發現視窗配置和 VS Code 很像，但多了一個 “Gravity Well” 面板。這是你跟 Agent 溝通的地方。

試試看輸入這個 Prompt：

「幫我建立一個 WordPress Custom Post Type 叫做 ‘Portfolio’，包含 ACF 欄位設定，並且在前端建立一個使用 CSS Grid 的 archive 頁面。請參考目前的 theme 樣式。」

在舊時代，你可能需要分三步驟問 ChatGPT。但在 Antigravity 裡，它會：

1. 讀取 Context： 分析你現在用的 Theme 的 style.css 和 functions.php。
2. 規劃任務： 列出「建立 CPT」、「設定 ACF JSON」、「建立 archive-portfolio.php」三個子任務。
3. 執行與寫入： 直接在你的檔案系統中建立這些檔案，並即時預覽給你看。

這就是為什麼我說 VS Code 已經是歷史的原因。我們不再是「寫程式」，我們是在「審核程式」。

常見問題與除錯 (Troubleshooting)

1. 安裝後 ag 指令找不到？
這通常是環境變數沒吃到。請檢查你的 .zshrc 或 .bashrc，確保 export PATH="$PATH:$HOME/.antigravity/bin" 存在。

2. 記憶體暴增？
Antigravity 預設會開啟「本地索引模式（Local Indexing Mode）」，這會吃掉大量 RAM。如果你的電腦只有 16GB RAM，建議在設定中開啟 Cloud Inference Only，雖然會多一點點延遲，但至少電腦不會卡死。

延伸閱讀與進階應用

學會安裝只是第一步，Antigravity 的精髓在於如何讓多個 Agent 協同工作，以及如何跟其他開發者協作。關於這些進階技巧，我強烈建議你閱讀以下幾篇文章，這也是我自己在浪花科技內部訓練時會用的教材：

• 一個人抵一個團隊？Google Antigravity 多代理人（Multi-Agent）開發工作流實戰：從架構設計到自動部署：這篇會教你怎麼設定不只一個 Agent，而是一組「團隊」來幫你工作。
• 2025 AI 開發工具大亂鬥：Cursor、Copilot 還是直上 Antigravity？資深工程師的選武指南：如果你還在猶豫要不要轉移陣營，這篇評比非常詳細。
• 寫 Code 還是管 AI？Vibe Coding 與 Google Antigravity 實戰：用「AI 代理人」重塑你的開發流：探討 2026 年最新的 “Vibe Coding” 開發哲學。

結論：擁抱變化，但別忘了基本功

雖然 Google Antigravity 很強大，讓開發門檻變低了，但這不代表你不需要懂程式碼。相反地，你需要更懂「架構」與「邏輯」，因為你現在是 AI 的主管。工具再強，如果下指令的人邏輯混亂，產出的系統一樣會是一團糟。

現在，去安裝 Antigravity 吧，感受一下未來的開發速度。

如果你在安裝過程中有任何問題，或者你們公司想要導入這種新世代的開發工作流但不知道從何開始，歡迎隨時找我們聊聊。浪花科技一直站在技術的最前緣，我們可以幫你省下大量的摸索時間。

---