Codex Switch
English | 中文
Multi-account Codex for DeepSeek Harness, powered by your ChatGPT subscription.
What it does
- Connects ChatGPT accounts with OAuth.
- Shows each account's 5-hour and weekly limits, and the reset time of every window that has started.
- Redeems banked rate-limit resets granted by OpenAI, right from the account card.
- Warms up an account on request, to start a window that has not run yet.
- Switches accounts manually or automatically.
- Adds Codex models to the Harness model picker.
- Optionally enables Codex search and
view_image.
Install
dsh plugin --profile web add dsh-codex-switch@alpha
dsh web
For pnpm 9:
dsh plugin --profile web add -w --config.auto-install-peers=false dsh-codex-switch@alpha
Set up
- Open Settings → Plugins → Plugin configuration → Codex Switch.
- Select Sign in with ChatGPT and add your accounts.
- Choose Manual or Automatic, then select a Codex model.
| Mode | Behavior |
|---|
| Manual | You choose the Current account. |
| Automatic | Codex Switch uses Available accounts by Account order. |
Search and view_image are disabled by default. Codex Switch does not change your default model or global search provider.
Quota windows
Codex Switch treats remaining capacity and reset lifecycle as separate facts. A zero-use 5-hour window shows Starts after first use rather than a meaningless countdown. The weekly lifecycle is independent: a stable weekly reset can keep counting down even while the 5-hour window is idle or visually full. Moving full-window projections are never presented as reset anchors. If OpenAI reports usage without a usable reset time, the card says Reset time unavailable.
Warm up reads that account's authorized Codex model list, then sends one minimal request for the core pool and each eligible additional model pool that still needs activation. It consumes a small amount of that account's quota, so it asks for confirmation and never runs on its own — not on refresh, sign-in, automatic switching, or background polling. Acceptance is not proof activation succeeded: Codex Switch re-reads usage, and keeps offering an explicit retry until positive use and at least five elapsed minutes prove the relevant window is running.
Commands
dsh plugin --profile web exec dsh-codex-switch status
dsh plugin --profile web exec dsh-codex-switch doctor
dsh plugin --profile web exec dsh-codex-switch accounts list
Credentials are stored under $DSH_HOME/openai-codex/credentials/. Removing the plugin does not delete them; use Sign out to remove an account.
ChatGPT subscription access is not an OpenAI API key. Available models and limits are controlled by OpenAI.
Development
pnpm install --frozen-lockfile
pnpm run check
License
Apache-2.0. Codex Switch is maintained by CHAKEW and retains upstream work by Frank Song and Yan-Zero. Third-party notices and modification history are documented in NOTICE and MODIFICATIONS.md.
