必備缺此無法上課
Claude 付費帳號
本課程核心圍繞 Cowork 功能，必須付費帳號才能使用。建議報名後至少提早一週開通，避免當天卡關。
請使用電腦付費，不要使用手機！
Read Before You Register
設備和帳號需求
這是一堂實作課，沒有準備好的話，當天會跟不上節奏。以下兩項缺一不可，請在開始前確認。
必備
Mac 或 Windows 筆電
請自備能連網的筆電，不接受手機或平板。Mac 與 Windows 課前教材會分別提供，報名後依作業系統分流。
Mac 必須為 M 系列晶片；Windows 建議配備 16GB RAM。
Start Here
先學會打開終端機
後面的安裝指令都要貼在終端機裡。Mac 請開 Terminal；Windows 請開 PowerShell，不要開到 CMD。
Mac：用 Spotlight 開 Terminal
按 Command + Space，輸入 Terminal，按 Enter。
Search: Terminal
Terminal.app
Applications
System Settings
weifeng@MacBook ~ %
把 Mac 指令貼在這裡
Mac 截圖示意：Spotlight 搜尋 Terminal，打開後會看到 `%` 或 `$` 開頭。
Windows：用開始選單開 PowerShell
按 Windows 鍵，輸入 PowerShell，選 Windows PowerShell。
Search: PowerShell
Windows PowerShell
Terminal
Command Prompt
PS C:\Users\你的名字>
把 Windows 指令貼在這裡
Windows 截圖示意：PowerShell 開頭通常會有
PS C:\Users\你的名字>。
Step 01
GH
CF
VC
SB
先把需要的帳號註冊好
帳號是後面上傳專案、建立資料庫、部署網站、設定網域時會用到的身分。先註冊 GitHub，再從兩個方案擇一：使用 Cloudflare（自帶部署和資料庫），或註冊 Vercel（網站部署）+ Supabase（資料庫）。新手建議用同一個 Google 或 GitHub 身分串起來。
GitHub 帳號
請先註冊 GitHub 帳號。建議直接使用 Google 帳號登入，會最簡單。註冊後記得完成 email 驗證，否則有些基本功能不能用。
建議 Google 登入程式碼雲端倉庫
Cloudflare 帳號
請註冊 Cloudflare 帳號。它可以同時處理網站部署、資料庫、買網域、DNS 指向與網站防護。可用 Google、Apple、GitHub 或 email 註冊。
方案一部署 + 資料庫DNS / 網域
Vercel 帳號
請註冊 Vercel 帳號。建議使用 Google 帳號登入。若你不走 Cloudflare 一站式方案，網站部署通常會用 Vercel。
方案二網站部署
Supabase 帳號
請註冊 Supabase 帳號。建議使用剛剛建立好的 GitHub 帳號登入。若你選 Vercel 部署，資料庫、登入系統、後台資料通常會用 Supabase。
方案二資料庫
Account Screens
註冊頁面大概會長這樣
GitHub
Continue with Google
Email
Password
Create account
示意畫面：新手優先選 Continue with Google。
Supabase 實際註冊頁：優先選 Continue with GitHub。
Vercel / Cloudflare
Continue with Google
Continue with GitHub
Email
Sign up
示意畫面：選你最常用、最不會忘記的登入方式。
Step 02
Git
VS
CLI
再安裝本機必要工具
Claude Code 不是只在網頁上聊天。它會在你的電腦資料夾裡讀檔、改檔、跑指令。新手最精簡流程是：先準備 Git、VS Code 和終端機，再用原生安裝裝 Claude Code；不需要先裝 Node.js。
Git：專案的存檔點
Git 讓你把專案存成一個個版本。AI 改壞時，你才有機會回到前一版。Windows 建議裝 Git for Windows，會一起裝 Git Bash。
VS Code：工作桌
用 VS Code 打開專案資料夾，看檔案、看修改、開終端機都在同一個畫面。新手會比只用黑色終端機安心很多。
Terminal：輸入指令的地方
Mac 叫 Terminal，Windows 建議用 PowerShell。Claude Code 第一次安裝與啟動都會在這裡完成。
Git Install
Git 安裝與確認
1
先檢查有沒有 Git
打開 Terminal，貼上這行。如果有版本號，就代表已經有 Git。
git --version
2
沒有 Git 時安裝 Homebrew
Homebrew 可以理解成 Mac 工具 App 商店。貼上官方指令後，照畫面輸入 Mac 密碼。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3
用 Homebrew 安裝 Git
brew install git git --version
Mac 新手提醒
密碼輸入時畫面不會出現星號，這是正常的。若跳出要求安裝 Apple Command Line Tools，按確認即可。
1
2
安裝精靈一路 Next
新手不用改設定。安裝完成後會有 Git 和 Git Bash。
3
確認安裝成功
打開 PowerShell 或 Git Bash，貼上：
git --version
Windows 為什麼建議裝 Git？
Claude Code 在 Windows 可直接用 PowerShell；但裝 Git for Windows 後，也能提供 Git Bash，對很多開發工具比較友善。
VS Code
VS Code 安裝與第一次開資料夾
1
下載 VS Code
到官方下載頁，Windows 選 User Installer，Mac 選符合晶片的 .dmg 或 Universal 版本。
2
建立專案資料夾
例如在桌面建立 my-first-claude-project。之後 Claude Code 只在這個資料夾內工作，比較安全。
3
用 VS Code 打開資料夾
選單選 File → Open Folder，選剛剛建立的資料夾。再用 Terminal → New Terminal 叫出下方終端機。
VS Code
Explorer：my-first-claude-project
index.html
README.md
Terminal → New Terminal
示意畫面：上方看檔案，下方開終端機輸入指令。
Step 03
Claude Code 安裝指令
本頁採官方推薦的原生安裝。新手照下面選自己的系統即可，不走 npm 安裝，因此不需要先裝 Node.js。
官方 Claude Code Setup 文件截圖：系統需求與安裝方式會以官方頁為準。
推薦
Mac 原生安裝
打開 Terminal，貼上：
curl -fsSL https://claude.ai/install.sh | bash
安裝完重新開 Terminal，再確認：
claude --version claude doctor
備用
Homebrew 安裝
brew install --cask claude-code claude --version
Homebrew 版本需要手動更新：
brew upgrade claude-code
推薦
Windows PowerShell 安裝
打開 PowerShell，貼上：
irm https://claude.ai/install.ps1 | iex
安裝完重新開 PowerShell，再確認：
claude --version claude doctor
備用
WinGet 安裝
winget install Anthropic.ClaudeCode claude --version
WinGet 版本需要定期手動更新：
winget upgrade Anthropic.ClaudeCode
如果你看到錯誤訊息
PowerShell 開頭通常會看到 PS C:\；CMD 則沒有 PS。如果指令說 irm 不認得，你可能在 CMD；如果說 && 不是合法分隔符，你可能在 PowerShell。回到對應終端機重貼正確指令。
Step 04
Claude Desktop 與 Cowork 安裝
Claude Desktop 是桌面版 Claude，也是 Cowork 常用入口。它適合圖形介面操作，但不取代上面的 Claude Code CLI 驗證；請兩個都裝好，課堂上比較不會卡住。
官方下載頁：到
claude.ai/download，選 macOS 或 Windows。網址請認明 claude.ai / claude.com。1
2
Mac 安裝
下載 macOS 版本，打開 .dmg，把 Claude 拖到 Applications。之後從 Applications 打開 Claude 並登入。
3
Windows 安裝
下載 Windows 版本，打開安裝檔；若跳出「是否允許變更」，按「是」。安裝完從 Start menu 開啟 Claude。
4
Cowork 權限
Cowork 需要付費 Claude 方案。PDF 教學中也提醒：免費版不能用 Cowork；Claude Pro、Max、Team、Enterprise 才可用。
Optional
Claude Chrome Extension（Cowork 常用）
Chrome
只用 Google Chrome 安裝
PDF 教學提到 Claude Chrome Extension 只支援 Google Chrome。它讓 Claude 能看到你正在瀏覽的網頁、點按、填表，適合 Cowork 做瀏覽器自動化。
PIN
安裝後釘選在右上角
進入 Chrome Web Store 後按 Add to Chrome。安裝完成後，點 Chrome 右上角拼圖圖示，把 Claude 釘選起來，之後比較好找。
Step 05
必跑
必跑
建議
不用
環境安裝驗證
這一步只確認工具有沒有裝好，還不是正式開始使用 Claude Code。請打開終端機，依序貼上下面指令；看到版本號或檢查結果，就代表基本環境已經準備好。
Claude Code 是否成功
先確認電腦找得到 Claude Code，再用 doctor 檢查登入、更新與環境狀態。
claude --version
claude doctor
Git 是否成功
Git 是專案存檔與上傳 GitHub 的基礎。看到版本號就代表可用。
git --version
VS Code 指令是否可用
如果這行有版本號，代表之後可以從終端機直接打開 VS Code。若沒有，也可以先用 VS Code App 手動開資料夾。
code --version
不檢查 Node.js
本頁使用 Claude Code 原生安裝，不走 npm 安裝，所以這裡不要求 node --version 或 npm --version。之後做網站真的需要時，再請 Claude Code 協助安裝即可。
Final Check
最後確認：看到 Claude Code 主畫面
完成 Step 05 的安裝驗證後，先確認能看到 Claude Code 主畫面。第一次啟動會引導登入、選主題或確認是否信任目前資料夾；看到主畫面就代表安裝與啟動成功。若卡住，再看下一段 Troubleshooting。
1. Mac 可用 Terminal，也可用 VS Code 內建 Terminal；輸入
claude 後按 Enter。
2. 第一次進入資料夾時，選
Yes, I trust this folder，再按 Enter 確認。
3. 看到 Claude Code 版本、模型與下方輸入列，代表已成功進入 Claude Code。
Windows 成功畫面：可用 PowerShell 或 VS Code 內建 Terminal；看到主題選擇或 Claude Code 主畫面，代表啟動成功。
Troubleshooting
新手常見卡關
輸入指令後說 command not found
先關掉 Terminal 重開，再跑 claude --version。還是不行就跑 claude doctor，或重新安裝。
Windows 顯示 PATH 提醒
若安裝成功但畫面提醒 .local\bin 不在 PATH，代表 Claude Code 已裝好，但系統還找不到指令。把 C:\Users\你的名字\.local\bin 加到使用者 PATH，然後重開 PowerShell。
Windows 不知道開哪個終端機
新手先用 PowerShell。看到開頭是 PS C:\Users\你的名字 就對了。
claude doctor 說尚未登入
若看到 OAuth token、subscriber auth 或 Run claude auth login，請在 PowerShell 執行 claude auth login，完成瀏覽器登入或貼上驗證碼。
害怕 Claude 改壞檔案
先用 Git 存檔，再讓 Claude 改。Claude 改檔前會顯示 diff，確認沒問題再同意。
登入後還是不能用 Claude Code
Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 帳號。免費 Claude.ai 方案不包含 Claude Code access。
GitHub 不知道要不要付費
新手先用免費個人帳號即可。完成 email 驗證，並建議開啟 2FA。
下載頁長得怪怪的
停止下載。Claude Desktop 請只用 claude.ai/download 或 claude.com/download。
Windows PATH 提醒：看到
Claude Code successfully installed 代表安裝成功；若同時看到 PATH 提醒，照上方方式補上路徑後重開 PowerShell。
claude doctor 登入提醒：出現 OAuth 或 subscriber auth 錯誤時，先執行 claude auth login 完成登入。
Step 06
進入專案並初始化 Claude Code
確認 Claude Code 可以成功啟動後，下一步才是進入真正要工作的專案資料夾。建議新手用 VS Code 內建 Terminal，因為它通常會直接停在目前專案資料夾；若用 Mac Terminal 或 Windows PowerShell，也一定要先切到專案資料夾，再執行 /init。
推薦
用 VS Code 內建 Terminal
先用 VS Code 打開你的專案資料夾，再點上方選單 Terminal → New Terminal。終端機通常會自動在這個資料夾裡。
# Mac 檢查目前位置 pwd # Windows PowerShell 檢查目前位置 Get-Location
備用
用原生 Terminal 或 PowerShell
如果你直接打開 Mac Terminal 或 Windows PowerShell，通常會停在使用者目錄。請先用 cd 進入專案資料夾。
# Mac 範例 cd ~/Desktop/my-first-claude-project # Windows PowerShell 範例 cd "$env:USERPROFILE\Desktop\my-first-claude-project"
1
確認位置後啟動
確認終端機已經在專案資料夾後，再輸入 claude。若前面 claude doctor 提醒尚未登入，先執行 claude auth login。
claude
2
建立專案規則檔
進入 Claude Code 後輸入 /init。它會在目前資料夾建立 CLAUDE.md，所以不要在桌面、下載或使用者目錄直接執行。
/init
3
做第一個安全任務
先從低風險任務開始，例如整理 README 或說明專案結構。
請用 5 個重點說明這個資料夾目前有哪些檔案，以及它們可能的用途。
提醒
先選資料夾，再讓 Claude 工作
Claude Code 會讀取並修改目前資料夾的檔案。新手不要在整個桌面、下載資料夾或使用者根目錄啟動，避免範圍太大。