Claude Code 下載與 Windows 安裝:Desktop App、CLI、WSL 點樣揀(2026)

Claude Code 下載到底應該揀桌面版定係 CLI?呢份 2026 Windows 安裝指南提供官方下載入口、PowerShell/WinGet/WSL 指令、Desktop 同 CLI 嘅分別,以及常見報錯處理。

PandaNpc首次發佈於
Claude Code 下載與 Windows 安裝:Desktop App、CLI、WSL 點樣揀(2026)

Claude Code download 嘅時候,最容易中伏嘅位唔係下載失敗,而係冇先搞清楚自己要裝邊一個:

  • 想要圖形介面、並排管理多個任務,下載 Claude Desktop,再入去入面嘅 Code 標籤;
  • 想喺 PowerShell、CMD、Git Bash 或 IDE 終端輸入 claude,安裝 Claude Code CLI
  • 項目同工具鏈主要行 Linux,或者需要沙箱,安裝去 WSL 2
  • Desktop 同 CLI 可以同時裝,兩者唔係互斥選項。

本文按 2026 年 8 月嘅官方文檔整理。官方下載只認以下兩個入口:

唔好從網盤、軟件下載站或者陌生 GitHub Release 下載所謂嘅「Claude Code 安裝包」。

先睇結論:Claude Code Desktop、CLI、WSL 點樣揀

方案 適合邊個 Windows 支援 主要分別
Claude Code Desktop 唔想用終端,想睇檔案、Diff、預覽同多個並行會話 Windows x64、Windows ARM64 圖形介面;Code 標籤已經包含 Claude Code,唔使另外裝 CLI
Claude Code CLI(原生 Windows) 日常喺 PowerShell、CMD、Git Bash、VS Code 終端工作 Windows 10+ 最貼近終端工作流程;建議安裝 Git for Windows;目前唔支援沙箱
Claude Code CLI(WSL 2) Linux 項目、Docker、伺服器端工具鏈、需要沙箱 Windows 10/11 + WSL 2 喺 Linux 環境入面執行;沙箱可用;項目最好都放喺 WSL 檔案系統入面

最簡單嘅判斷方式:

  • 第一次接觸 Claude Code,先裝 Desktop
  • 已經習慣用終端,直接裝 CLI
  • 開發環境本身已經喺 WSL,唔好跨檔案系統搞嚟搞去,直接裝入 WSL 2

Claude Code Desktop App 下載與安裝

Claude Code 嘅桌面版唔係一個叫「Claude Code.exe」嘅獨立產品。佢位於 Claude Desktop 應用程式入面嘅 Code 標籤。

第 1 步:由官方下載頁選擇版本

開啟 claude.com/download,Windows 用戶按處理器選擇:

  • 大部分 Intel / AMD 電腦:下載 Windows x64
  • Windows on ARM 裝置:下載 Windows ARM64

安裝之後,由開始選單啟動 Claude,登入 Anthropic 帳戶,再按頂部嘅 Code

第 2 步:選擇執行環境

開新 Code 會話嗰陣,桌面版通常提供三種環境:

  • Local:直接讀取同修改呢部電腦上嘅項目;
  • Remote:喺 Anthropic 嘅雲端環境入面執行;
  • SSH:連接你自己管理嘅遠端 Linux 或 macOS 機器。

如果你只係想畀 Claude 修改本機項目,揀 Local,再選擇項目資料夾就得。Windows 本機會話需要 Git,建議先安裝 Git for Windows

Desktop 版適合邊啲人

Desktop 嘅優勢唔係「將終端塞入視窗」,而係將多會話、檔案編輯器、終端、Diff 審查、應用程式預覽同 PR 狀態放喺同一個介面入面。你可以並排執行多個 Agent,又唔使不停咁切終端標籤。

但如果你需要腳本化啟動、喺現有終端入面工作、成日使用 slash command,CLI 通常更直接。

Claude Code Desktop 需要 Pro、Max、Team 或 Enterprise 方案。如果只裝好應用程式但睇唔到 Code,先檢查登入帳戶同訂閱權限。

Claude Code CLI:Windows 原生安裝

官方而家推薦原生安裝器,唔再要求為咗 Claude Code 先全域安裝 Node.js。

方法一:PowerShell 安裝(推薦)

開啟 PowerShell,執行:

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

安裝完成之後,關閉並重新開啟終端,再驗證:

powershell
claude --version
claude

首次執行 claude 會引導你登入。進入項目目錄之後先啟動,佢先可以從正確嘅工作目錄讀取程式碼:

powershell
cd D:\Projects\my-app
claude

方法二:WinGet 安裝

如果你習慣用 Windows 套件管理員:

powershell
winget install Anthropic.ClaudeCode

WinGet 版本唔會好似原生安裝器咁自動喺背景更新,之後需要手動執行:

powershell
winget upgrade Anthropic.ClaudeCode

方法三:CMD 安裝

如果你嘅提示字元係 C:\Users\...>,前面冇 PS,即係話你用緊 CMD。執行:

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

PowerShell 同 CMD 嘅命令唔可以溝埋用。好多「安裝腳本報語法錯誤」嘅情況,本質上只係將 CMD 命令貼咗入 PowerShell,或者掉轉頭。

Claude Code Windows:原生定係 WSL 2

Claude Code 已經支援原生 Windows,唔再係「Windows 一定要裝 WSL」。但兩種環境各有取捨。

揀原生 Windows,如果你:

  • 項目位於 C:\D:\
  • 依賴 Visual Studio、PowerShell、Windows SDK 等原生工具;
  • 想安裝最簡單;
  • 唔需要 Claude Code 沙箱。

原生模式建議安裝 Git for Windows。Claude Code 會優先使用 Git Bash 執行 Bash 工具;如果冇 Git Bash,亦都可以使用 PowerShell 工具。

揀 WSL 2,如果你:

  • 項目以 Linux、Docker、Node/Python 伺服器端工具鏈為主;
  • 需要沙箱;
  • 部署環境就係 Linux;
  • 已經長期喺 WSL 終端開發。

入咗 WSL 2 之後執行 Linux 安裝命令:

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

然後喺 WSL 入面驗證:

bash
claude --version
claude

唔好一時由 Windows PowerShell 啟動,一時又由 WSL 啟動,但就期望兩邊嘅路徑、Git、環境變數完全一致。項目喺邊個環境,就喺嗰個環境安裝同執行 Claude Code。

Claude Code Desktop App 同 CLI 有咩分別

問題 Desktop App CLI
需要終端嗎 唔需要 需要
需要另外安裝 Node.js 嗎 唔需要 原生安裝器唔需要;舊 npm 方式先需要
多會話並排管理 取決於你嘅終端工具
腳本化、命令列啟動
檔案、Diff、預覽 內置圖形介面 主要喺終端或 IDE 入面完成
Windows 原生執行 支援 支援
WSL 2 Desktop 唔會喺 WSL 入面執行 支援
可唔可以同時安裝 可以 可以

一個實用組合係:平時用 Desktop 睇多個會話同 Diff,需要自動化或者終端上下文嘅時候先用 CLI。裝唔裝 CLI,都唔會影響 Desktop 嘅 Code 標籤正常運作。

Windows 安裝常見錯誤

1. `The token '&&' is not a valid statement separator`

你將 CMD 命令貼咗入 PowerShell。返回上面嘅 PowerShell 方案,使用:

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

2. `'irm' is not recognized`

你而家用緊 CMD,唔係 PowerShell。開啟 Windows PowerShell,或者改用 CMD 安裝命令。

3. `claude` 唔係內部或外部命令

先關閉並重新開啟終端。如果仍然搵唔到,檢查 %USERPROFILE%\.local\bin 係咪喺 PATH 入面,然後執行:

powershell
Get-Command claude

亦可以執行官方診斷:

powershell
claude doctor

4. 搵唔到 Git Bash

安裝 Git for Windows;如果裝喺自訂目錄,可以喺 Claude Code 設定入面指定:

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

5. Desktop 入面冇 Code 標籤,或者出現 403

依次檢查:

  1. 而家登入嘅係咪買咗 Claude 方案嘅帳戶;
  2. Claude Desktop 係咪已經更新到最新版;
  3. 登出帳戶、重新啟動應用程式之後再登入;
  4. 團隊帳戶係咪被管理員限制咗用 Claude Code。

裝好之後,點樣從手機或瀏覽器繼續 Claude Code

安裝解決嘅係「Claude Code 喺邊度執行」,遠端控制解決嘅係「人唔喺電腦前面嗰陣點樣繼續」。

Anthropic 已經提供 Desktop、Web、Remote Control 同手機 Dispatch 等官方方式。如果你只係用官方 Claude 帳戶同官方模型,通常應該優先試呢啲功能。

如果你仲需要以下場景,可以再考慮吓 PandaNpc:

  • 喺同一個介面遠端控制 Claude Code、OpenAI Codex 同 PandaCode
  • Agent 繼續行喺自己嘅 Windows / macOS / Linux 開發機上面;
  • 使用自訂模型或者自己嘅 API endpoint;
  • 從 iPhone、任何瀏覽器、另一部桌面電腦或 Chrome 側邊欄繼續同一個會話;
  • 遠端查看串流輸出、審批工具呼叫、回答問題同查看程式碼變更;
  • 唔開放公網連接埠,開發機同控制端都只建立出站連線。

先確認官方 Claude Code 已經可以正常運行,再喺開發機安裝 pandapaw:

Windows PowerShell:

powershell
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

macOS / Linux:

bash
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh

安裝之後開啟 PandaNpc Agent,開發機嘅連線會出現喺列表入面。你亦都可以使用 Windows / macOS / Linux 用戶端或 iOS App

常見問題

Claude Code 係桌面軟件定係命令行工具?

兩者都係。Claude Desktop 嘅 Code 標籤提供圖形介面;Claude Code CLI 就從終端啟動。佢哋服務唔同嘅工作流程,可以同時安裝。

Claude Code Windows 一定要用 WSL 嗎?

唔一定要。原生 Windows 已經受支援。Windows 項目優先原生安裝;Linux 工具鏈或者需要沙箱嗰陣先揀 WSL 2。

Claude Code download 需要 Node.js 嗎?

Desktop 唔需要。官方原生 CLI 安裝器都唔需要。只有仲用緊舊嘅 npm install -g @anthropic-ai/claude-code 方式嗰陣先需要 Node.js。

Claude Code 有冇 Windows ARM64 版本?

Claude Desktop 官方下載頁提供 Windows ARM64 安裝包。CLI 就請以官方安裝腳本而家偵測到嘅平台為準。

Claude Code Desktop 支援 Linux 嗎?

Claude Code 嘅桌面 Code 體驗目前面向 macOS 同 Windows。Linux 用戶使用 CLI,或者透過 Web / 遠端用戶端操作執行喺 Linux 上嘅會話。

Desktop 同 CLI 邊個好啲?

冇絕對答案。想要可視化、多會話、Diff 同預覽,揀 Desktop;想要終端效率、腳本化同現有開發工具鏈,揀 CLI;Linux 環境同沙箱需求就優先 WSL 2。

一句講晒

淨係想快速開始:由 Claude 官方下載頁 安裝 Desktop,再開啟 Code 標籤。

想喺 Windows 終端使用:喺 PowerShell 執行:

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

項目喺 Linux 工具鏈入面:入去 WSL 2,執行:

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

首先將官方 Claude Code 安裝正確,再決定需唔需要 Desktop、CLI 同時使用,以及需唔需要用 PandaNpc 從手機、瀏覽器或另一部電腦遠端繼續會話。

讓 Claude 直接操作你嘅瀏覽器:填表、發帖,連滑塊驗證碼都拖得過去

讓 Claude 直接操作你嘅瀏覽器:填表、發帖,連滑塊驗證碼都拖得過去

大多數人用 AI 還停留在「你問它答」。PandaNpc 的 Chrome 插件讓你的 Claude Code 真的伸手進瀏覽器,替你點、替你填、替你翻頁——甚至替你把滑塊驗證碼拖過去。靠 Chrome 開發者協議在內核層注入 isTrusted=true 的真實輸入 + 後端計算好的擬人拖動軌跡,過反爬、進跨域 iframe。43 個操作工具,配一整套審批卡 + 域名黑名單 + 暫停開關 + 操作留痕的安全閘。

閱讀文章 →
Claude 訂閱可以共享嗎?如何安全分享 Claude Code 給朋友和團隊(無需密碼、隨時可撤銷)

Claude 訂閱可以共享嗎?如何安全分享 Claude Code 給朋友和團隊(無需密碼、隨時可撤銷)

可以——而且不用把帳號密碼交給任何人。PandaNpc 支援你將機器上的 Claude Code 連接用一條連結分享給朋友、家人或隊友:對方遠端使用你的訂閱額度運行 Claude Code,每個分享是獨立可撤銷的 token,可設 1/7/30 天或永久有效期,一鍵撤銷對方立刻斷開,完全不影響你自己用。

閱讀文章 →
Claude Code 遠端斷線排查:六種斷法的症狀、判據和對應解法

Claude Code 遠端斷線排查:六種斷法的症狀、判據和對應解法

Claude Code 遠端連線中斷了,先別急著重連——不同的斷線方式症狀不一樣,修復方法也完全不同。本文按「你看到的現象」反推六種斷因(機器睡眠、切換網絡掐斷長連線、投屏式方案本機必須開著、半死連線、重連丟失會話、進程被回收),每種都給出確認判據和對應解法,最後是一張可以照著走的排查清單。

閱讀文章 →