Windows 系統安裝與使用 Claude Code 全攻略

Claude Code 作為一款高效的 AI 編程輔助工具，深受開發者青睞，但由于其本身不支持 Windows 文件系統，在 Windows 系統上使用需要借助 WSL（適用于 Linux 的 Windows 子系統）。下面為你詳細介紹在 Windows 系統上安裝和使用 Claude Code 的完整流程。

什么是 WSL

WSL（Windows Subsystem for Linux，適用于 Linux 的 Windows 子系統）是微軟于 2016 年在 Windows 10 平臺發布的功能，它能讓用戶在 Windows 操作系統上運行 ELF 格式的 Linux 可執行文件，為在 Windows 上運行原本不支持該系統的程序提供了便利。

安裝前的準備

在安裝 WSL 進而部署 Claude Code 之前，需要滿足一些前置條件：

系統版本：Windows 11 或 Windows 10 21H2 以上，且必須是專業版、工作站版或企業版（非家庭版，因為需要支持 Hyper-V）。
CPU 要求：CPU 需支持虛擬化技術，并且已在 BIOS/UEFI 中啟用虛擬化功能，否則安裝過程中可能會出現未知錯誤。

安裝步驟

步驟一：安裝 WSL

開啟相關功能：打開控制面板，依次進入 “程序與功能”“打開或關閉 Windows 功能”，啟動 “Virtual Machine Platform（虛擬機平臺）” 和 “Windows Subsystem for Linux Support（WSL1）”
這兩個功能。
下載 WSL 安裝包：根據自己的系統版本選擇對應的安裝包，復制鏈接到瀏覽器進行下載。推薦 64 位的 WSL-2.5.9.0 版本，下載鏈接為vip.123pan.cn/1831946356/…；ARM64 版本的下載鏈接為vip.123pan.cn/1831946356/…；ARM64_MicrosoftStore 版本的下載鏈接為vip.123pan.cn/1831946356/…。也可以直接訪問 GitHub（github.com/microsoft/W…）安裝最新版本。
運行安裝包：下載完成后，運行安裝包，按照提示完成 WSL 的安裝。

步驟二：安裝虛擬機

安裝完 WSL 后，可以在微軟應用商店中安裝最新的 Ubuntu 24.04 LTS，也可以通過以下命令安裝：

wsl --install -d Ubuntu - 24.04

也可以通過wsl -l -o命令選擇其他系統版本進行安裝。安裝完成后，在終端（或 PowerShell）輸入wsl即可訪問安裝的操作系統，首次使用需要設置用戶名和密碼。如果通過開始菜單的應用訪問一次后直接關閉窗口而不輸入用戶名和密碼，下次訪問將使用 root 用戶。

步驟三：安裝 Claude Code

Claude Code 是用 Node.js 開發的，所以需要先安裝 Node.js 環境（Node.js 18+），可以通過以下命令安裝：

curl - fsSL https : / / deb . nodesource . com / setup_22 . x | sudo bash -
sudo apt - get install - y nodejs

安裝完成后，可以通過node --version和npm --version命令檢查 Node.js 和 npm 是否可用。

接下來安裝 Claude Code 包，根據自身情況二選一：

A. 全局安裝官方 Claude Code：如果你有官方 Claude Pro 賬號，使用以下命令：

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

B. 全局安裝中轉站 Claude Code：如果是中轉站用戶，選擇這個：

cd ~
npm install - g https : / / gaccode . com / claudecode / install -- registry = https : / / registry . npmmirror . com

如果是 Claude Duck 中轉站用戶，且已經安裝了官方的 Claude Code 包，需要先卸載，兩者有沖突，卸載命令如下：

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

步驟四：運行 Claude Code

安裝完成后，訪問項目文件夾，在該目錄下的終端輸入以下命令即可運行 Claude Code：

mkdir claude - test - demo
cd claude - test - demo
claude