Codex 模型选择

Codex 有两个使用入口，模型选择的来源并不相同：

开始前，要选择的第三方模型必须已经在 模型映射与上下文窗口 中创建并启用。选择器显示的是应用模型 id，不是供应商的上游模型名；填配置或使用 -m 时都必须使用前者。

1. 远端 Codex：先选接入方式

远端项目的模型选择器由远端 Codex app-server 回答。本机 ChatGPT.app 里的 Coskey 包装器不会把本地模型列表直接推送到远端，所以远端必须先通过「远端通道」接入一个可用的 provider。

1.1 远端 Codex 依赖模型网关

远端 Codex 的模型目录和模型请求都依赖本机 Coskey 模型网关。「远端通道」本身不提供 模型，它只是把远端 Codex 的回环地址经 SSH 反向隧道指向本机网关。因此，下面四项必须同时 可用：

1. Coskey 正在运行。关闭主窗口到系统托盘不影响网关；真正「退出 Coskey」会停止网关；
2. 模型网关已启用且进程正在运行；
3. 远端绑定的 gateway client 已启用，且「允许模型」包含远端要选的模型；
4. 该主机的远端通道正在运行，反向隧道能把远端回环地址接到本机网关。

任何一项缺失，SSH 或远端项目可能仍然能打开，但模型选择器会为空、看不到新模型，或者请求 超时、返回鉴权错误。模型网关是远端 Codex 的模型来源，不是只用于连接测试的可选页面。

点目标主机右侧的 接入，然后二选一：

想在远端像本地一样随时切换多个模型，优先使用经本机 Coskey 网关。

2. 经本机网关：用 client 允许模型决定列表

2.1 选择或创建 client

在接入弹窗里选择「经本机 Coskey 网关」，再选择一个已有 client，或创建新 client。

• 复用已有 client 时，弹窗只读展示它当前的允许模型；要增减模型，回到 模型网关 → 允许模型 → 编辑，远端接入不会擅自改写权限。
• 新建 client 时，勾选的模型全部写入该 client 的允许列表；第一个勾选的模型同时作为 远端 Codex 的默认模型。
• 官方模型和第三方模型在同一份候选清单里，按需要同时勾选即可。

选择完成后生成接入计划并确认。Coskey 会配置远端 provider、模型目录、专用 token 和反向 通道；远端不需要安装 Coskey，也不需要保存你的供应商 API key。

2.2 重连远端并打开项目

配置写入后，已经运行的远端 app-server 不会自动重载 provider：

1. 在 ChatGPT.app 打开 设置 → 连接，把目标 SSH 主机断开再连接；
2. 打开这台主机上的项目目录；
3. 点对话框右下角的模型选择器，选择该 client 允许的 Coskey 模型。

列表为空、只有单个模型，或看不到新加的第三方模型时，先按顺序检查：

1. 该网关 client 的「允许模型」是否包含目标应用模型 id；
2. 远端是否已经重新连接，让 app-server 重载 provider 与模型目录；
3. 修改允许模型后，Codex 自身还有约 5 分钟的目录缓存；重开 /model 或再次重连远端主机 可以立即刷新。

如果能在远端终端操作，可以直接核对目录中的模型 id：

codex debug models | jq -r '.models[].slug'

输出应包含你在网关 client 中授权的应用模型 id。

2.3 会话中切换

从远端模型选择器改选后，发送中的这一轮仍使用旧模型，下一轮请求才按新模型路由。 第三方与官方模型可以出现在同一个列表里；官方模型使用 Coskey 宿主机的 ChatGPT 订阅登录， 第三方模型使用对应供应商的额度。

3. 直连供应商：固定一个上游模型

「直连本机供应商」不使用本机网关和反向通道。它把选中的一个 Coskey 供应商、一个原生 Responses 上游模型及其密钥配置到远端；请求由远端直接访问供应商，远端账户会保存该密钥。

这种方式适合只使用一个固定模型。需要频繁切换多个模型时，改用「经本机 Coskey 网关」； 不要为了增加模型而重复叠加多套远端 provider 配置。

4. 本机 Codex CLI：启动后用 /model 选择 Coskey 模型

本机 CLI 的主路径不是启动时写死模型，而是用 coskey codex 启动后，在交互界面里运行 /model。启动器会把当前启用、有效的 Coskey 应用模型放进 Codex 的动态模型目录，因此 第三方模型可以直接从列表中选择，不需要手工维护 provider 配置，也不需要先启用固定网关。

4.1 先决条件：在 Coskey 中配置 DeepSeek 应用模型

启动 CLI 前，先在 Coskey 的模型映射与上下文窗口里创建并启用要使用的 DeepSeek 应用模型。/model 列表来自这些启用且有效的映射，不会直接读取供应商的原始模型清单。

下图中，展示名 DeepSeek Flash 对应应用模型 id deepseek-flash，指向供应商模型 deepseek/deepseek-flash。展示名只影响界面显示；/model 的选项和实际路由都依赖这条 启用映射。缺少这条映射或将其停用时，/model 不会出现对应的 DeepSeek 模型。

确认应用模型已启用后，再启动托管 CLI：

coskey codex
coskey codex resume

coskey codex 会启动一个只属于当前进程的随机回环 relay，并把 Coskey 已配置的模型目录 交给官方 Codex CLI。第三方模型应继续从这个入口启动；不要把临时端口或 token 复制给远端 或其它 Agent。

4.2 用 /model 切换到 DeepSeek 模型

完成上面的应用模型配置后，进入 coskey codex：

1. 输入 /model；
2. 在列表中选择 DeepSeek Flash。列表显示的是应用模型展示名，实际路由使用对应的 应用模型 id；
3. 选完后进入推理等级页。只想让本次会话使用 DeepSeek，按 s；
4. 下一轮请求由 relay 路由到该映射指向的 DeepSeek 供应商。

切换后，会话仍固定使用 coskey provider，变化的是应用模型 id；relay 据此选择实际上游。 同一个会话可以直接从 DeepSeek 切回其它第三方模型或官方模型，不需要重建会话。

4.3 推理等级页：按 s 或 Enter

选完 DeepSeek 模型会进入推理等级页。这里要区分两个按键：

只想为这一次任务切换到 DeepSeek，按 s。/model 的两条路径都不会修改 Coskey 的全局激活模型。 外部执行 coskey use 也不会让正在运行的 CLI 立刻跟随；它影响之后新启动的会话。

4.4 可选：启动时用 -m 直接指定

-m 是启动时的快捷覆盖，适合脚本或已经明确知道目标模型的场景，不是选择 Coskey 模型的 主要方式。它接收应用模型 id；例如 localdev-large 不是供应商那边的原始 model 字段：

coskey codex -m localdev-large
coskey codex exec -m localdev-large "总结当前改动"

没有传 -m 时，新会话使用 Coskey 当前激活的模型。resume 会保留会话已经持久化的模型； 只有显式再传 -m 时才覆盖。

5. 怎么选

6. 常见问题

相关：模型网关、模型映射与上下文窗口、 Coskey Tools。