1. 安裝 WSL 與 Ubuntu

1. 在 PowerShell（管理員模式） 執行：

   wsl --install -d Ubuntu
   

   → 安裝 Ubuntu（例如 Ubuntu 22.04）。

2. 第一次啟動 Ubuntu，設定使用者名稱與密碼。

2. 升級到 WSL2

Claude Code 需要 WSL2，不能用 WSL1。

1. 確認目前版本：

   wsl --list --verbose
   

   如果看到 Ubuntu VERSION = 1 → 代表是 WSL1。

2. 安裝 WSL2 核心更新：

   • 下載並安裝 WSL2 Kernel Update MSI

3. 啟用必要功能（PowerShell 管理員模式）：

   dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
   dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
   

   → 重開機

4. 確認 BIOS 已開啟虛擬化（Task Manager → CPU → 虛擬化是否「已啟用」）。

5. 切換 Ubuntu 至 WSL2：

   wsl --set-version Ubuntu 2
   wsl --set-default-version 2
   

6. 再次確認：

   wsl --list --verbose
   

   → Ubuntu VERSION = 2

3. 在 Ubuntu 安裝 Node.js 與 npm

1. 更新套件：

   sudo apt update
   

2. 使用 NodeSource 安裝最新版 Node.js（20.x）：

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

3. 驗證：

   node -v
   npm -v
   

4. 安裝 Claude CLI

舊版（不建議，已停止更新）

npm install -g claude-cli

→ 指令是 claude。

官方新版（建議）

sudo npm install -g @anthropic-ai/claude-code --registry=https://registry.npmjs.org/

驗證：

claude --version

5. 登入 Claude

1. 啟動：

   claude
   

2. 選擇登入方式：

   • 選 1 → Claude Pro 帳號登入（跳轉網頁）
   • 選 2 → 使用 API key 登入（從 Anthropic Console 生成 API key）

3. 常用指令：

   • /help → 查看幫助
   • /init → 建立 CLAUDE.md，幫助 Claude 理解專案
   • /status → 查看目前登入與環境狀態
   • /exit → 離開

4. 建議在專案資料夾使用，例如：

   mkdir -p ~/projects/test
   cd ~/projects/test
   claude
   

中間遇到的小問題與解法

1. 出現 WSL 1 is not supported

   • 解法：升級 Ubuntu 到 WSL2（安裝核心、啟用功能、BIOS 開啟虛擬化）。

2. 舊版 CLI (claude-cli) 已過時

   • 解法：改裝新版 @anthropic-ai/claude-code。

3. 登入方式疑問：Pro 帳號 vs API key

   • Pro 帳號：直接用訂閱額度，不額外花費。
   • API key：透過 Console 生成，依 token 計費，與 Pro 分開。

完成！現在可以在 WSL2 Ubuntu 裡使用 Claude Code 進行開發。