新手教學 · Windows 安裝 step-by-step

發布：2026-05-13 · 最後更新：2026-06-11

Claude Code Windows 安裝踩雷實錄（2026）

我這台是 Windows 11 主力機，用 Claude Code 半年了。第一次想跟著 YouTube 學裝那天，找了 4、5 部影片，點開全是 MacBook 畫面 — 字體、終端機 UI、安裝步驟通通對不到我的 Windows。

跟著做，第一步 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 以上：從 Node.js 官網 下載 LTS 版（綠色那顆按鈕，不要選 Current）
• PowerShell 5.1 或以上：Windows 內建。鍵盤版：按 Win 鍵 + X 選 Windows PowerShell。滑鼠版：左下角開始鍵（Windows 圖示）按右鍵 → 選 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 裝好了。打開 PowerShell（鍵盤版：Win + X 選 Windows PowerShell；滑鼠版：左下角開始鍵右鍵 → 選 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 比例高，AI 工具教學頻道也自然用 Mac 示範。中文圈現有的 Claude Code 教學影片幾乎清一色 MacBook 畫面，Windows 用戶完全找不到對應版本可以照抄。
• 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% 還在猶豫的人。

名詞解釋

Node.js

讓電腦能執行 JavaScript 程式的基礎環境，Claude Code 要靠它運作。免費，從官網 nodejs.org 下載安裝。

LTS（Long Term Support）

軟體的「長期支援版」，最穩定、官方維護最久的版本。下載 Node.js 時選綠色的 LTS 按鈕就對了。

npm

裝 Node.js 時附帶的套件管理工具，像程式界的 App Store — 一行指令就能安裝各種工具，Claude Code 也是用它裝的。

PowerShell

Windows 內建的指令視窗：用打字下指令的方式操作電腦，Claude Code 就在這裡面跑。按 Win + X 可以叫出來。

終端機（terminal）

「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。

執行原則（Execution Policy）

Windows 的安全限制，預設擋下外來的指令檔。第 3 節雷 1 的紅字就是它造成的，用系統管理員身分設定一次就終身解除。

PATH（環境變數）

系統的「去哪裡找程式」清單。輸入 claude 卻顯示找不到，九成是 npm 的資料夾沒被加進這份清單，手動加一次就好。

編碼（encoding）

電腦儲存文字的方式。Windows 中文路徑用 Big5，多數程式假設 UTF-8，兩邊對不上就變亂碼 — 所以資料夾一律用英文命名。

Vercel

把網站免費發佈到網路上的服務：做好的網站丟上去就有正式網址。第一次部署會撞的雷，見下方相關文章。

Homebrew（brew）

Mac 專用的軟體安裝工具，Windows 沒有也不需要。Mac 教學看到 brew install 開頭的指令，Windows 用戶直接跳過。

這篇是收斂後寫的版本。
我每兩週寄一封電子報，講「正在做但還沒寫成文章」的東西——
包含每月幫你過濾值得花時間的新 AI 工具，
以及 Lab 新文的個人版（你會比公開版早一週收到）。

→ 訂閱（雙週一封，第一封自動寄起步清單）

跳轉 Substack、隨時取消、不轉賣 email。

如果內容對你有用就太好了
隨喜斗內

看完這篇之前先確認:

← 回新手教學