Foreword¶
The philosophy of DSH is “everything is a plugin,” and the integration of model providers can also be implemented as plugins. dsh-codex-provider solves a specific problem: integrating OpenAI Codex into the DeepSeek Harness (DSH) web settings via device code OAuth login, eliminating the need for an OpenAI API Key. It uses ChatGPT Plus / Pro subscription quotas to call DSH’s built-in openai-codex model routing.
What Is This¶
dsh-codex-provider is a DSH community plugin authored by Hu9956, licensed under MIT.
It is an unofficial community-maintained plugin, with no affiliation or endorsement from OpenAI, DeepSeek, or DeepSeek Harness official. The DSH community directory is an independent site, with no official affiliation to DeepSeek /幻方 (High-Flyer), and is not equivalent to an official app store.
The primary function of this plugin is to add a provider entry in DSH. After completing device code authorization for an OpenAI account, it activates DSH’s built-in openai-codex model routing, allowing users to use Codex models in the model selector.
Core Features¶
- Device code OAuth login, no OpenAI API Key required.
- Imports local Codex CLI login state, corresponding to the path
~/.codex/auth.json. - Automatic refresh and rotation of
access token/refresh token. - Provides a “Settings → Providers” management interface, displaying login status, account, plan, token expiration time, and supporting logout.
- Activates DSH’s built-in
openai-codexmodel routing.
Installation and Activation¶
The current version requires DSH >= 0.1.0-rc.6 and is verified against @deepseek-ai/dsh 0.1.0-rc.6 and Node.js 22.
First, install the plugin:
dsh plugin --profile web add dsh-codex-provider
Alternatively, you can install the current source version using the GitHub repository address:
dsh plugin --profile web add github:Hu9956/dsh-codex-provider
After installation, restart the dsh web service and refresh the page. Check the entry in “Settings → Providers.”
Typical Usage¶
-
Before logging in, go to “Settings → Account Security and Login” on the ChatGPT web interface and enable the “Enable Device Code Authorization for Codex” switch.
-
Open DSH’s “Settings → Providers” and click “Log in with OpenAI Account.”
-
Copy the device code displayed on the page, follow the prompts to enter it, and complete the authorization.
-
After successful login, select a Codex model in the model selector, such as
gpt-5.4, to start using it. -
It is recommended to return to the ChatGPT web interface after login and disable the device code authorization switch.
If you already have Codex CLI login state locally, you can also import the login information from ~/.codex/auth.json.
Applicable Scenarios and Notes¶
This plugin is suitable for developers who already have a ChatGPT Plus / Pro subscription, want to use Codex models on the DSH web interface, and prefer not to use an OpenAI API Key.
Before use, please note:
- This plugin will be added to the DSH plugin runtime environment and run with the current
dshprocess permissions; you should review the source code and MIT license before installation. - It shares the same OAuth session with Codex CLI; refreshing the token on one side may invalidate the old
refresh tokenon the other side. - Available models are determined by the current DSH version and OpenAI account permissions.
access tokenandrefresh tokenare only written to the DSH credential store; the browser only receives sanitized account information and login status.- Do not disclose the device code, OAuth token,
~/.dsh/.credentials.yaml, or~/.codex/auth.jsoncontent. - This plugin consumes ChatGPT Plus / Pro subscription quotas, not OpenAI API billing.
Conclusion¶
The value of dsh-codex-provider lies in integrating OpenAI Codex’s device code OAuth, token refresh, and provider state management into DSH’s web settings, allowing developers to directly use the openai-codex routing in the model selector.
The materials reviewed did not provide an independent directory page address; the GitHub repository address is as follows:
https://github.com/Hu9956/dsh-codex-provider