前言¶

DeepSeek Harness（DSH）强调“一切皆插件”。如果希望在 DSH 中直接使用 ChatGPT Plus/Pro Codex models，而不是接入通用 OpenAI Platform API key，eons2long/dsh-codex-oauth 提供了一个较直接的方案：通过 OpenAI 的 Codex OAuth flow 登录，并在 DSH 模型选择器中使用 openai-codex。

下面介绍它的定位、核心能力、安装方式与典型命令。

这是什么¶

dsh-codex-oauth 是 eons2long 维护的独立 DSH 插件，用于在 DSH 中通过 standalone OAuth 使用 ChatGPT Codex 订阅。它面向的是 ChatGPT Codex backend，不是一般意义的 OpenAI Platform API-key adapter。

该插件提供独立的凭证文件和登录流程，支持 automatic token refresh、Codex model catalog，以及 DSH 中的 Web UI 与 CLI 登录入口。许可证为 MIT。

核心能力¶

已核实能力包括：

• 通过 OpenAI 的 Codex OAuth flow 使用 ChatGPT Plus/Pro Codex models
• 支持 streaming
• 支持 tool calls
• 支持 reasoning
• 支持 images
• 支持 replay
• 支持 compaction
• 支持 automatic token refresh
• 支持 Codex model catalog
• 使用 standalone credential file 和 login flow
• Web UI 中通过 Settings → OpenAI Codex 登录
• 提供 CLI login、status、logout 命令
• 支持 headless 机器的 device-code login
• 凭证存放在 $DSH_HOME/.openai-codex-auth.json，默认路径为 ~/.dsh/.openai-codex-auth.json
• 凭证文件使用 atomic writes，并保持 owner-only permissions
• refresh、login、logout 操作使用 cross-process file lock

安装与启用¶

先安装插件，再启动 Web 版本。

dsh plugin --profile web add dsh-codex-oauth
dsh web

如果使用 npx：

npx @deepseek-ai/dsh plugin --profile web add dsh-codex-oauth
npx @deepseek-ai/dsh web

典型用法¶

Web UI 登录¶

安装并启动后，在 DSH Web UI 中打开：

Settings → OpenAI Codex

点击 Sign in with ChatGPT。完成 OAuth 授权后，回到 DSH，在 model picker 中选择 openai-codex。

CLI 登录¶

在命令行中执行：

dsh plugin --profile web exec dsh-openai-codex login

在无可用浏览器或 headless 机器上，可以改用 device-code：

dsh plugin --profile web exec dsh-openai-codex login --device-code

查看状态和退出登录：

dsh plugin --profile web exec dsh-openai-codex status
dsh plugin --profile web exec dsh-openai-codex logout

凭证文件¶

凭证文件路径为：

$DSH_HOME/.openai-codex-auth.json

默认路径：

~/.dsh/.openai-codex-auth.json

该文件采用 atomic writes，并保持 owner-only permissions。refresh、login 和 logout 操作会使用 cross-process file lock。

插件不会读取或修改以下文件：

~/.pi/agent/auth.json
~/.codex/auth.json

适用场景与注意¶

适合在 DSH 中使用 ChatGPT Codex 订阅能力，并希望通过插件自身完成 OAuth 登录的开发者。使用它时需要注意：

• 这是 ChatGPT Codex backend，不是一般 OpenAI Platform API-key adapter
• Codex endpoints 不是 public OpenAI Platform API endpoints
• ChatGPT plan eligibility、model access、quotas 和 backend behavior 由 OpenAI 控制，并可能变化
• Filesystem、shell、MCP、permissions、attachments 以及其他 DSH capabilities 来自当前 active profile
• 插件以当前 dsh 进程权限运行；安装前应检查源码与许可证
• 若运行本地测试，npm test 需要 DSH 与 pi-ai peer dependencies，由一个 DSH profile 提供

DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不要把它理解为官方应用商店。

结尾¶

dsh-codex-oauth 的价值在于把 ChatGPT Codex 订阅接入 DSH 的插件体系：独立登录、独立凭证文件，支持 streaming、tool calls、reasoning、images、replay、compaction，并提供 Web 与 CLI 两条入口。

目录页：

https://www.skillhub.cn/plugins/eons2long/dsh-codex-oauth

GitHub：

https://github.com/eons2long/dsh-codex-oauth