嗨，我是 Eric，浪花科技的資深工程師。如果你的開發環境還停留在 VS Code 加上一堆 Copilot 外掛，那你可能已經成了 2026 年的「數位原始人」。

還記得 2024 年我們覺得 Cursor 很厲害嗎？到了今天，單純的「程式碼補全」（Autocomplete）已經不夠看了。Google Antigravity 的橫空出世，正式宣告了 Agentic IDE（代理人整合開發環境） 時代的來臨。這不僅僅是換一個編輯器，而是從「手動寫 Code」轉變為「指揮 AI 戰隊」的根本性工作流革命。

這幾天在公司內部遷移開發環境時，我踩了不少坑，也摸索出了一套最順滑的配置流程。今天這篇文章，就是要手把手帶你完成 Google Antigravity 的安裝、環境配置，以及那個最重要的「Hello World」——或者該說是「Hello Agent」。

為什麼 2026 年你需要 Agentic IDE？

在開始安裝之前，我們得先聊聊為什麼要這麼麻煩換工具。以前我們寫程式是這樣的：你思考邏輯，然後打字，AI 偶爾幫你補全幾行。但在 Google Antigravity 裡，邏輯變了：

• 意圖優先 (Intent-First)： 你告訴 IDE「我要一個有會員登入功能的 WordPress Headless 前端」，它會自己規劃檔案結構。
• 多模型協作 (Multi-Model)： 它不是只有一個 AI 在跑，而是同時調用 Gemini 3 Pro 處理邏輯、Claude 4.5 處理文案、甚至專精資安的小模型來審查代碼。
• 零重力環境 (Zero-Gravity)： 開發環境不再綁定你的本機硬體，運算都在雲端 Edge TPUs 上，你的 MacBook Air 也能跑得像伺服器一樣快。

簡單來說，Vibe Coding 的精髓就在這裡：你負責「感覺」產品的方向，Antigravity 負責把細節填滿。

第一步：安裝前的準備工作

雖然 Antigravity 主打雲端運算，但為了讓本機檔案系統（Local File System）能跟雲端代理人無縫同步，我們還是需要安裝本機橋接器（Local Bridge）。

系統需求

• OS： macOS Sequoia 16.2+ 或 Windows 12 (WSL 3)
• 記憶體： 雖然雲端跑很快，但建議至少 16GB RAM 以維持順暢的 UI 渲染。
• 帳號： Google Cloud 帳號（建議綁定企業版以解鎖無限 Context Window）。

第二步：下載與安裝 Antigravity CLI

Google 這次很激進，取消了單純的 DMG 或 EXE 安裝包，改用 CLI 引導安裝，這是為了確保你的環境變數直接配置正確。打開你的終端機（Terminal），輸入以下指令：

curl -fsSL https://antigravity.dev/install.sh | bash

安裝過程中，你會看到一個很有趣的選項：

Select your primary AI personality:
1) The Architect (Strict, scalable patterns)
2) The Hacker (Speed, MVP focused)
3) The Teacher (Verbose comments, educational)

身為資深工程師，我建議大家選擇 1) The Architect。雖然「Hacker」模式寫得快，但後續維護真的是火葬場（別問我為什麼知道，說多了都是淚）。

第三步：配置你的第一顆「反重力引擎」

安裝完成後，輸入 ag init 來初始化你的專案。這時候，Antigravity 不會只給你一個空的資料夾，它會生成一個關鍵的設定檔：.gravity.toml。這就是 Agentic IDE 的靈魂所在。

這是我目前針對 WordPress Headless 開發所使用的最佳化配置，你可以直接抄作業：

[project]
name = "roamer-tech-next-gen"
framework = "nextjs-16"
backend = "wordpress-headless"

[agent]
model = "gemini-3-ultra"
temperature = 0.2 # 保持程式碼嚴謹度
context_window = "2M" # 2026年標準配置，不要省

[permissions]
file_system = "read-write"
terminal = "ask-before-execute" # 安全起見，讓 AI 執行指令前先問你

[workflow]
auto_debug = true # AI 寫錯會自己修正，不用你動手
lint_on_save = true

這裡有個小細節要注意：terminal 權限建議設為 ask-before-execute。雖然我們信任 Google 的安全性，但你也不想讓 AI 一時興起把你的根目錄給刪了吧？

第四步：連接你的知識庫 (Context Scaffolding)

這是 Antigravity 最強大的地方。它允許你掛載外部的「知識庫」。例如，我們要開發 WordPress 外掛，不需要把整本 Codex 餵給它，只需要這樣設定：

ag link --doc "https://developer.wordpress.org/reference/" --alias "wp-docs"

這樣一來，當你在寫 Hook 的時候，Antigravity 不僅是「猜」你在寫什麼，它是根據最新的官方文檔在「查」資料。這對於我們這種需要精準串接 API 的工作來說，準確率提升了不只一個檔次。

第五步：Hello Agent！實戰演練

配置好後，我們來試試看它的威力。按下 Cmd + K (或 Windows 的 Ctrl + K) 喚醒 Agent 指令列，輸入：

「幫我建立一個 Next.js 頁面，透過 GraphQL 抓取 WordPress 的最新 3 篇文章，並使用 Tailwind CSS 做成卡片式佈局，風格要像 Linear。」

接下來的 30 秒，你會看到左側的檔案樹自動長出 /components/PostCard.tsx 和 /lib/graphql.ts，中間的編輯器代碼飛快生成，右側的預覽視窗同步渲染。

你不需要手動 npm install，Antigravity 已經偵測到你需要 Apollo Client 並在背景安裝完了。

常見雷區與除錯 (Troubleshooting)

1. Token Rate Limit 報錯

雖然 Gemini 3 很強，但預設的 API 配額對於大型重構專案可能不夠。如果你遇到 429 Too Many Requests，請到 ~/.gravity/credentials 中檢查你的計費專案設定，建議開啟「自動擴展 (Auto-scale)」選項。

2. 本機 Port 衝突

Antigravity 預設會佔用 Port 3000 和 8080。如果你本機還有跑 Docker 或舊的 Laravel Valet，記得在設定檔中修改 dev_port，以免打架。

結語：工具變了，思維也要跟上

安裝 Google Antigravity 只是第一步。真正的挑戰在於習慣「放手」。我們習慣了掌控每一行程式碼的細節，但現在，我們更像是一個「產品經理」兼「技術總監」，審核 AI 的產出，並在關鍵時刻修正方向。

如果你還在猶豫要不要轉移，我的建議是：現在就裝。因為當你的競爭對手已經用 Agentic IDE 一天產出你一週的工作量時，那種重力加速度的差距，是用加班也追不回來的。

想了解更多關於如何利用 AI Agent 優化開發流程？歡迎隨時聯繫我們！

延伸閱讀

• 一個人抵一個團隊？Google Antigravity 多代理人（Multi-Agent）開發工作流實戰：從架構設計到自動部署
• Coding AI 爭霸戰：從 Copilot、Cursor 到 Antigravity，2025 開發者該如何選對軍火庫？
• 寫 Code 還是管 AI？Vibe Coding 與 Google Antigravity 實戰：用「AI 代理人」重塑你的開發流