人來過

Claude Code 終端機安裝保姆級教學

Mac / Windows 兩條路線 — 每段指令一鍵複製,照做就會

← 返回首頁
5
分鐘裝完
1 行
指令就裝好
0
需要的程式底子
先看這個

三件事你要先知道

系統需求:
• Mac:macOS 13.0 以上
• Windows:Windows 10 1809 以上 或 Windows 11
• 記憶體:4GB 以上
• 網路:要能連到 anthropic.com
1
Mac 安裝
macOS 13 以上,3 步驟裝好
Mac STEP 1

打開終端機

Cmd + 空白鍵 叫出 Spotlight,輸入 terminal,按 Enter 打開「終端機」App。

看到一個黑色或白色的視窗、左邊有 你的名字@你的Mac ~ % 之類的字 = 找對了。這個視窗就是「終端機」,等下所有指令都貼在這裡按 Enter。
Mac STEP 2

貼上安裝指令,按 Enter

複製下面這行,貼到終端機按 Enter。等個 30 秒到 1 分鐘讓它跑完。

curl -fsSL https://claude.ai/install.sh | bash
它在做什麼:
這行指令會去 Anthropic 官方網站抓安裝腳本,幫你把 Claude Code 裝到 ~/.local/bin/claude,並把這個路徑加到你的 shell 設定裡。

裝完後你會看到「Successfully installed」之類的訊息。
裝完後請關掉終端機再重新打開,這樣 claude 指令才會被認得。
Mac STEP 3(替代方案)

用 Homebrew 裝(已經有 brew 的人)

如果你已經裝過 Homebrew,也可以用這行:

brew install --cask claude-code
差別:Homebrew 版本不會自動更新,要手動 brew upgrade claude-code。我推薦用上面的原生安裝(STEP 2),背景自己更新比較省事。

2
Windows 安裝
Windows 10 1809 以上 或 Windows 11
Win STEP 1

先裝 Git for Windows(必裝)

Claude Code 在 Windows 上需要 Git Bash 才能跑,所以這步一定要先做。

  1. 打開瀏覽器到 git-scm.com/downloads/win
  2. 下載 64-bit Git for Windows Setup
  3. 執行安裝檔,所有選項都用預設值,一直按 Next 到底
  4. 裝完不用重開機
為什麼要這個?Claude Code 內部會用 Git Bash 來跑像 lsgrep 這類 Unix 指令。Windows 原生的 PowerShell 沒有這些,所以一定要靠 Git Bash 補上。
Win STEP 2

打開 PowerShell

開始鍵,輸入 powershell,點「Windows PowerShell」打開。

看到藍色背景或黑色背景的視窗、最上面寫「Windows PowerShell」 = 找對了。不需要用「以系統管理員身分執行」,一般權限就行。
Win STEP 3

貼上安裝指令,按 Enter

複製下面這行,貼到 PowerShell 視窗按 Enter。等它跑完(30 秒到 1 分鐘)。

irm https://claude.ai/install.ps1 | iex
它在做什麼:
irm 是 PowerShell 的下載指令,iex 是執行指令。整行的意思是「去 Anthropic 官方抓安裝腳本,下載完直接執行」。

裝完後 claude 指令會被加到你的使用者環境變數裡。
裝完後請關掉 PowerShell 再重新打開,這樣 claude 指令才會被認得。
Win 替代方案

不想用 PowerShell?三條替代路線

路線 A:用 CMD(命令提示字元)

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

路線 B:用 WinGet(Windows 內建套件管理員)

winget install Anthropic.ClaudeCode

路線 C:用 WSL(Windows 的 Linux 子系統)

如果你會用 WSL,直接在 WSL 裡執行 Mac 那條指令:curl -fsSL https://claude.ai/install.sh | bash。WSL 2 還支援沙盒模式,安全性更高。

遇到 The token '&&' is not a valid statement separator
代表你在 PowerShell 跑了 CMD 的指令。看一下提示符是不是 PS C:\ 開頭,是的話就是 PowerShell,請改用 STEP 3 那條 PowerShell 指令。

3
驗證 + 登入 + 第一次跑
Mac 跟 Windows 都一樣,照做就好
驗證 1

確認版本號跑得出來

在終端機(Mac 的 Terminal 或 Win 的 PowerShell)執行:

claude --version

看到類似 2.x.x (Claude Code) 的版本號 = 安裝成功。

看到 command not found無法辨識
99% 是因為你裝完沒重開終端機。把終端機關掉,重新打開一個新的,再試一次。
驗證 2

跑一次健檢,確認所有依賴都齊

claude doctor

這個指令會檢查你的安裝、設定、網路、字體、shell 整合等等。看到一排綠色 ✓ 就是好了。如果有紅色 ✗,它會告訴你怎麼修。

登入

第一次啟動 + 登入 Anthropic 帳號

挑一個你想讓 Claude 工作的資料夾,cd 進去,然後執行 claude

cd ~/Desktop/我的專案 claude
第一次跑會發生什麼:
1. Claude Code 會問你要用哪個帳號登入(Pro/Max/Console)
2. 它會跳出一個瀏覽器視窗叫你登入
3. 在瀏覽器裡用你的 Anthropic 帳號登入並按「授權」
4. 回到終端機,會看到「Login successful」
5. 然後就進入 Claude Code 的對話介面,可以開始下指令了

下次再執行 claude 就不用再登入了,它會記住你的帳號。

第一次玩

試試這幾句最簡單的指令

進入 Claude Code 之後(提示符變成 > 開頭),試試:

這個資料夾裡有什麼?
幫我寫一個 hello.py,裡面 print("我裝好 Claude Code 了")
跑跑看 hello.py

這三句跑下來如果你看到檔案被建立、被執行、看到輸出,恭喜,你已經會用 Claude Code 了。剩下的就是想叫它幫你做什麼。


4
日常維護
更新、健檢、解除安裝
更新

原生安裝會自動更新

用 STEP 2 / STEP 3 的原生安裝,Claude Code 會在背景自動下載新版,下次啟動時生效。你什麼都不用做。

想立刻更新:

claude update
用 Homebrew 或 WinGet 裝的人要手動更新:
• Mac Homebrew:brew upgrade claude-code
• Win WinGet:winget upgrade Anthropic.ClaudeCode
解除安裝

如果哪天想完全移除

Mac / WSL:

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

Windows PowerShell:

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
注意:上面只移除程式本身。如果你還想清掉所有設定(含 MCP 設定、對話紀錄、技能庫),再執行 rm -rf ~/.claude(Mac)或對應的 PowerShell 指令。這會清光,要想清楚。
5
最常卡關的點
99% 的人卡在這幾個地方

裝完打 claude 卻說 command not found

最常見原因。把終端機關掉重開一個新的就好——claude 指令需要新的 shell session 才會被認得。

Windows 跑安裝指令時跳出 execution policy 錯誤

PowerShell 預設不准跑遠端腳本。在 PowerShell 跑這行解開(只影響你自己這台):

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

系統會問你要不要改,按 Y。改完再回去跑安裝指令。

登入時瀏覽器沒跳出來

看終端機裡有沒有印出一段 https://... 開頭的網址,自己複製貼到瀏覽器打開即可,效果一樣。

裝完之後想知道進階用法

看我寫的另外幾篇免費資源:

覺得有用?追蹤我的帳號

更多 AI 工具教學 + 一人公司實戰分享

@kanisleo328

覺得有用?引用這篇分享給更多人