完成條件：Browser、VS Code、Git、Node.js、npm、Python 3、pip 與 Terminal 都能正常使用；Codex、Claude Code、AGY 至少知道官方安裝入口與驗證方法。

先分成兩層

核心環境：Browser → VS Code → Terminal → Git → Node.js → Python
AI 開發工具：Codex / Claude Code / Antigravity CLI

核心環境建議全部裝好。AI coding CLI 不必三個全裝，但這堂課會把官方入口都列出來，之後想用哪個就不用重新找資料。

1. Browser

Web Basics 會使用 Developer Tools，所以至少準備一個能正常更新的主流瀏覽器。

Google Chrome 官方下載 · Microsoft Edge 官方下載 · Firefox 官方下載

macOS 已內建 Safari，不需要另外安裝。

2. VS Code

Visual Studio Code 官方下載頁

Windows：下載 User Installer，執行安裝程式。安裝後重新開啟 Terminal，可以測：

code --version

macOS：下載 .dmg，把 Visual Studio Code 拖進 Applications。如果想在 Terminal 使用 code，可在 VS Code 的 Command Palette 執行 Shell Command: Install 'code' command in PATH。

Linux：官方頁面提供 .deb、.rpm、Snap 等版本，依發行版選擇。

3. Git

Git 官方安裝頁

Windows：可以直接下載 Git for Windows；或使用官方頁面列出的 WinGet 安裝方式：

winget install --id Git.Git -e --source winget

macOS / Linux：官方頁面會依平台列出安裝方式。

安裝後重新開啟 Terminal：

git --version

4. Node.js 與 npm

Node.js 官方下載頁

這門課建議選 LTS。不要為了版本號追 Current；初學與一般專案更需要穩定與相容性。

依官方頁面選擇 Windows Installer、macOS Installer，或 Linux 對應的安裝方式。npm 會一起安裝。

驗證：

node -v
npm -v

5. Python 3 與 pip

Python 官方下載首頁 · Windows 官方下載 · macOS 官方下載

安裝目前穩定的 Python 3。不要安裝 Python 2。

Windows：新版 Python 官方提供 Python Install Manager，也仍提供對應的安裝器。安裝完成後先測：

py --version
py -m pip --version

如果你的系統直接使用 python：

python --version
python -m pip --version

macOS / Linux：常見指令是：

python3 --version
python3 -m pip --version

為什麼寫 python -m pip？它可以明確指定「這個 Python 對應的 pip」，之後有多個 Python 版本時比較不容易把套件裝錯地方。

6. Python virtual environment

先確認 venv 能用：

python -m venv --help

macOS / Linux 可改成：

python3 -m venv --help

真正建立 .venv 會留到需要 Python 專案時再做。

7. Terminal 與 PATH

Windows 可以使用 PowerShell；macOS / Linux 常見 zsh 或 bash。後面主要使用 VS Code 的整合式 Terminal。

PATH 可以先理解成「輸入指令時，shell 要去哪幾個位置找可執行程式」。

輸入 git / node / python / codex → shell 查 PATH → 找到程式 → 執行

剛裝完工具卻出現 command not found 或「不是內部或外部命令」時，先關閉並重新開啟 Terminal / VS Code，再測一次。

接下來是 AI coding CLI

這些工具能直接在專案資料夾裡讀檔、修改程式碼、執行指令與協助除錯。因為它們有能力動到你的檔案與 shell，所以不要一路無腦批准權限。

8. OpenAI Codex CLI

Codex CLI 官方 GitHub

Windows PowerShell：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

macOS / Linux：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

已有 npm 也可以：

npm install -g @openai/codex

驗證：

codex --version

進入專案後啟動：

codex

9. Claude Code

Claude Code 官方入門

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

macOS / Linux：

curl -fsSL https://claude.ai/install.sh | bash

也可以用 npm：

npm install -g @anthropic-ai/claude-code

npm 安裝不要加 sudo。驗證：

claude --version

進入專案後：

claude

10. Google Antigravity CLI（agy）

Antigravity CLI 官方安裝文件 · 官方下載頁

Windows PowerShell：

irm https://antigravity.google/cli/install.ps1 | iex

Windows CMD：

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

macOS / Linux：

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

驗證：

agy --version

進入專案後啟動：

agy

三個 AI CLI 都一定要裝嗎？

不用。核心工具建議全部準備好；AI coding CLI 選一個開始即可。這堂課把三個官方入口都列出，是為了讓你知道它們存在，而且知道去哪裡取得正版工具。

不要從不明 npm package、鏡像站或隨機教學文章下載 AI CLI。這類工具能直接執行程式與讀寫檔案，安裝來源本身就是安全邊界。

不要把 API key 直接貼進專案

CLI 的帳號登入，和你自己的程式使用 API key 是兩回事。現在不需要建立一堆 .env，更不要把私密金鑰寫進 Git 會追蹤的檔案。

Environment variables、.env、Secrets 與部署平台金鑰會在 Web App / AI Builder 再正式處理。

最後做一次環境檢查

核心工具：

code --version
git --version
node -v
npm -v
python --version
python -m pip --version

Windows 如果使用 Python launcher：

py --version
py -m pip --version

如果有安裝 AI coding CLI：

codex --version
claude --version
agy --version

必要：Browser、VS Code、Terminal、Git、Node.js、npm、Python 3、pip。

選配：Codex、Claude Code、AGY。

現在還不需要：Docker、資料庫伺服器、雲端部署 CLI、API keys、模型訓練環境。

如果某一個指令失敗

確認官方安裝是否完成 → 重開 Terminal / VS Code → 再測版本 → 檢查 PATH → 查官方文件 → 最後才重裝

一次只處理一個失敗點。python 壞掉不代表 Git 有問題；codex 找不到也不代表 Node.js 壞了。

完成條件：核心工具都有版本輸出，而且你知道 AI coding CLI 的官方下載位置、安裝方式與啟動指令。完成後再進入第 1 課。