如何在 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 CodeCodex 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
CMDcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
WinGetwinget 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"
npmnpm 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 Codeirm https://claude.ai/install.ps1 | iex在 WSL 中執行 curl -fsSL https://claude.ai/install.sh | bash
安裝 CodexPowerShell 安裝程式在 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 路線的三條規則:

  1. 用 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 轉換發行版。
  2. 在 WSL 內安裝和執行。 Linux 命令要在 WSL 終端裡執行,不是在 PowerShell 裡。從 WSL 呼叫 Windows 的 Node.js 就會出現 exec: node: not found:請用發行版的套件管理器或 nvm 在發行版內安裝 Node.js。
  3. 程式碼放在 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 PowerShellClaude Code 兩種 shell 都沒找到安裝 Git for Windows,或確認 PowerShell 在 PATH 中
npm install 時出現 EBADENGINENode.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 CodeCodex 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)」。

DevOps 工程師撰稿人前端開發者銷售代表後端開發者教練與培訓師軟體架構師法律顧問QA 工程師財務與行政全棧開發者創意設計師移動開發者研究員安全工程師人事與招聘
專案經理翻譯Git 專家資料分析師SEO 專家會計本地化專員公關與傳播頭腦風暴者營運與物流營銷專員客戶服務專案助理採購專員社群營運私人助理

下載 AgentsRoom

在一個視窗中執行你所有專案的所有 AI 代理。

下載 AgentsRoom免費

配套應用:隨時隨地監控你的 Agent

使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。

獲取擴充功能
Chrome Web Store

把 Bug 和需求直接傳送到您的公開待辦清單。

像讀聊天記錄一樣讀代理

每個代理都有角色、頭像和一條對話執行緒,讀起來就像聊天應用。

對話檢視

AgentsRoom 對話檢視:AI 程式設計代理的工作以聊天執行緒呈現
多專案管理
多供應商
多代理執行
即時狀態
檔案差異與提交
行動應用
即時預覽
代理團隊
瀏覽器自動化
Backlog 驅動開發
提示詞庫
技能庫
檢視所有功能

繼續閱讀