環境安裝教學 — AI 時代的創造力

1

安裝 Node.js

Node.js 是一個讓你的電腦能執行 JavaScript 的工具。Claude Code 需要它才能安裝和運作。
你不需要學 Node.js，只需要安裝它。

步驟 1.1

下載 Node.js

前往 Node.js 官方網站，下載 LTS 版本（長期支援版，目前是 v22）。

前往 nodejs.org 下載

選哪個版本？網頁上會看到兩個按鈕，請選左邊的 LTS（推薦大多數使用者），不要選 Current。

步驟 1.2

安裝

下載完成後，打開 .pkg 檔案，按照安裝精靈一路點「繼續」直到完成。

安裝精靈：一路點「繼續」→「安裝」→ 完成

下載完成後，打開 .msi 檔案，按照安裝精靈一路點「Next」直到完成。
過程中所有選項保持預設即可。

安裝精靈：一路點 Next → Install → Finish

步驟 1.3

驗證安裝成功

打開終端機，輸入以下指令：

怎麼打開終端機？打開 Finder → 應用程式 → 工具程式 → 終端機。
或者按 Command + 空白鍵 開啟 Spotlight，輸入「Terminal」按 Enter。

怎麼打開終端機？按 Windows 鍵，輸入「PowerShell」，點擊開啟。

Terminal

$ node --version
v22.11.0 ← 出現版本號就成功了

$ npm --version
10.9.0 ← npm 會隨 Node.js 一起安裝

看到版本號（例如 v22.x.x）代表安裝成功
版本號只要 v20 以上就可以
npm 也會一起安裝好，等下需要用它安裝 Claude Code

2

安裝 Claude Code

Claude Code 是你的 AI 開發助手。它可以直接在你的電腦上幫你寫程式、建立檔案、除錯。

步驟 2.1

用 npm 安裝 Claude Code

打開終端機，輸入以下指令：

Terminal

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

added 1 package in 15s ← 等它跑完，大約 15-30 秒

出現 permission denied？在指令前面加上 sudo：
sudo npm install -g @anthropic-ai/claude-code
然後輸入你的 Mac 登入密碼（輸入時畫面不會顯示，這是正常的）。

出現權限錯誤？請用「以系統管理員身分執行」打開 PowerShell，再重新輸入指令。

步驟 2.2

驗證安裝成功

Terminal

$ claude --version
1.0.x ← 出現版本號就成功了

看到版本號代表安裝成功
上課時會一起設定 Anthropic 帳號和 API Key

3

建立 GitHub 帳號

GitHub 是程式碼的「雲端硬碟」。你寫的程式碼會備份在這裡，也會從這裡部署上線。

步驟 3.1

前往 GitHub 註冊

用你的 Email 註冊一個免費帳號。用 Google 帳號登入也可以。

前往 GitHub 註冊

步驟 3.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

4

建立 Zeabur 帳號

Zeabur 是你的作品「住」的地方。它讓你的網站 24 小時運作，全世界都看得到。

步驟 4.1

用 GitHub 帳號登入 Zeabur

前往 Zeabur，用你剛才建立的 GitHub 帳號直接登入，不需要另外註冊。

前往 Zeabur

為什麼用 GitHub 登入？因為 Zeabur 會直接從你的 GitHub 取得程式碼來部署。用同一個帳號登入，就自動串好了。

✓

全部完成！

確認以下四項都看到版本號或成功登入，你就準備好上課了。

最終確認

$ node --version
v22.11.0 ✓

$ claude --version
1.0.x ✓

$ git --version
git version 2.39.x ✓

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

回到課前作業，勾選完成

常見問題

什麼是「終端機」？

終端機是一個讓你用文字指令操作電腦的工具。Mac 上叫「Terminal」或「終端機」，Windows 上叫「PowerShell」。

你不需要學很多指令，課堂上 Claude Code 會幫你處理大部分事情。

我需要學 Node.js 嗎？

不需要。Node.js 只是 Claude Code 運作所需的基礎環境，你只需要安裝它，不需要學它。就像你需要裝 Windows 才能用 Word，但你不需要學怎麼做 Windows。

安裝時出現錯誤怎麼辦？

大部分錯誤都是權限問題。Mac 用戶試試在指令前面加 sudo，Windows 用戶試試用系統管理員身分開啟 PowerShell。

如果還是不行，把錯誤訊息截圖，上課時我們一起解決。

我的電腦很舊，可以用嗎？

只要能跑最新版的 Chrome 瀏覽器，基本上就沒問題。Node.js 和 Claude Code 對硬體要求很低。

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

課前環境安裝Step by Step

課前環境安裝
Step by Step