适合你吗？
- 確認系統符合文件列出的 OS／RAM 門檻
- 選一條安裝通道：原生 install 腳本／Homebrew／WinGet／Linux 套件庫
- 執行官方指令後新開終端
- 跑 claude --version，必須印出版本號
- 在目標專案目錄執行 claude 並完成登入
- 可選：claude doctor 看安裝與設定診斷
- 失敗：command not found → 先修 PATH，不要重裝兩次掩蓋問題
快速结论
「Claude Code 安裝」以 Anthropic Claude Code setup（核於 2026-10-25）為準：macOS、常見 linux 發行版與 wsl 用 curl -fsSL https://claude.ai/install.sh | bash；windows 用文件中的 irm … | iex 路徑。裝完新開終端跑 claude --version，能印出版本號才算通過。登入需要付費方案或 Anthropic Console；免費 claude.ai 方案不含 Claude Code。Homebrew 可用 brew install --cask claude-code，但不會自動更新。選型對照見Codex vs Claude Code、Claude Code vs Cursor；港區訂閱見Claude 香港指南。
一句話結論
安裝成功的定義很窄：殼層找得到 claude，且 claude --version 有輸出。登入與訂閱是下一步，不要把「腳本跑完沒報錯」當成已可用。
以下步驟與失敗判據都對應 setup 頁；第三方博客的舊 npm 全域安裝說明可能已過時，官方仍列出 npm 路徑但標了注意事項，新手優先原生安裝。
逐步安裝（通過／失敗判據）
| 步驟 | 動作 | 通過 | 失敗／處理 |
|---|---|---|---|
| 1 | 打開終端；確認有網路 | 能訪問 claude.ai／downloads.claude.ai | 公司代理攔截 → 換網路或配代理 |
| 2 | macOS／Linux／WSL：curl -fsSL https://claude.ai/install.sh | bash | 安裝程序結束且無 403／語法錯 | 見 setup 頁 Troubleshoot；403 常是地區或防火牆 |
| 3 | Windows：在 PowerShell 跑 irm https://claude.ai/install.ps1 | iex（CMD 用 install.cmd 流程） | 提示完成 | irm 無法辨識 → 你在 CMD 不是 PowerShell |
| 4 | 關閉終端，新開一個 | 新 session 載入 PATH | 不新開就驗證，容易誤判失敗 |
| 5 | claude --version | 印出版本字串（文件示例形如含 Claude Code） | command not found → Fix your PATH（setup 頁） |
| 6 | 在專案目錄跑 claude 並登入 | 進入互動 session | 免費方案被拒 → 升級訂閱或改 Console／API 金鑰流程 |
| 7 | 可選 claude doctor | 安裝健康與設定警告可讀 | 依警告修 settings.json，不要無視 |
原生安裝會在背景自動更新；Homebrew／WinGet／Linux 套件庫預設要手動升級（setup 頁說明）。
其他安裝通道
Homebrew：brew install --cask claude-code（stable）或 claude-code@latest。升級用對應的 brew upgrade。
WinGet：winget install Anthropic.ClaudeCode；升級 winget upgrade Anthropic.ClaudeCode。
Linux 套件庫：setup 頁提供 apt／dnf／apk 簽名倉庫步驟；適合要公司統一發版的環境。
npm：npm install -g @anthropic-ai/claude-code（需較新 Node；官方提醒不要 sudo npm install -g）。新手仍建議原生安裝。
Windows 與 WSL 注意
可在原生 Windows 或 WSL 內安裝。專案在 Linux toolchain／需要 sandbox 時，文件建議 WSL 2。
原生 Windows 建議另裝 Git for Windows，以便 Bash 工具；未裝時 Claude Code 改走 PowerShell 工具。
PowerShell 與 CMD 的安裝指令不同：看到 PS C:\ 才是 PowerShell；在錯誤殼層貼指令會得到 irm 或 && 語法錯。
裝完後的最小設定
在倉庫根目錄準備 CLAUDE.md（團隊慣例、測試指令、禁止目錄），減少代理反覆詢問。
需要 API 金鑰且已 export ANTHROPIC_API_KEY 時，文件說明首次可能跳過瀏覽器登入提示（仍以當日 Authentication 頁為準）。
若你還在選 Codex 或 Cursor，先回到上文選型對照連結，並用站內 Cursor 對照文確認產品形態，避免裝錯。
安裝前檢查清單
先確認三件事，再貼 install 指令。第一，作業系統是否落在官方支援表：文件寫 macOS 13 以上、Windows 10 1809 以上搭配 WSL 或原生路徑、以及常見 Linux 發行版。第二，是否已有付費 Claude 方案或 Anthropic Console 授權；免費網頁帳不含 Claude Code。第三，終端能否訪問官方下載域名；公司代理與 SSL 攔截會讓 curl 管線靜默失敗。
硬體建議以官方系統需求為準，實務上至少預留數 GB 可用磁碟與 4GB 以上記憶體，避免大倉庫索引時被系統殺行程。若你只能用鎖定映像的公司筆電，先問 IT 是否允許 Homebrew cask，或需走內部軟體目錄。
把「安裝成功」定義成可核對的口令：新開終端執行 claude --version 有版本號；再執行 claude doctor（若當日文件仍提供）做唯讀診斷。只有聊天框能打字但讀不到專案檔，不算過關。
逐步：原生腳本與驗證
官方推薦原生安裝（macOS、Linux、WSL）大致為：在終端執行 curl -fsSL https://claude.ai/install.sh | bash，然後重開終端或重新載入 shell profile，再跑 claude --version。指令以 Claude Code setup 當日頁面為準，不要抄過期部落格。
通過條件：版本號印出；在 git 倉庫目錄執行 claude 能進入互動流程並提示登入。失敗條件：指令回 permission denied（檢查目錄寫入權）、curl 非零（檢查代理與 DNS）、裝完仍 command not found（PATH 未含安裝目錄，重開終端或手動加 PATH）。
登入階段：依提示用瀏覽器完成 OAuth 或文件所述方式。若帳號只有免費 claude.ai，終端會卡在授權。這是產品邊界，不是安裝腳本壞掉。升到 Pro、Max、Team、Enterprise 或走 Console 後再重試。
第一次進專案建議立刻建或補 CLAUDE.md：寫清套件管理器、測試指令、禁止修改的目錄。沒有這份檔，代理會反覆問同樣問題，看起來像不好用，其實是缺少專案合約。
Homebrew、套件管理器與企業鎖定環境
若資安禁止 curl 管線直裝，改走文件列出的套件管理器路徑。Homebrew 示例：brew install --cask claude-code；之後升級用 brew upgrade claude-code。cask 不會像你以為的那樣自動跟上游日更，需納入週期維護。
部分環境也提供 npm 全域安裝通道；是否仍推薦以 setup 頁為準。企業映像若鎖死全域 npm prefix，改用 IT 核准的內部鏡像，或把二進位放在使用者可寫的目錄。
離線或氣隙機房：Claude Code 需要雲端推理，無法當純離線編譯器。若政策禁止原始碼出站，先停在採購評估，不要硬裝完才發現合規不過。
版本釘選：生產支援的工程師應記錄「通過驗證的 CLI 版本號」，升級前在影子環境重跑 doctor 與一個小任務，再推全員。
Windows 與 WSL 細節
Windows 使用者優先核官方是否要求 WSL2，或已提供原生 Windows 安裝通道（以當日 setup 為準）。WSL 路徑下：在 Linux 發行版終端執行與 macOS、Linux 相同的 install.sh；專案檔放在 WSL 檔系統內效能較穩。掛載在 /mnt/c/ 底下的大型倉庫偶發較慢或檔案監看異常。
通過條件：WSL 終端內 claude --version 正常，且能讀到倉庫內原始碼。失敗條件：只在 PowerShell 裝了、卻在 WSL 裡 command not found。兩邊 PATH 不共用，需在實際會開發的殼裡重裝。
公司 VPN 只注入 Windows 主機、不進 WSL 時，會出現瀏覽器能開 claude.ai、WSL 裡 curl 失敗。把代理環境變數寫進 WSL profile，或改在有網路的時段完成安裝與登入。
防毒軟體偶發隔離新下載的二進位：若版本命令瞬間消失，先查隔離區與企業白名單，再重裝。
裝完後的最小設定與權限
最小可用設定有四項：登入成功；專案根有一份不過期的 CLAUDE.md；知道如何退出與中斷長任務；git 狀態乾淨時再讓代理大改，方便回滾。
權限與核准：依文件開啟的核准或沙箱模式，決定代理能否直接跑破壞性指令。團隊規範建議：生產憑證、雲端刪除、強制推送列為人工確認。不要為了更快把所有核准關掉。
升級節奏：原生安裝與 Homebrew 的更新方式不同；把「誰負責升級 CLI」寫進 oncall。版本落後常見於上個月裝過、本週功能對不上文件。
診斷：文件提供的 doctor 或診斷指令（若仍存在）只做唯讀檢查；把輸出貼進內部工單時記得遮罩帳號與路徑中的客戶名。
常見失敗案例（可複核）
| 現象 | 可能原因 | 下一步 |
|---|---|---|
| 安裝成功但拒絕使用 Code | 免費方案 | 核訂閱頁；升級或 Console |
| command not found | 未重開終端或 PATH | 新開殼；核安裝目錄 |
| 能聊不能改檔 | 目錄權限或核准模式 | 在倉庫內啟動；檢查核准設定 |
| 公司網失敗 | 代理或 TLS 攔截 | 改套件管理器或放行域名 |
| 與 Cursor 搞混 | 產品類別不同 | 見站內 Claude Code 對 Cursor 對照文 |
| 想和 Codex 對照 | 帳號生態不同 | 見上文 Codex 對照文 |
港區訂閱與 Max 額度問題不在安裝範圍，請轉Claude 香港指南與Claude Max。本頁只保證：在授權正確時，你能把 CLI 裝到可驗證狀態。
若安裝頁與本頁步驟衝突，以 Anthropic 當日 setup 為準，並把差異記進你們的內部 runbook，避免下一位同事繼續抄舊截圖。
FAQ
安裝腳本沒有進度條正常嗎？
setup 頁寫明下載期間可能無進度顯示；等結束後再驗證版本。
為什麼新開終端才找得到命令？
安裝程式通常改的是 shell 設定檔；舊 session 不會自動重載 PATH。
Alpine 等 musl 發行版？
需先裝 bash／curl 與 runtime 依賴，並可能設定 USE_BUILTIN_RIPGREP=0；細節見 setup 頁 Alpine 段。
和 Max 方案有關嗎？
安裝本身不綁 Max；能否登入取決於帳戶類型。方案對照見Claude Max 方案。