Claude Code 安裝失敗?Windows 檢查 6 步
先講重點
短答給趕時間的人:Claude Code 裝不起來,9 成不是安裝檔壞掉,是環境問題。照這個順序查:(1) node -v 有沒有 18 以上 (2) npm -v 打得出版本嗎 (3) PowerShell 有沒有擋指令碼 (4) 安裝指令跑完有沒有紅字 (5) 重開終端機再打 claude (6) 還不行就跑 claude doctor。每步 1-2 分鐘,10 分鐘內能定位問題在哪一層。
我自己第一次裝的時候在第 5 步卡了半小時 — 裝明明成功了,打 claude 卻說找不到命令,差點以為要重灌。後來才知道只是沒重開終端機。這篇把我裝機 + 後來幫別人排查累積的坑,整理成一個照順序走就好的排查表。
先看症狀:你卡在哪一步?
不同症狀對應不同原因,先對號入座再往下跳:
| 你看到的訊息 | 問題在哪 | 跳到 |
|---|---|---|
| node 不是內部或外部命令 | Node.js 沒裝或 PATH 沒吃到 | 第 1 步 |
| npm 不是內部或外部命令 | Node 裝了但 npm 路徑沒進 PATH | 第 2 步 |
| 因為這個系統上已停用指令碼執行 | PowerShell 執行原則擋住 | 第 3 步 |
| 安裝跑完滿屏紅字 EACCES / EPERM | 權限不足或公司電腦被鎖 | 第 4 步 |
| 裝完打 claude 沒反應 / 找不到命令 | 終端機沒重開 PATH 沒更新 | 第 5 步 |
| claude 有反應但登入卡住 | 網路 / 瀏覽器授權問題 | 第 6 步 |
第 1-2 步:Node.js 跟 npm 的地基
Claude Code 跑在 Node.js(一個讓 JavaScript 在你電腦上執行的環境)上,官方要求 18 以上版本(2026-07 查,以官方文件為準)。先打這兩行確認地基:
node -v
npm -v兩行都要吐出版本號(例如 v22.x.x 跟 10.x.x)才算過。常見三種失敗:(1) 完全沒裝 → 去 nodejs.org 下載 LTS(長期支援版),安裝時記得勾 Add to PATH。(2) 版本低於 18 → 重裝 LTS 蓋過去。(3) node 有版本、npm 沒有 → 安裝時沒勾完整元件,重跑安裝檔選修復。
裝完 Node 一定要「關掉終端機重開」再驗證 — 舊視窗讀的是開啟當下的 PATH,看不到新裝的東西。
第 3-4 步:PowerShell 擋路跟權限紅字
Windows 特有的第一雷:PowerShell 預設不給跑指令碼,npm 相關命令會吐「因為這個系統上已停用指令碼執行」。解法是把執行原則放寬到 RemoteSigned(只放行本機指令碼,不影響安全性太多):
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned跑完選 Y 確認,重開 PowerShell 再裝一次。第二雷是安裝時滿屏 EACCES / EPERM 紅字 — 這是權限問題:自己的電腦,用「以系統管理員身分執行」開 PowerShell 重跑;公司電腦,大概率是 IT 政策鎖住,別硬繞(可能違反公司規範),直接找 MIS 開權限。
確認地基都好之後,安裝指令本體只有一行:
npm install -g @anthropic-ai/claude-code第 5-6 步:裝完的最後一哩(最多人卡在這)
安裝顯示成功、打 claude 卻說找不到命令 — 這就是我當年卡半小時的地方。原因跟第 2 步一樣:npm 全域安裝會把 claude 放進一個資料夾,這個資料夾要透過 PATH 讓終端機找到,而 PATH 是終端機「開啟當下」讀的。解法一行都不用打:把終端機整個關掉、重開、再打 claude。
第一次啟動會跳出瀏覽器要你登入 Anthropic 帳號授權(OAuth,用你的帳號幫工具開門、不用把密碼給它)。這步卡住通常是:瀏覽器沒自動跳出(手動複製終端機顯示的網址)、或公司網路擋了授權頁(換熱點試一次就能分辨)。
全部都試過還不行,讓它自己體檢:啟動後打 /doctor,它會列出安裝狀態跟問題;或把終端機的錯誤訊息整段貼給網頁版 Claude 問 — 排查自己的錯誤訊息,本來就是 AI 最擅長的事之一。
口訣:地基(node/npm)→ 路障(執行原則/權限)→ 重開終端機 → /doctor。9 成問題活不過第 5 步。
Claude Code 安裝失敗 9 成是環境問題不是安裝檔問題,照 6 步排查:(1) node -v 確認 18 以上 (2) npm -v 有版本號 (3) PowerShell 執行原則放寬到 RemoteSigned (4) EACCES 紅字用系統管理員重跑、公司電腦找 MIS (5) 裝完關掉終端機重開再打 claude — 最多人卡在這步,PATH 要重開才更新 (6) 還不行打 /doctor 自我體檢,或把錯誤訊息貼給網頁版 Claude 問。每步 1-2 分鐘,10 分鐘內定位。裝好之後接「第一次用 AI 做網站」開始做東西。
名詞解釋
- Node.js
- 讓電腦能執行 JavaScript 程式的基礎環境，Claude Code 要靠它運作。免費，從官網 nodejs.org 下載安裝。
- npm
- 裝 Node.js 時附帶的套件管理工具，像程式界的 App Store — 一行指令就能安裝各種工具，Claude Code 也是用它裝的。
- PATH（環境變數）
- 系統的「去哪裡找程式」清單。指令打了卻顯示找不到，九成是程式所在的資料夾沒被加進這份清單。
- 執行原則（Execution Policy）
- Windows 的安全限制，預設擋下外來的指令檔。PowerShell 跳紅字常是它造成的，用系統管理員身分設定一次就解除。
- PowerShell
- Windows 內建的指令視窗：用打字下指令的方式操作電腦，Claude Code 在 Windows 上就在這裡面跑。按 Win + X 可以叫出來。
- 終端機（terminal）
- 「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- 命令列（CLI, Command Line Interface）
- 用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
- OAuth（帳號授權登入）
- 「用你的帳號幫工具開門」的標準流程：跳出瀏覽器讓你登入原服務，工具拿到授權後就能代你操作，全程不用把密碼交給工具。
- LTS（Long Term Support）
- 軟體的「長期支援版」，最穩定、官方維護最久的版本。下載 Node.js 時選綠色的 LTS 按鈕就對了。
如果內容對你有用就太好了
隨喜斗內
▸ 常見問題
Claude Code 安裝失敗最常見的原因是什麼?
9 成是環境問題:Node.js 沒裝或版本低於 18、npm 路徑沒進 PATH、PowerShell 執行原則擋住指令碼、或裝完沒重開終端機。真正安裝檔本身的問題很少見。照「node -v → npm -v → 執行原則 → 裝 → 重開終端機 → /doctor」的順序排查,10 分鐘內能定位。
npm 不是內部或外部命令怎麼辦?
代表終端機在 PATH(系統的程式尋找路徑清單)裡找不到 npm。三個解法照順序試:(1) 還沒裝 Node.js → 去 nodejs.org 裝 LTS 版,安裝時勾 Add to PATH (2) 剛裝完 → 關掉終端機重開,PATH 是開啟當下讀的 (3) 裝了也重開了還是沒有 → 重跑 Node 安裝檔選「修復」。
PowerShell 顯示「因為這個系統上已停用指令碼執行」怎麼解?
這是 Windows 的預設安全設定,不是壞掉。打 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned 然後按 Y,把執行原則放寬到「本機指令碼放行」,重開 PowerShell 再裝一次就過。-Scope CurrentUser 只影響你自己的帳號,不動系統全域設定。
裝完打 claude 卻說找不到命令?
最常見的卡點,解法最簡單:把終端機整個關掉、重新開啟、再打一次 claude。原因是 npm 全域安裝把程式放進的資料夾,要靠 PATH 讓終端機找到,而 PATH 是終端機開啟當下讀取的 — 舊視窗看不到新裝的東西。我自己第一次裝就在這卡了半小時,差點重灌。
公司電腦裝不了 Claude Code 怎麼辦?
安裝時滿屏 EACCES / EPERM 權限紅字、或執行原則改不動,大概率是 IT 政策鎖住了。不建議自己找方法繞過(可能違反公司資安規範),直接找 MIS 說明需求請他們開權限或代裝。真的不行,可以先用網頁版 Claude(免安裝)練「把需求講清楚」的基本功,回家再用自己的電腦跑 Claude Code。
看完這篇之前先確認:
- 照教學裝 Claude Code 卻在某一步卡住的人
- 打 npm 或 claude 出現「不是內部或外部命令」
- 裝完打 claude 卻沒反應 不知道哪裡壞
- 還沒開始裝 (先看 Windows 安裝那篇照順序走)
- Mac / Linux 用戶 (本篇以 Windows 為主)
- 裝好了但用起來卡 (那是額度或 context 問題,另有專文)
- 一報錯就重裝 — 9 成問題出在環境不在安裝檔
- 跳過「重開終端機」這步 — PATH 更新要重開才生效
- 在公司電腦硬裝 — 權限被 IT 鎖住,先問 MIS 別自己繞