這篇 Claude Code 安裝教學 會整理 macOS、Windows、Linux、WSL、Homebrew 與 IDE 的常見安裝方式，並補上第一次啟動、登入、初始化專案與常見錯誤排查。若你還不知道 Claude Code 是什麼，可以先看 Claude Code 完整教學 2026。
安裝前你需要準備什麼？
- 一個 Claude 或 Anthropic 帳號。
- 可以使用終端機的開發環境。
- Git，尤其 Windows 原生環境建議安裝 Git for Windows。
- 一個可以拿來測試的小型專案。
不要第一次就拿正式專案測試。先用 side project 熟悉權限、檔案修改和測試流程，會安全很多。
macOS / Linux / WSL 安裝
官方文件提供的通用安裝方式如下：
curl -fsSL https://claude.ai/install.sh | bash安裝後重新開啟終端機，確認指令是否可用：
claude --versionHomebrew 安裝
macOS 使用者也可以用 Homebrew 安裝：
brew install --cask claude-codeHomebrew 版本的好處是管理清楚；缺點是官方提醒它不會自動更新，可能也會比最新 release 慢一點。如果你想保守穩定，可以用 Homebrew；如果你想跟最新版本，使用官方 installer 會更直接。
Windows 安裝
Windows 可以在 PowerShell 或 CMD 執行：
irm https://claude.ai/install.ps1 | iex官方文件也提醒，Windows 原生環境建議安裝 Git for Windows，讓 Claude Code 可以使用 Bash 工具。沒有安裝時，它會改用 PowerShell，但某些跨平台專案的指令可能會不太一致。
第一次啟動 Claude Code
切到你的專案資料夾：
cd my-project
claude第一次執行時，Claude Code 會引導你登入。完成後，先不要急著叫它改檔案，可以先問：
請先閱讀這個專案，整理技術棧、啟動方式、測試方式。
先不要修改任何檔案。建議立刻執行 /init
進入專案後，建議立刻執行：
/init這會協助建立 CLAUDE.md，讓 Claude Code 記住專案規範、常用指令、測試方式、禁止操作和偏好。後續可以接著讀 CLAUDE.md 是什麼？ 這篇。
IDE 安裝與使用
Claude Code 也能在 VS Code、JetBrains 等開發環境中使用。對新手來說，我建議先用終端機理解它的工作方式，再接 IDE。因為終端機模式會讓你比較清楚看到它讀了什麼、改了什麼、跑了哪些指令。
常見問題排查
- 找不到 claude 指令：重新開終端機，或確認安裝路徑有沒有加入 PATH。
- Windows 指令不一致：安裝 Git for Windows，或改用 WSL。
- Claude 不知道怎麼跑專案：補 CLAUDE.md，把 test、lint、build 寫清楚。
- 權限一直確認：先用保守 permission mode，熟悉後再調整。
安裝後的第一個安全任務
我建議你的第一個任務不要是大改版，而是請 Claude Code 做一件可驗證的小事：
請找出這個專案的 README 是否過期。
只提出建議，不要修改檔案。
列出你會更新哪些段落，以及原因。等你確認它真的理解專案後，再讓它改 README、補測試或修小 bug。這樣會比一開始就放手重構整個專案更穩。
常見問題 FAQ
Claude Code 一定要用 npm 安裝嗎？
不一定。官方目前提供 native installer、Homebrew、Windows PowerShell 等方式。建議以官方文件最新指令為準。
Windows 用 Claude Code 推薦 WSL 嗎？
如果你做的是 Node.js、PHP、Python 或 Linux server 相關開發，WSL 通常會比較接近正式環境。若是純 Windows 工具鏈，原生 PowerShell 也可以。
安裝後第一件事要做什麼？
先在小型專案啟動 Claude Code，請它閱讀專案但不要修改檔案，再執行 /init 建立 CLAUDE.md。
