Claude Code 終端機安裝保姆級教學
Mac / Windows 兩條路線 — 每段指令一鍵複製，照做就會
黃志弘 Leo
2026-04-09 發佈 · 2026-08-14 更新 · 322 人看過
5 分鐘就能裝完，只要 1 行指令，需要的程式底子是 0。
為什麼非工程師也該學會打開終端機？
2026 年最強的 AI 工具幾乎都往終端機靠攏——Claude Code、Codex 這些工具最完整、最進階的能力都在命令列。原因很簡單：終端機能直接操作你的檔案、跑程式、串 API，這些是聊天視窗做不到的。學會打開終端機，等於從「跟 AI 聊天」升級成「讓 AI 幫你做事」。這個技能不綁任何一個工具，今天裝 Claude Code，明天換別的，終端機都是入口。
三件事你要先知道
- Claude Code 是「在終端機裡跑的 Claude」，可以直接讀寫你電腦上的檔案、跑指令、改程式、操作專案
- 它需要 付費帳號：Claude Pro、Max、Team、Enterprise 或 Console API 任一種都行。免費版 Claude.ai 不能用
- 本頁指令以 Anthropic 官方原生安裝為準，會背景自動更新。如指令有變動，請以官方文件為準
- 不想碰終端機？Claude Code 現在也有桌面版（Mac／Windows）、網頁版（claude.ai/code）、IDE 外掛（VS Code、JetBrains）。但終端機版功能最完整、最進階，而且「會用終端機」這個技能不綁任何工具——所以本頁帶你裝的是終端機版。
• Mac：macOS 13.0 以上
• Windows：Windows 10 1809 以上 或 Windows 11
• 記憶體：4GB 以上
• 網路：要能連到 anthropic.com
1Mac 安裝
macOS 13 以上，3 步驟裝好
打開終端機
按 Cmd + 空白鍵 叫出 Spotlight，輸入 terminal，按 Enter 打開「終端機」App。
你的名字@你的Mac ~ % 之類的字 = 找對了。這個視窗就是「終端機」，等下所有指令都貼在這裡按 Enter。貼上安裝指令，按 Enter
複製下面這行，貼到終端機按 Enter。等個 30 秒到 1 分鐘讓它跑完。
curl -fsSL https://claude.ai/install.sh | bash它在做什麼：這行指令會去 Anthropic 官方網站抓安裝腳本，幫你把 Claude Code 裝到 ~/.local/bin/claude，並把這個路徑加到你的 shell 設定裡。
裝完後你會看到「Successfully installed」之類的訊息。
claude 指令才會被認得。用 Homebrew 裝（已經有 brew 的人）
如果你已經裝過 Homebrew，也可以用這行：
brew install --cask claude-codebrew upgrade claude-code。我推薦用上面的原生安裝（STEP 2），背景自己更新比較省事。2Windows 安裝
Windows 10 1809 以上 或 Windows 11
先裝 Git for Windows（建議裝）
建議先裝，體驗更好（Unix 指令相容）；沒裝的話 Claude Code 會退回用 PowerShell 執行。
- 打開瀏覽器到 git-scm.com/downloads/win
- 下載 64-bit Git for Windows Setup
- 執行安裝檔，所有選項都用預設值，一直按 Next 到底
- 裝完不用重開機
ls、grep 這類 Unix 指令，裝了 Git Bash 執行起來比較順；沒裝也能跑，官方文件寫沒有 Git Bash 時會退回用 Windows 原生的 PowerShell。打開 PowerShell
按 開始鍵，輸入 powershell，點「Windows PowerShell」打開。
貼上安裝指令，按 Enter
複製下面這行，貼到 PowerShell 視窗按 Enter。等它跑完（30 秒到 1 分鐘）。
irm https://claude.ai/install.ps1 | iexpowershell -ExecutionPolicy Bypass -Command "irm https://claude.ai/install.ps1 | iex"它在做什麼：irm 是 PowerShell 的下載指令，iex 是執行指令。整行的意思是「去 Anthropic 官方抓安裝腳本，下載完直接執行」。
裝完後 claude 指令會被加到你的使用者環境變數裡。
claude 指令才會被認得。不想用 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 的 Terminal 或 Win 的 PowerShell）執行：
claude --version看到類似 2.x.x (Claude Code) 的版本號 = 安裝成功。
command not found 或 無法辨識？99% 是因為你裝完沒重開終端機。把終端機關掉，重新打開一個新的，再試一次。跑一次健檢，確認所有依賴都齊
claude doctor這個指令會檢查你的安裝、設定、網路、字體、shell 整合等等。看到一排綠色 ✓ 就是好了。如果有紅色 ✗，它會告訴你怎麼修。
第一次啟動 + 登入 Anthropic 帳號
挑一個你想讓 Claude 工作的資料夾，cd 進去，然後執行 claude：
cd ~/Desktop/我的專案
claude1. 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• Mac Homebrew：
brew upgrade claude-code• Win WinGet：
winget upgrade Anthropic.ClaudeCode如果哪天想完全移除
Mac / WSL：
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claudeWindows PowerShell：
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Forcerm -rf ~/.claude（Mac）或對應的 PowerShell 指令。這會清光，要想清楚。5最常卡關的點
裝完打 claude 卻說 command not found
claude 卻說 command not found最常見原因。把終端機關掉重開一個新的就好——claude 指令需要新的 shell session 才會被認得。
Windows 用 npm 安裝或執行時跳出 execution policy 錯誤
execution policy 錯誤這個錯誤只有用 npm 安裝時才會遇到，照本頁的 PowerShell 安裝指令裝的不會碰到。原因是 PowerShell 預設不准跑 npm 產生的 .ps1 腳本，在 PowerShell 跑這行解開（只影響你自己這台）：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned系統會問你要不要改，按 Y。改完再回去跑安裝指令。
登入時瀏覽器沒跳出來
看終端機裡有沒有印出一段 https://... 開頭的網址，自己複製貼到瀏覽器打開即可，效果一樣。
裝完之後想知道進階用法
看我寫的另外幾篇免費資源：
- Vibe Coding 懶人包 — 7 個核心技巧
- gstack 安裝指南 — 55 個現成技能一次裝好
- Channels 設定教學 — 把 Claude Code 接到 Telegram
- Claude Memory Framework — 讓 Claude 記住你的商業脈絡