Coskey
ChatGPT.app 的模型切换与密钥管理
让 ChatGPT.app / Codex.app 切换大模型自由、丝滑。
v0.14.3 · macOS 13+ · Windows 10+
为什么需要 Coskey
这些事，本不该这么难
如果你也曾被配置切换折磨，Coskey 就是为此而生。
痛点
改配置的常规做法
Coskey
第三方模型配置复杂，不支持多个模型
手工编辑 ~/.codex/config.toml，门槛高、易出错
GUI 录入供应商与 key，全程不碰任何配置文件
ChatGPT.app 只显示「自定义」，不支持多个
输入框选择器里没有第三方模型
第三方条目与官方模型并列，所选即实际，会话中也能改选
上下文窗口上限 272K
第三方模型的窗口改不了，只能吃默认值
自由配置窗口大小：每个应用模型单独设定窗口与生成参数，同一上游模型可以按场景给出多个尺寸
供应商（provider）切换，历史会话打不开
只能重开会话，历史会话就此搁置
全局默认 + 会话级钉住，跨供应商无缝切换；既有会话还可接管
上手三条主线
接进来，然后在 app 里选它
下图取自 Coskey 界面与 ChatGPT.app 实际运行画面。
接入供应商与上游模型
一个 OpenAI 兼容端点的 Base URL + 一个 API key，四步完成入库。密钥只进系统钥匙串。
- 1
新增供应商
选常用供应商（DeepSeek / 千问 / 智谱 / Kimi / MiniMax）一键填好前三项，只差 API key；也可以手填四项。保存时 key 直接写入系统钥匙串，不落配置文件、不进日志。
- 2
卡片就绪
供应商卡片立即出现，标题右侧显示「钥匙串 ✓」。顺手可以测一下这个地址是否可达、往返多久。
- 3
从上游清单导入模型
点「导入模型…」，Coskey 用该供应商的密钥拉一次上游 /models 清单，可搜索、可多选；搜索只影响显示，不会丢掉已勾选项。
- 4
协议自动判定
导入时逐个探测 /responses：原生支持的直接透传，只有 chat/completions 的交给本地翻译层互转（每个模型行还能单独「探测协议」）。此时模型已进目录——但还没进选择器。
配映射与窗口，在 app 里直接选
「模型映射」页的一条记录 = ChatGPT.app 选择器里的一个条目：指向哪个上游模型、窗口多大，都在这里定。
- 1
新建映射，指向目标模型
在「指向」里选上游模型；核心名与分组 ID 决定它在选择器里叫什么。不建映射的模型不会出现在 app 里。
- 2
建用户目录条目，放开窗口上限
内核按名字匹配窗口。点「+ 用户目录」建一条以 id 前缀命名的条目，缺省窗口与窗口上限都在这里设定。
- 3
拖出想要的窗口大小
有效窗口 = min(注入值, 上限) × 95%，界面直接给出结果。id 与展示名会自动带上窗口后缀，同名的不同窗口各有条目。
- 4
改动生效，在选择器里点选
映射与展示名即时生效，ChatGPT.app 选择器列表最迟约 5 分钟随窗口焦点刷新（重启更快）；用户目录条目要退出并重新打开 app 才生效。之后第三方条目与官方模型并列出现在选择器里，会话进行中也能改选。
把模型目录配顺手
0.6.0 起，模型目录是目录体系的总控台：一个开关解锁窗口上限，三个页签管条目、官方基底与目录模板。
- 1
目录模式一次开启
「模型目录增强（目录模式）」决定内核启动时读不读 Coskey 生成的目录缓存：解锁 272K 窗口上限、决定三方模型的提示词与请求形态，并应用官方基底覆写。全程零写 ~/.codex。
- 2
用户目录：给模型配窗口
一行 = 一个 slug + 一个目录模板基底，只存窗口与能力参数；映射页的「+ 用户目录」是同一份表单，确认后窗口区立刻命中。
- 3
目录模板：检查更新、切换版本
内置 DeepSeek、千问、GLM、Kimi、MiniMax 等常用模板；可装新模板、更新、切换版本（含回退），也能先预览提示词再装。
配完之后，日常切换就只剩下「在 app 里选一下」。完整步骤见使用手册。
一个不落
把切换这件事，做到彻底
主线之外，这些细节决定它能不能长期用下去。
按需停用
官方模型能不让它出现在选择器里；自己建的映射可临时停用，映射、默认与钉住引用都保留，随时开回来。
全局默认 + 会话钉住
未显式切换的会话跟随默认模型；在选择器里改选只钉住当前会话，其它会话不受影响。
既有会话接管
安装前创建的会话同样可见，可接管、可转交；卸载时能恢复接管前的供应商。
上游协议适配
原生 Responses 直通；只有 chat/completions 的端点由本地翻译层互转，流式与工具调用照旧。
多供应商并行
每个供应商一套 Base URL 与密钥，映射里自由指向，跨供应商切换不影响会话。
零配置改动
不修改 app、对 ~/.codex 零写入；一键停用即回到官方原生行为。
全链路体检
逐项检查 app、内核、包装器、钥匙串与中转端口，出问题直接给结论。
使用手册
按操作顺序编排的说明
每一步都配了界面截图，装完跟着走一遍即可。
反馈通道
遇到问题，来这里告诉我们
使用中碰到问题或有新想法，欢迎到发布仓提交 issue。GitHub 与 Gitee 双镜像，选你顺手的那个即可。