Claude Code 怎麼安裝？macOS、Linux、WSL 與 Windows 指令

先確認環境是否符合需求#

目前官方 Advanced setup 列出的基本條件如下：

Windows 原生安裝時，官方建議準備 Git for Windows，讓 Claude Code 能使用 Bash tool；如果沒有，Claude Code 會改用 PowerShell 作為 shell tool。WSL 環境不需要另外安裝 Git for Windows。

四種安裝方式怎麼選？#

Homebrew 的 claude-code 是 stable channel，通常較保守；claude-code@latest 會較快收到新版本。兩者都不會像 Native Install 那樣自動更新，所以要把升級指令放進自己的維護清單。

macOS、Linux 與 WSL：Native Install#

在 Bash、Zsh 或 WSL 終端機執行官方提供的命令：

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

完成後開一個新的終端機，或依安裝程式提示重新載入 shell，再檢查版本：

1
claude --version

如果你在公司環境不允許把網路內容直接 pipe 給 shell，先依組織政策檢查下載內容，再決定是否執行；不要把這條限制誤判成 Claude Code 本身的版本錯誤。官方文件也提供安裝故障排查與 Linux 套件管理器的替代方式。

Windows PowerShell：使用 irm#

如果終端機提示字首是 PS C:\，你在 PowerShell，使用這條官方命令：

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

接著在同一個 PowerShell 視窗驗證：

1
claude --version

如果看到「irm 不是內部或外部命令」，通常表示你其實開的是 CMD，不是 PowerShell。請先確認終端機類型，再換用下一節的 CMD 命令，不要在錯誤的 shell 裡反覆貼上同一條指令。

Windows CMD：不要使用 PowerShell 指令#

如果提示是 C:\，而不是 PS C:\，你在 Windows CMD。使用官方提供的下載、安裝、清除暫存檔流程：

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

安裝後執行：

1
claude --version

如果 PowerShell 回報 && 不是有效的 statement separator，代表你把 CMD 命令貼到了 PowerShell。PowerShell 和 CMD 都能使用 Claude Code，但安裝腳本的語法不能混用。

Homebrew：stable 與 latest 二選一#

已使用 Homebrew 的 macOS 或 Linux 使用者，可以選擇下列其中一個 cask：

1
# 較保守的 stable channel
2
brew install --cask claude-code
3

4
# 需要最新頻道時，改用這個，不要兩個都裝
5
brew install --cask claude-code@latest

升級時要使用對應的 cask 名稱：

1
brew upgrade claude-code
2
brew upgrade claude-code@latest

實際只執行你安裝的那一條。若同時保留兩個 cask，PATH 和符號連結會讓「到底執行哪一版」變得難以判斷；新手不需要為了追版本而並裝兩個頻道。

Windows：用 WinGet 管理版本#

如果你的 Windows 套件管理流程使用 WinGet：

1
winget install Anthropic.ClaudeCode

官方文件指出 WinGet 安裝不會自動更新，定期執行：

1
winget upgrade Anthropic.ClaudeCode

如果公司電腦的 WinGet 來源、權限或網路被管理員限制，改用 Native Install 前先確認組織軟體分發政策。不要直接把套件管理器的錯誤當作 Claude 帳號登入失敗。

安裝、登入與第一個工作階段#

先確認命令能找到，再進入登入流程：

1
claude --version
2
cd /path/to/your/project
3
claude

第一次啟動時，Claude Code 會引導你在瀏覽器登入。官方目前支援 Claude Pro、Max、Team、Enterprise、Claude Console，以及 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 等雲端供應商路徑；實際可用選項會依帳號和管理設定不同。

如果需要切換帳號或重新驗證，可以在執行中的 session 輸入：

1
/login

若環境已設定 ANTHROPIC_API_KEY，Claude Code 會走 API key 核准流程，而不是一般瀏覽器登入。這類金鑰只應放在受控的環境變數或密碼管理系統中，不要貼進文章、repository、.env 提交內容或 shell 記錄。

登入後可以先問一個唯讀問題確認工作目錄：

1
請先說明這個專案的技術棧、主要入口與測試指令，不要修改檔案。

這樣能先驗證它看到的是正確 repository，也能在授權任何修改前檢查工作範圍。

如果下一步要讓 Claude Code 自動修改檔案，先閱讀站內的 權限、工具白名單與回合上限檢查表。若安裝成功但啟動後出現模型或連線錯誤，再依 官方事故與本機環境排錯邊界 分辨服務狀態和自己的網路、憑證問題。

更新策略：不要只看 --version#

不同安裝方式的更新行為不同：

官方 Advanced setup 說明 Native Install 會自動更新，也提供 release channel、最低版本與停用自動更新的設定；需要可重現的企業環境時，應先把「自動更新」和「固定最低版本」當成供應鏈政策討論，而不是只在每台電腦手動修復。

常見安裝錯誤怎麼分流？#

常見問題#