Claude Code 教學/第 11 篇・共 17 篇

Windows 安裝完全指南：從 PowerShell 到裝好 Git

系列第 2 篇欠 Windows 使用者的那份詳細教學來了。從「怎麼打開 PowerShell」開始，一步步裝好 Claude Code 和它需要的 Git，每個會卡住的地方都講清楚——終端機版和桌面版都適用。

第 2 篇教安裝時，Windows 的部分只給了一行指令，說「之後有機會另外寫一篇」——這篇就是來還債的。而且第 10 篇介紹的桌面版在 Windows 上也需要先裝 Git，所以不管你走哪條路，這篇都用得上。

照慣例，假設你完全沒碰過命令列。每一步都講清楚。

一、先認識 PowerShell：Windows 的「終端機」

Mac 叫終端機，Windows 上你要找的東西叫 PowerShell。

怎麼打開：按鍵盤的 Windows 鍵，直接打「powershell」，按 Enter。會跳出一個藍底（或黑底）的文字視窗。

重要：認清你開的是哪一個。 Windows 上有兩種長很像的文字視窗，貼錯地方指令會失敗：

看視窗裡每行開頭：有 PS 開頭（像 PS C:\Users\你的名字>）的是 PowerShell——我們要用這個。只有 C:\Users\你的名字>、沒有 PS 的是舊的「命令提示字元（CMD）」。如果你貼指令出現「irm 不是內部或外部命令」，就代表你開到 CMD 了，關掉重開 PowerShell。

二、安裝 Claude Code

把這行貼進 PowerShell、按 Enter（這是官方安裝指令，會自動保持更新）：

irm https://claude.ai/install.ps1 | iex

跑完之後，把 PowerShell 視窗整個關掉、重新開一個新的——這樣它才認得新裝好的 claude 指令。

驗證一下：

claude --version

有出現版本號就成功了。如果說「無法辨識」，先確認你有關掉重開；還是不行，看下一小節。

重開了還是說「無法辨識」：PATH 沒設好

這是 Windows 上最常見的一關。安裝跑完時，畫面上可能夾著一段黃色的 Setup notes：

Native installation exists but C:\Users\你的帳號名\.local\bin is not in your PATH.

看到這句話，代表安裝其實是成功的——claude.exe 已經好好躺在 C:\Users\你的帳號名\.local\bin 裡面，只是這個資料夾不在 PATH 名單裡。

PATH 可以想成 Windows 的「找程式清單」：你打 claude，系統不會翻遍整顆硬碟去找，只會去 PATH 列出的那幾個資料夾看一眼，沒有就回你「無法辨識 ‘claude’ 詞彙是否為 Cmdlet、函數、指令檔或可執行程式的名稱」。所以問題不是沒裝好，是系統不知道要去哪裡找它。

分兩步處理。先臨時測試，確認程式本身沒問題（這行只在目前這個視窗有效，關掉就失效）：

$env:Path += ";C:\Users\你的帳號名\.local\bin"
claude --version

版本號跑出來了，就接著永久設定：

$u = [Environment]::GetEnvironmentVariable("Path","User")
[Environment]::SetEnvironmentVariable("Path", "$u;C:\Users\你的帳號名\.local\bin", "User")

跑完一樣要把 PowerShell 關掉重開，新的 PATH 才算數。

為什麼不直接拿 $env:Path 來接？ 這裡特地先用 GetEnvironmentVariable("Path","User") 讀「使用者層」的 PATH 再接上新路徑。因為 $env:Path 是系統層加使用者層合併後的結果，直接把它整份寫回使用者層，等於把系統 PATH 複製一份到你的帳號底下——以後系統那份有任何變動，你這份舊複本還會留著，路徑重複、版本走樣的問題就是這樣來的。網路上很多教學會漏掉這一點。

不想打指令的話，圖形介面也行：Windows 鍵搜尋「環境變數」→ 編輯我的帳戶的環境變數 → 選 Path → 編輯 → 新增 → 貼上 C:\Users\你的帳號名\.local\bin → 一路確定 → 重開 PowerShell。效果完全一樣。

補充兩個替代安裝法，擇一即可，不用都做：習慣用 Windows 內建软件管理的可以用 winget install Anthropic.ClaudeCode（之後要自己 winget upgrade 更新）；被公司電腦權限卡住的話，官方指令不需要系統管理員身分，一般帳號就能裝。

三、裝 Git for Windows：那個「一定要裝」的配角

為什麼需要它

兩個原因，對應你可能走的兩條路：

  1. 終端機路線：沒有 Git，Claude Code 在 Windows 上只能用比較受限的方式執行指令；裝了 Git（它附帶一個叫 Git Bash 的環境），Claude Code 才有完整的指令能力。官方文件明確建議裝。
  2. 桌面版路線（第 10 篇）：桌面版的本機模式必須有 Git 才能開工——沒裝會直接被擋在輸入框外。

而且 Git 本身就是第 4 篇講的「存檔／回頭路」機制的基礎，遲早要裝，一次裝好兩條路通用。

安裝步驟

  1. 打開瀏覽器，到官方下載頁：git-scm.com/downloads/win（認明 git-scm.com 這個網域，跟第 2 篇防釣魚同一個原則）。
  2. 點「Click here to download」下載最新版安裝檔，下載完雙擊執行。
  3. 接下來安裝精靈會問你非常多頁的選項——別慌，這是它出名的地方。對你來說答案很簡單：

全部保持預設，一路按 Next，最後按 Install。 那些選項是給進階使用者微調的，預設值就是官方建議值，一個都不用改。

  1. 裝完把 PowerShell 關掉重開，驗證：
git --version

有版本號就完成了。

裝完之後 Claude Code 怎麼知道？

通常不用你做任何事——重開 PowerShell（或重啟桌面版 App）它就會自己找到 Git。萬一它抱怨找不到，把那句錯誤貼給 Claude Code，跟它說「幫我設定好」，它會幫你把路徑補上。

四、第一次啟動（跟 Mac 相同）

在 PowerShell 打 claude 按 Enter，走引導流程：選主題 → 登入方式選第一個（Claude 訂閱帳號） → 瀏覽器授權 → 信任資料夾。需要 Pro（每月 20 美元）以上訂閱——建議先用手機的 Claude App 訂（之後續訂、取消都在手機的訂閱設定統一管理，不會忘記在哪訂的），細節見第 2 篇。

想做個總體檢，可以跑：

claude doctor

它會檢查安裝狀態、更新狀況，有問題會直接告訴你。

這篇的可驗證小成果：claude --version 和 git --version 都有版本號、打 claude 能進到對話畫面——你的 Windows 就緒了。

五、常見卡關速查（Windows 特有的坑）

症狀 原因與解法
irm 不是內部或外部命令 你開到 CMD 了。認 PS 開頭，重開 PowerShell
The token '&&' is not a valid statement separator 反過來——你把 CMD 的指令貼進 PowerShell 了。用本篇給的 PowerShell 版指令
裝完打 claude 沒反應 沒關掉重開 PowerShell。整個視窗關掉、開新的
重開了，打 claude 還是「無法辨識 ‘claude’ 詞彙…」 安裝資料夾不在 PATH。照第二節〈重開了還是說「無法辨識」〉把 .local\bin 加進去
桌面版說需要 Git 照第三節裝 Git，裝完重啟桌面版 App
防毒軟體跳警告 從官方網域（claude.ai／git-scm.com）下載的安裝檔是安全的；公司電腦被 IT 政策擋住的話，得找 IT 開通

六、進階：WSL 是什麼？（可以跳過）

查資料時你會看到「WSL」這個詞——那是在 Windows 裡跑一個 Linux 環境的機制，工程師用它取得跟 Mac/Linux 一致的開發體驗，Claude Code 也支援裝在 WSL 裡（沙盒功能還只在 WSL 下才有）。一般使用者不需要：本篇的原生安裝已經完全夠用。哪天你真的需要，到時候直接叫 Claude Code 帶你搬過去就行。

到這裡，Windows 使用者就跟上大部隊了：回到第 2 篇的「第一句話」繼續，或走第 10 篇的桌面版路線。系列其他篇的內容（CLAUDE.md、Skills、MCP、hooks）在 Windows 上全部通用。

本文參考素材

回教學列表