AI Coding Hub

教學

安裝 Claude Code

macOS、Linux 與 WSL 用一行 `curl -fsSL https://claude.ai/install.sh | bash` 即可安裝；Windows PowerShell 則是 `irm https://claude.ai/install.ps1 | iex`。裝好之後在專案資料夾執行 `claude`，接著在瀏覽器完成登入。有一個前提要先講清楚：Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 其中一種帳號，免費的 Claude.ai 方案並不包含（官方文件，2026-09-05 查證）。

繁體中文 · 最後查證日: 2026-09-05 · 英文完整版： English

系統需求

官方文件列出的支援環境為：macOS 13.0 以上、Windows 10 build 1809 以上或 Windows Server 2019 以上、Ubuntu 20.04 以上、Debian 10 以上、Alpine Linux 3.19 以上。硬體需 4GB 以上記憶體與 x64 或 ARM64 處理器，並需要網路連線。Shell 支援 Bash、Zsh、PowerShell 與 CMD。

方式一：原生安裝器（官方建議）

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
指令逐字取自官方安裝文件（2026-09-05 查證）。

原生安裝會在背景自動更新。如果 PowerShell 出現「權杖 && 不是有效的陳述式分隔符號」的錯誤，代表你把 CMD 版的指令貼進 PowerShell 了——提示字元開頭有 `PS` 的是 PowerShell，沒有的是 CMD。

方式二：套件管理程式

# Homebrew（macOS / Linux）
brew install --cask claude-code

# WinGet（Windows）
winget install Anthropic.ClaudeCode

# npm（需要 Node.js 22 以上）
npm install -g @anthropic-ai/claude-code
Homebrew、WinGet 與 Linux 套件管理程式安裝的版本不會自動更新。

兩個實務上容易踩到的細節。第一，Homebrew 有兩個 cask：`claude-code` 走 stable 頻道，通常落後約一週並會跳過有重大瑕疵的版本；`claude-code@latest` 則是一發布就更新。第二，npm 版自 v2.1.198 起要求 Node.js 22 以上；在較舊的 Node.js 上 npm 只會印出 EBADENGINE 警告，安裝仍會完成，因為該套件下載的是原生執行檔，執行時不會用到你的 Node.js。官方明確不建議使用 `sudo npm install -g`。

驗證安裝

claude --version
# 輸出範例：2.1.211 (Claude Code)

claude doctor
`claude doctor` 不會開啟工作階段，只輸出安裝與設定的唯讀診斷。

登入與帳號

執行 `claude` 後會開啟瀏覽器完成登入。若環境變數 `ANTHROPIC_API_KEY` 已設定，Claude Code 會改為詢問一次是否使用該金鑰，而不開瀏覽器。對公司導入來說最關鍵的一段在這裡：官方文件列出 Amazon Bedrock、Google Cloud 的 Agent Platform 與 Microsoft Foundry 為支援的第三方供應商。如果公司已經有雲端合約，走既有合約通常比新開一份訂閱更快通過採購。

Windows：原生還是 WSL

選項前置需求沙箱適用情境
原生 Windows無（Git for Windows 為選用）不支援Windows 原生的專案與工具鏈
WSL 2需啟用 WSL 2支援Linux 工具鏈，或需要隔離執行時
WSL 1需啟用 WSL 1不支援WSL 2 無法使用的環境
安裝 Git for Windows 會啟用 Bash 工具；未安裝時 Claude Code 改用 PowerShell 工具。

移除安裝

# 原生安裝（macOS / Linux / WSL）
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

# Homebrew
brew uninstall --cask claude-code

# WinGet
winget uninstall Anthropic.ClaudeCode

# npm
npm uninstall -g @anthropic-ai/claude-code
設定檔不會一起被刪

移除程式本體不會刪掉設定。使用者層在 `~/.claude` 與 `~/.claude.json`，專案層在 `.claude` 與 `.mcp.json`。要注意的是 VS Code 擴充功能、JetBrains 外掛與桌面版應用程式也會寫入 `~/.claude`，只要其中之一還在，該資料夾下次啟動時就會被重新建立。

常見問題

Claude Code 可以免費使用嗎？
不行。CLI 本身可以免費安裝，但執行需要 Pro、Max、Team、Enterprise 或 Console 帳號，免費的 Claude.ai 方案不包含 Claude Code 存取權（官方文件，2026-09-05 查證）。想找免費的終端機代理程式，可以看 Gemini CLI 或 OpenCode。
安裝 Claude Code 需要 Node.js 嗎？
只有走 npm 這條路才需要，而且自 v2.1.198 起要求 Node.js 22 以上。原生安裝器、Homebrew、WinGet 以及 apt/dnf/apk 安裝的都是同一個原生執行檔，執行時不會用到 Node.js。
Windows 要怎麼安裝？
PowerShell 使用 `irm https://claude.ai/install.ps1 | iex`；CMD 使用 `curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd`；或用 WinGet 執行 `winget install Anthropic.ClaudeCode`。官方說明不需要系統管理員權限。安裝 Git for Windows 可啟用 Bash 工具。
要怎麼更新到最新版？
原生安裝會在背景自動更新，也可以執行 `claude update` 立即更新。Homebrew 與 WinGet 不會自動更新，需執行 `brew upgrade claude-code` 或 `winget upgrade Anthropic.ClaudeCode`。設定 `autoUpdatesChannel` 可在 `"latest"` 與 `"stable"` 之間切換，stable 大約落後一週。

資料來源

延伸閱讀