← W1 | MACOS

環境安裝指南

從零開始，一步步在 macOS 上安裝好 Claude Code 所需的完整開發環境。

1

更新 macOS

打開「系統設定」→「一般」→「軟體更新」，安裝所有可用更新。建議使用 macOS Ventura (13) 以上版本。

2

安裝 Xcode Command Line Tools

這會安裝 git、clang 等基本開發工具。安裝視窗跳出後點選「安裝」，等待完成。

$xcode-select --install

確認安裝成功：xcode-select -p → /Library/Developer/CommandLineTools

3

安裝 Homebrew

macOS 的套件管理工具，後續安裝 Node.js 會用到。

$/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安裝完成後依提示將 brew 加入 PATH，然後確認：brew --version

4

安裝 Node.js

Claude Code 需要 Node.js v18 以上版本。

$brew install node

確認版本：node --version（需 ≥ v18）、npm --version

5

安裝 Claude Code

用 npm 全域安裝 Claude Code CLI。

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

啟動與登入

在 Terminal 輸入 claude 即可啟動。首次會開啟瀏覽器進行 Anthropic 帳號登入，完成後就能在終端機中使用了。

$claude