用 PowerShell 安裝 Claude Code：從 Git、PATH 到 WSL 一次排好（Windows 實測）

如果你在 Windows 上裝過命令列工具，應該知道最麻煩的通常不是「安裝」，而是：

• 安裝看起來成功了，但命令不能用
• Git 明明裝了，PowerShell 卻抓不到
• npm 全域安裝完成，但 claude 還是不存在
• 環境變數在這個視窗有，重開就沒了
• PowerShell、Git Bash、WSL 三套環境混在一起，越修越亂

Claude Code 也是一樣。

所以這篇不只講安裝指令，而是用 Windows 新手最常見的實際流程，把整條環境一次排好。目標很簡單：

用 PowerShell 把 Claude Code 裝起來，並且真的能用。

先講結論：Windows 最穩的做法

如果你只是想先把 Claude Code 跑起來，我建議直接用這套：

• Windows Terminal
• PowerShell
• winget
• Git for Windows
• Node.js LTS
• npm 全域安裝 Claude Code
• 使用者層級環境變數

先不要一開始就混用：

• cmd
• Git Bash
• WSL

不是它們不能用，而是對新手來說，會多出很多不必要的排錯變數。

Step 1：先確認你在 PowerShell，不是在別的殼裡

打開 Windows Terminal，選 PowerShell。

先檢查一下：

$PSVersionTable.PSVersion

只要能正常顯示版本，就表示目前 PowerShell 可用。

為什麼這一步很重要？

因為很多人其實是在 A 環境安裝，去 B 環境測試。

例如：

• 在 PowerShell 安裝 Node
• 去 Git Bash 測 claude
• 在 Windows 裡設環境變數
• 去 WSL 裡找不到

這種情況下，你會以為是 Claude Code 壞了，其實只是你進了不同的環境。

Step 2：先把 Git 裝好

很多 CLI 工具就算能在沒有 Git 的情況下啟動，真正開始用的時候還是會卡。

先檢查 Git：

git --version

如果沒有，直接裝：

winget install --id Git.Git -e --source winget

安裝完成後，關掉 PowerShell，再重開一個新視窗。

然後再驗證：

git --version
where.exe git

如果這兩個命令都正常，就代表 Git 這一層通了。

順手初始化一個測試資料夾

mkdir $HOME\Projects\claude-code-test -Force
cd $HOME\Projects\claude-code-test
git init

這樣你後面測 Claude Code，不會卡在「這裡根本不是一個正常專案目錄」。

Step 3：安裝 Node.js 和 npm

Claude Code 常見安裝方式會用到 npm，所以 Node.js 先正常最重要。

先檢查：

node --version
npm --version

如果沒有，就裝 LTS：

winget install --id OpenJS.NodeJS.LTS -e --source winget

裝完之後，再關一次 PowerShell，重新開新視窗。

然後檢查：

node --version
npm --version
where.exe node
where.exe npm

這裡最常見的坑

1. node 有版本，npm 沒反應
2. 系統裡有舊版 Node，路徑打架
3. 剛裝完沒重開 PowerShell，所以抓到的是舊 PATH

如果發生這種情況，先不要急著重裝 Claude Code，先把 Node/npm 這層確認穩定。

Step 4：安裝 Claude Code

現在再來裝 Claude Code。

先看看有沒有裝過：

where.exe claude
claude --version

如果沒有，就安裝：

npm install -g @anthropic-ai/claude-code

然後驗證：

where.exe claude
claude --version

如果順利，你應該能看到 Claude Code 的版本號。

Step 5：如果 claude 找不到，優先排 PATH，不要先怪工具

Windows 上最常見的情況是：

• 安裝沒報錯
• 但 PowerShell 說 claude 不存在

例如：

claude : The term 'claude' is not recognized as the name of a cmdlet, function, script file, or operable program.

這種情況 大概率不是工具沒裝上，而是 PATH 沒更新，或你目前這個終端沒讀到 npm 的全域可執行目錄。

先查 npm 的 prefix：

npm config get prefix

再查全域安裝包：

npm list -g --depth=0

還可以讓 PowerShell 直接查：

Get-Command claude -ErrorAction SilentlyContinue

我的排錯順序建議

先照這個順序來，不要亂跳：

1. 完整關閉 PowerShell，再重開
2. where.exe claude
3. npm config get prefix
4. npm list -g --depth=0
5. 檢查 PATH

查看使用者 PATH：

[Environment]::GetEnvironmentVariable("Path", "User")

查看系統 PATH：

[Environment]::GetEnvironmentVariable("Path", "Machine")

如果 npm 全域可執行位置不在 PATH，就補進去。

Step 6：環境變數要分清楚「暫時」和「永久」

很多人會這樣設：

$env:ANTHROPIC_API_KEY = "your_key_here"

這當然可以，但它只在目前這個 PowerShell 視窗有效。你關掉視窗就沒了。

如果你希望重開之後還在，應該設成使用者層級環境變數：

[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "your_key_here", "User")
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "your_key_here", "User")
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://crazyrouter.com/v1", "User")

然後關掉 PowerShell，再開新視窗驗證：

echo $env:ANTHROPIC_API_KEY
echo $env:OPENAI_API_KEY
echo $env:OPENAI_BASE_URL

這一步的典型錯誤

• 在 PowerShell 暫時設了變數，結果去新視窗找不到
• 在 Windows 側設了變數，跑去 WSL 裡找
• 在 Git Bash 裡測，結果行為和 PowerShell 不同

所以重點只有一個：

先選定一個主環境，再在那個環境裡把變數配完整。

Step 7：WSL 到底要不要用？

我的建議很簡單：

如果你是新手

先不要。

先把 PowerShell 版跑通，因為這樣最容易發現問題到底出在哪一層。

如果你平常本來就用 Linux 工作流

那 WSL 很適合你。

但你要記住：

• WSL 不是 PowerShell 的延伸
• WSL 裡的 Git、Node、npm、Claude Code 都要重新安裝/確認
• WSL 裡的環境變數要設在 Linux shell 裡

也就是說：

Windows 裝好，不等於 WSL 也裝好。

Step 8：一組完整的健康檢查指令

如果你想一次確認整條鏈是不是通了，可以跑這組：

git --version
node --version
npm --version
claude --version
where.exe git
where.exe node
where.exe npm
where.exe claude

然後再確認當前專案目錄：

cd $HOME\Projects\claude-code-test
git status

如果這些都正常，代表你的環境已經不是「裝了但不能用」，而是接近可正式工作的狀態。

最常見的 5 個 Windows 安裝問題

1. claude 指令不存在

先不要重灌，先查：

• PowerShell 有沒有重開
• PATH 有沒有更新
• npm prefix 在哪裡
• 全域安裝包是否真的存在

2. Git 已經安裝，但還是找不到

通常只是因為你在安裝前開了 PowerShell，PATH 沒刷新。

解法：重開終端。

3. Node 有，npm 不正常

通常是安裝不完整或舊版衝突。

解法：先把 Node/npm 層修乾淨，再碰 Claude Code。

4. 環境變數在這個視窗有，下個視窗沒有

你只是設了會話變數，沒設永久變數。

5. PowerShell 可以，WSL 不行；或 WSL 可以，PowerShell 不行

因為你其實在兩個不同世界裡。

實務上我會怎麼建議團隊新人？

如果要把這件事寫成團隊 SOP，我會要求新手照這個順序做：

1. 開 Windows Terminal + PowerShell
2. 安裝 Git
3. 安裝 Node.js LTS
4. 驗證 npm 正常
5. 安裝 Claude Code
6. 修 PATH
7. 設定使用者層級環境變數
8. 在 Git repo 中做第一次低風險測試

這樣排錯成本最低，也最容易遠端支援。

FAQ

Q1：Windows 新手應該直接用 WSL 嗎？

如果你已經熟悉 Linux，可以。否則先用 PowerShell，成功率更高。

Q2：為什麼 npm 顯示安裝成功，但 claude 不能用？

通常是 PATH 沒更新，或目前終端抓到的是舊環境。

Q3：一定要先裝 Git 嗎？

從實務角度看，幾乎是要的。因為沒有 Git，後面很多正常開發動作都會變很痛苦。

Q4：Git Bash 適不適合拿來跑 Claude Code？

可以，但不建議新手把它當第一環境，因為會增加 shell 差異。

Q5：如果公司網路擋住 npm 安裝怎麼辦？

先檢查代理設定與公司安全政策，再看是不是需要設定 npm proxy。

結語

Windows 上安裝 Claude Code，真正的問題通常不在那一條安裝命令，而在整條環境鏈有沒有對齊。

如果你照這篇的順序做：

• PowerShell
• Git
• Node/npm
• Claude Code
• PATH
• 環境變數
• Git repo 驗證

通常都能比「想到哪修到哪」快很多，也更不容易越修越亂。