选择你的系统
所有安装包都发布在官方 Releases 页面，每个版本附带 SHA256 校验值。请不要安装群聊或网盘转发的版本。
macOS
下载对应架构的 .dmg，拖入「应用程序」即可。安装包已签名并公证，正常情况下不会有安全提示。
Niko_<版本>_aarch64.dmg
Niko_<版本>_x64.dmg
已签名 + 公证
Windows
下载安装包并运行。当前 Windows 产物尚未做代码签名，SmartScreen 会提示「未知发布者」，核对 SHA256 后选择「更多信息 → 仍要运行」即可。
Niko_<版本>_x64-setup.exe
Niko_<版本>_x64_en-US.msi
暂未签名，需手动确认
四步完成接入
登录器使用站内账号登录，密钥保存在系统钥匙串或凭据管理器；写入客户端配置前会自动生成快照，可随时回滚。
- 安装并启动 macOS 拖入「应用程序」，Windows 运行安装包。登录器会常驻托盘或菜单栏。
- 登录账号 输入米云的用户名或邮箱与密码，登录后显示余额、分组和可用模型。
- 选择分组与模型 Codex 与 Claude 可分别选择模型；界面会标注兼容等级和受限能力。
- 一键接入 在「客户端」页点击接入，配置直接写好；已运行的客户端需退出后重开生效。
安装前后需要知道的事
登录器会读写本机 Codex 与 Claude 的配置文件，因此安装来源和权限值得多一分谨慎。
核对 SHA256
下载后先校验，再安装。
macOS：shasum -a 256 <安装包>
Windows：Get-FileHash <安装包> -Algorithm SHA256
自动更新
登录器内置更新检查。版本低于服务端要求的下限时会显示强制升级页，按提示回到本页下载新版本即可。
配置快照
每次写入前的配置都会备份到 ~/.niko/backups/，在「设置 → 配置快照恢复」可回滚。
出错时怎么办
先用「设置 → 连通性检测」查看错误分类与建议；需要反馈时点击「导出日志」，日志已自动脱敏。