Preface

When integrating Codex into DeepSeek Harness (DSH), the common approach is to prepare an OpenAI API Key or additionally install the Codex CLI as a bridge. If you already have a ChatGPT/Codex subscription and prefer to keep the quota, search, and image capabilities within the DSH session, you need an integration path that does not rely on an API Key.

Below, we introduce the community plugin dsh-codex-subscription (maintained by WSL043, GitHub repository WSL043/dsh-codex-subscription). It completes an independent OAuth login within DSH, integrating the subscription model, real quota, search routing, and image generation into a single interface, without requiring an OpenAI API Key or the Codex CLI.

What Is This

dsh-codex-subscription is a model inference plugin for DeepSeek Harness. Its npm package name is also dsh-codex-subscription, currently at version v1.9.0, and it uses the MIT license. The plugin is categorized under “Model Inference” in the SkillHub Community Directory; as of writing, GitHub shows 22 stars and 3 forks.

Its positioning is straightforward: use your existing ChatGPT account (which must currently have Codex access) to log in within DSH, then select the Codex series like choosing a regular model, and view the quota, select search sources, switch to Fast mode, etc., in the settings page. If the subscription route fails, it will explicitly report an error and will not silently switch to another paid channel.

The official README states that the plugin is compatible with DeepSeek Harness 0.1.1-rc.2 and earlier versions; before use, please confirm that your local DSH version matches the plugin’s compatibility.json.

Core Features

The following capabilities are derived from the repository’s README and package.json description, summarized by usage path.

Subscription Login and Models

  • Saves credentials locally on the host machine via ChatGPT OAuth; the settings page provides browser login, requiring no token pasting or Codex CLI.
  • After logging in, you can select Codex subscription models in the conversation; supports switching between Standard and Fast modes (operated within the composer).
  • The context window can be set according to the model catalog’s default values, each model’s supported Extended window, or individually filled with a complete token limit for each model; Custom mode validates model capacity and integrates with DSH’s native agent compaction strategy.

Quota and Reset

  • Displays the real quota returned by the backend, with limits for standard Codex, Codex-Spark, Credits, etc., shown separately.
  • Allows viewing the next expiration time and reset count; to reset in advance, confirmation and a cooldown period are required, and it will not automatically retry.
  • Within the composer, you can choose a compact percentage, progress bar, or hide quota display (default is off).

Search and Images

  • The global search route can be explicitly chosen between “DSH Default Search” and “Logged-in Codex Subscription Search,” applying to all models and sessions, and does not change with the currently selected model.
  • Supports Codex image generation and editing (Beta): can generate without a reference image, or select an image and annotate a region for editing; supports preview, zoom, downloading the original image, and continuing the conversation in the same composer.

Diagnostics and Support

  • The login state is automatically reconciled; the settings page can generate a support report without credentials or account identifiers, including information such as bounded request phases, HTTP/transport types, time intervals, and route sources, aiding in troubleshooting subscription routing issues.

Installation and Activation

Before installation, please read the repository’s source code and MIT license. DSH plugins run with the current dsh process permissions, and the installation command will modify the plugin list under the profile.

Existing dsh Command

If a global dsh (including the standard plugin command for DSH-Portable) is configured locally, execute:

dsh plugin --profile web add dsh-codex-subscription

To verify successful installation:

dsh plugin --profile web list dsh-codex-subscription --depth 0
dsh --profile web --dump-config

The plugin list should show a dsh-codex-subscription entry, and the configuration should have a codex-subscription entry.

Official npm Route (Node.js Installed)

If launching via npx @deepseek-ai/dsh web without a global dsh command, you need to retain the full npx prefix and lock the DSH version compatible with the plugin:

npx -y @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add dsh-codex-subscription
npx -y @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web list dsh-codex-subscription --depth 0
npx -y @deepseek-ai/dsh@0.1.1-rc.2 --profile web --dump-config

Windows One-Click Script

On Windows, you can also run the official release script in PowerShell. The script detects the current directory, system commands, common installation locations, and running official DSH or DSH-Portable, and prompts before installing if multiple candidate targets are found:

irm 'https://github.com/WSL043/dsh-codex-subscription/releases/latest/download/dsh-codex-setup.ps1' | iex

Post-Installation Activation

After installation, manually restart DSH, then follow the three-step process in the README:

  1. Open Settings → Codex.
  2. Complete browser login using a ChatGPT account with Codex access.
  3. Select a search source and choose a Codex model from the model list.

If you want an Agent to handle installation, updates, or uninstallation, the repository provides AGENTS.md guidance, which includes verification steps and requires preserving existing DSH profiles, login states, and other plugins.

When you prefer not to configure Node.js yourself, the README suggests considering the community portable distribution DSH-Portable; for the official route, refer to the DeepSeek Harness Run Guide.

Typical Usage

After completing installation and login, the daily workflow is similar to using DSH’s built-in models, with the main differences in Codex-related settings.

Select Model and Mode. Choose a Codex subscription model in the composer’s model selector; for supported models, switch between Standard and Fast modes.

Configure Search. In Settings → Codex, decide whether global search uses DSH’s default search or Codex subscription search. This option applies to all sessions and does not change with the model selection in a single conversation.

View and Manage Quota. In the same settings page, view each individual limit and expiration time; when needed, attempt quota reset per the interface prompts (with confirmation and cooldown). If you want to see the quota in the conversation interface, enable percentage or progress bar display in the settings.

Image Generation and Editing (Beta). Under a Codex model that supports this capability, you can initiate generation without a reference image, or select an image, annotate a region, and continue editing, seamlessly continuing the conversation in the same composer.

Troubleshooting. If login or routing is abnormal, you can export a support report from the settings page, compare the request phases and route source types in it to locate the issue, or submit an issue through the feedback link in the README.

Use Cases and Notes

Who Is It For

  • Those who already have a ChatGPT/Codex subscription and want to use subscription quota directly in the DSH agent workflow, without maintaining an OpenAI API Key.
  • Those who need to distinguish between standard Codex, Spark, Credits, etc., in DSH and want to see real backend quota in the interface rather than estimated values.
  • Those who want search, images, Fast mode, and model context settings all completed within the same DSH UI.

Pre-Use Notes

  • The account must currently have Codex access; the plugin does not enable subscriptions for you.
  • The plugin has a corresponding DSH version; the README uses 0.1.1-rc.2 as the compatibility baseline, and it is recommended to check compatibility.json before upgrading either side.
  • Installation, updates, and uninstallation modify the plugin configuration under the web profile; when multiple people share a machine, confirm the profile path.
  • SkillHub is a community plugin directory independent of DeepSeek / High-Flyer, not an official app store; plugin quality and maintenance rhythm depend on the repository and maintainer.

Conclusion

dsh-codex-subscription connects ChatGPT/Codex subscriptions to DSH’s OAuth, model selection, quota display, search routing, and image capabilities, eliminating the extra configuration of API Keys and the Codex CLI. If you are looking for a subscription-based Codex integration solution within the DSH ecosystem, you can read the complete documentation from the community directory page or GitHub repository and try it out.