進階設定

Claude Code 的系統需求、平台特定安裝、版本管理和卸載。

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

系統需求

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。
位置：Anthropic 支援的國家

其他依賴項

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

安裝 Claude Code

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

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.

Git for Windows is recommended on native Windows so Claude Code can use the Bash tool. If Git for Windows is not installed, Claude Code uses PowerShell as the shell tool instead. WSL setups do not need Git for Windows.

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.

winget install Anthropic.ClaudeCode

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：原生 Windows

從 PowerShell 或 CMD 執行安裝命令。您不需要以系統管理員身分執行。安裝 Git for Windows 為選用。它透過提供 Git Bash 來啟用 Bash 工具。

無論您從 PowerShell 還是 CMD 安裝，只會影響您執行的安裝命令。您的提示在 PowerShell 中顯示 PS C:\Users\YourName>，在 CMD 中顯示 C:\Users\YourName>（沒有 PS）。如果您是終端機新手，終端機指南會逐步說明每個步驟。

安裝後，從任何終端機啟動 claude。

沒有 Git for Windows，Claude Code 透過 PowerShell 工具執行 shell 命令。
有 Git for Windows，Claude Code 使用 Git Bash 來執行 Bash 工具。如果 Claude Code 找不到 Git Bash，請在您的 settings.json 檔案中設定路徑：
```
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}
```

安裝 Git for Windows 時，PowerShell 工具正在逐步推出作為 Bash 的額外選項。設定 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

如果此命令失敗並出現 command not found 或其他錯誤，請參閱疑難排解安裝和登入。

如需更詳細的安裝和配置檢查，請執行 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 時生效。

執行 claude doctor 以查看最近更新嘗試的結果。

如果 npm 全域安裝因為 npm 全域目錄不可寫而無法自動更新，Claude Code 會在啟動時顯示一次性通知，而 claude doctor 會列出可用的修復。詳見安裝期間的權限錯誤。

Note

Homebrew、WinGet、apt、dnf 和 apk 安裝預設不會自動更新；請參閱下方以選擇加入 Homebrew 和 WinGet。若要手動升級 Homebrew，請執行 brew upgrade claude-code 或 brew upgrade claude-code@latest，取決於您安裝的 cask。對於 WinGet，請執行 winget upgrade Anthropic.ClaudeCode。對於 Linux 套件管理員，請參閱使用 Linux 套件管理員安裝中的升級命令。

若要讓 Claude Code 在 Homebrew 或 WinGet 上為您執行升級命令，請將 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE 設定為 1。Claude Code 會在有新版本可用時在背景執行升級，並在成功時顯示重新啟動提示。升級僅針對 Claude Code 套件，不會影響您已安裝的其他軟體。

在 WinGet 上，當 Claude Code 執行時升級可能會失敗，因為 Windows 會鎖定可執行檔。在這種情況下，Claude Code 會改為顯示手動命令。apt、dnf 和 apk 繼續需要手動升級，因為這些命令需要提升的權限。

已知問題：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"
}

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

minimumVersion 固定只會限制更新。若要讓 Claude Code 拒絕在版本範圍外啟動，請改為使用受管設定 requiredMinimumVersion 和 requiredMaximumVersion。更新也會遵守 requiredMaximumVersion 上限。請參閱可用設定。

停用自動更新

在您的 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）。您在安裝時選擇的通道將成為自動更新的預設值。請參閱配置發行版本通道以取得更多資訊。

若要安裝最新版本（預設）：

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

若要安裝穩定版本：

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

若要安裝特定版本號：

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 在每個發佈發行時立即提供。下面的命令配置 stable 通道，適合大多數使用者；每個標籤也顯示 latest 儲存庫 URL。套件管理員安裝不會透過 Claude Code 自動更新；更新會透過您的正常系統升級工作流程進行。

所有儲存庫都使用 Claude Code 發佈簽署金鑰簽署。在信任金鑰之前，請按照每個標籤中的說明驗證它。

適用於 Debian 和 Ubuntu。下列命令配置 stable 通道：

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

若要改用 latest 通道，URL 路徑和套件組合名稱都會變更。使用此 deb 行：

echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main" \
| sudo tee /etc/apt/sources.list.d/claude-code.list

在信任之前驗證 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。下列命令配置 stable 通道：

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

若要改用 latest 通道，將 baseurl 設定為 latest 儲存庫：

baseurl=https://downloads.claude.ai/claude-code/rpm/latest

dnf 在首次安裝時下載金鑰，並提示您確認指紋。在接受之前驗證它是否與 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE 相符。

若要稍後升級，請執行 sudo dnf upgrade claude-code。

適用於 Alpine Linux。下列命令配置 stable 通道：

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

若要切換至 latest 通道，移除 stable 儲存庫行並新增 latest 儲存庫：

sed -i '\|downloads.claude.ai/claude-code/apk/stable|d' /etc/apk/repositories
echo "https://downloads.claude.ai/claude-code/apk/latest" >> /etc/apk/repositories

使用 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。您的套件管理員必須允許選擇性依賴項。如果安裝後二進位檔案遺失，請參閱疑難排解。

若要升級 npm 安裝，請執行 npm install -g @anthropic-ai/claude-code@latest。避免使用 npm update -g，因為它會遵守原始安裝的 semver 範圍，可能無法將您移至最新版本。

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

每個發佈都會發佈一個 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 下列出的值進行比較。

sha256sum claude

shasum -a 256 claude

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

平台程式碼簽名

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

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 仍然執行，您可能有第二個安裝或來自舊版安裝程式的遺留 shell 別名。請參閱檢查衝突的安裝以找到並移除它。

原生安裝

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

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

移除配置檔案

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

若要移除 Claude Code 設定和快取資料：

# 移除使用者設定和狀態
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

setup.md +26 −4

258 258

259在[受管設定](/zh-TW/permissions#managed-settings)中，這會強制執行使用者和專案設定無法覆蓋的組織範圍最低版本。259在[受管設定](/zh-TW/permissions#managed-settings)中，這會強制執行使用者和專案設定無法覆蓋的組織範圍最低版本。

260 260

261`minimumVersion` 固定只會限制更新。若要讓 Claude Code 拒絕在版本範圍外啟動，請改為使用受管設定 `requiredMinimumVersion` 和 `requiredMaximumVersion`。更新也會遵守 `requiredMaximumVersion` 上限。請參閱[可用設定](/zh-TW/settings#available-settings)。

262

261<h3 id="disable-auto-updates">263<h3 id="disable-auto-updates">

262 停用自動更新264 停用自動更新

263</h3>265</h3>

366 使用 Linux 套件管理員安裝368 使用 Linux 套件管理員安裝

367</h3>369</h3>

368 370

369Claude Code 發佈已簽署的 apt、dnf 和 apk 儲存庫。將 `stable` 替換為 `latest` 以使用滾動通道。套件管理員安裝不會透過 Claude Code 自動更新；更新會透過您的正常系統升級工作流程進行。371Claude Code 發佈已簽署的 apt、dnf 和 apk 儲存庫。每個儲存庫提供兩個通道：`stable` 提供通常約一週前的版本，跳過有重大迴歸的發佈，而 `latest` 在每個發佈發行時立即提供。下面的命令配置 `stable` 通道，適合大多數使用者；每個標籤也顯示 `latest` 儲存庫 URL。套件管理員安裝不會透過 Claude Code 自動更新；更新會透過您的正常系統升級工作流程進行。

370 372

371所有儲存庫都使用 [Claude Code 發佈簽署金鑰](#binary-integrity-and-code-signing)簽署。在信任金鑰之前，請按照每個標籤中的說明驗證它。373所有儲存庫都使用 [Claude Code 發佈簽署金鑰](#binary-integrity-and-code-signing)簽署。在信任金鑰之前，請按照每個標籤中的說明驗證它。

372 374

373<Tabs>375<Tabs>

374 <Tab title="apt">376 <Tab title="apt">

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

376 378

377 ```bash theme={null}379 ```bash theme={null}

378 sudo install -d -m 0755 /etc/apt/keyrings380 sudo install -d -m 0755 /etc/apt/keyrings

384 sudo apt install claude-code386 sudo apt install claude-code

385 ```387 ```

386 388

389 若要改用 `latest` 通道，URL 路徑和套件組合名稱都會變更。使用此 `deb` 行：

390

391 ```bash theme={null}

392 echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main" \

393 | sudo tee /etc/apt/sources.list.d/claude-code.list

394 ```

395

387 在信任之前驗證 GPG 金鑰指紋：`gpg --show-keys /etc/apt/keyrings/claude-code.asc` 應該報告 `31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE`。396 在信任之前驗證 GPG 金鑰指紋：`gpg --show-keys /etc/apt/keyrings/claude-code.asc` 應該報告 `31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE`。

388 397

389 若要稍後升級，請執行 `sudo apt update && sudo apt upgrade claude-code`。398 若要稍後升級，請執行 `sudo apt update && sudo apt upgrade claude-code`。

390 </Tab>399 </Tab>

391 400

392 <Tab title="dnf">401 <Tab title="dnf">

393 適用於 Fedora 和 RHEL：402 適用於 Fedora 和 RHEL。下列命令配置 `stable` 通道：

394 403

395 ```bash theme={null}404 ```bash theme={null}

396 sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'405 sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'

404 sudo dnf install claude-code413 sudo dnf install claude-code

405 ```414 ```

406 415

416 若要改用 `latest` 通道，將 `baseurl` 設定為 `latest` 儲存庫：

417

418 ```ini theme={null}

419 baseurl=https://downloads.claude.ai/claude-code/rpm/latest

420 ```

421

407 dnf 在首次安裝時下載金鑰，並提示您確認指紋。在接受之前驗證它是否與 `31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE` 相符。422 dnf 在首次安裝時下載金鑰，並提示您確認指紋。在接受之前驗證它是否與 `31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE` 相符。

408 423

409 若要稍後升級，請執行 `sudo dnf upgrade claude-code`。424 若要稍後升級，請執行 `sudo dnf upgrade claude-code`。

410 </Tab>425 </Tab>

411 426

412 <Tab title="apk">427 <Tab title="apk">

413 適用於 Alpine Linux：428 適用於 Alpine Linux。下列命令配置 `stable` 通道：

414 429

415 ```sh theme={null}430 ```sh theme={null}

416 wget -O /etc/apk/keys/claude-code.rsa.pub \431 wget -O /etc/apk/keys/claude-code.rsa.pub \

419 apk add claude-code434 apk add claude-code

420 ```435 ```

421 436

437 若要切換至 `latest` 通道，移除 `stable` 儲存庫行並新增 `latest` 儲存庫：

438

439 ```sh theme={null}

440 sed -i '\|downloads.claude.ai/claude-code/apk/stable|d' /etc/apk/repositories

441 echo "https://downloads.claude.ai/claude-code/apk/latest" >> /etc/apk/repositories

442 ```

443

422 使用 `sha256sum /etc/apk/keys/claude-code.rsa.pub` 驗證下載的金鑰，應該報告 `395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6`。444 使用 `sha256sum /etc/apk/keys/claude-code.rsa.pub` 驗證下載的金鑰，應該報告 `395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6`。

423 445

424 若要稍後升級，請執行 `apk update && apk upgrade claude-code`。446 若要稍後升級，請執行 `apk update && apk upgrade claude-code`。

setup.md 2026-06-16 21:57 UTC to 2026-06-17 17:02 UTC

進階設定

系統需求

其他依賴項

安裝 Claude Code

在 Windows 上設定

Alpine Linux 和 musl 型發行版

驗證您的安裝

驗證身份

更新 Claude Code

自動更新

配置發行版本通道

固定最低版本

停用自動更新

手動更新

進階安裝選項

安裝特定版本

使用 Linux 套件管理員安裝

使用 npm 安裝

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

驗證資訊清單簽名

下載並匯入公開金鑰

下載資訊清單和簽名

驗證簽名

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

平台程式碼簽名

卸載 Claude Code

原生安裝

Homebrew 安裝

WinGet 安裝

apt / dnf / apk

npm

移除配置檔案