主題
環境安裝
本章節提供完整的開發環境安裝指南，包含 Node.js、Docker、Claude Code 及相關工具。
Node.js 安裝
最新 LTS 版本
目前最新的 Node.js LTS 版本是 v24.12.0 (Krypton)，將持續支援至 2028 年 4 月。
| 版本 | 狀態 | 代號 | 終止日期 |
|---|---|---|---|
| 24.x | Active LTS | Krypton | 2028-04-30 |
| 22.x | Maintenance LTS | Jod | 2027-04-30 |
| 20.x | Maintenance LTS | Iron | 2026-04-30 |
macOS 安裝
方法 1：官方安裝包（推薦）
- 前往 Node.js 官網
- 下載 macOS Installer (.pkg)
- 執行安裝程式並依照指示完成安裝
方法 2：使用 Homebrew
bash
# 安裝 Node.js LTS
brew install node@24
# 或使用 nvm（Node Version Manager）
brew install nvm
nvm install --lts
nvm use --ltsWindows 安裝
- 前往 Node.js 官網
- 下載 Windows Installer (.msi)
- 執行安裝程式
- 勾選「Automatically install the necessary tools」
驗證安裝
bash
node --version # 應顯示 v24.x.x
npm --version # 應顯示 10.x.xDocker Desktop 安裝
Docker Desktop 讓你可以在本機運行容器化應用程式，這對於測試和部署非常重要。
系統需求
macOS：
- macOS 14 或更新版本
- 至少 4 GB RAM
- Apple Silicon (M1/M2/M3) 或 Intel 處理器
Windows：
- Windows 10/11 64-bit: Enterprise, Pro, 或 Education 版本
- WSL 2.1.5 或更新版本
- 啟用虛擬化功能
macOS 安裝步驟
- 前往 Docker Desktop 下載頁面
- 下載 macOS 版本（選擇對應的晶片架構）
- 開啟
Docker.dmg - 將 Docker 拖曳到 Applications 資料夾
- 開啟 Docker Desktop 並完成初始設定
bash
# 驗證安裝
docker --version
docker run hello-worldWindows 安裝步驟
- 前往 Docker Desktop 下載頁面
- 下載 Windows 版本
- 執行
Docker Desktop Installer.exe - 選擇「Use WSL 2 instead of Hyper-V」（建議）
- 完成安裝後重新啟動電腦
授權注意
Docker Desktop 對於小型企業（員工少於 250 人且年收入低於 1000 萬美元）、個人使用、教育用途及非商業開源專案免費。商業用途可能需要付費訂閱。
Claude Code 安裝
Claude Code 是 Anthropic 官方的 AI 程式碼助手 CLI 工具。
方法 1：原生安裝（推薦）
原生安裝不依賴 npm 或 Node.js，是最穩定的安裝方式。
macOS / Linux / WSL：
bash
# 安裝穩定版
curl -fsSL https://claude.ai/install.sh | bash
# 或安裝最新版
curl -fsSL https://claude.ai/install.sh | bash -s latest方法 2：npm 全域安裝
bash
npm install -g @anthropic-ai/claude-code重要提醒
- 不要使用
sudo npm install -g，這會導致權限問題和安全風險 - npm 安裝版本不支援
claude update自動更新
驗證安裝
bash
claude --version
# 預期輸出: @anthropic-ai/claude-code 2.x.x首次設定
bash
# 啟動 Claude Code
claude
# 首次使用會要求登入 Anthropic 帳號
# 按照提示完成授權更新 Claude Code
bash
# 原生安裝版本
claude update
# npm 安裝版本（需要重新安裝）
npm install -g @anthropic-ai/claude-code@latestVS Code 擴充套件
建議安裝以下擴充套件以提升開發體驗：
必裝套件
| 擴充套件 | 用途 |
|---|---|
| ESLint | JavaScript/TypeScript 程式碼檢查 |
| Prettier | 程式碼格式化 |
| Tailwind CSS IntelliSense | Tailwind CSS 自動補全 |
選裝套件
| 擴充套件 | 用途 |
|---|---|
| Marp for VS Code | Markdown 簡報預覽 |
| GitLens | Git 增強功能 |
| Error Lens | 即時顯示錯誤訊息 |
一鍵安裝
bash
# 使用 VS Code CLI 安裝
code --install-extension dbaeumer.vscode-eslint
code --install-extension esbenp.prettier-vscode
code --install-extension bradlc.vscode-tailwindcss完成檢查清單
在開始開發之前，請確認以下項目都已完成：
- [ ] Node.js v24+ 已安裝
- [ ] npm v10+ 已安裝
- [ ] Docker Desktop 已安裝並運行
- [ ] Claude Code 已安裝並登入
- [ ] VS Code 及擴充套件已安裝
下一步
恭喜你完成環境設置！接下來：
- Claude Code 入門 - 學習基本操作
- MCP 設定 - 擴充 Claude 的能力
- 開發流程 - 了解完整的開發 SOP