進階設定

本頁涵蓋系統需求、平台特定安裝詳情、更新和卸載。如需首次會話的引導式逐步說明，請參閱快速入門。如果您從未使用過終端機，請參閱終端機指南。

系統需求

Claude Code 在以下平台和配置上運行：

作業系統：
- macOS 13.0+
- Windows 10 1809+ 或 Windows Server 2019+
- Ubuntu 20.04+
- Debian 10+
- Alpine Linux 3.19+
硬體：4 GB+ RAM、x64 或 ARM64 處理器
網路：需要網際網路連線。請參閱網路配置。
Shell：Bash、Zsh、PowerShell 或 CMD。原生 Windows 設定需要 Git for Windows。WSL 設定不需要。
位置：Anthropic 支援的國家

其他依賴項

ripgrep：通常包含在 Claude Code 中。如果搜尋失敗，請參閱搜尋疑難排解。

安裝 Claude Code

偏好圖形介面？桌面應用程式讓您無需終端機即可使用 Claude Code。下載適用於 macOS 或 Windows 的版本。初次使用終端機？請參閱終端機指南以取得逐步說明。

To install Claude Code, use one of the following methods:

Native Install (Recommended)
Homebrew
WinGet

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

If you see The token '&&' is not a valid statement separator, you’re in PowerShell, not CMD. If you see 'irm' is not recognized as an internal or external command, you’re in CMD, not PowerShell. Your prompt shows PS C:\ when you’re in PowerShell and C:\ without the PS when you’re in CMD.Native Windows setups require Git for Windows. Install it first if you don’t have it. WSL setups do not need it.

Native installations automatically update in the background to keep you on the latest version.

brew install --cask claude-code

Homebrew offers two casks. claude-code tracks the stable release channel, which is typically about a week behind and skips releases with major regressions. claude-code@latest tracks the latest channel and receives new versions as soon as they ship.

Homebrew installations do not auto-update. Run brew upgrade claude-code or brew upgrade claude-code@latest, depending on which cask you installed, to get the latest features and security fixes.

winget install Anthropic.ClaudeCode

WinGet installations do not auto-update. Run winget upgrade Anthropic.ClaudeCode periodically to get the latest features and security fixes.

You can also install with apt, dnf, or apk on Debian, Fedora, RHEL, and Alpine. 安裝完成後，在您要使用的專案中開啟終端機並啟動 Claude Code：

claude

如果您在安裝期間遇到任何問題，請參閱疑難排解指南。

在 Windows 上設定

您可以在 Windows 上原生執行 Claude Code 或在 WSL 內執行。根據您的專案位置和所需功能進行選擇：

選項	需要	沙箱	何時使用
原生 Windows	Git for Windows	不支援	Windows 原生專案和工具
WSL 2	WSL 2 已啟用	支援	Linux 工具鏈或沙箱化命令執行
WSL 1	WSL 1 已啟用	不支援	如果 WSL 2 無法使用

選項 1：使用 Git Bash 的原生 Windows 安裝 Git for Windows，然後從 PowerShell 或 CMD 執行安裝命令。您不需要以系統管理員身分執行。無論您從 PowerShell 還是 CMD 安裝，只會影響您執行的安裝命令。您的提示在 PowerShell 中顯示 PS C:\Users\YourName>，在 CMD 中顯示 C:\Users\YourName>（沒有 PS）。如果您是終端機新手，終端機指南會逐步說明每個步驟。安裝後，從 PowerShell、CMD 或 Git Bash 啟動 claude。Claude Code 在內部使用 Git Bash 來執行命令，無論您從何處啟動它。如果 Claude Code 找不到您的 Git Bash 安裝，請在您的 settings.json 檔案中設定路徑：

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Claude Code 也可以在 Windows 上原生執行 PowerShell。PowerShell 工具正在逐步推出；設定 CLAUDE_CODE_USE_POWERSHELL_TOOL=1 以選擇加入或 0 以選擇退出。請參閱 PowerShell tool 以了解設定和限制。 選項 2：WSL 開啟您的 WSL 發行版本並從上面的安裝說明執行 Linux 安裝程式。您在 WSL 終端機內安裝和啟動 claude，而不是從 PowerShell 或 CMD。

Alpine Linux 和 musl 型發行版

Alpine 和其他 musl/uClibc 型發行版上的原生安裝程式需要 libgcc、libstdc++ 和 ripgrep。使用您的發行版套件管理員安裝這些，然後設定 USE_BUILTIN_RIPGREP=0。此範例在 Alpine 上安裝所需的套件：

apk add libgcc libstdc++ ripgrep

然後在您的 settings.json 檔案中將 USE_BUILTIN_RIPGREP 設定為 0：

{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

驗證您的安裝

安裝後，確認 Claude Code 正常運作：

claude --version

如需更詳細的安裝和配置檢查，請執行 claude doctor：

claude doctor

驗證身份

Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 帳戶。免費的 Claude.ai 方案不包括 Claude Code 存取權。您也可以透過第三方 API 提供者（如 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry）使用 Claude Code。安裝後，執行 claude 並按照瀏覽器提示登入。請參閱驗證以了解所有帳戶類型和團隊設定選項。

更新 Claude Code

原生安裝會在背景自動更新。您可以配置發行版本通道來控制您是立即接收更新還是按延遲穩定時間表接收，或完全停用自動更新。Homebrew、WinGet 和Linux 套件管理員安裝需要手動更新。

自動更新

Claude Code 在啟動時和執行期間定期檢查更新。更新會在背景下載和安裝，然後在您下次啟動 Claude Code 時生效。

Homebrew、WinGet、apt、dnf 和 apk 安裝不會自動更新。對於 Homebrew，執行 brew upgrade claude-code 或 brew upgrade claude-code@latest，取決於您安裝的 cask。對於 WinGet，執行 winget upgrade Anthropic.ClaudeCode。對於 Linux 套件管理員，請參閱使用 Linux 套件管理員安裝中的升級命令。已知問題：Claude Code 可能會在新版本在這些套件管理員中可用之前通知您有更新。如果升級失敗，請稍候並稍後重試。Homebrew 在升級後會將舊版本保留在磁碟上。定期執行 brew cleanup 以回收磁碟空間。

配置發行版本通道

使用 autoUpdatesChannel 設定控制 Claude Code 為自動更新和 claude update 遵循的發行版本通道：

"latest"，預設值：在新功能發佈時立即接收
"stable"：使用通常約一週舊的版本，跳過有重大迴歸的發佈

透過 /config → 自動更新通道配置此項，或將其新增到您的 settings.json 檔案：

{
  "autoUpdatesChannel": "stable"
}

對於企業部署，您可以使用受管設定在整個組織中強制執行一致的發行版本通道。 Homebrew 安裝根據 cask 名稱而不是此設定選擇通道：claude-code 追蹤穩定版本，claude-code@latest 追蹤最新版本。

固定最低版本

minimumVersion 設定建立一個下限。背景自動更新和 claude update 拒絕安裝低於此值的任何版本，因此如果您已經在較新的 "latest" 組建上，移至 "stable" 通道不會降級您。透過 /config 從 "latest" 切換到 "stable" 會提示您保留目前版本或允許降級。選擇保留會將 minimumVersion 設定為該版本。切換回 "latest" 會清除它。將其新增到您的 settings.json 檔案以明確固定下限：

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

在受管設定中，這會強制執行使用者和專案設定無法覆蓋的組織範圍最低版本。

停用自動更新

在您的 settings.json 檔案的 env 鍵中將 DISABLE_AUTOUPDATER 設定為 "1"：

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

DISABLE_AUTOUPDATER 只會停止背景檢查；claude update 和 claude install 仍然有效。若要阻止所有更新路徑（包括手動更新），請改為設定 DISABLE_UPDATES。當您透過自己的通道發佈 Claude Code 並需要使用者保持在您提供的版本上時，請使用此選項。

手動更新

若要立即套用更新而不等待下一次背景檢查，請執行：

claude update

進階安裝選項

這些選項適用於版本固定、Linux 套件管理員、npm 和驗證二進位檔案完整性。

安裝特定版本

原生安裝程式接受特定版本號或發行版本通道（latest 或 stable）。您在安裝時選擇的通道將成為自動更新的預設值。請參閱配置發行版本通道以取得更多資訊。若要安裝最新版本（預設）：

macOS、Linux、WSL
Windows PowerShell
Windows CMD

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

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

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

若要安裝穩定版本：

macOS、Linux、WSL
Windows PowerShell
Windows CMD

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

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

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

若要安裝特定版本號：

macOS、Linux、WSL
Windows PowerShell
Windows CMD

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

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

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

使用 Linux 套件管理員安裝

Claude Code 發佈已簽署的 apt、dnf 和 apk 儲存庫。將 stable 替換為 latest 以使用滾動通道。套件管理員安裝不會透過 Claude Code 自動更新；更新會透過您的正常系統升級工作流程進行。所有儲存庫都使用 Claude Code 發佈簽署金鑰簽署。在信任金鑰之前，請按照每個標籤中的說明驗證它。

適用於 Debian 和 Ubuntu。若要使用滾動通道，請變更 deb 行中的兩個 stable 出現次數：URL 路徑和套件組合名稱。

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
  -o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

在信任之前驗證 GPG 金鑰指紋：gpg --show-keys /etc/apt/keyrings/claude-code.asc 應該報告 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE。若要稍後升級，請執行 sudo apt update && sudo apt upgrade claude-code。

適用於 Fedora 和 RHEL：

sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

dnf 在首次安裝時下載金鑰，並提示您確認指紋。在接受之前驗證它是否與 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE 相符。若要稍後升級，請執行 sudo dnf upgrade claude-code。

適用於 Alpine Linux：

wget -O /etc/apk/keys/claude-code.rsa.pub \
  https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code

使用 sha256sum /etc/apk/keys/claude-code.rsa.pub 驗證下載的金鑰，應該報告 395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6。若要稍後升級，請執行 apk update && apk upgrade claude-code。

使用 npm 安裝

您也可以將 Claude Code 安裝為全域 npm 套件。該套件需要 Node.js 18 或更新版本。

npm install -g @anthropic-ai/claude-code

npm 套件安裝與獨立安裝程式相同的原生二進位檔案。npm 透過每個平台的選擇性依賴項（例如 @anthropic-ai/claude-code-darwin-arm64）提取二進位檔案，並透過 postinstall 步驟將其連結到位。已安裝的 claude 二進位檔案本身不會呼叫 Node。支援的 npm 安裝平台為 darwin-arm64、darwin-x64、linux-x64、linux-arm64、linux-x64-musl、linux-arm64-musl、win32-x64 和 win32-arm64。您的套件管理員必須允許選擇性依賴項。如果安裝後二進位檔案遺失，請參閱疑難排解。

請勿使用 sudo npm install -g，因為這可能導致權限問題和安全風險。如果您遇到權限錯誤，請參閱疑難排解權限錯誤。

二進位檔案完整性和程式碼簽署

每個發佈都會發佈一個 manifest.json，其中包含每個平台二進位檔案的 SHA256 校驗和。該資訊清單使用 Anthropic GPG 金鑰簽署，因此驗證資訊清單上的簽名可以傳遞地驗證它列出的每個二進位檔案。

驗證資訊清單簽名

步驟 1-3 需要具有 gpg 和 curl 的 POSIX shell。在 Windows 上，在 Git Bash 或 WSL 中執行它們。步驟 4 包括 PowerShell 選項。

下載並匯入公開金鑰

發佈簽署金鑰發佈在固定 URL。

curl -fsSL https://downloads.claude.ai/keys/claude-code.asc | gpg --import

顯示匯入金鑰的指紋。

gpg --fingerprint security@anthropic.com

確認輸出包含此指紋：

31DD DE24 DDFA B679 F42D  7BD2 BAA9 29FF 1A7E CACE

下載資訊清單和簽名

將 VERSION 設定為您要驗證的發佈。

REPO=https://downloads.claude.ai/claude-code-releases
VERSION=2.1.89
curl -fsSLO "$REPO/$VERSION/manifest.json"
curl -fsSLO "$REPO/$VERSION/manifest.json.sig"

驗證簽名

驗證分離的簽名對比資訊清單。

gpg --verify manifest.json.sig manifest.json

有效的結果報告 Good signature from "Anthropic Claude Code Release Signing <security@anthropic.com>"。gpg 也會為任何新匯入的金鑰列印 WARNING: This key is not certified with a trusted signature!。這是預期的。Good signature 行確認密碼檢查已通過。第 1 步中的指紋比較確認金鑰本身是真實的。

根據資訊清單檢查二進位檔案

將您下載的二進位檔案的 SHA256 校驗和與 manifest.json 中 platforms.<platform>.checksum 下列出的值進行比較。

Linux
macOS
Windows PowerShell

sha256sum claude

shasum -a 256 claude

(Get-FileHash claude.exe -Algorithm SHA256).Hash.ToLower()

資訊清單簽名適用於 2.1.89 及以後的發佈。較早的發佈在 manifest.json 中發佈校驗和，但沒有分離的簽名。

平台程式碼簽名

除了簽署的資訊清單外，個別二進位檔案在支援的地方還帶有平台原生程式碼簽名。

macOS：由「Anthropic PBC」簽署並由 Apple 公證。使用 codesign --verify --verbose ./claude 驗證。
Windows：由「Anthropic, PBC」簽署。使用 Get-AuthenticodeSignature .\claude.exe 驗證。
Linux：二進位檔案不是單獨程式碼簽署的。如果您直接從 claude-code-releases 儲存庫下載或使用原生安裝程式，請使用上面的資訊清單簽名驗證完整性。如果您使用 apt、dnf 或 apk 安裝，您的套件管理員會使用儲存庫簽署金鑰自動驗證簽名。

卸載 Claude Code

若要移除 Claude Code，請按照您的安裝方法的說明進行。

原生安裝

移除 Claude Code 二進位檔案和版本檔案：

macOS、Linux、WSL
Windows PowerShell

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

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Homebrew 安裝

移除您安裝的 Homebrew cask。如果您安裝了穩定版 cask：

brew uninstall --cask claude-code

如果您安裝了最新版 cask：

brew uninstall --cask claude-code@latest

WinGet 安裝

移除 WinGet 套件：

winget uninstall Anthropic.ClaudeCode

apt / dnf / apk

移除套件和儲存庫配置：

sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc

sudo dnf remove claude-code
sudo rm /etc/yum.repos.d/claude-code.repo

apk del claude-code
sed -i '\|downloads.claude.ai/claude-code/apk|d' /etc/apk/repositories
rm /etc/apk/keys/claude-code.rsa.pub

npm

移除全域 npm 套件：

npm uninstall -g @anthropic-ai/claude-code

移除配置檔案

移除配置檔案將刪除您的所有設定、允許的工具、MCP 伺服器配置和會話歷史記錄。

VS Code 擴充功能、JetBrains 外掛程式和桌面應用程式也會寫入 ~/.claude/。如果其中任何一個仍然安裝，下次執行時目錄會被重新建立。若要完全移除 Claude Code，請在刪除這些檔案之前卸載 VS Code 擴充功能、JetBrains 外掛程式和桌面應用程式。若要移除 Claude Code 設定和快取資料：

macOS、Linux、WSL
Windows PowerShell

# 移除使用者設定和狀態
rm -rf ~/.claude
rm ~/.claude.json

# 移除專案特定設定（從您的專案目錄執行）
rm -rf .claude
rm -f .mcp.json

# 移除使用者設定和狀態
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

# 移除專案特定設定（從您的專案目錄執行）
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force

設定與存取

使用情況和成本

外掛程式發佈

安全性和資料

系統需求

其他依賴項

安裝 Claude Code

在 Windows 上設定

Alpine Linux 和 musl 型發行版

驗證您的安裝

驗證身份

更新 Claude Code

自動更新

配置發行版本通道

固定最低版本

停用自動更新

手動更新

進階安裝選項

安裝特定版本

使用 Linux 套件管理員安裝

使用 npm 安裝

二進位檔案完整性和程式碼簽署

驗證資訊清單簽名

平台程式碼簽名

卸載 Claude Code

原生安裝

Homebrew 安裝

WinGet 安裝

apt / dnf / apk

npm

移除配置檔案

設定與存取

使用情況和成本

外掛程式發佈

安全性和資料

​系統需求

​其他依賴項

​安裝 Claude Code

​在 Windows 上設定

​Alpine Linux 和 musl 型發行版

​驗證您的安裝

​驗證身份

​更新 Claude Code

​自動更新

​配置發行版本通道

​固定最低版本

​停用自動更新

​手動更新

​進階安裝選項

​安裝特定版本

​使用 Linux 套件管理員安裝

​使用 npm 安裝

​二進位檔案完整性和程式碼簽署

​驗證資訊清單簽名

​平台程式碼簽名

​卸載 Claude Code

​原生安裝

​Homebrew 安裝

​WinGet 安裝

​apt / dnf / apk

​npm

​移除配置檔案

系統需求

其他依賴項

安裝 Claude Code

在 Windows 上設定

Alpine Linux 和 musl 型發行版

驗證您的安裝

驗證身份

更新 Claude Code

自動更新

配置發行版本通道

固定最低版本

停用自動更新

手動更新

進階安裝選項

安裝特定版本

使用 Linux 套件管理員安裝

使用 npm 安裝

二進位檔案完整性和程式碼簽署

驗證資訊清單簽名

平台程式碼簽名

卸載 Claude Code

原生安裝

Homebrew 安裝

WinGet 安裝

apt / dnf / apk

npm

移除配置檔案