前言¶

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