Claude Code Windows 兼容性问题：指定版本 2.1.112 可解决

Claude Code Windows 兼容性问题：指定版本 2.1.112 可解决

一、问题现象

在 Windows 64 位系统上通过 npm 安装 Claude Code 时，提示不兼容：

程序"claude.exe"无法运行：指定的可执行文件不是此操作系统平台的有效应用程序

或 npm 返回 EBADPLATFORM 错误。

二、原因分析

1. 官方不支持原生 Windows：Claude Code 官方支持平台为 macOS 10.15+、Ubuntu 20.04+/Debian 10+，或通过 WSL 使用

2. 版本差异：经社区验证，某些版本可在原生 Windows 运行，某些则不能

三、已验证可用的版本

版本号	兼容性	验证来源
2.1.112	✅ 可用	本文目标版本
2.1.111	✅ 可用	社区反馈
2.1.110	✅ 可用	社区反馈
2.1.114	❌ 报错	社区反馈

结论 ：2.1.112 及之前部分版本可用，2.1.114 开始出现兼容性问题。

四、解决方案

方案一：安装指定版本（推荐）

# 卸载现有版本
npm uninstall -g @anthropic-ai/claude-code

# 安装 2.1.112
npm install -g @anthropic-ai/claude-code@2.1.112

# 验证
claude --version

方案二：使用官方脚本（需 Git Bash）

# 安装 Git for Windows 后，以管理员身份运行 PowerShell
irm https://claude.ai/install.ps1 | iex

方案三：使用 WSL（官方推荐）

wsl --install -d Ubuntu
# 进入 WSL 后执行
npm install -g @anthropic-ai/claude-code

五、官方认可的 Windows 使用方式

根据阿里云和摩尔线程文档中心，Windows 上使用 Claude Code 需要满足以下条件：

• 安装 Node.js 18+
• 安装 Git for Windows
• 在 Git Bash 或 WSL 中执行安装命令

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

六、补充说明

关于 PowerShell 执行策略

如遇到脚本执行报错，可执行：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force

关于版本选择

不要使用最新版本。社区验证表明，回退到 2.1.110-2.1.112 范围即可解决兼容性问题。

关于 WSL 环境变量

如在 WSL 中安装时提示 OS/platform detection issues，可执行：

npm config set os linux

---

一句话总结 ：安装 npm install -g @anthropic-ai/claude-code@2.1.112，其他版本可能报错。