更新日期：2026年6月19日
如果你完全沒裝過，第一階段是無法逃避的安裝清單
新手最容易卡住的地方，就是把一些必要工具都裝完並開起來，如果連這點都做不到，那現在可以關掉這個網頁去追劇。草創階段主要可以分成三個階段：
- 第一階段：先動起來再說：安裝 Codex App，先開一個專用的練習資料夾，體驗一下讓 AI 在你電腦讀檔、改檔、動來動去的感覺。
- 第二階段：開始讓 AI 操作檔案：安裝 VS Code、Git、Node.js LTS。完成後，你可以動嘴叫 AI 幫你整理剛剛的測試資料夾、建立索引跟洞見或摘要。
.md筆記檔、打開專案資料夾、執行基本指令。 - 第三階段：進階工作流：熟悉 Codex App 後，再考慮 Codex CLI、Antigravity 2.0 / Antigravity CLI，或把 Obsidian 加進來管理長期筆記，這些都可以在本站找到相關教學或作品。
你現在是哪一種階段？
| 你的狀態 | 先做到哪裡 | 先不要著急做什麼 |
|---|---|---|
| 只是想開始學 AI 工具 | 裝好 VS Code、Git、Node.js LTS，建立一個固定工作區，先用一般資料夾和 .md 檔保存筆記。 |
先不要裝一堆 extension，也不要急著讓 AI 掃整顆硬碟。 |
| 已經會用 ChatGPT / Gemini / Claude 問問題 | 開始把筆記、prompt、練習檔案放到本機資料夾，再用Codex App 或是 VS Code 取代網頁版。 | 永遠不要把公司資料、私密檔案或憑證交給 Agent 測試。 |
| 想開始用 coding agent | 先用 Codex App 處理一個小資料夾，練習看它改了哪些檔案，每一步都要看 AI 做了什麼。 | 先不要同時開多個 agent，也不要在不熟悉時同意大量刪除或搬移檔案。 |
這篇的學習路線
這份清單是提供一個學習路線，可以先從網頁問答熟悉 AI，再把工作搬到本機做。這裡說的 Agentic，可以先理解成「AI 不只回答問題，還能在你指定的資料夾裡做事」。第一次學的目標很單純：讓你知道每個工具負責哪一段、裝完怎麼確認、卡住時先檢查哪裡。
- 網頁問答：用 ChatGPT、Gemini 或 Claude 練問問題、改寫、摘要、整理資料。
- 本機工作區：用 VS Code、Git 與 Node.js，把資料留在可保存、可回溯的位置。筆記先用資料夾裡的
.md檔即可。 - 單一 agent：用 Codex App 在指定資料夾中讀檔、改檔、跑驗證，開始接觸真實檔案系統。
- 多 agent 協作：看懂 Codex App 的安全邊界與修改節奏後，再用 Codex 的平行 threads、worktrees，或 Antigravity 2.0 / Antigravity CLI 練背景任務、可重複技能與跨資料夾工作流。
想先看進階工具實際畫面？
如果你已經完成前兩階段，下一步可以接著看 Ep.1 環境建置與 Agentic Mode 初探。那篇會把 Antigravity 的 Editor、Agent Manager、Browser 與 artifacts 放在同一個工作流裡看，適合用來理解「agentic mode」不只是聊天，而是讓 AI 在受控專案範圍內規劃、執行與回報。
主要工具是做什麼的？
VS Code
你的主要工作室。用來打開專案資料夾、編輯 Markdown、查看 Git 變更。之後也可以和 Codex App / Codex IDE extension 搭配使用。
Git
專案的時間機器。它能記錄每次修改、還原錯誤、下載 GitHub 專案，也是 AI agent 做 code review 的基礎。
Node.js
很多前端、自動化與 AI 周邊工具的執行環境。新手先安裝官方 LTS 版本即可，不需要追最新 Current 版。
Codex App
OpenAI 的桌面 coding agent command center。新手優先用 App：選一個資料夾或 Git repo，登入後在同一個介面裡開 thread、看 diff、跑任務、檢查結果。
Antigravity 2.0
Google 的 agent-first development platform。它比較適合放在第二階段：等你看得懂 AI 如何修改檔案，再用它練多 agent、背景任務與跨資料夾管理。
如果想先認識 Editor 與 Manager Surface 雙介面，請看 Ep.1 環境建置與 Agentic Mode 初探。
官方下載位置
| 工具 | 下載位置 | 新手建議 | 給 AI 的安裝 prompt |
|---|---|---|---|
| VS Code | code.visualstudio.com/download | Windows 選 User Installer；macOS 依晶片選 Apple silicon 或 Universal。裝完後先打開一次，確認可以看到 Welcome 畫面。 | |
| Git | git-scm.com/install/windows | Windows 安裝時多數選項用預設值即可；macOS 可用官方下載頁或 Homebrew。新手不用先理解全部選項。 | |
| Node.js | nodejs.org/en/download | 選 LTS，不要追 Current 版；安裝前以官方下載頁顯示的 LTS 為準。裝完後用 node --version 確認。 |
|
| Codex App | developers.openai.com/codex/app | 最建議新手先用。官方提供 macOS 與 Windows 下載；打開 App 後登入、選一個練習資料夾，確認 Local 模式後再送出第一個任務。 | |
| Antigravity 2.0 | antigravity.google/docs | 建議放在第二階段：等 Codex App 的單一專案流程熟了，再安裝 Antigravity 2.0 / Antigravity CLI。 |
VS Code 和 Codex App 差在哪裡？
這兩個工具不是二選一。第一天只要記住一句話：VS Code 負責讓你看清楚資料夾和檔案；Codex App 負責讓 AI 在同一個資料夾裡幫你工作。
VS Code 是你的工作桌
你用 VS Code 打開資料夾、看檔案、寫 .md 筆記、修改文字、查看專案結構。它像是你親手整理資料和檢查內容的地方。
Codex App 是你的 AI 協作視窗
你在 Codex App 裡選同一個資料夾，請 AI 幫你看檔案、解釋內容、找問題、提出修改、產生 diff。它不是取代 VS Code，而是幫你加速理解和修改。
第一次可以這樣練習
- 先用 VS Code 打開
AI-Workspace或你的練習專案。 - 在 Codex App 選同一個資料夾。
- 問 Codex：「請先說明這個資料夾裡有哪些檔案。」
- 如果 Codex 做了修改，回到 VS Code 看檔案內容。
- 如果這個資料夾有 Git，也可以看哪些檔案被改過。
為什麼 Codex 先推薦 App？
對新手來說，Codex App 比 CLI 更適合作為第一個入口，因為它把「選資料夾、開任務、看結果、檢查修改」放在同一個桌面介面裡，不需要先熟悉一堆終端機指令。
官方支援 macOS 和 Windows
官方 Codex App 頁面提供 macOS 與 Windows 下載。新手只要選對作業系統，打開 App 後登入，再選一個練習資料夾即可開始。
同一介面看任務與修改
Codex App 支援平行 threads、worktrees、Git 功能、in-app browser、artifact previews、plugins 與 skills。剛開始不用全學，先會看 diff 和任務結果就夠。
建議安裝節奏
1. 一次只裝一個工具
先裝 VS Code，打開確認沒問題；再裝 Git，確認版本號；再裝 Node.js。不要同時開三個安裝程式，否則出錯時很難知道是哪一步造成的。
2. 每裝完一個，就重開終端機
很多指令找不到，不一定是安裝失敗，而是舊的終端機還沒讀到新的 PATH 設定。關掉 PowerShell / Terminal，重新打開再測一次。
3. 先建立練習資料夾，再讓 AI agent 進去
第一次使用 Codex App 或 Antigravity，不要指向桌面、下載資料夾或公司專案。先建立一個只有測試檔案的小資料夾，確認你看得懂 agent 做了什麼。
安裝後怎麼確認成功？
1. 打開終端機
Windows 用 PowerShell 或 Windows Terminal；macOS 用 Terminal。之後看到文章寫「終端機」，大多就是指這個可以輸入指令的視窗。
2. 確認 Git 與 Node.js
git --version
node --version
npm --version能看到版本號就代表安裝成功。若顯示找不到指令，先關掉終端機重開，再確認安裝程式是否已完成。
3. 確認 VS Code 指令列
code --version如果找不到 code，也可以先用滑鼠打開 VS Code；之後再設定 Command Line PATH。
4. 確認 Codex App
打開 Codex App，使用 ChatGPT 帳號或 OpenAI API key 登入。接著選一個練習資料夾或 Git repository，確認畫面上選的是 Local，送出第一個小任務，例如「請幫我說明這個資料夾有哪些檔案」。
5. 確認 Antigravity CLI
agy --version這一步不急。先完成 Codex App 的第一個本機任務，再安裝 Antigravity 2.0 desktop app 或 CLI（小黑窗指令工具），從 Project 與 CLI 慢慢進入多 agent 工作流。
安裝時如果想看完整畫面與權限設定，可以搭配 Ep.1 環境建置與 Agentic Mode 初探，先理解 project scope、permission 與 artifacts 審核流程。
卡住時先看這裡
| 你看到的狀況 | 可能原因 | 先做這個 |
|---|---|---|
git、node 或 npm 找不到 |
終端機還沒讀到新的 PATH，或安裝程式沒有完整跑完。 | 關掉終端機重開，再跑一次版本指令；仍失敗時，回到官方安裝程式重新安裝。 |
code --version 找不到 |
VS Code 可以用，但指令列捷徑尚未設定。 | 先用滑鼠打開 VS Code，不要卡在這一步；之後再補 Command Line PATH 設定。 |
| Codex App 第一次登入不知道選哪個 | 不同環境可能支援 ChatGPT 帳號登入或 API key。 | 新手優先用 ChatGPT 帳號登入；如果改用 API key，要知道部分功能可能不完整。不要把 token、API key 貼到不明網站或聊天視窗。 |
| Antigravity 看起來很複雜 | 它本來就不是第一天的必要項目。 | 先跳過。完成 Codex App 的第一個本機練習後，再回來裝。 |
PM 讀者可以用 Legacy Gemini CLI 篇當情境案例
Gemini CLI 系列已標成 Legacy，新讀者應以 Antigravity CLI / Antigravity 2.0 作為新入口；但第 3、4 篇仍適合作為「本機 AI 讀資料、產出文件、協助 PM 工作」的案例參考。
- PM x Gemini CLI (三)：AI 賦能產品探索與定義 (Legacy)：看 AI 如何輔助市場研究、競品分析、使用者回饋洞察與 UI 原型探索。
- PM x Gemini CLI (四)：規格撰寫與專案管理 (Legacy)：看 PRD、QA 驗收清單與
todo.md任務管理如何串成 PM 到工程的協作流程。
Codex App、CLI 和 Antigravity 2.0 怎麼分工？
| 情境 | 先用 Codex App | 再練 Antigravity 2.0 |
|---|---|---|
| 第一個本機 coding agent | 最推薦。從單一資料夾、單一任務開始，學會讓 AI 看檔案、改檔案、跑檢查，並在 App 內看 diff 和結果。 | 先不要急。等你看得懂 AI 如何動到本機檔案，再進入多 agent 工作流。 |
| 跨多個任務或資料夾 | 先用 App 練基礎，知道怎麼描述目標、檢查 diff、要求驗證。熟悉後再碰 CLI 或 IDE extension。 | 這時再用。Antigravity 2.0 的重點是「指揮多個 agent 一起做事」，適合背景任務與跨資料夾管理。 |
| 從 Gemini CLI 舊流程轉移 | 不是主要遷移目標。 | Google 官方已把 Gemini CLI 個人使用者的遷移方向指向 Antigravity CLI 與 Antigravity 2.0。 |
建議建立的資料夾
工具裝完後，建立一個固定工作區。第一階段先用一般資料夾管理檔案就好：VS Code 負責打開資料夾，Git 負責記錄修改，筆記先放在 .md 檔或其他普通檔案裡。
Windows 範例
mkdir C:\Users\你的使用者名稱\Documents\AI-Workspace
mkdir C:\Users\你的使用者名稱\Documents\AI-Workspace\projects
notepad C:\Users\你的使用者名稱\Documents\AI-Workspace\first-note.mdmacOS / Linux 範例
mkdir -p ~/AI-Workspace/projects
touch ~/AI-Workspace/first-note.md之後每個練習專案都放在 projects 裡。筆記可以先寫在 first-note.md，等內容變多、需要整理連結時，再考慮進階筆記工具。
進階選擇：Obsidian
什麼時候才需要裝？
Obsidian 適合用來長期管理 Markdown 筆記、prompt、操作紀錄、會議摘要與專案 SOP。它不是第一天必裝工具；如果你目前只是跟著教學建立幾個 .md 檔，用 VS Code 或系統內建文字編輯器就夠了。
當你的筆記開始變多、需要雙向連結、標籤或跨主題整理時，再到 obsidian.md/download 安裝桌面版，並把既有的 AI-Workspace 當成 vault 或另建一個筆記資料夾。
新手容易混淆的幾件事
- VS Code 不是 Visual Studio：本文說的是輕量編輯器 Visual Studio Code，不是大型 IDE Visual Studio。
- Node.js 不是 AI 模型：它是很多工具的執行環境。裝它不是為了聊天，而是為了讓相關 CLI（小黑窗指令工具）或套件能跑。
- GitHub 和 Git 不一樣：Git 是本機版本控制工具；GitHub 是放專案的雲端平台。
- Markdown 檔不是特殊系統：
.md是普通文字檔，可以用 VS Code、Obsidian 或其他文字編輯器打開。 - Obsidian 是進階筆記工具：它適合筆記變多後整理知識庫，不是第一天必裝項目。
- AI agent 會動到檔案：讓 Codex App、Antigravity 或其他 agent 修改前，確認目前資料夾是你願意交給它工作的專案資料夾。
完成檢查清單
如果下面幾件事都完成，你就已經準備好進入下一篇或開始第一個本機 agent 練習。
- 我能打開 VS Code，並用它開啟一個資料夾。
- 我在終端機能看到
git --version、node --version、npm --version的版本號。 - 我已經建立一個固定工作區，例如
AI-Workspace。 - 我已經能在工作區裡建立或編輯一個
.md筆記檔。 - 我知道 VS Code 是看資料夾與專案，Git 是記錄修改，Obsidian 可以等筆記變多後再裝。
- 我知道 Codex App 會動到檔案，所以第一次只會拿練習資料夾測試。
- 我知道 Antigravity 2.0 可以晚點再裝，不需要第一天全部完成。
安全與維護建議
- 只從官方網站或可信套件管理器下載安裝檔。
- 不要把 API key、ChatGPT token、GitHub token 貼進公開文件或不明網站。
- AI agent 要求執行刪除、搬移、覆寫大量檔案時，先停下來看清楚。
- 把練習專案放在獨立資料夾，不要直接讓工具掃整個桌面或整顆硬碟。
參考來源
- Node.js official download page
- Git official Windows install page
- Visual Studio Code official download page
- Obsidian official download page
- OpenAI Codex App documentation
- OpenAI Codex getting started guide
- OpenAI Codex product page
- Google Antigravity official documentation
- Google Developers Blog: Transitioning Gemini CLI to Antigravity CLI