如果說(shuō) Mac 上安裝 Claude Code 的難點(diǎn)在 PATH 和 shell 配置，那么 Windows 上的難點(diǎn)通常是：環(huán)境太多，路徑太多，入口太多。

你可能同時(shí)接觸到：

• PowerShell
• Windows Terminal
• 命令提示符（cmd）
• Git Bash
• WSL
• winget
• 手動(dòng)安裝版 Node.js
• 手動(dòng)安裝版 Git

結(jié)果就是：

• 你在一個(gè)終端里能運(yùn)行 claude
• 換一個(gè)終端就不行了
• 變量在 PowerShell 里有，在 WSL 里沒(méi)有
• Git 裝好了，但 PATH 沒(méi)刷新
• npm 全局安裝成功了，但系統(tǒng)說(shuō)命令不存在

所以 Windows 版最重要的不是快，而是先統(tǒng)一環(huán)境，再安裝，再驗(yàn)證。

一、先決定你走哪條路：原生 Windows 還是 WSL？

這是第一步，否則后面很容易越裝越亂。

方案 A：原生 Windows

使用：

• Windows Terminal
• PowerShell
• Git for Windows
• Node.js for Windows
• npm 全局安裝 Claude Code

這個(gè)方案最適合大多數(shù)新手。

方案 B：WSL

使用：

• WSL2
• Ubuntu / Debian
• 在 Linux 子系統(tǒng)里安裝 Git、Node、Claude Code

這個(gè)方案長(zhǎng)期更像真正的 Linux 開(kāi)發(fā)環(huán)境，但對(duì)完全新手來(lái)說(shuō)，會(huì)多一層理解成本。

如果你是第一次裝，我建議先走原生 Windows + PowerShell。

二、推薦的新手默認(rèn)組合

最穩(wěn)妥的組合是：

• Windows 10/11 最新更新
• Windows Terminal
• PowerShell
• winget
• Git for Windows
• Node.js LTS
• Claude Code via npm

這套方案最無(wú)聊，也最穩(wěn)定。

三、先打開(kāi)正確的終端：PowerShell

盡量不要一上來(lái)就在多個(gè) shell 之間來(lái)回切換。

先打開(kāi)：

• Windows Terminal
• PowerShell 標(biāo)簽頁(yè)

檢查 PowerShell 版本：

$PSVersionTable.PSVersion

如果這一步正常，就用同一個(gè) PowerShell 窗口完成后面的安裝和驗(yàn)證。

四、檢查winget能不能用

現(xiàn)代 Windows 上，用 winget 裝 Git 和 Node 最省心。

winget --version

如果命令正常，說(shuō)明你可以直接用系統(tǒng)包管理方式安裝。

如果不行：

• 更新 Microsoft Store 里的 App Installer
• 或者改走手動(dòng)下載安裝包

五、安裝 Git

先檢查：

git --version

如果沒(méi)有，就安裝：

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

安裝完成后，一定要關(guān)閉并重新打開(kāi) PowerShell。

再驗(yàn)證：

git --version
where.exe git

為什么 Claude Code 新手必須盡快補(bǔ)上 Git？

因?yàn)楹竺嫠姓嬲杏玫墓ぷ髁鞫茧x不開(kāi)它：

• 跟蹤改動(dòng)
• 查看 diff
• 管理分支
• 撤銷(xiāo)修改
• 讓項(xiàng)目具備標(biāo)準(zhǔn)開(kāi)發(fā)上下文

如果你現(xiàn)在只是一個(gè)空文件夾，建議順手初始化倉(cāng)庫(kù)：

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

再配置一下身份：

git config --global user.name "你的名字"
git config --global user.email "you@example.com"

六、安裝 Node.js 和 npm

Claude Code 常見(jiàn)安裝方式依賴(lài) npm，所以 Node.js/npm 要先通。

先檢查：

node --version
npm --version

如果沒(méi)有，就安裝 Node.js LTS：

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

安裝完成后，關(guān)閉 PowerShell，再打開(kāi)一個(gè)新的。

再次檢查：

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

如果 node 能運(yùn)行但 npm 不正常，說(shuō)明安裝可能不完整，或者系統(tǒng)里有舊版 Node 沖突。

七、安裝 Claude Code

先看系統(tǒng)是否已經(jīng)安裝過(guò)：

where.exe claude
claude --version

如果沒(méi)有，再執(zhí)行：

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

安裝后再驗(yàn)證：

where.exe claude
claude --version

八、為什么 Windows 上最容易出現(xiàn)“安裝成功但命令不存在”？

Windows 用戶(hù)最常見(jiàn)的報(bào)錯(cuò)之一就是：

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

通常不是因?yàn)?Claude Code 沒(méi)裝上，而是因?yàn)椋?/p>

• npm 全局安裝目錄沒(méi)進(jìn) PATH
• 安裝后當(dāng)前 PowerShell 沒(méi)刷新
• 你在一個(gè) shell 里裝，去另一個(gè) shell 里測(cè)
• 系統(tǒng)有多個(gè) Node/npm 版本互相沖突

第一步：看 npm 全局前綴

npm config get prefix

再看全局包：

npm list -g --depth=0

也可以查 PowerShell 是否能識(shí)別：

Get-Command claude -ErrorAction SilentlyContinue

第二步：先徹底重開(kāi)終端

很多 PATH 問(wèn)題其實(shí)不是配置錯(cuò)了，而是 shell 還在用舊環(huán)境。

第三步：檢查 PATH

查看用戶(hù)級(jí) PATH：

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

查看系統(tǒng)級(jí) PATH：

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

如果 npm 全局可執(zhí)行文件所在目錄不在 PATH 里，就要補(bǔ)進(jìn)去。

九、環(huán)境變量到底該怎么在 Windows 上配？

Windows 新手最容易混淆的一點(diǎn)是：當(dāng)前會(huì)話變量和持久變量不是一回事。

當(dāng)前 PowerShell 會(huì)話內(nèi)臨時(shí)設(shè)置

$env:ANTHROPIC_API_KEY = "your_key_here"
$env:OPENAI_API_KEY = "your_crazyrouter_key"
$env:OPENAI_BASE_URL = "https://crazyrouter.com/v1"

這類(lèi)變量只在當(dāng)前窗口有效，關(guān)掉就沒(méi)了。

持久化到當(dāng)前用戶(hù)環(huán)境變量

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

設(shè)置完后，關(guān)閉 PowerShell，再開(kāi)一個(gè)新窗口驗(yàn)證：

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

為什么我在 PowerShell 能看到變量，在別的終端里看不到？

因?yàn)椴煌h(huán)境并不共享同一套會(huì)話狀態(tài)。

• PowerShell 會(huì)話變量 ≠ cmd 會(huì)話變量
• Windows 原生環(huán)境變量 ≠ WSL 內(nèi)部 shell 變量
• Git Bash 也有自己的一層 shell 行為

十、PowerShell、cmd、Git Bash、WSL 到底有什么區(qū)別？

這一步非常重要，因?yàn)楹芏?Windows 新手在這里越裝越亂。

如果你是在 PowerShell 里裝的 Node 和 Claude Code，不要立刻切到 WSL 里測(cè)試，并假設(shè)一切都會(huì)自動(dòng)同步。

WSL 是另一套環(huán)境：

• 另一套 PATH
• 另一套包管理器
• 另一套 shell 配置文件
• 另一套環(huán)境變量

十一、如果你想走 WSL，正確姿勢(shì)是什么？

先檢查 WSL 狀態(tài)：

wsl --status

如果還沒(méi)裝：

wsl --install

然后按系統(tǒng)提示重啟。

進(jìn)入 Ubuntu 之后，要把它當(dāng)成一臺(tái) Linux 機(jī)器單獨(dú)配置：

• 在 WSL 里安裝 Git
• 在 WSL 里安裝 Node
• 在 WSL 里安裝 Claude Code
• 在 WSL 的 ~/.bashrc / ~/.zshrc 里設(shè)置環(huán)境變量

不要以為 Windows 側(cè)裝好的 Node/npm 會(huì)自動(dòng)覆蓋 WSL。

十二、如何確認(rèn)你的 Windows 環(huán)境真的打通了？

建議至少執(zhí)行下面這一組檢查：

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

然后再創(chuàng)建一個(gè)測(cè)試目錄：

mkdir $HOME\Projects\claude-code-test -Force
cd $HOME\Projects\claude-code-test
if (-not (Test-Path .git)) { git init }
"# test" | Out-File README.md -Encoding utf8

之后再讓 Claude Code 執(zhí)行低風(fēng)險(xiǎn)操作。

十三、Windows 上最常見(jiàn)的 7 類(lèi)問(wèn)題和修法

1）claude不是內(nèi)部或外部命令 / not recognized

原因：

• npm 全局可執(zhí)行目錄沒(méi)進(jìn) PATH
• 終端沒(méi)刷新
• 安裝沒(méi)真正完成

處理：

• 重新打開(kāi) PowerShell
• 檢查 npm config get prefix
• 檢查 npm list -g --depth=0
• 檢查 Get-Command claude

2）Git 裝好了，但 PowerShell 還是找不到

原因：

• 你安裝前就打開(kāi)了這個(gè)終端，PATH 沒(méi)更新

處理：

• 完整關(guān)閉終端
• 重新打開(kāi)
• 用 where.exe git 驗(yàn)證

3）Node 有了，但 npm 不正常

原因：

• 安裝不完整
• 系統(tǒng)里存在沖突版本

處理：

• 重新安裝 LTS 版本
• 必要時(shí)卸掉沖突舊版再裝
• 同時(shí)驗(yàn)證 node --version 和 npm --version

4）環(huán)境變量只在當(dāng)前窗口有效

原因：

• 只用了 $env:...，沒(méi)做持久化

處理：

• 用 [Environment]::SetEnvironmentVariable(..., "User")
• 然后重開(kāi)終端

5）PowerShell 能用，WSL 不能用；或者反過(guò)來(lái)

原因：

• 你其實(shí)在維護(hù)兩套完全不同的環(huán)境

處理：

• 明確選一個(gè)主環(huán)境
• 在那個(gè)環(huán)境里把全部依賴(lài)補(bǔ)齊

6）公司網(wǎng)絡(luò)或代理導(dǎo)致 npm 安裝失敗

可能需要：

npm config set proxy http://proxy.example.com:8080
npm config set https-proxy http://proxy.example.com:8080

7）安全軟件攔截 CLI 或腳本

如果日志看起來(lái)正常，但命令行為不正常，要檢查：

• Windows Security
• 殺毒軟件
• 企業(yè)安全終端
• 是否把剛安裝的可執(zhí)行文件隔離了

十四、給新手的 Windows 最穩(wěn)妥方案

如果你的目標(biāo)只有一個(gè)：盡快把 Claude Code 穩(wěn)定跑起來(lái)，那我建議：

• Windows Terminal
• PowerShell
• winget
• Git for Windows
• Node.js LTS
• npm 全局安裝 Claude Code
• 用戶(hù)級(jí)持久環(huán)境變量

這套方案最適合寫(xiě)教程，也最適合給別人遠(yuǎn)程排查。

FAQ

Q1：新手應(yīng)該直接用 PowerShell 還是 WSL？

如果你是第一次配，先用 PowerShell。你已經(jīng)熟悉 Linux 開(kāi)發(fā)環(huán)境，再考慮 WSL。

Q2：為什么明明 npm 顯示安裝成功，claude還是不能用？

通常是 PATH 沒(méi)刷新、裝到了你當(dāng)前 shell 不可見(jiàn)的位置，或者你在不同終端之間切來(lái)切去導(dǎo)致判斷混亂。

Q3：Windows 上一定要先裝 Git 嗎？

從實(shí)際工作流看，幾乎可以視為必須。沒(méi)有 Git，后面很多正常開(kāi)發(fā)動(dòng)作都會(huì)很別扭。

Q4：環(huán)境變量應(yīng)該存在哪里？

如果你希望重開(kāi)終端后還有效，就應(yīng)該設(shè)置成 用戶(hù)級(jí)持久環(huán)境變量，而不是只寫(xiě)當(dāng)前 PowerShell 會(huì)話。

Q5：Git Bash 適不適合跑 Claude Code？

能跑，但不適合新手拿它當(dāng)?shù)谝画h(huán)境。因?yàn)樗鼤?huì)多引入一層 shell 差異，排錯(cuò)更復(fù)雜。

結(jié)語(yǔ)

Windows 上安裝 Claude Code 不難，難的是你可能不知不覺(jué)同時(shí)踩進(jìn)了兩三套環(huán)境里。

只要你把順序固定下來(lái)：

1. Windows Terminal
2. PowerShell
3. winget
4. Git
5. Node/npm
6. Claude Code
7. PATH
8. 環(huán)境變量
9. Git 倉(cāng)庫(kù)驗(yàn)證

以上就是Windows下Claude Code的安裝教程與常見(jiàn)問(wèn)題全排查的詳細(xì)內(nèi)容，更多關(guān)于Claude Code 安裝的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論