WSL043/dsh-codex-subscription

简体中文

Sign in to ChatGPT and use a Codex subscription directly in DeepSeek Harness. No OpenAI API key or Codex CLI installation is required. DSH conversations, tools, permissions, search choice, and quota stay in one place.

Agent install · Windows install · Update or uninstall

Choose a Codex model and chat directly in DSH. When the Beta quota display is enabled, the composer shows the selected model's remaining quota.

What it does

• Uses your ChatGPT / Codex subscription directly inside DSH, with no OpenAI API key or Codex CLI required;
• Signs in to ChatGPT from Settings and keeps credentials on the host;
• Switches between DSH's default search and Codex subscription search;
• Shows the quota, reset time, and freshness actually returned by the backend;
• Can show the selected Codex model's remaining quota before the model name (Beta, off by default);
• Keeps Codex-Spark, Credits, and other independent limits separate;
• Fails visibly when subscription routing is unavailable instead of silently using another paid route.

Prepare DSH

This plugin supports DeepSeek Harness 0.1.0-rc.6 and requires a ChatGPT account that currently has Codex access.

• Do not want to configure Node.js? Use the community DSH-Portable package.
• Prefer the official route? Follow the DeepSeek Harness run guide.

If DSH already opens normally, continue with the plugin installation below.

Install

Let an Agent install it (recommended)

Send the following URL directly to your Agent. The guide contains install, update, uninstall, and verification steps. It preserves the DSH profile and sign-in and never restarts DSH without permission:

Open the Agent installation guide

https://raw.githubusercontent.com/WSL043/dsh-codex-subscription/main/AGENTS.md

Manual Windows install

Open PowerShell and paste these two lines in order. They support both a normal DSH install and DSH-Portable. Portable users do not need a system Node.js or pnpm.

curl.exe -fL https://github.com/WSL043/dsh-codex-subscription/releases/latest/download/dsh-codex.ps1 -o "$env:TEMP\dsh-codex.ps1"
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\dsh-codex.ps1" Install

Bypass applies only to this child process and does not change the system PowerShell execution policy.

The commands support both a normal DSH installation and DSH-Portable. Portable users do not need a separate Node.js or pnpm installation, and no administrator access is required. The installer finds DSH, verifies the result, and adds the per-user dsh-codex command. It does not change the system execution policy or restart DSH on its own.

If the portable folder was renamed or moved, start the intended DSH-Portable copy once and install again. Restart DSH manually after installation.

dsh plugin --profile web add https://github.com/WSL043/dsh-codex-subscription/releases/download/v0.2.8/dsh-codex-subscription.tgz
dsh plugin --profile web list dsh-codex-subscription --depth 0
dsh --profile web --dump-config

The plugin list should contain one dsh-codex-subscription, and the config should contain one codex-subscription entry.

Sign in and use

1. Open Settings -> Codex in DSH.
2. Sign in with a ChatGPT account that has Codex access.
3. Choose DSH default search or Codex subscription search.
4. Choose a Codex model from the model selector.

Codex subscription search reuses the same ChatGPT sign-in and does not need an OpenAI API key. Changing the search source does not change the conversation model, and a failed source never silently falls back to another paid service. Existing DSH search remains the default after an upgrade; opt in to Codex subscription search when wanted.

How quota is shown

• Settings always shows the detailed quota returned by the backend. The compact percentage is Beta and off by default;
• When enabled, it appears inside the composer before the model name and only while a Codex model is selected;
• Standard Codex models use the lowest remaining standard Codex window, avoiding an overly optimistic number;
• A selected Spark model uses the separate Spark quota returned by the backend;
• Only windows actually returned by the backend are shown; there is no hard-coded “5-hour + weekly” layout;
• If the account currently reports only weekly usage, no 5-hour window is invented; it appears automatically if the backend restores it;
• Independent Codex-Spark limits are not merged into standard Codex quota;
• Credits and monthly spending caps appear only when the account or workspace actually returns them;
• Percentages describe usage status, not billing amounts or billing guarantees.

Update and uninstall

Windows installer users only need these short commands:

Action	PowerShell command
Update	dsh-codex update
Uninstall	dsh-codex uninstall

Update verifies the latest Release manager script with SHA-256. Uninstall removes the plugin and dsh-codex command while preserving the DSH profile, unrelated plugins, and saved sign-in. If an older installation has no short command, run the two Windows first-install commands above once.

Update and verify:

dsh plugin --profile web add https://github.com/WSL043/dsh-codex-subscription/releases/download/v0.2.8/dsh-codex-subscription.tgz
dsh plugin --profile web list dsh-codex-subscription --depth 0
dsh --profile web --dump-config

Uninstall:

dsh plugin --profile web remove dsh-codex-subscription

When updating manually from v0.2.1, remove the old package name only after the new package installs successfully:

dsh plugin --profile web remove @wsl043/dsh-codex-subscription

If DSH is running, restart it manually after installation or update.

Troubleshooting

• If dsh-codex is not found after installation, close and reopen PowerShell;
• If DSH-Portable is not found, start the intended portable copy once and retry;
• If curl.exe is missing, more than one DSH is present, or the command still fails, send the Agent guide URL above to an Agent. Do not change the machine PATH or execution policy, and do not delete a profile to force an install.

Boundaries and support

• This package connects a ChatGPT subscription; it does not create an OpenAI API key;
• The ChatGPT Codex backend and DeepSeek Harness can change independently;
• This is a community project with no affiliation or endorsement from DeepSeek or OpenAI.

Use GitHub Issues for project feedback. For general DSH plugin discussion, visit DeepSeek Harness Discussions. Read SECURITY.md before reporting sensitive issues.

MIT