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

你可能同時接觸到：

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

結果就是：

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

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

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

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

方案 A：原生 Windows

使用：

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

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

方案 B：WSL

使用：

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

這個方案長期更像真正的 Linux 開發(fā)環(huán)境，但對完全新手來說，會多一層理解成本。

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

二、推薦的新手默認組合

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

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

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

三、先打開正確的終端：PowerShell

盡量不要一上來就在多個 shell 之間來回切換。

先打開：

• Windows Terminal
• PowerShell 標簽頁

檢查 PowerShell 版本：

$PSVersionTable.PSVersion

如果這一步正常，就用同一個 PowerShell 窗口完成后面的安裝和驗證。

四、檢查winget能不能用

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

winget --version

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

如果不行：

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

五、安裝 Git

先檢查：

git --version

如果沒有，就安裝：

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

安裝完成后，一定要關閉并重新打開 PowerShell。

再驗證：

git --version
where.exe git

為什么 Claude Code 新手必須盡快補上 Git？

因為后面所有真正有用的工作流都離不開它：

• 跟蹤改動
• 查看 diff
• 管理分支
• 撤銷修改
• 讓項目具備標準開發(fā)上下文

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

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 常見安裝方式依賴 npm，所以 Node.js/npm 要先通。

先檢查：

node --version
npm --version

如果沒有，就安裝 Node.js LTS：

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

安裝完成后，關閉 PowerShell，再打開一個新的。

再次檢查：

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

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

七、安裝 Claude Code

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

where.exe claude
claude --version

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

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

安裝后再驗證：

where.exe claude
claude --version

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

Windows 用戶最常見的報錯之一就是：

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

通常不是因為 Claude Code 沒裝上，而是因為：

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

第一步：看 npm 全局前綴

npm config get prefix

再看全局包：

npm list -g --depth=0

也可以查 PowerShell 是否能識別：

Get-Command claude -ErrorAction SilentlyContinue

第二步：先徹底重開終端

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

第三步：檢查 PATH

查看用戶級 PATH：

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

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

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

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

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

Windows 新手最容易混淆的一點是：當前會話變量和持久變量不是一回事。

當前 PowerShell 會話內臨時設置

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

這類變量只在當前窗口有效，關掉就沒了。

持久化到當前用戶環(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")

設置完后，關閉 PowerShell，再開一個新窗口驗證：

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

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

因為不同環(huán)境并不共享同一套會話狀態(tài)。

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

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

這一步非常重要，因為很多 Windows 新手在這里越裝越亂。

如果你是在 PowerShell 里裝的 Node 和 Claude Code，不要立刻切到 WSL 里測試，并假設一切都會自動同步。

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

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

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

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

wsl --status

如果還沒裝：

wsl --install

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

進入 Ubuntu 之后，要把它當成一臺 Linux 機器單獨配置：

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

不要以為 Windows 側裝好的 Node/npm 會自動覆蓋 WSL。

十二、如何確認你的 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)建一個測試目錄：

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í)行低風險操作。

十三、Windows 上最常見的 7 類問題和修法

1）claude不是內部或外部命令 / not recognized

原因：

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

處理：

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

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

原因：

• 你安裝前就打開了這個終端，PATH 沒更新

處理：

• 完整關閉終端
• 重新打開
• 用 where.exe git 驗證

3）Node 有了，但 npm 不正常

原因：

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

處理：

• 重新安裝 LTS 版本
• 必要時卸掉沖突舊版再裝
• 同時驗證 node --version 和 npm --version

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

原因：

• 只用了 $env:...，沒做持久化

處理：

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

5）PowerShell 能用，WSL 不能用；或者反過來

原因：

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

處理：

• 明確選一個主環(huán)境
• 在那個環(huán)境里把全部依賴補齊

6）公司網絡或代理導致 npm 安裝失敗

可能需要：

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

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

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

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

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

如果你的目標只有一個：盡快把 Claude Code 穩(wěn)定跑起來，那我建議：

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

這套方案最適合寫教程，也最適合給別人遠程排查。

FAQ

Q1：新手應該直接用 PowerShell 還是 WSL？

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

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

通常是 PATH 沒刷新、裝到了你當前 shell 不可見的位置，或者你在不同終端之間切來切去導致判斷混亂。

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

從實際工作流看，幾乎可以視為必須。沒有 Git，后面很多正常開發(fā)動作都會很別扭。

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

如果你希望重開終端后還有效，就應該設置成 用戶級持久環(huán)境變量，而不是只寫當前 PowerShell 會話。

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

能跑，但不適合新手拿它當?shù)谝画h(huán)境。因為它會多引入一層 shell 差異，排錯更復雜。

結語

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

只要你把順序固定下來：

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

以上就是Windows下Claude Code的安裝教程與常見問題全排查的詳細內容，更多關于Claude Code 安裝的資料請關注腳本之家其它相關文章！

最新評論