本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-codex-provider

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-codex-provider

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 设备码 OAuth 登录：在界面点击“使用 OpenAI 账号登录”，按提示完成设备码授权，无需 API Key
• 导入 Codex CLI 登录态：直接复用本机 ~/.codex/auth.json 中已有的登录（无需重新授权）
• 令牌自动刷新：后台定期检查 access token，过期前自动用 refresh token 轮换（refresh_token 也会一并轮换）
• 供应商管理界面：设置 → 供应商，展示登录状态、账号、套餐（Plus/Pro）、令牌过期时间，支持退出登录
• 激活内置 Codex 模型：登录后 openai-codex 路由自动激活，模型选择器直接可选

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

需要 OpenAI API Key 吗？

不需要。本插件消费的是 ChatGPT Plus / Pro 订阅额度（与 Codex CLI 同一通道），登录走的是设备码 OAuth，不是 API Key 计费。

已经装了官方 Codex CLI，能复用登录吗？

可以。在供应商页点击「导入本机 Codex CLI 登录态」，插件会直接读取 ~/.codex/auth.json，无需重新授权。

登录失败提示设备码授权被拒绝怎么办？

需要先在 ChatGPT 网页端「设置 → 账户安全与登录」中打开「为 Codex 启用设备代码授权」开关，否则 OAuth 服务端会拒绝发放设备码。

令牌会自动刷新吗？

会。host 侧每分钟检查一次 access token 过期时间，剩余不足 10 分钟时用 refresh_token 自动换新（refresh_token 也会一并轮换）。

凭证存在哪里？安全吗？

access token / refresh token 只写入 DSH 凭证库（OPENAI_CODEX_API_KEY / OPENAI_CODEX_REFRESH_TOKEN），浏览器侧只收到脱敏账号与登录状态；host 进程内每分钟自动刷新，原始 token 不会返回前端。

跟 Codex CLI 同时登录会被踢下线吗？

共享同一 OAuth 会话。任一侧刷新令牌后，另一侧持有的旧 refresh_token 可能失效，此时在 Codex CLI 侧重新 codex login 即可恢复。

支持哪些模型？

由当前 DSH 版本和 OpenAI 账户权限共同决定，README 举例包括 gpt-5.4、gpt-5.5、gpt-5.6-* 等 DSH 内置的 openai-codex 系列。

怎么卸载？

通过 dsh 移除该插件即可，host 侧会自动撤销凭证（unset 凭证库两条 key 并取消 settings 中的 apiKeyEnv 引用），重启后供应商分区消失。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.6
• Node: >=22

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则