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

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

有出現版本號就成功了。如果說「無法辨識」，先確認你有關掉重開；還不行，把錯誤訊息整段複製，等下裝好之後貼給 Claude 問（對，它可以幫你修它自己的安裝問題）。

補充兩個替代安裝法，擇一即可，不用都做：習慣用 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。整個視窗關掉、開新的
桌面版說需要 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 上全部通用。

本文參考素材

回教學列表