Agent 接入
Codex 接入方式
先按你平时打开 Codex 的方式选择，不需要先理解配置文件。
ChatGPT 桌面端里的 Codex 工作区可以接入 Lumoswitch，但普通 ChatGPT 对话不会切换到 Lumoswitch。
选择你的使用方式
| 你的情况 | 应选择的接入方式 | 可用生命周期 | 日常怎么打开 |
|---|---|---|---|
| 只安装了 ChatGPT 桌面端，不使用终端里的 Codex | ChatGPT 桌面端（Codex） | 永久、清除；无临时方式 | 像平时一样打开 ChatGPT，再进入 Codex |
只在终端中使用 codex | Codex CLI | 仅本次、永久、清除 | 运行 Lumoswitch 启动器 |
| 桌面端和终端都要使用同一个模型 | ChatGPT 桌面端 + Codex CLI | 永久共用、清除；无临时方式 | 桌面端正常打开；终端运行 codex |
如果终端提示 codex: command not found，但你已经安装 ChatGPT 桌面端，这并不代表安装失败：桌面应用和 Codex CLI 是两个入口。只用桌面端时，不需要额外安装 CLI。
三种方式有什么区别
| 接入方式 | 需要安装 Codex CLI | 是否修改 ~/.codex 共享配置 | 是否影响另一个 Codex 界面 |
|---|---|---|---|
| ChatGPT 桌面端（Codex） | 不需要 | 会 | 以后安装 CLI 后也会读取 |
| Codex CLI | 需要 | 不会 | 不影响桌面端 |
| ChatGPT 桌面端 + Codex CLI | 需要 | 会 | 两端使用同一配置 |
桌面端和 Codex IDE 扩展会读取用户级 ~/.codex/config.toml、~/.codex/.env 与 Lumoswitch 专属模型目录。这个目录会把配置完成页给出的下游模型加入 Codex 模型选择器，避免误选内置 GPT 模型。普通 codex 命令也会读取这套配置，因此“桌面端 + CLI”只需导入一次。
CLI 原生方式通过 CODEX_HOME 使用 Lumoswitch 专属 Codex 配置，日常直接运行 codex，不会修改共享配置。需要让桌面端和 CLI 使用不同提供方或不同模型时，应选择这种隔离方式。
接入前都需要准备什么
无论选择哪一种方式，都需要：
- 一项启用了 Responses 输出的 Lumoswitch 配置 API。
- 该配置可使用的 Lumoswitch Access Key。
- 配置完成页显示的「下游模型名称」。
进入上表对应的接入页面后，按页面说明填写地址、Access Key 和下游模型名称，再复制完整命令。每种使用方式都在自己的页面维护，不需要跨页面拼接配置。
已经确定使用方式后，进入上表对应的接入页。