---
# System prepended metadata

title: Claude Code 在 Windows 上的完整設定指南

---

# 安裝 WSL 環境

wsl 安裝成功後，會要求設定使用者名稱跟密碼
```bash
wsl --install
```

查詢有哪些 linux 版本，我目前的電腦有2個(包含)以上
```bash
wsl --list
Windows 子系統 Linux 版發佈:
Ubuntu (預設)
docker-desktop
```

如果你的 Ubuntu 不是 WSL 預設版本，需要將剛才安裝的 Ubuntu 設定為 WSL 預設版本
```bash
wsl --set-default Ubuntu # 設定預設 distribution
```

![Screenshot 2025-07-10 180505](https://hackmd.io/_uploads/rJqilf6Bgx.png)
![image](https://hackmd.io/_uploads/SyUpxMTreg.png)


## 安裝 NVM

更新 ubuntu 和相關套件
```bash
sudo apt-get update
sudo apt-get install build-essential libssl-dev
```

安裝 latest nvm 套件
```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
```

## 安裝 Node.js

透過 NVM 安裝 Node.js 最新的 LTS 版本
```bash
nvm install lts
nvm use lts
```

# 安裝 Claude Code
## npm 安裝 claude code 套件

```bash
npm install -g @anthropic-ai/claude-code
```

## VSCode 安裝 Claude Code Extension

請確保你 Windows 已安裝 VSCode

開啟Extensions 安裝:

1. WSL 
2. Claude Code for VSCode

## VSCode WSL + Claude Code

Ctrl+Shift+P -> 選擇 WSL: Connect to WSL
![image](https://hackmd.io/_uploads/HkthWM6Bxx.png)

成功開啟 VSCode 連結 WSL
![image](https://hackmd.io/_uploads/BkglMG6Sxe.png)

在 terminal 打上 claude 跟著步驟進行登入

當有看到這樣的訊息表示成功了
![image](https://hackmd.io/_uploads/Hk2rXzaHlg.png)

輸入 /ide 可以建立 claude code 跟 VSCode IDE 的整合功能 (Claude Code for VSCode)
例如 claude code 的 diff 狀態會透過 gui 呈現 

這裡的範例是使用 github 的 nowinandroid
我請claude code 幫忙優化專案，問了一個發散的問題
claude code會幫我分析與列出調整事項
![image](https://hackmd.io/_uploads/r1g8EfTSeg.png)
![image](https://hackmd.io/_uploads/BkhiNGpBeg.png)

我直接請claude code幫忙調整其提到的問題
![image](https://hackmd.io/_uploads/rk8CVzTrxx.png)
因為有使用 WSL 連結 VSCode，所以可以完整使用 Claude Code 擴充套件的功能，diff比較是其中一個
![image](https://hackmd.io/_uploads/S1aWSMTSxg.png)

以上就是Claude Code在Windows上大致的設定