Coskey 是一个独立的桌面应用。它不改动 ChatGPT.app、不重新打包，只是把 app 的 Code 会话接到你选择的任意 OpenAI 兼容大模型供应商上。
1. 准备工作
| 条件 | 说明 |
|---|---|
| 系统 | macOS 13+ 或 Windows 10+ |
| ChatGPT.app | 已安装（macOS 默认探测 /Applications/ChatGPT.app，也支持 ~/Applications；Windows 为 MSIX 包） |
| 供应商 | 一个 OpenAI 兼容端点（https://…/v1）与 API key |
端点的协议要求很简单：原生支持 /v1/responses 的直接透传；只有 /v1/chat/completions
的端点，由 Coskey 的本地翻译层自动互转，同样可用。
2. 下载与安装
安装包见产品页的下载入口，两个平台同内容同步发布：
| 平台 | 产物 |
|---|---|
| macOS（Apple Silicon） | Coskey_<版本>_aarch64.dmg |
| macOS（Intel） | Coskey_<版本>_x64.dmg |
| Windows（x64） | Coskey_<版本>_x64-setup.exe |
macOS：双击 DMG，把 Coskey.app 拖进「应用程序」，直接打开即可（安装包已签名并公证）。 若系统仍提示「来自身份不明的开发者」（例如手动替换过二进制），右键点应用 →「打开」放行一次。
Windows：双击 -setup.exe 安装。安装器是 per-user 的（装在当前用户目录，不弹 UAC）。
首发版本尚未做 Authenticode 签名，首次运行会有 SmartScreen 提示——点「更多信息 → 仍要运行」
即可（应用内的更新包有独立的 minisign 签名校验，不受影响）。
3. 首次启动：安装包装器
首次打开只有一个引导步骤：
点「安装包装器与启动配置」，Coskey 会把包装器装到 ~/.coskey/bin/codex，并配置登录时注入
CODEX_CLI_PATH（当前会话立即生效，无需注销）。引导页顶部会显示是否检测到 ChatGPT.app。
这一步做什么：ChatGPT.app 的 Code 能力由它内嵌的 codex 内核驱动，而 app 支持用
CODEX_CLI_PATH 覆盖内核路径。Coskey 把内核路径指向自己的包装器，包装器再拉起真实内核，
于是有了一个可以按请求决定「用哪个供应商、哪个模型」的切入点。
4. 生效时机
| 操作 | 何时生效 |
|---|---|
| 安装包装器、改供应商 / 模型 / 映射 | 退出并重新打开 ChatGPT.app |
| 设置页切「默认模型」 | 即时：未钉住的会话下一轮对话即跟随 |
| 设置页「全局开关」 | 即时：关闭后包装器纯透传官方请求 |
配置改动之所以要重启 app：运行中的包装器持有启动时的配置快照。Coskey 会明确提示，不用猜。
5. 升级
应用内检测到新版本后可直接更新；更新包带 minisign 签名校验。供应商、模型映射与密钥都在
~/.coskey 与系统钥匙串里，升级不影响，也不需要迁移。
下一步：供应商与上游模型。