Qoder在Windows与macOS上安装及配置差异源于签名机制、包管理、沙盒策略与Shell环境不同：Windows依赖PowerShell与注册表，需管理员权限和防火墙放行；macOS需Gatekeeper授权、Homebrew依赖及移除隔离属性；配置路径、换行符、权限、语言初始化均须按平台适配。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在Windows与macOS系统上安装Qoder，但发现安装路径、依赖管理、权限控制或界面初始化行为存在明显差异，则可能是由于两套系统在签名机制、包管理生态、沙盒策略及默认Shell环境上的根本性不同所致。以下是针对Windows与macOS平台的具体安装与差异化配置说明：
一、Windows平台安装与配置要点
Windows系统依赖PowerShell运行时与注册表机制管理应用配置，安装过程以图形化向导为主，需特别注意防火墙放行与管理员权限调用，确保CLI命令全局可用及IDE后台服务持续运行。
1、访问https://www.php.cn/link/4fe9b99a93f17369b95f15d8d806128a，选择标注为“Windows x64”的安装包（文件名通常含Setup-x64.exe）。
2、双击运行安装程序，在向导中勾选“添加至系统PATH”与“开机自启服务”选项，避免后续终端无法识别qoder命令。
3、安装完成后，以管理员身份启动PowerShell，执行qoder --version验证基础命令是否就绪；若报错“未识别命令”，需重启终端或手动将安装目录下的bin子目录加入系统环境变量。
4、首次启动Qoder IDE时，若弹出Windows安全中心拦截提示，须在防火墙设置中明确允许Qoder.exe通过专用/公用网络，否则云端模型连接将失败。
二、macOS平台安装与配置要点
macOS采用Gatekeeper签名验证与App Sandbox隔离机制，Qoder.app默认被标记为“来自未识别开发者”，且依赖Homebrew统一管理Python、Node.js等底层运行时，必须解除隔离属性并完成开发者授权，方可加载内核级插件与本地Agent模块。
1、打开终端，依次执行命令安装基础依赖：brew install python node git；如未安装Homebrew，先运行/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
2、从官网下载.dmg镜像，双击挂载后，将Qoder.app拖入“应用程序”文件夹；此时系统会弹出“无法验证开发者”警告。
3、进入“系统设置→隐私与安全性”，在“安全性”区域点击“仍要打开”按钮完成首次授权。
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
4、在终端中执行：sudo xattr -rd com.apple.quarantine /Applications/Qoder.app，彻底移除隔离元数据，确保Connector模块与本地调试工具可正常加载。
三、双平台共性配置差异处理
Qoder在Windows与macOS上虽共享同一套配置文件结构（config.yaml），但路径解析、编码格式、权限继承方式截然不同：Windows使用反斜杠路径与CRLF换行，macOS强制UTF-8编码与LF换行，且对~符号展开逻辑不一致，直接复制配置易导致解析失败或路径不可达。
1、在Windows中，配置文件默认位于%APPDATA%\Qoder\config.yaml；编辑时须使用支持UTF-8无BOM的编辑器（如VS Code），禁用自动换行符转换。
2、在macOS中，配置文件位于~/Library/Application Support/Qoder/config.yaml；若通过scp或iCloud同步该文件，需在保存前手动将换行符统一为LF，并确认所有路径中不包含Windows风格的盘符或反斜杠。
3、涉及SSH密钥、Git凭据等敏感路径字段（如git_ssh_key_path），Windows应填写类似C:\Users\Name\.ssh\id_rsa的绝对路径，macOS则必须使用/Users/Name/.ssh/id_rsa格式，且确保目标文件权限为600（macOS下执行chmod 600对应路径）。
四、界面与语言初始化差异应对
Qoder IDE首次启动时，Windows与macOS对系统区域设置的读取逻辑不同：Windows优先匹配控制面板中“语言与区域”设置，macOS则严格遵循系统语言偏好顺序及NSLocale配置，导致中文界面触发时机与切换稳定性存在偏差。
1、Windows用户若安装后仍显示英文界面，可在安装向导最后一步主动勾选“默认使用中文界面”选项；若已跳过，需手动编辑config.yaml，将language字段设为zh-CN并重启IDE。
2、macOS用户首次启动后，若未自动弹出语言切换框，需在终端中执行：defaults write com.qoder.Qoder IDE AppLanguage zh-Hans，随后强制退出并重开应用。
3、双平台均需注意字体渲染差异：Windows默认启用ClearType，macOS启用subpixel antialiasing；若代码编辑区出现模糊字符，应在Qoder设置中关闭“硬件加速渲染”并重启。
