免費版的 Claude 可以用 Claude Code 嗎？

不行，最少要 Pro。官方文件寫的是需要 Pro、Max、Team、Enterprise 或 Console 帳號。

要先裝 Node.js 嗎？

用官方的安裝指令不用。只有你堅持用 npm 裝才需要 Node.js 22 以上。

Windows 一定要裝 WSL 嗎？

不用，可以直接裝在 Windows 上，也不需要系統管理員權限。

台灣可以用嗎？

可以。Anthropic 的支援地區清單裡有台灣，香港、澳門和中國不在裡面。

Claude Code 安裝教學：Mac、Windows 一行指令裝好，順便講我踩到的坑

第一次裝 Claude Code，很容易卡在同一個地方：指令貼了、畫面也說裝好了，結果打 claude 卻跳出「找不到指令」。

這個我這次真的遇到了。為了寫這篇，我在自己的 Mac 上照官方的方式重裝了一遍，把畫面和卡住的地方都記下來。中間還出了一個小意外，放在後面講。

先確認兩件事，不然裝了也不能用

第一，你要有付費帳號。Claude Code 不包含在免費版裡，最少要 Pro，每個月 20 美元。不然會裝完、要登入了才發現。方案怎麼選，我另外寫了一篇。

第二，電腦不能太舊。官方的最低需求是這樣：

項目	需求
macOS	13.0 以上
Windows	Windows 10 版本 1809 以上
Linux	Ubuntu 20.04、Debian 10、Alpine 3.19 以上
記憶體	4 GB 以上

近五六年買的電腦大概都沒問題。

Mac：貼一行，等半分鐘

打開「終端機」。找不到的話，按 Command + 空白鍵，打「終端機」三個字就會出現。

把這行貼上去，按 Enter：

curl -fsSL https://claude.ai/install.sh | bash

接下來畫面會停住。沒有進度條，沒有百分比，什麼都沒有。不要以為它當掉了，它正在下載，等就對了。我這邊等了 24 秒。

裝完長這樣：

Setting up Claude Code...

Checking installation status...
Installing Claude Code native build latest...
Setting up launcher and shell integration...

✔ Claude Code successfully installed!

  Version: 2.1.296

  Location: ~/.local/bin/claude

  Next: Run claude --help to get started

✅ Installation complete!

你不用另外去找下載檔，這行指令會自己抓最新版。裝好的程式在 ~/.local/bin/claude，吃掉我大約 230 MB 的空間。

中間那段警告是什麼

我裝的時候，畫面中間多跳了這一段：

⚠ Setup notes:
  ● Native installation exists but ~/.local/bin is not in your PATH. Run:

    echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

看起來有點嚇人，其實它只是在說：程式裝好了，但你的終端機還不知道要去哪裡找它。這就是「找不到指令」的原因。

解法它自己都寫給你了。把最後那一行複製起來，貼上去執行：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

做一次就好，以後不會再出現。

Windows：先看你開的是哪一種視窗

先說清楚，Windows 這段我這次沒有實際裝，是照官方文件整理的。

Windows 麻煩在它有兩種終端機，指令不能混用，貼錯就會噴一串看不懂的紅字。分辨的方法是看每一行的開頭：

開頭是 PS C:\，你在 PowerShell。
只有 C:\、前面沒有 PS，你在命令提示字元，也就是 CMD。

在 PowerShell 就貼這行：

irm https://claude.ai/install.ps1 | iex

在 CMD 就貼這行：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

不用特地「以系統管理員身分執行」，一般打開就可以。

官方另外建議裝 Git for Windows。裝了，Claude Code 會用裡面的 Git Bash 跑指令；沒裝也能用，它會改用 PowerShell。

平常都在 WSL 裡工作的人，就在 WSL 的視窗裡跑 Mac 那一行，不要在 PowerShell 裝。

裝完一定要做的一件事

開一個新的終端機視窗，然後打：

claude --version

重點是「新的」。原本那個視窗還停在安裝之前的狀態，在裡面打 claude 很可能找不到。

有跳出版本號就成功了。我看到的是：

2.1.296 (Claude Code)

還是不放心的話，可以跑 claude doctor。它只會把安裝狀況列出來，不會動到任何東西。我的結果長這樣（節錄）：

Claude Code doctor

Running: native (2.1.296)
Platform: darwin-arm64
Path: ~/.local/share/claude/versions/2.1.296
Config install method: native
Search: OK (bundled)
Auto-update channel: latest

看到 Running: native，代表你用的是官方安裝程式裝的那一份。

接著進到你想工作的資料夾，打 claude。第一次會跳出瀏覽器要你登入，照著做就好。瀏覽器沒有跳出來的話，在終端機按一下 c，登入網址會被複製起來，自己貼到瀏覽器。

我踩到的坑：舊版本被默默移除了

這是我這次實測最有感的一件事。

我的電腦本來就有 Claude Code，是用 npm 裝的。這次為了測官方的安裝指令，我又跑了一次原生安裝程式。

結果它偵測到我有舊的 npm 版，直接把它移除了。至少在我那次執行的畫面上，沒有出現任何詢問。

我是後來打 claude，看到「找不到指令」才發現的。當下我還開著好幾個 Claude Code 視窗在跑別的工作。還好那些視窗都撐住了，我把原本的版本裝回去才沒事。

對大部分人來說這其實是好事，兩份並存反而容易打架。但如果你有理由要留在某個版本，裝之前先打 claude --version 把版本號記下來，之後才知道要裝回哪一版。

其他裝法

習慣用套件管理工具的人，也可以這樣裝：

方式	指令	會自己更新嗎
Homebrew（Mac）	`brew install --cask claude-code`	不會，要自己跑 `brew upgrade claude-code`
WinGet（Windows）	`winget install Anthropic.ClaudeCode`	不會，要自己跑 `winget upgrade Anthropic.ClaudeCode`
npm	`npm install -g @anthropic-ai/claude-code`	會，前提是 npm 的全域目錄可以寫入。需要 Node.js 22 以上

提醒一件事：用 npm 裝的時候不要加 sudo。官方特別警告過，這樣會搞出權限問題。

不管用哪一種，都只從上面這些官方管道裝。網路上號稱「外洩版」「解鎖版」的 Claude Code 不要碰，資安公司發現有些藏了竊密程式，經過在 Claude Code 原始碼外洩是怎麼回事。

至於看到終端機就頭痛的人，Claude Code 有桌面版 App，點一點就能用，不用背指令。下載和第一次使用的步驟在官方的桌面版快速開始。它跟終端機版差在哪，我寫在Claude Code 桌面版怎麼用。

裝不起來的時候

下面是官方整理的常見錯誤訊息。第一個我自己就中了。

你看到的訊息	怎麼回事	怎麼解
`zsh: command not found: claude`	裝好了，但終端機找不到它	執行上面那行 PATH 的指令，再開新視窗
`'claude' is not recognized`（Windows）	同上	先開新視窗再試；不行再把 `%USERPROFILE%\.local\bin` 加進 PATH
`The token '&&' is not a valid statement separator`	你在 PowerShell，卻貼了 CMD 的指令	改貼 PowerShell 那一行
`'irm' is not recognized`	你在 CMD，卻貼了 PowerShell 的指令	改貼 CMD 那一行
`syntax error near unexpected token '<'` 或 `curl: (22) ... 403`	抓到的不是安裝程式，多半是網路暫時有狀況，也可能被公司防火牆擋住	等幾分鐘再試；還是不行就改用 Homebrew 或 WinGet
`App unavailable in region`	官方的說法是所在地區不支援	台灣本身有支援。有開 VPN 的話先關掉再試（這是我猜的，官方沒有寫）
`OAuth error: Invalid code`	登入碼過期，或沒有複製完整	按 Enter 重來，瀏覽器打開後快點登完

之後要更新或移除

用官方安裝程式裝的，會在背景自己更新，下次啟動就是新版。等不及的話打 claude update。其他安裝方式的更新指令、怎麼改成晚一週的穩定版、怎麼關掉自動更新，我另外寫在Claude Code 怎麼更新。

想移除，在 Mac 上跑這兩行：

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

這只會刪掉程式本身。你的設定和對話紀錄放在 ~/.claude 資料夾和 ~/.claude.json，不會跟著不見。

裝好之後，下一步看Claude Code 教學，照著做完第一個任務。