進階設定

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

偏好圖形介面？桌面應用程式讓您無需終端機即可使用 Claude Code。下載適用於 macOS、Windows 或 Linux 的版本。

若要安裝 Claude Code，請開啟終端機並執行適用於您系統的命令。如果您之前未使用過終端機，終端機指南會說明如何開啟終端機並貼上命令。

原生安裝（建議）

macOS、Linux、WSL：

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

在 Windows 上，當您在 PowerShell 中時，提示字元會顯示 PS C:\，而在 CMD 中時會顯示 C:\（不含 PS）。

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

安裝命令在下載 Claude Code 時不會顯示進度。當安裝程式完成時，請開啟新的終端機視窗並執行 claude --version。正常的安裝會列印版本號碼。如果您的 shell 說找不到 claude 或無法識別，安裝目錄還未在您的 PATH 上：請參閱修正您的 PATH。

如果您看到 The token '&&' is not a valid statement separator，表示您在 PowerShell 中，而非 CMD。如果您看到 'irm' is not recognized as an internal or external command，表示您在 CMD 中，而非 PowerShell。

如果安裝命令失敗並出現 syntax error near unexpected token '<'、403 或其他任何錯誤，請參閱疑難排解安裝以將錯誤與修正相對應，並查看替代安裝方法。

建議在原生 Windows 上安裝 Git for Windows，以便 Claude Code 可以使用 Bash 工具。如果未安裝 Git for Windows，Claude Code 會改用 PowerShell 作為殼層工具。WSL 設定不需要 Git for Windows。

原生安裝會在背景自動更新，以保持您使用最新版本。

Homebrew

brew install --cask claude-code

Homebrew 提供兩個 casks。claude-code 追蹤穩定版本通道，通常比最新版本晚約一週，並跳過有重大迴歸的版本。claude-code@latest 追蹤最新通道，並在新版本發佈時立即接收。

Homebrew 安裝不會自動更新。執行 brew upgrade claude-code 或 brew upgrade claude-code@latest（取決於您安裝的 cask），以取得最新功能和安全修正。

WinGet

winget install Anthropic.ClaudeCode

WinGet 安裝不會自動更新。定期執行 winget upgrade Anthropic.ClaudeCode 以取得最新功能和安全修正。

您也可以在 Debian、Fedora、RHEL 和 Alpine 上使用 apt、dnf 或 apk 進行安裝。

安裝完成後，在您要使用的專案中開啟終端機並啟動 Claude Code：

claude

Claude Code 會在您的終端機中開啟互動式工作階段。

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

​

在 Windows 上設定

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

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

​

在原生 Windows 上安裝

從 PowerShell 或 CMD 執行安裝命令。您不需要以系統管理員身分執行。安裝 Git for Windows 為選用。它提供 Git Bash，這是 Bash 工具和 Monitor 工具所需的。

無論您從 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 工具可在 claude.ai 和 Console 帳戶上預設啟用，並在 Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 工作階段中使用 CLAUDE_CODE_USE_POWERSHELL_TOOL=1 啟用。將其設定為 0 以關閉工具。請參閱 PowerShell 工具以了解設定和限制。

​

在 WSL 中安裝

開啟您的 WSL 發行版本並從安裝說明執行 Linux 安裝程式。您在 WSL 終端機內安裝和啟動 claude，而不是從 PowerShell 或 CMD。

​

Alpine Linux 和 musl 型發行版

在 Alpine 和其他 musl/uClibc 型發行版上安裝 Claude Code 需要 bash 和 curl 用於安裝命令，以及 libgcc、libstdc++ 和 ripgrep 用於執行時。Alpine 預設不包含 bash 或 curl，因此在您安裝它們之前，文件中的安裝命令會失敗並出現 not found 錯誤。使用您的發行版套件管理員安裝這些套件，然後設定 USE_BUILTIN_RIPGREP=0。

此範例在 Alpine 上安裝所需的套件：

apk add bash curl libgcc libstdc++ ripgrep

在 Alpine 上，ripgrep 位於社群儲存庫中。如果 apk 報告套件遺失，請將社群儲存庫新增至 /etc/apk/repositories，使用您的 Alpine 版本：

echo "https://dl-cdn.alpinelinux.org/alpine/v3.22/community" >> /etc/apk/repositories

執行 apk update 以重新整理套件索引，然後重試 apk add 命令。

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

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

​

驗證您的安裝

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

claude --version

正常的安裝會列印版本號，例如 2.1.211 (Claude Code)。

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

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

claude doctor

claude doctor 會列印唯讀的安裝和設定診斷資訊，而不啟動工作階段，包括安裝健康狀況、設定檔驗證錯誤，以及任何帶有建議修正的警告。

​

驗證身份

Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 帳戶。免費的 claude.ai 方案不包括 Claude Code 存取權。您也可以透過第三方 API 提供者（如 Amazon Bedrock、Google Cloud’s Agent Platform 或 Microsoft Foundry）使用 Claude Code。

安裝後，執行 claude 並按照瀏覽器提示登入。如果您已設定 ANTHROPIC_API_KEY 環境變數，並在 Claude Code 詢問是否使用該金鑰時予以核准，Claude Code 便會略過登入提示。請參閱身分驗證以了解所有帳戶類型和團隊設定選項。

​

更新 Claude Code

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

​

自動更新

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

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

在 macOS 和 Linux 上，原生安裝程式會將啟動器管理為 ~/.local/bin/claude 的符號連結，指向 ~/.local/share/claude/versions/。如果您將該啟動器替換為自己的指令碼或符號連結，自動更新和 claude update 會將其保留在原位：新版本仍會安裝在 versions/ 目錄下，而您的啟動器決定執行哪個版本。

使用自訂啟動器時，Claude Code 也會將每個已安裝的版本保留在磁碟上，因為它無法判斷啟動器需要哪個版本。claude doctor 會報告原生安裝程式未建立的啟動器。

若要讓 Claude Code 再次管理啟動器，請移除 ~/.local/bin/claude 並執行 claude update。

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

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"
}

新推出的模型可能需要比穩定通道所提供版本更新的 Claude Code 版本。若要立即執行該模型，請切換至最新通道。

對於企業部署，您可以使用受管設定在整個組織中強制執行一致的發行版本通道。

Homebrew 安裝根據 cask 名稱而不是此設定選擇通道：claude-code 追蹤穩定版本，claude-code@latest 追蹤最新版本。

從 apt、dnf 和 apk 儲存庫進行的安裝根據儲存庫而不是此設定選擇通道。若要切換通道，請依照使用 Linux 套件管理員安裝中的說明操作。

​

固定最低版本

minimumVersion 設定建立一個下限。背景自動更新和 claude update 拒絕安裝低於此值的任何版本，因此如果您已經在較新的 "latest" 組建上，移至 "stable" 通道不會降級您。

透過 /config 從 "latest" 切換到 "stable" 會提示您保留目前版本或允許降級。選擇保留會將 minimumVersion 設定為該版本。切換回 "latest" 會清除它。

將其新增到您的 settings.json 檔案以明確固定下限：

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

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

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

​

停用自動更新

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

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

在原生或 npm 安裝上，透過執行 claude doctor 並檢查 Auto-updates 行是否顯示 disabled (set by env: DISABLE_AUTOUPDATER) 而不是 enabled 來確認變更已生效。

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

​

手動更新

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

claude update

當更新安裝時，命令會報告 Successfully updated from <old version> to version <new version>。如果您已經在最新版本上，它會報告 Claude Code is up to date (<version>)。由 Homebrew、WinGet 或 apk 管理的安裝會改為報告 Claude is up to date!。

​

進階安裝選項

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

​

安裝特定版本

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

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

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

若要安裝穩定版本：

macOS、Linux、WSL

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

Windows PowerShell

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

Windows CMD

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

若要安裝特定版本號：

macOS、Linux、WSL

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

Windows PowerShell

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

Windows CMD

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

若要確認已安裝的版本，請執行 claude --version：該命令會列印您傳遞的確切版本，例如 2.1.89 (Claude Code)。

​

使用 Linux 套件管理員安裝

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

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

apt

適用於 Debian 和 Ubuntu。下列安裝命令使用 curl 下載簽署金鑰，並使用 gpg 驗證它，新鮮的 Debian 和 Ubuntu 安裝可能不包含這兩個命令。如果任一命令報告 command not found，請先安裝兩者：

sudo apt install curl gnupg

下載簽署金鑰：

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

如果此下載失敗，稍後 apt update 會失敗並出現 NO_PUBKEY BAA929FF1A7ECACE。在繼續之前，確認金鑰已下載並屬於 Anthropic：

gpg --show-keys /etc/apt/keyrings/claude-code.asc

gpg 列印的指紋應該是 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE。如果 gpg 報告無法開啟檔案或不包含有效的 OpenPGP 資料，則下載失敗或傳回了錯誤的內容：確認您的網路可以到達 downloads.claude.ai，然後重新執行下載命令。

在 stable 通道上註冊儲存庫並安裝：

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

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

dnf

適用於 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。

apk

適用於 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 套件。npm 套件需要 Node.js 22 或更新版本。在較舊的 Node.js 版本上，npm 在安裝期間列印 EBADENGINE 警告而不是失敗；安裝完成且 claude 仍然執行，因為該套件下載不使用您的 Node.js 的原生二進位檔案。

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 範圍，可能無法將您移至最新版本。

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

​

在網路儲存裝置上安裝

執行中的工作階段在運作時會從磁碟讀取 Claude Code 可執行檔的部分內容，而不僅是在啟動時讀取。如果該檔案在工作階段期間變得無法讀取，例如因為它在網路儲存裝置上被截斷或刪除，工作階段就會當機。在 Linux 上，您的 shell 會將此回報為 Bus error。

當家目錄位於網路儲存裝置上時，例如掛載在多台機器上的 NFS 家目錄，請妥善規劃安裝方式，讓每個工作階段的可執行檔在工作階段結束前都保持可讀取：

• 安裝在本機磁碟上：將二進位檔案放在每台機器的本機檔案系統上，例如使用 Linux 套件管理員或您自己的部署工具。個別使用者的 npm prefix 和原生安裝程式的預設 ~/.local/share/claude/versions/ 目錄都位於家目錄中。
• 將每個版本保存在各自的目錄中：使用 npm install -g 就地升級 npm 安裝會刪除先前的二進位檔案。在多台機器共用的儲存裝置上，這會移除其他機器上的工作階段仍在執行的檔案。請將每個新版本安裝在舊版本旁邊，再將使用者移至新版本。
• 僅在沒有任何機器可能仍在執行舊版本時才將其刪除：一台機器無法看到在其他機器上執行的程序，因此在刪除前檢查執行中的程序並不足夠。
• 關閉 Claude Code 本身的更新：設定 DISABLE_UPDATES，並使用您自己的工具安裝新版本。否則，某台機器上 npm 安裝的自動更新會執行相同的就地升級，並移除其他機器上工作階段正在執行的二進位檔案。僅設定 DISABLE_AUTOUPDATER 並不足夠，因為使用者仍可執行 claude update 和 claude install。請參閱停用自動更新。

原生安裝程式會自行從 ~/.local/share/claude/versions/ 刪除舊版本，當該目錄位於共用儲存裝置上時，這一點很重要。除了啟動器指向的版本以及同一台機器上任何工作階段正在執行的版本之外，它會保留最新的兩個版本並刪除其餘版本。另一台機器上正在執行已刪除版本的工作階段會失去其二進位檔案。使用自訂啟動器時，Claude Code 會保留每個已安裝的版本，並將清理工作交由您處理。

​

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

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

​

驗證資訊清單簽名

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

1. 下載並匯入公開金鑰

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

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

   顯示匯入金鑰的指紋。

   gpg --fingerprint [e-mail]
   

   確認輸出包含此指紋：

   31DD DE24 DDFA B679 F42D  7BD2 BAA9 29FF 1A7E CACE
   
2. 下載資訊清單和簽名

   將 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"
   
3. 驗證簽名

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

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

   有效的結果報告 Good signature from "Anthropic Claude Code Release Signing <[e-mail]>"。

   gpg 也會為任何新匯入的金鑰列印 WARNING: This key is not certified with a trusted signature!。這是預期的。Good signature 行確認密碼檢查已通過。第 1 步中的指紋比較確認金鑰本身是真實的。

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

   將您下載的二進位檔案的 SHA256 校驗和與 manifest.json 中 platforms.<platform>.checksum 下列出的值進行比較。下列命令假設目前目錄中有 claude 二進位檔案。若要改為驗證已安裝的原生二進位檔案，請針對 ~/.local/share/claude/versions/VERSION 執行命令，將 VERSION 替換為您在步驟 2 中設定的發佈。

   Linux

   sha256sum claude
   

   macOS

   shasum -a 256 claude
   

   Windows PowerShell

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

​

卸載原生安裝

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

macOS、Linux、WSL

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

Windows PowerShell

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 卸載

移除套件和儲存庫配置：

apt

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

dnf

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

apk

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

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

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

Windows PowerShell

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