Setup Guide · 環境安裝教學

課前環境安裝
Step by Step

全程用 App 與安裝精靈完成,大約 75 分鐘,不需要碰終端機。

Mac
Windows
← 回到課前準備
1
安裝 Claude 桌面 App
本課全程在 Claude 桌面 App 的 Code 分頁操作,不需要打開終端機,也不需要安裝 Node.js 或 CLI。
步驟 1.1
下載並安裝 Claude App
前往官方下載頁,選 Mac 或 Windows 版本,下載後照安裝精靈完成即可。
Mac:下載 .dmg,拖進「應用程式」資料夾即完成。
Windows:下載 .exe,安裝精靈全程保留預設值,一路 Next 到底。
步驟 1.2
登入 Claude 帳號,確認看到 Code 分頁
打開 App,用你的 Claude 帳號登入(建議至少訂閱 Pro 方案)。登入後,左側側欄應該看到 「Code」 分頁,點進去就是本課的主要操作介面。
Claude — 桌面 App(示意圖)
Code 分頁
─ 在這裡下指令給 AI
─ AI 直接幫你改電腦上的檔案
─ 本課全程在這操作
  • 看到 Code 分頁代表安裝與登入成功
  • 看不到 Code 分頁?請更新 App 到最新版,或確認使用的是付費帳號(Free 方案可能看不到)
2
讓 Git 可以使用
Git 是版本控制工具,讓 Claude App 能幫你備份程式碼、部署上線。只需要裝好,不需要自己打任何 git 指令。
Windows — 需要安裝
下載 Git for Windows
前往官方頁面,下載 x64 Setup 版本:
安裝精靈全程保留預設值,一路 Next 到底即可。
安裝完成後,把 Claude App 完全關閉再重開——這樣 App 才能認得新裝的 Git。
macOS — 多數電腦已內建
先裝好 Claude App,在 Code 分頁驗收
macOS 通常已內建 Git,不需要另外安裝。先完成 Step 1 的 Claude App 安裝,課堂操作時若 App 明確提示「缺少 Git」,再照提示補裝即可;現在先不用動。
如果看到「要安裝開發者工具嗎?」點「安裝」,等完成後把 Claude App 重新開啟一次。
3
帳號都能登入
課程會用到以下帳號,請在上課前確認每個都能登入。帳號之間有串接關係,建議照順序準備。
步驟 3.1
GitHub — 程式碼的雲端備份
GitHub 是程式碼的「雲端硬碟」,也是 Zeabur 部署的來源。用 Email 或 Google 帳號免費註冊。
建議開啟兩步驟驗證,並把備份碼存到安全的地方(例如密碼管理器)。
步驟 3.2
Claude 帳號 — 已在 Step 1 登入
已在 Step 1 安裝 App 時登入,這步確認帳號與訂閱方案即可。建議至少訂閱 Pro 方案以使用 Code 分頁所有功能。
步驟 3.3
Google 帳號 — 用於 Firebase 資料庫
課程會用 Firebase 當資料庫。用 Google 帳號登入 Firebase Console 確認可以進入即可,先不用建立任何專案。
步驟 3.4
Zeabur — 作品上線的地方
Zeabur 是你的作品「住」的地方,讓網站 24 小時在線。用 GitHub 帳號直接登入,不需要另外填表單。
為什麼用 GitHub 登入?Zeabur 會直接從 GitHub 取得程式碼部署,用同一帳號登入就自動串好了。
最終確認
在 Claude App 的 Code 分頁開新對話,輸入下面這句話,Claude 回報 OK 就完成了。
Claude App — Code 分頁
你輸入:
請幫我確認這台電腦的 Git 可以使用
Claude 回報類似:
✓ Git 已安裝,版本 2.x.x,可以正常使用。
常見問題
什麼是「終端機」?
終端機是一個讓你用文字指令操作電腦的工具。Mac 上叫「Terminal」,Windows 上叫「PowerShell」。

本課不需要用到終端機。所有操作都在 Claude 桌面 App 的 Code 分頁完成,想了解 CLI 路線的工程師請看本頁最底部的進階附錄。
我需要先安裝 Node.js 嗎?
不需要。本課使用 Claude 桌面 App 的 Code 分頁,不需要安裝 Node.js 或任何 CLI 工具。
看不到 Code 分頁怎麼辦?
常見原因有兩個:
1. App 版本太舊:到 claude.com/download 下載最新版,重新安裝。
2. 帳號方案不夠:Free 方案可能沒有 Code 分頁,請確認使用 Pro 或以上方案的帳號登入。

以上確認後仍看不到,截圖帶上課一起處理。
我的電腦很舊,可以用嗎?
只要能跑最新版的 Chrome 瀏覽器,基本上就沒問題。

Mac 建議 macOS 13 以上,Windows 建議 Windows 10 以上(需能安裝 Claude App)。
進階附錄:工程師路線(終端機版 Claude Code CLI)
本課全程不需要這條路線,給想用 CLI 的工程師參考。以下是原終端機安裝教學,內容保留原樣。
安裝 Claude Code CLI
步驟 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 重新執行安裝指令。
CLI Git 驗證
在終端機確認 Git 可用
Mac 通常已經內建 Git。打開終端機驗證:
Terminal
$ git --version
git version 2.39.x ← 有版本號就 OK
如果出現「要安裝開發者工具嗎?」點「安裝」,等它完成後再輸入一次 git --version
PowerShell
> git --version
git version 2.47.x
CLI 最終確認
在終端機執行最終驗收
最終確認
$ claude --version
2.x.x

$ git --version
git version 2.39.x

# GitHub ✓ — 能登入 github.com
# Zeabur ✓ — 能登入 zeabur.com