如何在 Windows 上安裝 Claude Code 和 Codex CLI
在 Windows 10 和 11 上安裝 Claude Code、安裝 Codex CLI 的確切 PowerShell、CMD、WinGet 和 npm 命令,什麼時候該選 WSL,以及如何修復「'claude' 不是內部或外部命令」等你會遇到的錯誤。
如今兩個 CLI 在 Windows 上都只需一行命令就能裝好。麻煩大多出在這之後:終端找不到命令,執行策略攔下 npm,舊的 WSL 1 發行版,命令粘錯了 shell。本文給出每種安裝方式的確切命令,再列出常見錯誤和解決辦法。
關於兩個 CLI 的資訊來自 Anthropic 和 OpenAI 的文件以及安裝腳本本身,查閱於 2026 年 11 月 16 日,版本為 Claude Code 2.1.318 和 Codex CLI 0.169.0。兩者更新都很快:如果下面的命令失敗,請檢視各節連結的官方頁面。
簡短回答。 開啟 PowerShell(不是 CMD),執行:
irm https://claude.ai/install.ps1 | iex
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
然後開啟新終端,執行 claude --version 和 codex --version。如果 Windows 提示無法識別 claude,PATH 的修復方法在下文的錯誤表中。
兩個 CLI 在 Windows 上的要求
| Claude Code | Codex CLI | |
|---|---|---|
| Windows 版本 | Windows 10 1809 或更高,Windows Server 2019 或更高 | 推薦 Windows 11,較新的 Windows 10 為「盡力支援」 |
| 處理器 | x64 或 ARM64,不支援 32 位 | x64 或 ARM64 |
| 帳號 | 付費 Claude 套餐或 Console 帳號 | ChatGPT 套餐或 OpenAI API 金鑰 |
| Node.js | 僅 npm 方式需要,22 或更高 | 僅 npm 方式需要 |
| Git for Windows | 可選 | 不需要 |
| 原生 Windows 沙箱 | 無,僅在 WSL 2 中 | 有,自帶 Windows 沙箱 |
| 安裝需管理員權限 | 否 | 否 |
表中有兩行常讓人意外。Claude Code 不再需要 Git for Windows:沒有它就用 PowerShell 作為 shell 工具。而 Codex 在原生 Windows 上也會把命令放進沙箱,Claude Code 則只在 WSL 2 中這樣做。
在 Windows 上安裝 Claude Code
Anthropic 的安裝頁面列出了四種方式。推薦原生安裝程式:不需要 Node.js,並在後台自動更新。
| 方式 | 命令 |
|---|---|
| PowerShell(推薦) | irm https://claude.ai/install.ps1 | iex |
| CMD | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd |
| WinGet | winget install Anthropic.ClaudeCode |
| npm(Node.js 22+) | npm install -g @anthropic-ai/claude-code@latest |
每種方式裝完後的情況:
- 原生安裝程式:
claude.exe在%USERPROFILE%\.local\bin,各版本在%USERPROFILE%\.local\share\claude。.local\bin不在 PATH 中時安裝程式會提醒你,但不會替你新增。 - WinGet:沒有自動更新。用
winget upgrade Anthropic.ClaudeCode更新;Anthropic 提醒,Claude Code 執行時更新可能失敗,因為 Windows 會鎖定可執行檔案。 - npm:Node.js 低於 22 時,安裝最後會出現
EBADENGINE警告。
想比最新版晚一個版本,用 stable 通道:
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable
然後檢查安裝。claude --version 列印版本號,claude doctor 以唯讀方式診斷安裝和設定。
如果裝了 Git for Windows,Claude Code 會依次在 C:\Program Files\Git、C:\Program Files (x86)\Git 和 PATH 中的 git 處查詢 Git Bash。要強制用另一個,在 settings.json 的 env 塊中設定 CLAUDE_CODE_GIT_BASH_PATH。它必須指向名為 bash.exe 或 sh.exe 的檔案,而不是 git-bash.exe。
在 Windows 上安裝 Codex CLI
OpenAI 的 Windows 頁面說得很清楚:預設原生使用 Codex 及其 Windows 沙箱,工具鏈已經在 Linux 裡時再選 WSL。有一處來源過時了:GitHub 儲存庫的安裝頁面仍寫著「Windows 11 via WSL2」。官方文件已經更新,安裝程式也一樣。
| 方式 | 命令 |
|---|---|
| PowerShell 安裝程式 | powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" |
| npm | npm install -g @openai/codex |
PowerShell 安裝程式最省事。讀一下腳本就知道它做了什麼:把 Codex 裝到 %LOCALAPPDATA%\Programs\OpenAI\Codex\bin,把該資料夾加入使用者 PATH 和當前會話,並提示你開啟新的 PowerShell 視窗。再次執行同一命令即可更新 Codex。用 npm 的話,重新執行安裝命令即可更新。
接著登入。執行 codex 並選擇 Sign in with ChatGPT,或執行 codex login。在沒有瀏覽器的機器上,codex login --device-auth 會給你一個程式碼,在另一台裝置上輸入。codex login status 顯示你當前登入的帳號。
Windows 沙箱
Codex 在 Windows 上有三種沙箱實現:
mxc:推薦方案,無需管理員設定。需要 Windows 11 24H2(內部版本 26100.9278)或 25H2(內部版本 26200.9278)。elevated:首選的後備方案。需要管理員批准一次性設定。unelevated:網路隔離較弱,也沒有唯讀路徑。
在 config.toml 中選擇:
[features]
prefer_mxc = true
[windows]
sandbox = "elevated" # or "unelevated"
如果沙箱報錯 1385,說明 Windows 拒絕了沙箱帳號的登入型別。此時 OpenAI 會要你提供 CODEX_HOME/.sandbox/sandbox.log。切勿分享 .sandbox-secrets/ 裡的內容。
原生 Windows 還是 WSL?
| 原生(PowerShell、CMD) | WSL 2 | |
|---|---|---|
| 安裝 Claude Code | irm https://claude.ai/install.ps1 | iex | 在 WSL 中執行 curl -fsSL https://claude.ai/install.sh | bash |
| 安裝 Codex | PowerShell 安裝程式 | 在 WSL 中執行 curl -fsSL https://chatgpt.com/codex/install.sh | sh |
| Claude Code 沙箱 | 不可用 | 可用,需 bubblewrap 和 socat |
| Codex 沙箱 | Windows 沙箱 | Linux 沙箱 |
| 儲存庫放在哪裡 | 任意位置 | 放在 ~/ 下,不要放在 /mnt/c/ 下 |
如果專案本來就在 Linux 中建置和執行,或者你希望 Claude Code 把它執行的命令放進沙箱,就選 WSL 2。如果是 Windows 專案(.NET、PowerShell 腳本、到處是 Windows 路徑),就留在原生環境。
走 WSL 路線的三條規則:
- 用 WSL 2,別用 WSL 1。 Codex 從 0.115 版起不再支援 WSL 1。Claude Code 的沙箱會以
Sandboxing requires WSL2拒絕 WSL 1,在 WSL 1 上安裝也可能報Exec format error。用wsl --set-version <DistroName> 2轉換發行版。 - 在 WSL 內安裝和執行。 Linux 命令要在 WSL 終端裡執行,不是在 PowerShell 裡。從 WSL 呼叫 Windows 的 Node.js 就會出現
exec: node: not found:請用發行版的套件管理器或 nvm 在發行版內安裝 Node.js。 - 程式碼放在 Linux 檔案系統中。 兩家廠商都建議把儲存庫放在
/mnt/c/之外,Anthropic 還指出 Claude Code 在那裡的搜尋不夠完整。把儲存庫克隆到 Linux 主目錄下。
「claude 無法識別」及其他錯誤
| 你看到的 | 原因 | 解決辦法 |
|---|---|---|
'claude' is not recognized as an internal or external command(CMD),The term 'claude' is not recognized(PowerShell) | %USERPROFILE%\.local\bin 不在 PATH 中 | 加入使用者 PATH(命令見下),再開啟新終端 |
| 新增後仍無法識別 | 終端或包含它的編輯器在修改之前就已啟動 | 重開終端,終端在編輯器裡的話編輯器也要重開 |
| 剛更新完就無法識別 | 更新在替換中途被打斷,沒留下 claude.exe | 把最新的 claude.exe.old.* 改回 claude.exe(命令見下) |
'irm' is not recognized | 把 PowerShell 命令粘到了 CMD 裡 | 開啟 PowerShell,或改用 CMD 那一行 |
The token '&&' is not a valid statement separator | 把 CMD 命令粘到了 Windows PowerShell 裡 | 改用 PowerShell 那一行 |
npm.ps1 cannot be loaded because running scripts is disabled on this system | 執行策略攔截了 npm 的 PowerShell 包裝腳本 | Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser,或呼叫 npm.cmd |
| 64 位電腦上出現關於 32 位 Windows 的錯誤 | 你從開始選單開啟了「Windows PowerShell (x86)」 | 開啟普通的 64 位 PowerShell |
claude 開啟的是桌面應用而不是 CLI | 舊版 Claude 桌面應用在 WindowsApps 中放了 Claude.exe,在 PATH 中排在 CLI 前面 | 更新 Claude 桌面應用 |
requires either Git for Windows (for bash) or PowerShell | Claude Code 兩種 shell 都沒找到 | 安裝 Git for Windows,或確認 PowerShell 在 PATH 中 |
npm install 時出現 EBADENGINE | Node.js 低於 22 | 升級 Node.js,或改用原生安裝程式 |
在 PowerShell 中為當前使用者修復 PATH,無需管理員權限:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
改動之前,先看看 Windows 在哪裡查詢:
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
where.exe claude
更新中斷後的改名命令:
Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe
關於執行策略:Windows 自帶的 Windows PowerShell 5.1 在客戶端電腦上預設是 Restricted,所以新筆記本會攔截 npm.ps1。CurrentUser 範圍不需要管理員權限。Claude 原生安裝程式和 Codex 安裝程式不受影響:irm | iex 和 -ExecutionPolicy ByPass 從不從磁碟載入腳本檔案。
更新與解除安裝
| Claude Code | Codex CLI | |
|---|---|---|
| 立即更新 | claude update(原生),winget upgrade Anthropic.ClaudeCode,或重新執行 npm 安裝 | 在支援的版本上用 codex update,重新執行 PowerShell 安裝程式,或 npm install -g @openai/codex |
| 自動更新 | 僅原生安裝,用 DISABLE_AUTOUPDATER=1 關閉 | 文件未說明 |
| 解除安裝 | 刪除 %USERPROFILE%\.local\bin\claude.exe 和 %USERPROFILE%\.local\share\claude,或 winget uninstall Anthropic.ClaudeCode,或 npm uninstall -g @anthropic-ai/claude-code | 刪除安裝資料夾,或 npm uninstall -g @openai/codex |
| 殘留的設定 | %USERPROFILE%\.claude 和 %USERPROFILE%\.claude.json | %USERPROFILE%\.codex |
在 Windows 上執行代理 CLI 學到的事
AgentsRoom 會並排啟動 Claude Code、Codex 和其他代理 CLI,它的 Windows 版讓我們看清了這些安裝離開終端後會在哪裡出問題。就算你從不用我們的應用,這四點也值得知道。
從開始選單啟動的程式會一直用啟動時的 PATH。 你裝好 Claude Code,把 .local\bin 加進 PATH,已經開啟的桌面應用還是找不到 claude。對於替你啟動 CLI 的應用,重啟終端不夠。AgentsRoom 查詢 CLI 時會從登錄檔重新讀取使用者和系統的 PATH,所以剛裝好的 CLI 不會被報告為缺失。
npm 不會安裝 .exe。 npm install -g @openai/codex 在 %APPDATA%\npm 中寫入三個檔案:codex、codex.cmd 和 codex.ps1。直接啟動 codex 的程式會得到 spawn codex ENOENT,因為 Windows 只會給裸名稱補上 .exe。終端會掩蓋這一點,因為 PowerShell 和 CMD 會讀取 PATHEXT。這又是一個優先用原生安裝程式的理由,它們確實提供可執行檔案。
npm 包裝腳本執行時需要 Node.js。 如果在同一會話裡先裝 Node.js 再裝 CLI,在 Node.js 進入 PATH 之前啟動的程式能找到 .cmd 包裝腳本,卻會因「node is not recognized」而失敗。Node 版本管理器的包裝腳本指向未啟用的版本時,症狀相同。
Windows 上啟動程序的開銷大得多。 我們測得 Windows 上建立一個程序要 20 到 80 ms,macOS 上只要 1 到 3 ms;而且防毒軟體會檢查檔案,每次檔案檢查也更貴。我們最初的 CLI 檢測會嘗試每個資料夾、名稱和副檔名,在 Windows 上讓應用卡住長達一秒。改成每個資料夾唯讀一次後問題解決。
在應用中,安裝助手會用廠商為你的系統提供的官方安裝程式安裝缺失的 CLI(Claude Code 用 irm https://claude.ai/install.ps1 | iex,Codex 用 OpenAI 的腳本),腳本失敗時退回 npm,並在你能看到的終端裡執行。CLI 啟動不了時,CLI Doctor 會讀取錯誤和確切的命令,告訴你哪裡出了問題。兩個 CLI 都能響應 --version 後,接下來交給入門指南,而Windows 版發布說明介紹了應用在 Windows 上能做什麼。
常見問題
如何在 Windows 上安裝 Claude Code?
開啟 PowerShell,執行 irm https://claude.ai/install.ps1 | iex。在 CMD 裡改用 Anthropic 安裝頁面上的 install.cmd 那一行,用 WinGet 則執行 winget install Anthropic.ClaudeCode。程式會放在 %USERPROFILE%\.local\bin,但安裝程式不會把它加入 PATH:如果 claude 無法識別,就自己加上,然後開啟新終端執行 claude --version。
在 Windows 上執行 Claude Code 或 Codex 需要 WSL 嗎?
不需要。兩者都能在 Windows 10 和 11 的 PowerShell 或 CMD 中原生執行。如果你的專案本來就在 Linux 裡,或者你想用 Claude Code 的沙箱(原生 Windows 上不可用),WSL 2 才值得用。要用就用 WSL 2,不要用 WSL 1:Codex 從 0.115 版起已不再支援 WSL 1。
為什麼剛裝完,Windows 就提示 'claude' 無法識別?
原生安裝程式把 claude.exe 放在 %USERPROFILE%\.local\bin,如果該資料夾不在 PATH 中會列印警告,但不會自己修改 PATH。把這個資料夾加入使用者 PATH,然後關閉並重新開啟終端;如果終端在編輯器裡執行,編輯器也要重開。已經開啟的終端會一直沿用舊的 PATH。
Claude Code 需要 Git for Windows 嗎?
現在不需要了。Anthropic 的安裝頁面把 Git for Windows 列為可選:沒有它,Claude Code 會用 PowerShell 作為 shell 工具;有它,Claude Code 會在 C:\Program Files\Git 中找到 Git Bash,你也可以用 CLAUDE_CODE_GIT_BASH_PATH 設定指定另一個 bash.exe。
沒有 Node.js 能在 Windows 上安裝 Codex CLI 嗎?
能。OpenAI 的 PowerShell 安裝程式會下載獨立版 Codex,放到 %LOCALAPPDATA%\Programs\OpenAI\Codex\bin,並把該資料夾加入使用者 PATH。只有 npm 方式(npm install -g @openai/codex)才需要 Node.js。
安裝時該用 PowerShell 還是 CMD?
用 PowerShell。兩條官方一行命令都是 PowerShell 命令,最常見的錯誤就來自把 PowerShell 命令粘到 CMD 裡,或者反過來:出現 'irm' is not recognized(中文版 Windows 顯示「'irm' 不是內部或外部命令,也不是可執行的程式或批處理檔案。」)說明你在 CMD 裡,出現 '&&' is not a valid statement separator 說明你在 PowerShell 裡。請用 64 位 PowerShell,不要用開始選單裡的「Windows PowerShell (x86)」。
下載 AgentsRoom
在一個視窗中執行你所有專案的所有 AI 代理。
配套應用:隨時隨地監控你的 Agent
使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。
把 Bug 和需求直接傳送到您的公開待辦清單。
繼續閱讀
Codex、OpenCode、Antigravity 和 Claude Code 的語音模式:哪個 CLI 有?
我們在 2026 年 10 月 13 日檢查了五個程式設計代理 CLI 和兩個應用。Codex CLI 和 oh-my-pi 能進行語音對話,Claude Code 和 Antigravity CLI 只能把語音聽寫進提示詞,OpenCode 沒有任何內建功能。每個怎麼啟動、音訊發往哪裡,以及語音要花多少令牌。
閱讀全文Claude Code 與 Codex CLI 對比:2026 年該選哪個(以及為什麼我兩個都用)
一份關於 Claude Code 和 Codex CLI 的誠實對比:價格、速度、MCP、可控性。還有為什麼幾週之後,我不再二選一。
閱讀全文如何從 Git 提交中去掉 Co-Authored-By Claude
Claude Code 會給你的提交加上 Co-Authored-By 尾註,給你的 pull request 加上一行 Generated with Claude Code。去掉它們的設定、該放進哪個檔案,以及如何清理已經推送的提交。
閱讀全文
