Claude Code 安裝失敗？Windows 檢查 6 步
文 / Coolkid發布：2026-07-15 · 最後更新：2026-07-23閱讀約 9 分鐘
短答給趕時間的人：先講最快的路。2026 年官方推薦的裝法是 native 一行安裝(下載獨立程式、不靠 Node.js 那層環境;PowerShell 跑 irm https://claude.ai/install.ps1 | iex)，舊教學會遇到的問題大半直接繞過。照舊教學用 npm 裝到一半卡住的，與其繼續 debug，直接改走這條，快的話幾分鐘就結束。堅持排查 npm 裝法的，照這個順序：(1) node -v 有沒有 22 以上 (2) npm -v 打得出版本嗎 (3) PowerShell 有沒有擋指令碼 (4) 安裝指令跑完有沒有紅字 (5) 重開終端機再打 claude (6) 還不行就跑 claude doctor。每步 1-2 分鐘，10 分鐘內能定位問題在哪一層。
我自己第一次裝的時候在第 5 步卡了半小時。
裝明明成功了，打 claude 卻說找不到命令，差點以為要重灌。
後來才知道只是沒重開終端機。
這篇把我裝機加上後來幫別人排查累積的問題，整理成一個照順序走就好的排查表。
先試最短路徑：官方 native 一行安裝(2026 推薦裝法)
2026 年的官方文件已經把 native 安裝列為推薦裝法。
一行指令下載獨立程式，不用 Node.js、不用 npm，裝完還會自動更新。
下面 6 步排查裡，有 4 步在查 Node 跟 npm 環境，而 native 裝法根本沒有這幾層。
所以裝不起來的人先試這行，快的話幾分鐘就結束了：
irm https://claude.ai/install.ps1 | iex這裡有兩個地方要注意。
第一，要貼在 PowerShell 不是 CMD。
視窗提示字元開頭有 PS(像 PS C:\Users\你)才是 PowerShell，貼錯視窗會跳「irm 不是內部或外部命令」。
第二，裝完把終端機關掉重開，再打 claude --version 驗證。
這條走得通，下面 6 步都不用看。
走不通(通常是公司網路或權限鎖住)，或你就是要用 npm 裝法，再往下排查。
先看症狀：你卡在哪一步？
不同症狀對應不同原因，先對號入座再往下跳：
| 你看到的訊息 | 問題在哪 | 跳到 |
|---|---|---|
| irm 不是內部或外部命令 | 你開的是 CMD 不是 PowerShell | 第 0 節 |
| 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 的地基
npm 這條裝法，要靠 Node.js(一個讓 JavaScript 在你電腦上執行的環境)來安裝。
官方要求 22 以上版本(2026-07 查，以官方文件為準;native 裝法完全不用這層，見第 0 節)。先打這兩行確認地基：
node -v
npm -v兩行都要吐出版本號(例如 v22.x.x 跟 10.x.x)才算過。
常見的失敗有哪三種？
第一，完全沒裝，去 nodejs.org 下載 LTS(長期支援版)，安裝時記得勾 Add to PATH。
第二，版本低於 22，重裝 LTS 蓋過去。
第三，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 步。排查到心累，回第 0 節換 native 裝法，一行指令繞過整條 npm 安裝路線。
Claude Code 安裝失敗 9 成是環境問題，不是安裝檔問題。最快解法：改用 2026 官方推薦的 native 一行安裝(PowerShell 跑 irm https://claude.ai/install.ps1 | iex)，不經過 Node 與 npm，大半的雷直接繞過。要排查 npm 裝法照 6 步：(1) node -v 確認 22 以上 (2) npm -v 有版本號 (3) PowerShell 執行原則放寬到 RemoteSigned (4) EACCES 紅字用系統管理員重跑、公司電腦找 MIS (5) 裝完關掉終端機重開再打 claude，最多人卡在這步，PATH 要重開才更新 (6) 還不行打 /doctor 自我體檢，或把錯誤訊息貼給網頁版 Claude 問。每步 1-2 分鐘，10 分鐘內定位。裝好之後接「第一次用 AI 做網站」開始做東西。
名詞解釋
- native 安裝（原生安裝）
- 官方提供的獨立安裝方式：一行指令下載完整程式，不依賴 Node.js 這類其他環境，裝完會自動更新。2026 年官方文件的推薦裝法。
- Node.js
- 讓電腦能執行 JavaScript 程式的基礎環境。Claude Code 的 npm 舊裝法才需要先裝它；2026 年官方推薦的 native 一行安裝不用。免費，從官網 nodejs.org 下載安裝。
- npm
- 裝 Node.js 時附帶的套件管理工具，像程式界的 App Store — 一行指令就能安裝各種工具。Claude Code 的舊裝法用它裝；現在官方推薦改用 native 一行安裝。
- 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 沒裝或版本低於 22、npm 路徑沒進 PATH、PowerShell 執行原則擋住指令碼、或裝完沒重開終端機。真正安裝檔本身的問題很少見。照「node -v → npm -v → 執行原則 → 裝 → 重開終端機 → /doctor」的順序排查，10 分鐘內能定位。更快的路：改用官方 native 一行安裝(irm https://claude.ai/install.ps1 | iex)，不經過 Node/npm，這些雷大半直接消失。
不想排查了，有沒有最快讓 Claude Code 裝起來的方法？
有。2026 年官方推薦的 native 安裝法：打開 PowerShell(提示字元開頭是 PS 的那種視窗)，貼 irm https://claude.ai/install.ps1 | iex 按 Enter，裝完關掉終端機重開，打 claude --version 有版本號就完成。它下載的是獨立程式，不用 Node.js、不用 npm、還會自動更新，舊教學 6 步排查裡的 Node 與 npm 雷全都沒有。走不通通常只剩兩種原因：公司網路擋下載，或權限被 IT 鎖住。
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 問題，另有專文)