应优先启用.NET Framework 3.5、以Windows 8兼容模式运行安装程序、禁用SmartScreen与驱动签名强制、改用npm全局安装CLI，或在WSL2中部署，从而绕过版本误判与签名拦截。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在Windows 11上安装或运行Qoder（包括Qoder CLI、QoderWork或可视化设计器）时收到“操作系统版本过低”或“不兼容”的提示，这通常并非源于Qoder自身对系统版本的硬性限制，而是可能由安装包签名验证失败、.NET Framework组件缺失、权限策略拦截或旧版引导程序误判系统版本所致。以下是多种针对性解决方法：
一、启用.NET Framework 3.5及必要Windows功能
Qoder CLI部分版本依赖于旧版运行时组件，尤其是使用PowerShell脚本或基于.NET Framework构建的安装器时，若系统未启用对应功能，会触发兼容性误报。
1、按 Win + R 打开“运行”对话框，输入 optionalfeatures.exe 并回车。
2、在“Windows 功能”窗口中，勾选 .NET Framework 3.5 (包括 .NET 2.0 和 3.0)。
3、同时勾选 Windows PowerShell 2.0（如存在该选项）和 TLS 1.0/1.1 支持（部分旧签名验证需启用）。
4、点击“确定”，等待Windows自动下载并启用组件。完成后重启系统。
二、以兼容模式运行Qoder安装程序
某些Qoder早期安装包（如Qoder-Setup.exe）内置的NSIS或Inno Setup引导程序可能调用已弃用的API检测系统版本，导致在Windows 11上错误返回“版本过低”。通过兼容模式可绕过该检测逻辑。
1、在文件资源管理器中找到下载的 Qoder-Setup.exe 或 qodercli-install.ps1 文件。
2、右键该文件，选择 显示更多选项 → 属性。
3、切换至“兼容性”选项卡，勾选 以兼容模式运行这个程序。
4、从下拉菜单中选择 Windows 8（非Windows 7或XP，因Windows 11内核版本号与Windows 8更接近，兼容性判断更稳定）。
5、同时勾选 以管理员身份运行此程序，点击“应用”后确定。
三、禁用SmartScreen与驱动程序签名强制验证
Windows 11默认启用的Windows Defender SmartScreen及内核模式驱动签名强制策略，可能拦截未经微软认证的Qoder安装脚本或自签名二进制文件，表现为“无法验证发布者”或“安装被阻止”，间接触发兼容性拒绝流程。
1、右键开始菜单，选择 Windows Terminal (管理员) 或 PowerShell (管理员)。
2、依次执行以下命令（每行回车一次）：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
bcdedit /set loadoptions DISABLE_INTEGRITY_CHECKS
bcdedit /set testsigning ON
3、重启电脑，再尝试运行Qoder安装脚本或双击安装程序。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
四、使用官方推荐的免安装CLI方式
Qoder官方明确建议在Windows 11上优先采用npm或curl方式部署CLI，该路径不依赖传统安装引导程序，规避所有版本检测环节，且适配Windows 11原生PowerShell 7+及Node.js环境。
1、访问 https://qoder.com/zh 下载并安装最新版Node.js（v18.17.0或更高）。
2、以管理员身份打开Windows Terminal，执行：
npm install -g @qoder-ai/qodercli
3、安装完成后，直接运行：
qodercli --version
4、若提示证书或网络问题，配置npm镜像源：
npm config set registry https://registry.npmmirror.com
五、在Windows子系统WSL2中部署Qoder CLI
当宿主系统策略过于严格（如企业域控环境禁用PowerShell脚本、组策略封锁exe执行），可在WSL2 Ubuntu环境中独立运行Qoder CLI，完全脱离Windows版本检测链路，且获得更稳定的Linux级运行时支持。
1、以管理员身份运行PowerShell，启用WSL2：
wsl --install
2、重启后启动Ubuntu，更新系统：
sudo apt update && sudo apt upgrade -y
3、安装Node.js：
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt-get install -y nodejs
4、全局安装Qoder CLI：
sudo npm install -g @qoder-ai/qodercli
5、执行 qodercli login，使用浏览器完成授权。
