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 版本，ARM64 版本，ARM64_MicrosoftStore 版本。也可以直接訪問 GitHub安裝最新版本。
- 運行安裝包：下載完成後，運行安裝包，按照提示完成 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相關説明
- 沒有 Claude Pro 或者 Max 賬號的用户，在國內可以直接使用中轉站，Claude code 鏡像使用指南
- 安裝過程中出現問題，都可以發送任意郵件到 ClaudeCode@163.com 獲取幫助，相關信息會實時更新。
- 首次使用 WSL 的用户，可以在彈出的 “歡迎使用 WSL” 頁面瞭解幫助，也可以在【WSL 設置】中找到入口。
- WSL 不僅是命令行版本的 Linux 操作系統，它有對應的桌面環境。
- 如果使用的 IDE 編程工具是 VSCode、Cursor 之類的，可以使用 VSCode 的 WSL 插件，鏈接並使用 WSL。安裝完插件之後，使用code .啓動 VSCode，這樣可以使用 Claude Code IDE 插件。
