有 Coskey 在,你放心用 Codex 桌面版

围绕模型自由切换、系统提示词与窗口、个性化代理、本地模型网关,讲清 Coskey 怎样让 Codex 桌面版用得放心。

有 Coskey 在,你放心用 Codex 桌面版

导语:Codex 桌面版不该被一种模型绑住。Coskey 要解决的,是换完模型以后仍然能自由切、旧会话不失效、第三方模型不低人一等,以及国内网络环境里的重要功能仍然能用。

这里说的 Codex 桌面版,就是使用 Codex 能力的 ChatGPT.app。Coskey 是它旁边的一层本地工具,不修改、也不重打包桌面版。

安装和录入供应商只是起点。真正构成产品核心的,是下面四件事:

  1. 模型能自由切换,官方和第三方一视同仁;
  2. Codex 的 272K 限制能解锁,第三方模型也有同等级的系统提示词和可调窗口;
  3. 个性化代理把国内环境里最常用的本地能力补齐;
  4. 本地模型网关能把同一套模型开放给其它 Agent。

01 大模型自由切换,官方与第三方一视同仁

在 Codex 桌面版里,第三方模型会和官方模型一起出现在选择器里。新会话可以直接选;对话进行中也能换,下一轮请求就走新模型,跨供应商也可以。

Coskey 还维护一层清楚的切换语义:没显式切换的会话跟随全局默认;在选择器里改选,只钉住当前会话,不影响其它对话。

Codex 桌面版模型选择器里的多个第三方模型

图:官方与第三方模型并排出现,同一个会话可以连续切换。

更关键的是,切模型不能把过去一起带走。

历史会话在建立时会记下当时的 provider。后来 provider 被删除、改名,或者换用了别的网关,再打开这条对话就可能报「找不到 provider」。3.x 版本的 cc switch 更像是在切换配置;配置一换,旧会话就可能停在报错页。

ChatGPT 打开历史会话时提示找不到 provider

图:provider 消失后,ChatGPT.app 会直接提示历史会话无法恢复。

Coskey 的「会话」页把这类问题单独列出来:能救的会话可以一键适配到本地中转,会话内容不变,之后照常打开,也能继续在会话里切模型;不想继续交给 Coskey 管理,还能「转交」回原生可解析的 provider。

Coskey 会话管理页列出已适配和打开报错的会话

图:会话页直接区分已适配、未适配和 provider 不可解析的会话。

这个报错从哪来、Coskey 又是在哪一步接回来的,可以看往期文章《ChatGPT.app 换了 provider,老会话打不开了》。

Codex CLI 与远端 Codex,同样是原生 /model 体验

本机终端里,用 coskey codex 启动的仍然是官方 Codex CLI。进入交互界面后输入 /model,Coskey 里已启用的模型会进入原生模型列表,同一会话也能在官方模型和第三方模型之间切换。普通 codex 命令不受影响。

Codex CLI 的模型列表里出现 DeepSeek Flash

图:用 coskey codex 启动后,仍然在原生 /model 列表里选择模型。

远端 Codex 也一样。通过 Coskey 的远端通道接入后,本地 ChatGPT.app 打开的远端项目会读取本机网关提供的模型目录,在模型选择器里直接切换。任务仍在远端执行,模型选择不再被 SSH 连接截断。

远端 Codex 项目里切换 Coskey 提供的模型

图:远端项目仍在 ChatGPT.app 里操作,模型列表由本机 Coskey 提供。

完整操作分别见《Codex CLI 切换三方模型也可以很简单》和《远端 Codex 切换三方模型,也能像本地一样丝滑》。切换体验的总览,也可以回看《ChatGPT.app 换个模型,也可以很丝滑》。

02 解锁 272K,给第三方模型同等提示词和窗口能力

Codex 默认会把第三方模型的上下文窗口锁在 272K。模型本身支持更长上下文,到了桌面版也只能按这个上限使用,长文档和大型项目很容易被截断。

Coskey 的「模型目录」先解锁这个限制,再把目录模板合成到第三方模型上。模板负责系统提示词、请求形态和工具声明,让第三方模型拿到与官方模型同等级的系统提示词,而不是只靠内核兜底元数据。

内置目录覆盖了国内几款常用模型:deepseek-flash、qwen3.8、glm-5.3、kimi-k3、MiniMax-M3。其它模型也可以套用这些目录模板,不必从空白开始配。

Coskey 模型目录管理提示词、窗口和目录模板

图:用户目录为第三方模型准备独立的目录条目、窗口范围和能力开关。

Coskey 系统目录管理官方模型的窗口与展示状态

图:系统目录列出官方模型,可以逐条调整窗口、展示和启用状态。

官方模型也不是只能被动跟随默认值。进入「系统目录」,点某个模型右侧的编辑,就能单独修改它的默认窗口和窗口上限,不会连带改动其它官方模型。

上下文窗口也同样能调:

  • 第三方模型走「模型映射」,为每个应用模型设置默认窗口和窗口上限;
  • 官方模型走「系统目录」,可以逐条单独修改上下文窗口,也可以调整展示状态;
  • 同一个上游模型还能做成多个条目,例如省流的小窗口版和给长文档用的大窗口版。

实际生效窗口会在注入值和目录上限之间取较小值,再乘以 95%。例如填入 640K,界面会显示约 608K,不需要用户自己换算。

在模型映射里给 DeepSeek 设置 640K 上下文窗口

图:窗口上限和生效值直接写在表单里,640K 会折算为 608K。

这里有两个边界要记住:目录类改动需要重启桌面版才会重新读取;上下文窗口在会话建立时确定,会话中途切模型会走新模型,但窗口仍保持原值,新建、fork 或重启后恢复会话才会采用新窗口。

窗口从 272K 到更大尺寸的实际配置,可以回看《ChatGPT.app 优雅地用上国内模型》里的映射步骤。

03 个性化代理,把国内环境最常用的本地能力补齐

在国内网络环境里,ChatGPT.app 依赖的部分取数链路可能不可达,结果不只是中文界面不出现,Browser Use、Computer Use、应用快照这些本地能力也可能一起不可用。

Coskey 的「个性化」页把这组能力收在一处:中文界面、浏览器助手、电脑操作、电脑操作服务、外部浏览器控制、应用快照等都能逐项配置。它通过本地代理和受管启动,让这些本地能力不必因为同一条远端取数链路不可达而一起失效。

Coskey 个性化页集中管理中文界面、Browser 和 Computer Use 等能力

图:中文界面、浏览器助手、电脑操作和应用快照等本地能力集中在一个页面。

配置好后,可以通过 Coskey 打开 ChatGPT.app,也可以生成「ChatGPT 个性化启动器」,以后双击自己的入口即可。普通 Dock、Finder 或开始菜单启动不会带上这套个性化设置。

它也要说清边界:个性化主要面向 API key 模式的 ChatGPT.app,只处理本地功能开关和能力代理,不会授予账号、套餐、工作区或地区权限;插件和系统权限仍然要单独装好、开启好。它解决的是国内环境里重要本地能力更容易被用起来,不是把所有服务都变成不受限制。

中文界面和个性化启动入口的完整操作,见往期文章《我的 Codex 中文界面,我作主》。

04 本地模型网关,让其它 Agent 共用同一套模型

Coskey 的「模型网关」会把已配置的模型暴露成一个固定的 OpenAI 兼容入口。它监听本机回环地址,也可以按需开放到局域网,供其它程序接入。

每个 Agent 使用独立的 client,有自己的 token、访问范围和允许模型列表。外部程序只拿到 Coskey 的 client token,不会拿到供应商 API key,也拿不到宿主机的 ChatGPT OAuth token。增加模型时可以直接编辑 client,不必每次重建。

在 Coskey 模型网关里为客户选择允许模型

图:每个 client 单独指定访问范围和允许模型。

这让同一套模型不只在桌面版里可用:

  • 本机的 DeepSeek Harness、IDE 或脚本可以接这个网关;
  • 局域网里的其它机器可以按 client 范围接入;
  • 远端 SSH 主机上的 Codex 可以通过反向通道使用本机网关,远端不必安装 Coskey,也不必保存供应商密钥。

本地、局域网和远端 Agent 的具体接法,分别见《DeepSeek Harness 怎么用上 ChatGPT 订阅模型》和《远端 Codex 切换三方模型,也能像本地一样丝滑》。

小结

Coskey 的四个核心,不是四组孤立功能,而是围绕同一件事展开:让 Codex 桌面版的模型选择不再被供应商、历史会话、网络环境或使用场景绑死。

  • 模型可以自由切,官方和第三方同场;
  • Codex 的 272K 限制能解锁,第三方模型有同等系统提示词,窗口也能按模型调整;
  • 国内环境里的中文界面、Browser Use、Computer Use 等本地能力可以通过个性化代理补齐;
  • 同一套模型还能经本地网关提供给其它本地、局域网和远端 Agent。

而这套能力仍然保持可退:Coskey 不修改 ChatGPT.app,API key 只进系统钥匙串,全局开关关闭后会恢复官方请求路径。

所以,有 Coskey 在,放心的不只是「模型能换成第三方」,而是换完以后还能接着用、继续切,也能把同一套能力交给下一个 Agent。

Coskey 已在 macOS 和 Windows 上发布:

coskaiagent

需要具体操作步骤?

安装、配置和排障以产品使用手册为准;文章里的步骤若与手册不同,会优先更新手册。

查看 Coskey 使用手册