更新時間：2026 年 6 月
Claude Code 是 Anthropic 推出的 AI 輔助程式開發工具，可以直接在終端機中讀取專案、分析程式碼、修改檔案、執行指令、撰寫測試與協助除錯。對開發者來說，它不是單純的聊天機器人，而是能與本機開發環境整合的命令列 coding agent。
這篇教學會帶你完成 Claude Code 的最新安裝方式，涵蓋 Windows、macOS、Linux、WSL、Homebrew、WinGet，以及 npm 安裝。若你原本習慣用 fnm 管理 Node.js，也會在後段提供 fnm + npm 的進階安裝方式。
Claude Code 是什麼？
Claude Code 是 Anthropic 官方提供的命令列開發工具，讓你可以在終端機中使用 Claude 協助軟體開發。常見用途包括：
- 直接在專案資料夾中詢問程式架構
- 產生、修改與重構程式碼
- 分析錯誤訊息與測試失敗原因
- 協助撰寫單元測試與文件
- 審查
git diff中的程式變更 - 自動化重複性的開發工作
和一般網頁版 AI 工具相比，Claude Code 的優勢是可以直接理解目前專案檔案、終端機輸出與 Git 狀態，因此更適合實際開發流程。
安裝方式怎麼選？
目前 Anthropic 官方建議優先使用原生安裝器。npm 仍然可以使用，但比較適合已經熟悉 Node.js 生態系的開發者。
| 安裝方式 | 適合對象 | 是否需要 Node.js | 更新方式 |
|---|---|---|---|
| 官方安裝器 | 大多數使用者，推薦 | 否 | 自動背景更新 |
| WinGet | Windows 使用者 | 否 | winget upgrade Anthropic.ClaudeCode |
| Homebrew | macOS 使用者 | 否 | brew upgrade claude-code |
| apt / dnf / apk | Linux 使用者 | 否 | 使用系統套件管理器 |
| npm | Node.js 開發者 | 是，Node.js 18+ | npm install -g @anthropic-ai/claude-code@latest |
| fnm + npm | 需要管理多版本 Node.js 的開發者 | 是，Node.js 18+ | 透過 npm 更新 |
如果你只是想最快開始使用，建議選官方安裝器。若你正在寫 Node.js 專案，並且已經習慣用 fnm、nvm 或其他 Node.js 版本管理器，再考慮 npm 安裝。
系統需求
安裝前請確認環境符合以下條件：
- 作業系統：
- macOS 13.0+
- Windows 10 1809+ 或 Windows Server 2019+
- Ubuntu 20.04+
- Debian 10+
- Alpine Linux 3.19+
- 處理器：x64 或 ARM64
- 記憶體：4GB RAM 以上
- 網路：需要可連線到 Anthropic 服務
- Shell：Bash、Zsh、PowerShell 或 CMD
Claude Code 可以在 Windows 原生環境執行，也可以在 WSL 中執行。若你的專案主要放在 Windows 檔案系統，建議使用 Windows 原生安裝；若你的開發環境以 Linux 工具鏈為主，則建議使用 WSL 2。
方法一：使用官方安裝器安裝 Claude Code
這是目前最推薦的安裝方式。
macOS、Linux、WSL
開啟終端機，執行：
curl -fsSL https://claude.ai/install.sh | bash
安裝完成後，重新開啟終端機，或依照畫面提示重新載入 shell 設定。
接著執行：
claude
Windows PowerShell
開啟 PowerShell，執行：
irm https://claude.ai/install.ps1 | iex
安裝完成後，重新開啟 PowerShell，執行：
claude
如果你看到 irm 無法辨識，代表你可能是在 CMD 而不是 PowerShell。PowerShell 的提示字元通常會顯示 PS C:\...。
Windows CMD
如果你使用 CMD，請依照 Claude Code 官方文件提供的 CMD 安裝方式操作。Windows 使用者也可以改用 WinGet 安裝，流程更直覺。
方法二：使用 WinGet 安裝 Claude Code
Windows 使用者可以用 WinGet 安裝：
winget install Anthropic.ClaudeCode
安裝完成後執行：
claude
WinGet 安裝不會自動更新，建議定期執行：
winget upgrade Anthropic.ClaudeCode
方法三：使用 Homebrew 安裝 Claude Code
macOS 使用者可以用 Homebrew 安裝穩定版：
brew install --cask claude-code
安裝完成後：
claude
Homebrew 安裝不會自動更新，建議定期執行：
brew upgrade claude-code
如果你想追最新版本，也可以依官方文件選擇 claude-code@latest cask。
方法四：使用 npm 安裝 Claude Code
如果你偏好 npm，也可以用 npm 安裝 Claude Code。這個方式需要 Node.js 18 或更新版本。
先確認 Node.js 與 npm：
node --version
npm --version
如果 Node.js 版本是 18 以上，就可以安裝：
npm install -g @anthropic-ai/claude-code
安裝後確認版本：
claude --version
啟動 Claude Code：
claude
更新 npm 安裝的 Claude Code 時，建議使用：
npm install -g @anthropic-ai/claude-code@latest
不建議使用 sudo npm install -g，因為容易造成權限問題，也可能帶來安全風險。
方法五：使用 fnm 管理 Node.js 並安裝 Claude Code
如果你同時開發多個 Node.js 專案，建議使用 fnm 管理 Node.js 版本。fnm 是 Fast Node Manager，可以快速安裝與切換不同 Node.js 版本。
安裝 fnm
macOS、Linux 或 WSL 可執行：
curl -fsSL https://fnm.vercel.app/install | bash
安裝完成後，依照你的 shell 重新載入設定：
source ~/.bashrc
或：
source ~/.zshrc
確認 fnm 已安裝：
fnm --version
安裝 Node.js
Claude Code 的 npm 安裝需要 Node.js 18 以上。你可以安裝 Node.js 22：
fnm install 22
fnm use 22
fnm default 22
確認版本：
node --version
npm --version
安裝 Claude Code
npm install -g @anthropic-ai/claude-code
確認安裝：
claude --version
啟動：
claude
首次登入與認證
安裝完成後，進入你的專案資料夾，執行：
claude
Claude Code 會引導你完成登入與認證流程。依目前官方說明，Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 帳號；免費 Claude.ai 方案不包含 Claude Code 存取權限。
如果你是使用 Anthropic Console、Amazon Bedrock、Google Vertex AI 或其他企業環境，也可以依照團隊設定使用 API 或雲端供應商的認證方式。
基本使用方式
在專案中啟動 Claude Code
cd my-project
claude
進入 Claude Code 後，你可以直接詢問：
請分析這個專案的架構，並指出最需要改善的地方
直接用一行指令詢問
claude "請說明這個專案的測試如何執行"
搭配 Git Diff 做程式碼審查
git diff | claude "請審查這些變更，指出可能的 bug、風險與缺少的測試"
從檔案讀取提示
claude < prompt.txt
模型設定
Claude Code 支援使用模型 alias，不需要硬記完整模型版本名稱。常見 alias 包括：
| Alias | 用途 |
|---|---|
default |
使用目前帳號建議的預設模型 |
sonnet |
適合日常 coding 工作 |
opus |
適合複雜推理與大型任務 |
haiku |
適合快速、簡單任務 |
best |
使用目前最強能力模型 |
啟動時指定模型：
claude --model opus
在 Claude Code 互動模式中切換模型：
/model
或：
/model sonnet
如果要設定預設模型，可以使用 Claude Code 的 /config 介面，或設定 ANTHROPIC_MODEL 環境變數。
設定檔位置
Claude Code 使用 settings.json 管理設定，常見位置包括：
| Scope | 位置 | 用途 |
|---|---|---|
| User | ~/.claude/settings.json |
個人全域設定 |
| Project | .claude/settings.json |
專案共享設定，可提交到 Git |
| Local | .claude/settings.local.json |
個人專案設定，通常不提交 |
範例：
{
"model": "sonnet"
}
若是團隊或企業環境，建議由管理者統一規劃專案設定與權限設定。
常見問題排除
claude: command not found
可能原因是安裝路徑尚未加入 PATH，或安裝後尚未重新開啟終端機。
可以先重新開啟終端機，再執行：
claude --version
如果仍然失敗，請回到安裝器輸出內容，確認是否有提示要加入 shell 設定檔。
npm 安裝時出現權限錯誤
不要使用 sudo npm install -g。建議改用官方安裝器，或設定 npm 的全域安裝目錄。
例如：
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
再把 npm global bin 加入 PATH。Bash 使用者可以加入：
echo 'export PATH="HOME/.npm-global/bin:PATH"' >> ~/.bashrc
source ~/.bashrc
Zsh 使用者可以加入：
echo 'export PATH="HOME/.npm-global/bin:PATH"' >> ~/.zshrc
source ~/.zshrc
Windows 該用原生安裝還是 WSL？
如果你的專案、Node.js、Git、IDE 都在 Windows 環境，建議使用 Windows 原生 Claude Code。
如果你的專案在 WSL 裡，或你依賴 Linux 工具鏈，建議在 WSL 內安裝 Claude Code。
不要在 Windows 裝一次、WSL 又混用同一組工具。在哪個環境開發，就在哪個環境安裝與執行。
使用 npm 安裝後無法更新到最新版
請使用：
npm install -g @anthropic-ai/claude-code@latest
不要只依賴：
npm update -g @anthropic-ai/claude-code
因為 npm update -g 可能受原始安裝版本範圍限制，不一定會更新到最新版本。
API Key 或登入失敗
請先確認你的帳號類型是否支援 Claude Code。依官方說明，Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 帳號。
如果你使用企業、Console、Bedrock 或 Vertex AI 環境，請依照公司或雲端平台提供的認證方式設定。
快速安裝腳本
如果你使用 macOS、Linux 或 WSL，並想用官方安裝器快速安裝，可以建立 install-claude-code.sh：
#!/usr/bin/env bash
set -euo pipefail
echo "Installing Claude Code..."
curl -fsSL https://claude.ai/install.sh | bash
echo "Done. Restart your terminal, then run:"
echo "claude"
執行：
chmod +x install-claude-code.sh
./install-claude-code.sh
如果你使用 Windows PowerShell，直接執行官方安裝指令即可：
irm https://claude.ai/install.ps1 | iex
Claude Code 實用技巧
讓 Claude 先理解專案
第一次進入專案時，可以先問：
請閱讀這個專案的 README、package 設定與主要目錄，整理專案架構與開發指令
要求 Claude 先提出計畫
對於比較大的修改，可以先要求：
請先分析問題並提出修改計畫，不要直接改檔
確認方向後再讓 Claude 實作。
搭配測試流程
可以要求 Claude 修改後執行測試：
請修正這個 bug，完成後執行相關測試並整理結果
審查自己的變更
提交前可以執行：
git diff | claude "請用 code review 的角度檢查這次變更"
這很適合用來找出邊界條件、缺少的測試與可能的回歸風險。
更新與維護
不同安裝方式的更新指令不同：
| 安裝方式 | 更新指令 |
|---|---|
| 官方安裝器 | 通常會自動背景更新 |
| WinGet | winget upgrade Anthropic.ClaudeCode |
| Homebrew | brew upgrade claude-code |
| npm | npm install -g @anthropic-ai/claude-code@latest |
你也可以執行：
claude doctor
檢查 Claude Code 的安裝與更新狀態。
結語
Claude Code 已經從早期偏向 Node.js/npm 的安裝方式，逐步轉向官方原生安裝器與各平台套件管理器。對大多數使用者來說，現在最簡單的方式是直接使用官方安裝器；只有在你明確需要 npm 工作流程時，才建議使用 fnm + npm。
安裝完成後，建議從現有專案開始嘗試，先讓 Claude Code 分析專案結構、整理開發指令，再逐步用於除錯、測試、重構與程式碼審查。這樣能更快看出它在實際開發流程中的價值。
相關資源
- Anthropic Claude Code 官方文件：https://code.claude.com/docs/en/setup
- Claude Code 設定文件：https://code.claude.com/docs/en/settings
- Claude Code 模型設定：https://code.claude.com/docs/en/model-config
- Anthropic Console：https://console.anthropic.com
- fnm 官方網站：https://github.com/Schniz/fnm
