Introduction

DeepSeek Harness (DSH) adopts an “everything is a plugin” architecture. When developers use consumer subscriptions (such as Claude Pro, ChatGPT Plus, or Grok), they typically have to manually handle API keys or complex authentication flows. The dsh-plugin-subs plugin uses the OAuth flow to connect existing consumer subscriptions directly as local LLM providers, eliminating the need to manually generate an API key.

Plugin Overview

dsh-plugin-subs is a plugin maintained by randomix777, classified under model inference, with an MIT license. It primarily addresses the following problem: how to use existing consumer subscription services for model inference in DSH without directly requesting a developer API key.

Core Features

  • OAuth Login: Supports direct login to subscription providers through OAuth authorization, without manual API key configuration.
  • Model Resolution: Parses the list of models available to Composer directly from the subscription.
  • Feature Support: Supports streaming output, tool calling (Tool Calling), and image input (depending on provider support).
  • Status Monitoring: Displays usage status in the Subscriptions settings section.
  • Catalog Management: Includes built-in model catalogs for each provider and supports overrides in configuration.

Installation and Enablement

Installing this plugin requires no compilation steps; use the official command directly:

dsh plugin --profile web add dsh-plugin-subs

After installation, the plugin will automatically register with DSH’s plugin system.

Typical Usage

  1. Start DSH: Run dsh web and open the URL printed in the terminal.
  2. Access Settings: Navigate to Settings → Subscriptions in the web interface.
  3. Connect a Provider: Click the Connect button next to the target service (such as Claude, Codex, Grok, etc.).
  4. Complete Authentication:
    • Complete the OAuth authorization flow in the browser tab.
    • In a headless environment, manually paste the callback URL or authorization code.
    • Note: Agnes AI requires manually pasting the callback URL (DSH does not support the agnes:// protocol).
  5. Select a Model: In any chat interface, open the model selector (/model) and choose a model from the list of logged-in providers.

Applicable Scenarios and Considerations

Applicable Scenarios

This plugin is suitable for DSH users who want to use existing consumer subscriptions (such as ChatGPT Plus, Claude Pro, Grok, etc.) directly for model calls, especially in scenarios where reducing the complexity of API key management is desired.

Considerations

  • Visibility: Providers that you have not logged in to will not display cards in the model selector.
  • Subscription Dependency: Provider availability depends on your subscription status.
  • Image Generation: Requires active session support from Codex or Grok.
  • Tool Limitations: The x_search (search) tool requires Grok login and a subscription tier with API access.
  • OpenRouter: Its API key remains valid indefinitely (there is no refresh mechanism); to change the key, log out and log in again.
  • Configuration for Chinese Providers:
    • iFlytek Spark and Baidu ERNIE require registering OAuth applications on their respective platforms and configuring environment variables (SPARK_CLIENT_ID, SPARK_CLIENT_SECRET, etc.).
  • Qwen Code Flow: Uses Device Flow authentication; you need to enter the user code in the verification URL. The flow can be canceled and will expire.

Short Conclusion

dsh-plugin-subs enables seamless integration from consumer subscriptions to LLM providers and simplifies the configuration process. For more technical details and source code, refer to the GitHub repository.