DeepSeek Harness : ce qui est disponible et comment l’installer

Publié sur npm le 13 août 2026, le même jour que V4-Pro est passé en disponibilité générale, DeepSeek Harness (DSH) est le harness d’agent de code conçu pour V4-Pro et V4-Flash. Le package à installer est @deepseek-ai/dsh : il s’appuie sur une clé API DeepSeek classique, se met en route en quatre étapes et s’accompagne d’un système de plugins. Attention toutefois à un piège de nommage : un package Python sans aucun lien, baptisé deepseek-harness, est présent sur PyPI depuis mai et fournit lui aussi une commande dsh. Ce ne sont pas le même outil.

À quoi sert DeepSeek Harness (DSH) ?

Un harness d’agent de code encadre le modèle : il choisit le contexte à transmettre, gère les erreurs d’outils, réévalue le plan lorsque nécessaire et détermine quand une tâche est terminée. À modèle identique, les résultats de benchmark peuvent varier selon la configuration du harness. C’est pourquoi DeepSeek publie les réglages du harness avec ses évaluations d’agents, plutôt que de présenter de simples scores de modèle.

Quelques équivalents connus : Claude Code sert de harness aux modèles Claude d’Anthropic, Cursor rassemble plusieurs fournisseurs dans un IDE, et GitHub Copilot joue ce rôle pour les modèles OpenAI dans VS Code. L’agent naît de l’association d’un modèle et d’un harness : au lieu de répondre à une requête isolée, il peut modifier des fichiers, lancer des commandes et appeler des API. DSH remplit cette fonction pour V4-Pro et V4-Flash.

DSH est le harness officiel de DeepSeek pour V4-Pro et V4-Flash, de la même façon que Claude Code est pensé pour Sonnet et Opus. Le changelog de la bêta V4-Flash du 31 juillet l’a mentionné publiquement pour la première fois : les benchmarks d’agents y étaient réalisés avec « DeepSeek Harness minimal mode (to be released soon) », un effort réglé sur max, top_p=0.95 et temperature=1.0.

Le « minimal mode » correspond à une configuration dépouillée : effort de raisonnement maximal et paramètres d’échantillonnage fixes. L’objectif est de rendre les benchmarks d’agents reproductibles, au lieu d’optimiser les réglages pour chaque test. Le produit complet, notamment avec le système de plugins évoqué dans les retours de bêta, va donc au-delà du simple exécuteur ayant produit les scores publiés.

V4-Pro comme V4-Flash proposent une fenêtre de contexte de 1M tokens et trois niveaux d’effort de raisonnement : low pour les tâches simples, high pour le travail d’agent courant et max pour les tâches complexes (changelog officiel, entrée du 13 août).

Installer @deepseek-ai/dsh

Node.js 18 ou une version plus récente est requis, soit le même prérequis que celui indiqué dans le guide officiel d’intégration à Claude Code de DeepSeek.

1. Vérifiez votre version de Node : node --version (18+ requis ; sur macOS, utilisez brew install node s’il n’est pas installé).
2. Installez le package globalement : npm install -g @deepseek-ai/dsh.
3. Définissez votre clé : export DEEPSEEK_API_KEY=<your key>, récupérée depuis la plateforme DeepSeek.
4. Lancez DSH : cd /path/to/my-project && dsh.

Les erreurs de permission lors d’une installation npm globale sont fréquentes sous macOS. La solution recommandée par npm consiste à définir un préfixe global accessible en écriture par l’utilisateur (npm config set prefix ~/.npm-global). sudo fonctionne aussi, mais peut entraîner des conflits de droits lors des futures mises à jour de packages.

Aucun tarif distinct n’a été annoncé pour le logiciel de harness lui-même. En revanche, la tarification de l’API des modèles évolue le 16 août à 16:00 UTC : la famille V4 passera à une grille heures pleines/heures creuses, le tarif hors pointe correspondant à la moitié du tarif de pointe (changelog officiel).

Benchmarks de V4-Pro GA : le rôle du harness

Voici les chiffres officiels publiés par DeepSeek dans son entrée de changelog du 13 août. Tous ont été obtenus avec la configuration de harness décrite plus haut :

V4-Pro devance Flash de 0.5 à 8.3 points sur ces benchmarks. Les écarts les plus marqués concernent DeepSWE (+8.3) et NL2Repo (+7.3). Le chiffre phare est le 87.9 obtenu sur Terminal Bench 2.1. Une reproduction indépendante avec un harness public sur r/LocalLLaMA a placé Flash 0731 à 82.7 sur 445 essais, ce qui correspond à l’affirmation de DeepSeek dans les marges de variation liées à la configuration. DSBench-FullStack et DSBench-Hard étant des jeux d’évaluation internes, les deux lignes correspondantes reposent sur les propres mesures de DeepSeek.

Tous les benchmarks publiés ont été exécutés avec l’effort max. Pour un usage en production, DeepSeek recommande low pour les tâches simples, high pour le travail d’agent habituel et max pour les tâches complexes.

@deepseek-ai/dsh ou pip install deepseek-harness ?

Ces deux packages aux noms presque identiques sont sortis à plusieurs mois d’intervalle. Ils n’ont aucun lien entre eux.

Le projet PyPI est une bibliothèque d’adaptation de protocole, pas un agent de code. Son auteur a documenté 16 comportements de l’API V4 sur plus de 270 essais, puis les a formalisés dans un contrat de 10 règles disponible sous quatre formes : bibliothèque Python, CLI dsh, serveur MCP et Anthropic Skill. Les trois constats les plus susceptibles de poser problème lors d’un développement sur V4 sont les suivants :

• Les boucles d’outils multi-tours renvoient HTTP 400 si reasoning_content n’est pas conservé dans les messages assistant — reproduit 3/3 sur les deux modèles.
• L’endpoint /beta remappe silencieusement v4-pro vers deepseek-reasoner.
• Les cache hits semblent arriver par blocs de 256 tokens après un préfixe de 1,024 tokens ; une boucle de cinq tours a atteint un équilibre de 95 %, réduisant le coût effectif d’entrée d’environ 50x.

La principale source de confusion vient du fait que les deux packages fournissent une commande dsh. Une installation via pip vous donne la bibliothèque d’adaptation. Une installation via npm, sous le scope @deepseek-ai, vous donne le harness.

Utiliser DeepSeek V4 comme agent de code sans DSH

Si vous voulez un agent de code propulsé par DeepSeek avant que la documentation de DSH ne se stabilise, le guide d’intégration officiel de DeepSeek présente trois options prises en charge :

La configuration de Claude Code associe les modèles DeepSeek aux emplacements de modèles de Claude Code :

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

Une particularité de ce mapping : les requêtes visant claude-sonnet sont résolues vers Flash, et non Pro. La documentation de DeepSeek affecte Pro à l’emplacement Opus et Flash à l’emplacement Haiku. Les trois outils sont documentés comme des intégrations tierces, dont DeepSeek ne garantit ni l’efficacité ni la sécurité. Pour une comparaison plus large, consultez notre comparatif des LLM pour agents de code et le guide API de V4-Pro GA.

FAQ

@deepseek-ai/dsh est-il bien le DeepSeek Harness officiel ?

Le scope npm @deepseek-ai correspond à l’organisation GitHub de DeepSeek, et la date de publication correspond au calendrier annoncé dans le changelog du 31 juillet. Des publications de la communauté confirment que le package s’installe. Le changelog de DeepSeek du 13 août documente la disponibilité générale de V4-Pro, sans nommer le harness, et npm empêche la vérification automatisée de la page du package.

Quelle différence entre DSH et deepseek-harness sur PyPI ?

Il s’agit de produits distincts, maintenus par des personnes différentes. @deepseek-ai/dsh est le harness d’agent de code disponible sur npm depuis le 13 août. pip install deepseek-harness installe une bibliothèque Python indépendante d’adaptation de protocole, créée par Henry Zhang (MIT, 9 mai), qui gère les particularités de l’API V4. Les deux fournissent une commande dsh.

Une clé API DeepSeek est-elle nécessaire pour utiliser DSH ?

Oui. Le harness fonctionne avec V4-Pro et V4-Flash via l’API DeepSeek ; l’usage est donc facturé au token. Le package npm s’installe gratuitement, le coût vient de la consommation de l’API. La tarification de la famille V4 bascule vers un système heures pleines/heures creuses le 16 août à 16:00 UTC, le tarif hors pointe correspondant à la moitié du tarif de pointe.

Comment DSH se compare-t-il à Claude Code ?

Claude Code est un agent de code mature et documenté pour le terminal, qui fonctionne déjà avec DeepSeek via l’endpoint compatible Anthropic. DSH mise sur une optimisation spécifique au modèle : un harness construit autour du comportement de protocole de V4 plutôt qu’adapté à celui-ci. L’avantage paraît plausible au vu des réglages de benchmark divulgués, mais il reste à démontrer en usage indépendant, le temps que la documentation de DSH et les tests de la communauté rattrapent leur retard.

Quelle est la différence entre un harness IA et un agent IA ?

Le harness est la couche d’infrastructure : gestion du contexte, routage des outils et orchestration des tâches. L’agent est le système complet, c’est-à-dire un modèle exécuté dans un harness et capable d’actions en plusieurs étapes. Chaque agent a besoin d’un harness, mais un même harness peut servir différents modèles. Claude Code, Cursor, Copilot et DSH sont tous des harnesses ; ils deviennent des « agents » par le modèle qui les alimente.

Statut de la sortie : faits confirmés et informations communautaires

Les informations de cet article reposent sur deux niveaux de sources.

Confirmé officiellement (changelog de l’API DeepSeek, entrées datées) :

• deepseek-v4-pro est passé en disponibilité générale le 13 août, avec prise en charge native de l’OpenAI Responses API et trois niveaux d’effort de raisonnement (changelog).
• V4-Flash est entré en bêta publique le 31 juillet, avec des benchmarks réalisés en « DeepSeek Harness minimal mode (to be released soon). »
• Tous les résultats publiés pour V4-Pro GA et V4-Flash bêta proviennent de ces entrées de changelog.
• La tarification de la famille V4 bascule vers des tarifs heures pleines/heures creuses le 16 août à 16:00 UTC.
• Le guide d’intégration Claude Code, OpenCode et OpenClaw est une documentation officielle.

Rapporté par la communauté (publications Reddit, captures d’écran reproduites) :

• @deepseek-ai/dsh peut être installé et fonctionne. u/Testx01 a publié le lien vers le package à 12:56 UTC le 13 août ; u/Available_Yam_6267 a suivi quelques minutes plus tard. Le scope npm @deepseek-ai correspond à l’organisation GitHub de DeepSeek.
• La page du package npm bloque les requêtes automatisées : la version, la licence et les métadonnées de mainteneur ne sont donc pas confirmées via le registre.

« Deepseek harness is out on npm :) » — u/Testx01, r/DeepSeek, 13 août

• Un message de bêta interne reproduit évoque un groupe de bêta de 369 membres, qui aurait livré une version interne finale le 11 août. Les développeurs de plugins auraient été invités à étiqueter leurs dépôts avec #dsh avant la bêta publique du 13 août ; après le lancement, les plugins pourraient être transférés vers des comptes individuels.
• Des informations communautaires, citant la presse technologique chinoise en mai, indiquaient que DeepSeek constituait une équipe dédiée aux harnesses et recrutait pour des postes produit Agent Harness.

Considérez les affirmations relatives aux fonctionnalités, à la CLI et aux plugins de DSH comme confirmées par la communauté, jusqu’à ce que DeepSeek publie une documentation officielle sur son propre site.