Claude Code 要裝 WSL 嗎？Windows 直接跑就好
文 / Coolkid發布：2026-08-06閱讀約 7 分鐘
短答給趕時間的人：2026 年裝 Claude Code 不需要 WSL，Claude Code 已經原生支援 Windows，照 Windows 安裝篇直接裝就能跑。網路上「第一步：安裝 WSL」的教學是 2025 年早期的產物，當時 Windows 確實要靠 WSL，現在照做是繞遠路。WSL 白話講，就是在 Windows 裡面再開一台「小型 Linux 電腦」的功能，少數需要 Linux 環境的工具用得到，遇到再裝，隨時能補裝。
我 2026 年 4 月入門那天就是直接裝在 Windows 上，全程沒碰 WSL。到今天主力工作也都在原生環境。
但我電腦上確實也跑著 WSL，為了一個天生屬於 Linux 的工具。
而且該遇到的問題我都遇過了：裝半套開不起來、兩邊版本各走各的、路徑混用出錯。
這篇把「要不要裝」的判斷，和真的要裝時的三個問題，一次講清楚。
先講答案：2026 年，直接原生裝
Claude Code 剛出的年代(2025 年初)，Windows 上要靠 WSL 才能跑。
所以那個時期的教學都把「裝 WSL」寫成第一步，這些文章現在還排在搜尋結果前面。
但現在的情況已經變了。
官方原生支援 Windows，開 PowerShell 照 Windows 安裝篇走完就能用。
所以看到叫你先裝 WSL 的教學，第一件事要做什麼？看那篇的發文日期。
那 WSL 到底是什麼？
一句白話：微軟讓你在 Windows 裡面再開一台「小型 Linux 電腦」的功能。
Linux 是另一個作業系統家族，伺服器與許多開發工具的老家。
兩台電腦共用你的硬碟，但各自有各自的系統、工具和習慣。
記住「它是另一台電腦」這個畫面，後面三個問題你就都能預判了。
那 WSL 什麼時候有用？
| 你的情況 | 建議 |
|---|---|
| 新手、第一次裝 Claude Code | 原生，別繞路 |
| 日常做網站 / 機器人 / 自動化(我的主力場景) | 原生全部做得到 |
| 要用的某個工具只支援 Linux | 這才是 WSL 的用武之地 |
| 常跟著 Linux / Mac 的教學做事 | WSL 內指令幾乎不用翻譯，可考慮 |
先講我自己的誠實現況。
電腦上確實有一個工具跑在 WSL 裡，那東西天生是 Linux 的，硬搬到 Windows 比裝一個 WSL 更折騰。
但那是三個月來的唯一特例。
其他所有專案，包括這個網站、每天在跑的自動化機器人，全在原生 Windows。
之前查證 Codex 那篇時也看到同款注記：少數需要 Linux 工具的場景，官方仍建議搭配 WSL。
關鍵詞是「少數」。WSL 隨時能補裝，不需要預防性安裝。
真的要裝的話，會踩到哪三個坑？
- 裝半套。wsl --install 跑完顯示成功，其實還要重開機才算完;有的電腦還得進 BIOS 把虛擬化功能打開(開機時按特定鍵才進得去的那個設定畫面)。卡在「明明裝了卻開不起來」的人，九成是這兩步沒做完。
- 兩邊各裝各的。WSL 是另一台電腦：你在 Windows 裝好的 Node.js、設定好的環境，WSL 裡通通沒有，要重裝一份;而且兩邊版本各走各的。我踩過 WSL 裡的 node 版本跳來跳去，Windows 這邊修好的東西，那邊照樣壞。修了半天才想起來，我根本修錯台電腦。
- 路徑與速度。Windows 的 C:\ 在 WSL 裡叫 /mnt/c，兩套寫法混在同一個指令裡一定出錯;更隱形的是跨系統讀檔很慢，檔案放 Windows、程式跑 WSL(或反過來)，速度可以差好幾倍。原則一句：檔案跟工具住同一邊。
判斷表收尾+一個通用提醒
收尾判斷。新手直接原生裝，照 Windows 安裝篇走、亂碼問題配亂碼篇，那兩篇加起來就是你需要的全部。
已經裝了 WSL 而且一切順的人，不用搬，能跑就是好架構。
覺得卡卡的人，問自己一句：「我有用到任何 Linux 限定的東西嗎？」
沒有的話，搬回原生通常一小時內搞定。
這種環境搬家的活，直接叫 Claude Code 教你搬，比爬文快。
最後一個通用提醒。價值超過這篇其他所有內容。
在兩個世界並存的電腦上，遇到怪問題先確認「我現在到底在哪一邊」。
看終端機的提示字串長什麼樣、路徑開頭是 C:\ 還是 /。
我在 WSL 遇到的問題，一半以上原因都是「以為自己在 A，其實在 B」。
搞清楚位置，一半的怪問題自動消失。
2026 年裝 Claude Code 不需要 WSL：已經原生支援 Windows，「第一步裝 WSL」是 2025 年早期教學的過時產物，看到先查發文日期。WSL 就是在 Windows 裡再開一台小型 Linux 電腦，兩台共用硬碟但各有系統與工具;用武之地是「某工具只支援 Linux」「常跟 Linux 教學做事」這種少數場景，遇到再裝，隨時能補裝，不用預防性安裝(我 2026-04 起主力全原生，只有一個 Linux 原生工具跑 WSL)。真要裝的三個坑：wsl --install 只裝半套(要重開機、要在 BIOS 開虛擬化)、兩邊各裝各的(Node.js 與環境要重來，版本各走各的，小心修錯台電腦)、路徑與速度(C:\ 在 WSL 叫 /mnt/c，混用一定出錯;跨系統讀檔慢好幾倍，檔案跟工具住同一邊)。通用提醒：遇到怪問題先確認自己在哪一邊。
名詞解釋
- WSL（Windows Subsystem for Linux）
- 微軟提供的功能：在 Windows 裡面跑一個 Linux 子系統，像電腦裡再開一台小電腦。需要 Linux 環境的工具靠它就能在 Windows 上用，但檔案與工具分屬兩個世界，混用容易踩坑。
- Linux
- 跟 Windows、macOS 並列的作業系統家族，伺服器與許多開發工具的主流環境。不少教學的指令以它為前提寫成，搬到 Windows 有時要翻譯。
- Claude Code
- Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- 終端機（terminal）
- 「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- Node.js
- 讓電腦能執行 JavaScript 程式的基礎環境。Claude Code 的 npm 舊裝法才需要先裝它；2026 年官方推薦的 native 一行安裝不用。免費，從官網 nodejs.org 下載安裝。
- PATH（環境變數）
- 系統的「去哪裡找程式」清單。指令打了卻顯示找不到，九成是程式所在的資料夾沒被加進這份清單。
如果內容對你有用就太好了
隨喜斗內
▸ 常見問題
2026 年在 Windows 裝 Claude Code,還需要先裝 WSL 嗎？
不需要。Claude Code 已原生支援 Windows，開 PowerShell 照安裝步驟走就能跑，我 2026 年 4 月入門起全程原生，網站與自動化機器人都在上面做。要求先裝 WSL 的教學是 2025 年早期的產物，照做等於繞遠路;判斷法很簡單：先看那篇教學的發文日期。
WSL 是什麼？裝了會不會影響 Windows？
WSL(Windows Subsystem for Linux)是微軟的功能：在 Windows 裡面跑一台「小型 Linux 電腦」，給需要 Linux 環境的工具用。兩邊共存、不會弄壞 Windows，但要知道：它是另一台電腦，佔硬碟空間、工具要另外裝一份、檔案與路徑分屬兩個世界。沒有明確需求的話，不用預防性安裝。
wsl --install 跑完了，怎麼好像沒裝好？
九成卡在兩步：一是要重開機才算裝完(指令跑完顯示成功很會騙人);二是部分電腦要進 BIOS 把虛擬化功能打開，沒開的話 WSL 根本啟動不了。這兩步做完還不行，把錯誤訊息貼給 Claude Code 讓它帶你查，環境問題交給 AI 自己查，比自己猜快。
檔案該放 Windows 這邊還是 WSL 裡面？
跟工具住同一邊：程式在哪邊跑，檔案就放哪邊。跨邊讀寫(檔案在 Windows、程式在 WSL，或反過來)不只路徑容易錯(C:\ 與 /mnt/c 兩套寫法)，速度還會慢好幾倍，這是 WSL 最隱形的坑。如果發現自己常常需要跨邊，通常代表這個專案放錯世界了，搬到同一邊一勞永逸。
看完這篇之前先確認:
- 看到教學說 Windows 要先裝 WSL,想確認還需不需要的人
- 已經裝了 WSL 覺得卡卡的，想知道要不要搬回原生的人
- 分不清原生跟 WSL 兩種裝法差在哪的人
- Mac 用戶 (沒有這個問題)
- 本來就熟 Linux 的工程師 (你自己會判斷)
- 只想找安裝步驟 (直接看 Windows 安裝那篇)
- 照 2025 年的舊教學先裝 WSL — 繞遠路，現在原生就能跑
- wsl --install 跑完以為好了 — 沒重開機/虛擬化沒開，只裝半套
- 檔案放一邊、工具跑另一邊 — 路徑錯亂，而且慢好幾倍