如何在 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。去掉它们的设置、该放进哪个文件,以及如何清理已经推送的提交。
阅读全文
