第 1 週課前完成

環境安裝

整學期只用這一組工具，全部免費。請在第 1 週上課前裝好，上課時我們只做「確認」。

軟體	用途	下載位置
Antigravity	Google 的 AI 開發工具：編輯器加上 AI 助手。用中文告訴 AI 要做什麼，它幫你寫程式、執行指令	antigravity.google/download
Python 3.12 以上	執行 Flask 網站、資料庫指令	python.org
Git	建立存檔點；AI 改壞了可以回到上一版	git-scm.com
GitHub 帳號	雲端備份程式碼；Vercel 從這裡取得程式碼	github.com/signup
GitHub CLI（gh）	用瀏覽器登入 GitHub，讓 AI 推送程式碼時不需要密碼	cli.github.com
Vercel 帳號	把 GitHub 上的專案自動部署成公開網址（用 GitHub 帳號登入）	vercel.com/signup

開始前確認：一個可以登入的 Google 帳號、至少 3 GB 硬碟空間、Windows 10（64 位元）以上或 macOS 12 以上。

步驟 0：查一下你的電腦是哪一種

Antigravity 依處理器分成不同版本，下載前先確認：

Windows

「設定 → 系統 → 關於」，看「系統類型」：顯示 x64 下載 x64 版（大多數筆電）；顯示 ARM 下載 ARM64 版。

Mac

左上角蘋果選單 →「關於這台 Mac」，看「晶片」：Apple M1／M2／M3／M4 下載 Apple Silicon 版；Intel 下載 Intel 版。

步驟 1：安裝 Antigravity

開啟 antigravity.google/download，下載符合你電腦的桌面版（Windows 是 .exe，Mac 是 .dmg）。
執行安裝檔。Windows 一路按「下一步」；Mac 把 Antigravity 拖進「應用程式」資料夾。
開啟 Antigravity，用你的 Google 帳號登入。
在「文件」裡建立資料夾 程式設計三，之後每個專案都放在它底下。

Antigravity 更新很快，畫面上的按鈕名稱可能與講義略有不同，以實際畫面為準。

步驟 2：關閉遙測，建立資料安全習慣

開啟 Antigravity 的設定（Settings），在搜尋框輸入 telemetry。
把 Telemetry（遙測資料收集）相關選項關閉。

三條資料安全規則（本課程必守）

1. AI 會讀取你專案資料夾裡的檔案，並送到雲端模型處理。專案資料夾只放虛構資料或範例資料。

2. 帳號密碼、API 金鑰、別人的個資，永遠不貼進 AI 對話框，也不放進專案資料夾的程式碼裡。

3. Agent 要執行指令或修改檔案前會先詢問你。看清楚它要做什麼，再按同意。

步驟 3：安裝 Python

Windows

到 python.org/downloads 下載最新版。
安裝畫面第一頁一定要勾選「Add python.exe to PATH」，再按 Install Now。

Mac

同樣從 python.org 下載 macOS 安裝檔，一路按「繼續」即可。之後課程中的 python 指令，Mac 請改用 python3。

安裝完成後，重新開啟 Antigravity，讓它讀到新安裝的程式。

步驟 4：安裝 Git

Windows

到 git-scm.com/downloads 下載 Windows 版，所有選項都用預設值，一直按 Next。

Mac

開啟「終端機」，輸入 git --version 後按 Enter。跳出「安裝命令列開發者工具」視窗時按「安裝」，約需 5–15 分鐘。

裝好後設定你的名字與 Email（每一個存檔點都會記錄是誰存的）：

git config --global user.name "你的名字"
git config --global user.email "註冊 GitHub 用的 Email"

步驟 5：請 AI 幫你檢查安裝結果

在 Antigravity 開啟 程式設計三 資料夾，在 AI 對話框貼上：

提示詞 Antigravity

請在終端機依序執行 python --version、pip --version、git --version，
用表格告訴我三個版本號碼。
如果有任何一個指令失敗，請用初學者看得懂的中文說明原因和解決方法，
但先不要自己安裝或修改任何系統設定。

應該看到三個版本號碼，例如 Python 3.13.x、pip 25.x、git version 2.x，就完成了。

步驟 6：註冊 GitHub 帳號

從第 4 週起，每完成一條功能就要把程式碼備份到 GitHub；第 8 週再從 GitHub 部署成網站。

到 github.com/signup 用自己的 Email 註冊（選免費方案），並到信箱完成驗證。
建議使用和步驟 4 git config 相同的 Email，GitHub 才會把存檔紀錄對應到你的帳號。
帳號密碼由你自己保管，不要貼給 AI，也不要請別人代為登入。

步驟 7：串接 GitHub CLI 與 Vercel

安裝 GitHub CLI 並登入、註冊 Vercel、安裝課程的 Antigravity 套件。詳細步驟在 Git × GitHub × Vercel 工作流程的「一次性設定」，第 1 週課堂上會帶著做，並完成第一次上線。

全部完成的檢查方式在終端機執行 gh auth status 顯示已登入；Vercel 首頁看得到你的帳號；第 1 週的 my-first-site 有一個 .vercel.app 公開網址。

Antigravity 使用須知

模型選單在對話框下方。課堂示範使用 Gemini 系列模型；Claude 等其他模型也可以使用。
額度：免費方案的使用額度每週計算，用完要等重置。Gemini 系列與其他模型（例如 Claude）各自計算額度；一組用完時，切換到另一組模型即可繼續上課。
指定檔案：在提示詞中直接寫出檔名，例如「請先讀 PROJECT.md」，AI 就會到專案資料夾讀取。

常見狀況

輸入 python 出現「找不到指令」或打開 Microsoft Store

Windows 安裝時沒有勾選「Add python.exe to PATH」。重新執行安裝檔，選「Modify」→ 勾選「Add Python to environment variables」，完成後關掉並重開 Antigravity。

Windows 啟動虛擬環境時出現「因為這個系統上已停用指令碼執行」

在終端機執行一次 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned，輸入 Y 確認。這只影響你自己的帳號。

Mac 開啟 Antigravity 時說「無法驗證開發者」

到「系統設定 → 隱私權與安全性」，在下方找到 Antigravity，按「強制打開」。

學校電腦沒有安裝權限

請在自己的筆電完成安裝。若暫時無法使用筆電，可以先用網頁版 AI（例如 Gemini）完成當週的對話部分，與同學共用一台電腦實作。

第 1 週開頭 15 分鐘逐一確認步驟 5 的三個版本號碼。沒裝好的學生安排坐在一起，由助教集中處理，其他人先開始課程內容。