Introduction

DeepSeek Harness (DSH) adopts a plugin-based architecture, aiming to extend its functionality through plugins. When using DSH for Claude model inference, developers usually need to manually obtain and refresh API keys or tokens. The grloper/dsh-claude-oauth plugin addresses this pain point by integrating the Claude Pro/Max OAuth authentication flow directly into DSH’s Web settings interface. It supports sign-in with a Google/Gmail account and automatically handles token refresh, model discovery, and quota tracking.

Plugin Overview

grloper/dsh-claude-oauth is a model inference plugin. It provides Claude OAuth model provider support for DeepSeek Harness. This plugin is maintained by user grloper and is released under the MIT License.

Core Features

  1. One-click sign-in via Web UI: Provides a dedicated Claude entry point in DSH’s Web settings, allowing OAuth authentication directly with a Google or Gmail account without manual terminal operation.
  2. Zero terminal configuration: No need to manually copy token strings or edit YAML configuration files; all authentication state is managed by the plugin in the background.
  3. Dual-stack PKCE OAuth engine: Supports IPv4 and IPv6 loopback addresses, avoiding local loopback resolution issues in Windows environments.
  4. Multi-storage credential synchronization: After successful authentication, tokens are automatically synchronized to ~/.claude/.credentials.json (shared with the official Claude Code CLI) and ~/.dsh/.credentials.yaml.
  5. Real-time quota and model monitoring: Displays 5-hour and 7-day subscription usage bars and reset countdowns in the settings interface and chat sidebar; queries the /v1/models endpoint in real time and automatically mounts the latest Claude models.

Installation and Activation

Before installing, make sure the current DSH process is using the Web profile and that the system environment meets Node.js >= 20.

dsh plugin --profile web add github:grloper/dsh-claude-oauth

After installation, start the DSH Web GUI.

Typical Usage

  1. Start the Web interface
    dsh web

  1. Authenticate

    • Click the gear icon in the left sidebar to open Settings.
    • Select the Claude option from the navigation list (located next to Antigravity and Codex).
    • Click the “Sign in with Google / Gmail” button.
    • In the browser window that appears, select your Google account and click Authorize.
    • After successful authentication, the settings page will display “Claude Connected” and show your current email address, subscription tier (CLAUDE PRO/MAX), and real-time quota.

  2. Set the default model
    To set Claude Sonnet 4.5 as the default model, edit the configuration file ~/.dsh/settings.yaml:

    agent-default-model:
      provider: anthropic
      model: claude-sonnet-4-5
  1. Optional: command-line authentication
    You can also run the built-in script directly in the terminal to authenticate:
    claude-oauth-login
    # or use npx
    npx dsh-claude-oauth

Notes

  • Environment dependency: The plugin requires Node.js version >= 20 to run.
  • License: This project is released under the MIT License. You can view the source code and details on GitHub.
  • Ecosystem context: DSH emphasizes its plugin ecosystem. This plugin is a community contribution and has no direct affiliation with DeepSeek or the official Huanfang team; it is recommended to review the source code and license before installing.

Conclusion

This plugin simplifies the process of integrating Claude into DSH through the OAuth protocol, providing automated token management and quota monitoring. For developers who frequently switch models or use Claude Pro/Max services in a DSH environment, the plugin can effectively reduce configuration overhead and improve usage efficiency.