Qoder官方镜像需x64架构Windows 10/11系统，启用WSL2、安装.NET 8.0与VC++运行库，关闭安全软件拦截，并按需预分配GPU资源。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试安装Qoder官方镜像版本，但软件无法正常启动或出现兼容性异常，则可能是由于底层运行环境未按要求配置。以下是确保稳定运行的底层环境准备步骤：
一、验证系统架构与平台匹配性
Qoder官方镜像为x64架构专用，仅支持Windows 10/11操作系统，不兼容ARM设备或32位系统环境。若在非匹配平台上强行运行，将导致进程崩溃或初始化失败。
1、右键“此电脑”→选择“属性”，确认“系统类型”显示为“64位操作系统，基于x64的处理器”。
2、在命令提示符中执行echo %PROCESSOR_ARCHITECTURE%，输出结果必须为AMD64。
3、检查Windows版本号：按Win+R输入winver，确认版本不低于Windows 10 21H2（内部版本19044）。
二、启用Windows子系统WSL2（如需Repo Wiki索引与多模态文件扫描）
Qoder的代码库深度索引与跨文件依赖分析功能依赖WSL2内核提供的Linux兼容层，缺失该组件将导致Repo Wiki生成失败、MCP工具调用中断及日志文件解析异常。
1、以管理员身份打开PowerShell，依次执行：dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart。
2、执行：dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart。
3、重启电脑后，运行wsl --install，等待自动下载并安装WSL2内核更新包。
4、执行wsl -l -v，确认默认发行版状态为Running且版本号≥5.15。
三、配置.NET Runtime与Visual C++运行库
Qoder桌面端基于.NET 8.0 Windows Desktop Runtime构建，同时调用大量原生C++模块，缺失对应运行时将触发“0xc00007b”错误或界面白屏。
1、访问微软官方站点下载dotnet-runtime-8.0.5-win-x64.exe，运行安装并勾选“将dotnet添加到PATH”选项。
2、下载vc_redist.x64.exe（2015–2022版本合集），执行安装时选择“修复”模式以覆盖旧版冲突组件。
3、在终端执行dotnet --list-runtimes，输出中必须包含Microsoft.NETCore.App 8.0.5及Microsoft.WindowsDesktop.App 8.0.5。
四、关闭安全软件主动防护策略
部分终端安全产品会拦截Qoder动态加载的LLM模型权重文件、MCP协议通信端口及内存映射区域，造成模型加载超时、Agent任务卡死或截图上下文无法识别。
1、临时禁用Windows Defender实时保护：进入“Windows安全中心”→“病毒和威胁防护”→“管理设置”→关闭“实时检测”。
2、在第三方杀毒软件中将qoder.exe、QoderModelHost.exe及安装目录整体添加至信任区。
3、检查防火墙入站规则，确保QoderMcpBridge.exe的TCP端口（默认51234）未被阻止。
五、预分配GPU显存与共享内存资源（适用于启用了本地大模型的场景）
当使用Qoder内置的Claude 3.5 Sonnet或GPT-4 Turbo离线推理模块时，需预留至少4GB GPU显存及2GB系统共享内存，否则将触发OOM error或模型响应延迟超过30秒。
1、确认NVIDIA驱动版本≥535.98，AMD GPU需Adrenalin 23.12.1或更高。
2、运行nvidia-smi -i 0 -c 3（NVIDIA）或amdgpu-pro-installer --set-compute（AMD）启用计算模式。
3、在Qoder安装目录下创建config/gpu-config.json，写入{"max_gpu_memory_mb": 4096, "shared_memory_mb": 2048}。
