新手教學 · Windows 安裝 step-by-step · 最後更新：2026-05-15

Claude Code Windows 安裝踩雷實錄（2026）｜非工程師全程截圖

短答給趕時間的人：Windows 10 / 11 都能跑 Claude Code，30 分鐘 setup 完。需要 Node.js 18 以上、Windows 內建 PowerShell、Anthropic Pro 訂閱（US$20/月）。流程跟 Mac 一樣的部分有 90%，差別在 Windows 會多撞 3 個雷：PowerShell Execution Policy 被擋、中文資料夾路徑亂碼、npm 全域安裝後 PATH 沒抓到。下面全部給完整指令、卡住怎麼辦、跟 Mac 對照。

我這台是 Windows 11 主力機，用 Claude Code 半年了。第一次想跟著 YouTube 學裝那天，找了 4、5 部影片，點開全是 MacBook 畫面。雷蒙三十、學長 Ethan、PAPAYA、柚智夫妻一字排開，連背景的咖啡杯都像同一張。

跟著做，第一步 brew install 就卡住。Windows 沒這東西，谷歌一下才知道這是 Mac 的鍋。繞過去之後，第二雷紅字、第三雷亂碼，一個下午就過去了（是有屁用看 Mac 教學。

後來是丟給 agent 排查一輪，才發現這些雷都跟 Claude Code 本身沒關係，是 Windows 環境的問題。這篇把那一個下午的痛重整成 step-by-step 教學，照著做 30 分鐘可以裝完。讀完你會做出：一台 Windows 跑得起來的 Claude Code 環境，可以開始用 AI 寫程式、做網站、跑自動化。

Windows 10 / 11 可以用 Claude Code 嗎？需要哪些前置條件？

答案是可以。Windows 10、Windows 11 都能跑 Claude Code，跟 Mac 用同一個 npm 套件。下面是開始前要備齊的東西，少一樣後面就會卡住。

• 作業系統：Windows 10 或 Windows 11（64-bit）
• Node.js 18 以上：從 nodejs.org 下載 LTS 版（綠色那顆按鈕，不要選 Current）
• PowerShell 5.1 或以上：Windows 內建，按 Win 鍵 + X 選 Windows PowerShell 開啟
• Anthropic 帳號 + Pro 訂閱：claude.ai 註冊，Pro 方案 US$20/月。免費版只能用網頁版，沒辦法跟自己電腦的檔案對接
• 硬碟空間至少 2 GB：Node 加上 npm 套件加起來不小

跟 Mac 教學最大的差別：Mac 預設用 Homebrew 安裝 Node，Windows 不需要。直接從 nodejs.org 下載 .msi 安裝程式雙擊一路 Next 就好。新手不要被 brew install 的指令嚇到。

Claude Code 在 Windows 怎麼裝？（PowerShell 4 步驟完整指令）

下面 4 步是我自己 Windows 11 從零裝起來的順序，30 分鐘可全跑完。每一步都附完整指令、預期看到什麼、卡住怎麼辦。直接複製貼進 PowerShell 不會錯。

1. Step 1：確認 Node.js 裝好了。按 Win 鍵 + X 選 Windows PowerShell，輸入 node --version 按 Enter。要看到 v18 或更高的數字。看到「無法辨識的詞彙」代表 Node.js 沒裝好或 PATH 沒抓到，先回 nodejs.org 下載 LTS 版重裝。
2. Step 2：用 npm 全域安裝 Claude Code。輸入 npm install -g @anthropic-ai/claude-code 按 Enter。會跑 30 秒到 2 分鐘看你網路。跑完看到「added X packages」就成功。如果跳紅字 EACCES、ExecutionPolicy 之類的，跳到第 3 節雷 1 看解法。
3. Step 3：進到你要工作的資料夾。先在桌面新建一個英文命名的資料夾例如 my-project，回到 PowerShell 輸入 cd C:\Users\你的名字\Desktop\my-project。注意路徑用反斜線，Windows 跟 Mac 不一樣（Mac 是正斜線）。資料夾名稱絕對不要用中文，會在後面卡關。
4. Step 4：啟動 Claude Code。在資料夾裡輸入 claude 按 Enter。第一次會跳出登入流程，把 PowerShell 顯示的網址貼到瀏覽器登入 Anthropic 帳號，把回傳的驗證碼貼回 PowerShell 就完成。

怎麼確認 setup 真的成功：PowerShell 視窗應該變成一個對話介面，左下角顯示「>」等你輸入。輸入「你好」按 Enter，Claude 用中文回你一段話 = 完成。如果輸入 claude 跳「無法辨識的詞彙」，跳到第 3 節雷 3，99% 是 PATH 環境變數沒設好。

PowerShell 跳紅字、找不到 claude 指令怎麼辦？（Windows 三個專屬雷）

下面 3 個雷，99% 的 Windows 用戶會撞到，跟 Claude Code 本身沒關係，是 Windows 環境的問題。Mac 教學完全不會提，因為 Mac 沒有這些限制。每個雷給現象、原因、解法，照著做就過。

雷 1：PowerShell 執行原則（Execution Policy）被擋下來

現象：輸入 claude 跳一片紅字，內含「指令碼執行已停用」「about_Execution_Policies」「PSSecurityException」等字。

原因：Windows 預設禁止跑 npm 全域安裝的執行檔，是系統安全限制，不是 Claude Code 的問題。

解法：在開始選單對 PowerShell 按右鍵選「以系統管理員身分執行」，輸入 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser 按 Enter，跳出確認時打 Y 按 Enter。設一次就終身有效，不是每次都要。設完關掉 PowerShell 重開再試 claude 就過了。

雷 2：中文資料夾路徑讓 Claude 讀檔變亂碼

現象：資料夾命名用「桌面」「我的文件」「專案」這種中文，Claude Code 讀進去整個檔名變問號或方框，工作流卡住。

原因：Windows 中文路徑用 Big5 / GBK 編碼，Node.js 跟很多 npm 套件預設假設是 UTF-8，編碼對不上就解碼錯誤。

解法：所有跟 AI 對接的資料夾，全部改成英文 + 數字 + 連字號的命名。例如「我的網站專案」改成 my-web-project。改習慣比每次修錯誤快。Mac 用戶不會遇到這個雷因為 Mac 預設是 UTF-8。

雷 3：輸入 claude 跳「無法辨識的詞彙」（PATH 沒抓到）

現象：第 2 步 npm install 跑成功看到「added X packages」，但第 4 步輸入 claude 跳「無法將 'claude' 識別為 Cmdlet」。

原因：npm 全域安裝的執行檔會放在 C:\Users\你的名字\AppData\Roaming\npm 這條路徑，Windows PATH 沒抓到這條，輸入 claude 系統就找不到。Mac 完全不會遇到，因為 Mac 預設都會抓 npm 全域路徑。

解法：手動把 npm 路徑加進系統 PATH。Windows 設定 → 系統 → 進階系統設定 → 環境變數 → 在「使用者變數」找到 Path 點編輯 → 新增 → 貼上 C:\Users\你的名字\AppData\Roaming\npm → 確定 → 全部關掉。重開 PowerShell 再試 claude 就過了。

為什麼 KOL 教學都用 Mac？Windows 用戶該怎麼補？

工程師圈子 Mac 比例高，Anthropic 官方文件原本就假設 Mac 或 Linux 環境。但 Windows 在台灣個人電腦市佔率超過 80%，所以「跟著 Mac 教學做不出來的人」其實比 Mac 用戶還多。下面 3 個結構性原因講為什麼會這樣。

• 工程師圈早期 Mac 比例高，KOL 自然用 Mac 示範。雷蒙三十、學長 Ethan、PAPAYA、柚智夫妻一字排開都是 MacBook 畫面，連背景咖啡杯都像同一張。
• Mac 的 Terminal + Homebrew + zsh 環境跟 Linux 接近，Anthropic 官方文件原本就是這個假設，Windows 用戶要自己補環境差異。
• Mac 沒有 PowerShell Execution Policy 這種「保護用戶不誤開檔」的限制，所以 Mac 教學步驟少很多。看起來「Mac 裝起來超快」是這個原因，不是 Mac 真的優越。

Windows 用戶補的方法：跟著 Mac 教學跑，遇到 brew install 改用直接下載 .msi 安裝程式、遇到 sudo 改用「以系統管理員身分執行」、遇到正斜線改反斜線、遇到中文路徑改英文。看 Mac 教學 + 這 4 個翻譯，90% 的內容可以照搬。剩下 10% 就是上面三個專屬雷。

Claude Code 裝完之後第一個專案怎麼開？（從 setup 到上線的下一步）

第一個專案不要挑「我要做一個 SaaS」，挑「我老婆會用、我每天會用、我家人會用」的小工具。技術門檻低、需求清楚、做完馬上能用，新手建立信心的速度最快。

我自己第一個專案是給老婆做的童裝庫存管理頁。從零到上線在 Vercel 花了一個下午，但中間部署卡了 3 小時——「我自己電腦看得到、網路上完全沒變化」這個玄學問題，Windows 用戶 100% 會撞到。

詳細紀錄寫在這篇：我以為再補一段就好，結果改了 3 小時——「重寫比修補快」的啟示（連結在下方相關文章區）。建議裝完 Claude Code 之後直接接著看那篇，把第一次部署的雷一起避開。

不想自己 setup 怎麼辦？Windows 非工程師的 3 個選擇

有 3 條路，看你時間跟意願。下面從免費自學到付費代做，從輕到重排序。

1. 路線 1 — 跟著這篇文章自己跑一次。Pro：只付 Claude Code US$20/月，能力長在自己身上。Con：Windows 三個雷至少花 1-2 小時 debug。適合：有時間、想搞懂底層、看文章不痛苦的人。
2. 路線 2 — 看這篇加上 Lab 未來推出的 Windows 系列影片。Pro：跟著畫面做卡住率比看文字版低。Con：影片還在製作中，目前先以這篇文字版為主。適合：看影片比看長文快的人。
3. 路線 3 — 不想自己研究我教你（規劃中）。1-on-1 帶你從 Windows 安裝、Claude Code setup、第一個專案上線、build-in-public 開戶整套跑完。Pro：不用自己 debug、不用看長文、有人帶。Con：要付費。適合：沒時間自己研究、不想看文章、想直接從 0 到 1 的人。

Windows 用戶在 AI 時代不是劣勢，只是 KOL 沒人寫教學給你而已。三條路任選一條開始跑，就贏 80% 還在猶豫的人。

看完這篇之前先確認:

← 回新手教學