Setup Guide · 環境安裝教學

課前環境安裝
Step by Step

照著做，大約 10 分鐘就能完成所有安裝。

Mac
Windows
← 回到課前作業
1
安裝 Claude Code
Claude Code 是你的 AI 開發助手。它可以直接在你的電腦上幫你寫程式、建立檔案、除錯。
官方現在提供「原生安裝器」——一行指令就裝好，不需要先安裝 Node.js。
步驟 1.1
打開終端機
怎麼打開終端機？打開 Finder → 應用程式 → 工具程式 → 終端機。
或者按 Command + 空白鍵 開啟 Spotlight，輸入「Terminal」按 Enter。
怎麼打開終端機？按 Windows 鍵，輸入「PowerShell」，點擊開啟。
⚠️ 重要：開頭的 $ 不用輸入！
指令前面的 $ 只是「提示符號」，代表「這裡可以開始打字」，是終端機本來就會自己顯示的，不是指令的一部分。
例如看到 $ claude --version，你只要輸入 claude --version 就好。
（本頁的指令已經設定成：用滑鼠選取複製時，$ 不會被一起複製，可以放心框選。）
步驟 1.2
執行安裝指令
複製以下指令，貼到終端機，按 Enter：
Terminal
$ curl -fsSL https://claude.ai/install.sh | bash

Installing Claude Code... ← 等它跑完，大約 30 秒
PowerShell
> irm https://claude.ai/install.ps1 | iex

Installing Claude Code... ← 等它跑完，大約 30 秒
它在做什麼？這行指令會從官方網站下載 Claude Code 並自動安裝好，過程不需要你做任何選擇。
步驟 1.3
驗證安裝成功
先關掉終端機、重新打開一次（讓系統認得新指令），再輸入：
Terminal
$ claude --version
2.x.x ← 出現版本號就成功了
  • 看到版本號代表安裝成功
  • Mac：如果顯示「command not found」，先確認有重開終端機，再重新執行一次安裝指令
  • Windows：如果出現紅字「無法辨識 'claude'」，幾乎每台 Windows 都會遇到，照下面的修復框做就好
  • 上課時會一起設定 Anthropic 帳號和 API Key
⚠️ Windows 修復框：出現「無法辨識 'claude' 詞彙…」紅字錯誤
這不是你做錯了——是官方安裝程式在 Windows 上的已知問題：Claude Code 有安裝成功，但安裝程式沒有把它登記到系統的「指令搜尋路徑」（PATH），所以 PowerShell 找不到它。修復只要三步：

第 1 步：複製下面整行指令，貼到 PowerShell 按 Enter（執行完不會顯示任何訊息，沒反應就是成功）：
PowerShell
> [Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$env:USERPROFILE\.local\bin", [EnvironmentVariableTarget]::User)
第 2 步：把 PowerShell「整個視窗」關掉，重新開一個新的（開新分頁沒有用，一定要新視窗）。
第 3 步：在新視窗輸入 claude --version，看到版本號就修好了。

如果三步做完還是不行：貼這行指令檢查檔案有沒有裝好：
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
顯示 True = 有裝好（再確認一次是開「新視窗」）；顯示 False = 安裝沒成功，回到步驟 1.2 重新執行安裝指令。
2
建立 GitHub 帳號
GitHub 是程式碼的「雲端硬碟」。你寫的程式碼會備份在這裡，也會從這裡部署上線。
步驟 2.1
前往 GitHub 註冊
用你的 Email 註冊一個免費帳號。用 Google 帳號登入也可以。
前往 GitHub 註冊
步驟 2.2
安裝 Git（版本控制工具）
Mac 通常已經內建 Git。打開終端機驗證：
Terminal
$ git --version
git version 2.39.x ← 有版本號就 OK
如果出現「要安裝開發者工具嗎？」點「安裝」，等它完成後再輸入一次 git --version。
Windows 需要另外安裝 Git：
下載 Git for Windows
安裝時所有選項保持預設，一路 Next 即可。安裝完成後驗證：
PowerShell
> git --version
git version 2.47.x
3
建立 Vercel 帳號
Vercel 是你的作品「住」的地方。它讓你的網站 24 小時運作，全世界都看得到。
步驟 3.1
用 GitHub 帳號登入 Vercel
前往 Vercel，點 Continue with GitHub，用你剛才建立的 GitHub 帳號直接登入，不需要另外註冊。
前往 Vercel
為什麼用 GitHub 登入？因為 Vercel 會直接從你的 GitHub 取得程式碼來部署。用同一個帳號登入，就自動串好了。
已經有 Zeabur 帳號？也可以直接用 Zeabur，課程的部署平台 Vercel / Zeabur 擇一即可。
✓
全部完成！
確認以下四項都看到版本號或成功登入，你就準備好上課了。
最終確認
$ claude --version
2.x.x ✓

$ git --version
git version 2.39.x ✓

# GitHub ✓ — 能登入 github.com
# Vercel ✓ — 能登入 vercel.com（或 Zeabur，擇一）
回到課前作業，勾選完成
常見問題
什麼是「終端機」？
終端機是一個讓你用文字指令操作電腦的工具。Mac 上叫「Terminal」或「終端機」，Windows 上叫「PowerShell」。

你不需要學很多指令，課堂上 Claude Code 會幫你處理大部分事情。
我需要先安裝 Node.js 嗎？
不需要。以前 Claude Code 要透過 Node.js 的 npm 安裝，官方現在改推「原生安裝器」——一行指令直接下載獨立程式，完全不碰 Node.js。

如果你之前已經用 npm 裝過，也可以繼續用，不影響上課。
安裝時出現錯誤怎麼辦？
最常見的狀況：安裝完輸入 claude --version 卻顯示「找不到指令」。
Mac：把終端機關掉重新打開一次，通常就好了。
Windows：這是官方安裝程式的已知問題（不是你做錯），回到步驟 1.3 的「Windows 修復框」，貼一行指令就能修好。

如果還是不行，把錯誤訊息截圖，上課時我們一起解決。
我的電腦很舊，可以用嗎？
只要能跑最新版的 Chrome 瀏覽器，基本上就沒問題。Claude Code 對硬體要求很低（4GB 記憶體就夠）。

Mac 建議 macOS 13 以上，Windows 建議 Windows 10 以上。