外觀

語言

高效 AI 駕馭術

AI 寫程式前的準備:終端機、Git、GitHub、Node.js 一次裝好(2026)

用 AI 寫程式、自己架設網站之前,電腦要先有四樣東西:終端機、Git、GitHub 帳號和 Node.js。macOS 和 Windows 的安裝指令、驗證方法和新手最常卡住的地方都整理在這裡。

Kelvin Wang · · 8 分鐘閱讀

終端機是輸入指令的視窗,電腦本來就有。Git 是記錄每一次修改的版本控制工具。GitHub 把程式碼放上雲端,部署平台從這裡拿程式碼。Node.js 是執行 Astro 這類網站工具的環境。Mac 用內建的「終端機」加上 Xcode 命令列工具或 Homebrew,Windows 用 PowerShell 加上 Git for Windows 和 Node.js 安裝檔。全部裝好,git --version、gh --version、node -v、npm -v 都印得出版本號,就可以開始讓 AI 幫你寫網站。

Node.js 目前的 LTS 版本
v26.13.0
Node.js 下載頁
Git 最新版本
2.56.0
git-scm.com
GitHub 免費方案的公開與私人 repo
不限數量
GitHub 方案頁

四樣工具各做什麼?

工具用途macOSWindows
終端機輸入指令。AI 寫程式工具也在這裡執行內建「終端機」內建 PowerShell(或 Windows Terminal)
Git記錄每次修改,改壞了可以回到上一版Xcode 命令列工具或 HomebrewGit for Windows 安裝檔
GitHub在雲端存放程式碼;部署平台從這裡抓程式碼上線網頁註冊+GitHub CLI網頁註冊+GitHub CLI
Node.js執行 Astro、npm 和多數網站工具nodejs.org 安裝檔nodejs.org 安裝檔或 winget

版本資料 2026-11-07 查詢:Node.js [9]、Git for Windows [4]。

這四樣的關係是:你(或 AI)在終端機裡下指令,Node.js 把網站跑起來,Git 記下每次改了什麼,最後推到 GitHub,部署平台看到 GitHub 有新版本就自動更新網站。我的個人網站就是這樣運作:程式碼放在 GitHub,push 到 main 分支,Cloudflare Workers Builds 就會重新建置並部署。

第一步:打開終端機

終端機是一個只能打字的視窗。你輸入一行指令、按 Enter,電腦執行完把結果印出來。

  • macOS:按 Cmd + Space 打開 Spotlight,輸入 Terminal(或「終端機」),按 Enter。
  • Windows:按 Win + X,選「Windows PowerShell」或「終端機」。

Windows 有兩種命令列:PowerShell 和 CMD。文中的 Windows 指令都在 PowerShell 裡執行。分辨方法是看每一行開頭:PowerShell 會顯示 PS C:\Users\你的名字>,CMD 則沒有 PS。

先試幾個指令,macOS 和 Windows PowerShell 都能用:

pwd          # 顯示你現在在哪個資料夾
ls           # 列出這個資料夾裡的檔案
mkdir sites  # 建一個叫 sites 的資料夾
cd sites     # 進到 sites 資料夾
cd ..        # 回到上一層

貼上指令的快捷鍵:macOS 是 Cmd + V,Windows PowerShell 是 Ctrl + V 或按滑鼠右鍵。終端機裡不能用滑鼠點選位置,要用方向鍵移動。

第二步:裝 Git

macOS

在終端機輸入:

git --version

如果電腦還沒有 Git,macOS 會跳出視窗,問你要不要安裝「命令列開發者工具」,按「安裝」等它跑完即可。也可以直接用 Apple 提供的指令安裝:

xcode-select --install

已經裝了 Homebrew 13 的人,可以改用 brew install git,版本會比 Apple 附的新。

Windows

到 git-scm.com/install/windows 4 下載 Git for Windows(2026-11-07 查詢時是 2.56.0(4),10 月 26 日發布)。安裝程式畫面很多,全部照預設按 Next 就好;看到「Adjusting your PATH environment」時保留建議的選項。

想用指令裝也可以,在 PowerShell 執行:

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

Git 官網註明,winget 上的 Git.Git 不是 Git for Windows 團隊維護的,版本可能比官網慢一點。裝完要關掉 PowerShell 再開一個新的,新視窗才讀得到 Git。

Git for Windows 還附了 Git Bash。Claude Code 在 Windows 上找得到 Git Bash 時會用它執行指令,找不到就改用 PowerShell,兩種都能用1。

設定你的名字和 email

每一次 commit(存一個版本)都會記下作者。裝好 Git 之後設定一次就好:

git config --global user.name "你的名字"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main

最後一行讓新的 repo 預設分支叫 main,和 GitHub 一致。email 會公開在每個 commit 上,不想露出私人信箱的話,可以在 GitHub 的 Settings → Emails 找到 GitHub 給你的 noreply 地址,填那個。

第三步:註冊 GitHub,建第一個 repo

註冊帳號

到 github.com 14 註冊。免費方案就夠個人網站用:公開和私人 repo 都不限數量,每月有 2,000 分鐘的 GitHub Actions(公開 repo 不算分鐘數)、500MB 的 Packages 空間(GitHub 方案頁5,2026-11-07 查詢)。註冊後到 Settings → Password and authentication 開啟兩步驟驗證,你的程式碼和之後串接的部署平台都靠這個帳號。

裝 GitHub CLI 並登入

GitHub CLI(指令是 gh)讓你在終端機裡登入 GitHub、建 repo,不用自己處理 SSH 金鑰或 token。

macOS 有 Homebrew 的話:

brew install gh

沒有 Homebrew,就到 GitHub CLI 的 releases 頁15下載檔名含 macOS_universal.pkg 的安裝檔,雙擊安裝。

Windows PowerShell:

winget install --id GitHub.cli --source winget

裝好後登入:

gh auth login

依序選 GitHub.com、HTTPS,問到要不要用 GitHub 帳號驗證 Git 時選 Yes,再選用瀏覽器登入。終端機會給你一組代碼,貼到打開的網頁上就完成了。登入的 token 會存在系統的憑證管理裡6。

建第一個 repo 並推上去

先回到你想放專案的資料夾(例如前面建的 sites),再執行:

gh repo create my-site --private --add-readme --clone
cd my-site

第一行在 GitHub 上建一個叫 my-site 的私人 repo,附一份 README,再把它下載(clone)到電腦裡的 my-site 資料夾。打開 https://github.com/你的帳號/my-site,看得到 README 就成功了。不想用 CLI 的話,也可以在 github.com/new 16 用網頁建 repo,勾選 Add a README,再用 git clone 加上頁面給的網址下載。

之後每次改完檔案,存版本並推上 GitHub 都是這三行:

git add .
git commit -m "說明這次改了什麼"
git push

git add . 把這個資料夾裡所有改過的檔案放進待存區,git commit 存成一個版本,git push 推到 GitHub。用 AI 寫程式時,這三步通常也可以交給 AI 做,但你要知道它在做什麼。

第四步:裝 Node.js

Node.js 是執行 JavaScript 工具的環境。Astro、npm、Cloudflare 的部署工具 wrangler 都靠它。選 LTS(長期支援)版本:2026-11-07 查詢時,nodejs.org 下載頁預設給的是 v26.13.0 LTS9。

  • macOS:在 nodejs.org/en/download 9 下載 macOS 安裝檔(.pkg),雙擊照步驟裝。
  • Windows:同一頁下載 Windows 安裝檔(.msi),照預設安裝。也可以在 PowerShell 用 winget install -e --id OpenJS.NodeJS.LTS。

裝完開一個新的終端機視窗確認:

node -v
npm -v

兩行都印出版本號就好了。

為什麼要選 LTS:網站工具會規定最低版本。Astro 官方文件寫的是 Node.js v22.23.4 以上,而且不支援 v23 這種奇數版本10。我的網站在 package.json 裡也寫了 "engines": { "node": ">=22.12.0" },版本太舊時 npm 會警告。LTS 版本通常同時符合多數工具的要求。

第五步:確認四樣都裝好

開一個新的終端機視窗,依序執行:

git --version
gh --version
node -v
npm -v

四行都印出版本號,電腦就準備好了。任何一行出現 command not found(macOS)或「無法辨識」(Windows),通常是安裝後沒有開新視窗:系統的 PATH(電腦找指令的路徑清單)只會在新開的終端機裡更新。關掉重開還是找不到,就重新執行那個工具的安裝程式。

接下來:裝一個 AI 寫程式工具

電腦準備好之後,就可以裝 AI 寫程式工具,讓它在你的專案資料夾裡讀檔、寫程式、跑指令。常見的兩個是 OpenAI 的 Codex 和 Anthropic 的 Claude Code,用法很像:在終端機進到專案資料夾,打字交代任務。兩個都要付費方案才能在終端機用:Codex 用 ChatGPT 帳號登入,Plus 以上的方案含 CLI12;Claude Code 要 Claude 的 Pro、Max、Ultra、Team、Enterprise 方案或 Claude Console 帳號1。已經在付哪一家,就先裝哪一家。

安裝都只要一行,選你要的工具:

Codex

# macOS、Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

裝完開新視窗,進到剛剛的 my-site 資料夾執行 codex,第一次選「Sign in with ChatGPT」登入11。

Claude Code

# macOS、Linux、WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

裝完開新視窗,進到剛剛的 my-site 資料夾執行 claude,第一次會用瀏覽器登入1。

這兩個工具本身不需要你另外裝 Node.js,但它們幫你建網站時會用到 Node.js、Git 和 GitHub,前面裝的東西這時都派得上用場。

想深入 AI 寫程式工具比較 2026:Claude Code、Codex、Grok Build 各適合誰 用同一套標準比較誰適合、怎麼用、價格和限制,不選贏家。

新手常卡住的地方

  • 裝完說找不到指令。 先關掉終端機開新的。PATH 只在新視窗生效。
  • 在 CMD 裡貼了 PowerShell 的指令。 看開頭有沒有 PS。irm 這類指令只有 PowerShell 認得。
  • Git 問你是誰。 第一次 commit 時出現 Please tell me who you are,就是還沒做第二步那三行 git config 設定。
  • push 時要求密碼。 GitHub 已經不接受帳號密碼推送程式碼。用 gh auth login 登入過就不會再問。
  • 金鑰進了 repo。 一旦推上 GitHub 就當作外洩處理:先到該服務撤銷、換一把新的,再補 .gitignore。只刪檔案沒有用,歷史紀錄裡還在。
  • Node.js 版本太舊。 npm 出現 EBADENGINE 或 Astro 啟動失敗時,先跑 node -v,低於工具要求就重裝 LTS。

資料來源

  1. 1. Advanced setup(Claude Code) · Anthropic · 2026-11-07 查詢
  2. 2. Terminal guide for new users · Anthropic · 2026-11-07 查詢
  3. 3. Install Git on macOS · git-scm.com · 2026-11-07 查詢
  4. 4. Install Git on Windows · git-scm.com · 2026-11-07 查詢
  5. 5. GitHub Pricing · GitHub · 2026-11-07 查詢
  6. 6. gh auth login · GitHub CLI · 2026-11-07 查詢
  7. 7. Installing gh on macOS · GitHub CLI · 2026-11-07 查詢
  8. 8. Installing gh on Windows · GitHub CLI · 2026-11-07 查詢
  9. 9. Download Node.js · Node.js · 2026-11-07 查詢
  10. 10. Install Astro · Astro · 2026-11-07 查詢
  11. 11. Codex CLI · OpenAI · 2026-11-07 查詢
  12. 12. Codex pricing · OpenAI · 2026-11-07 查詢
  13. 13. Homebrew · Homebrew · 2026-11-07 查詢
  14. 14. GitHub · GitHub · 2026-11-07 查詢
  15. 15. GitHub CLI releases · GitHub CLI · 2026-11-07 查詢
  16. 16. Create a new repository · GitHub · 2026-11-07 查詢

關於作者

Kelvin Wang

電機工程師,和 AI Agent 做工具,分享工程與投資的實作筆記。

更多關於我