SSD Nodes Learn Hosting plans →
Guides Matt ConnorPar Matt Connor

Qu’est-ce qu’un harness d’agent ?

Découvrez ce qu’est un harness d’agent : boucle, outils, permissions et état de session, et pourquoi il ne faut pas le confondre avec un modèle ou un framework.

Ce qu’est un harness d’agent

Un harness d’agent est le programme qui s’exécute autour d’un modèle de langage et le transforme en agent. Il contient la boucle qui continue d’appeler le modèle, les définitions des outils que le modèle est autorisé à appeler, les règles de permission qui déterminent lesquels de ces appels sont effectivement exécutés, l’état de session conservé entre les tours et le répertoire de travail où les opérations sont effectuées. Le modèle peut être remplacé à l’intérieur de ce dispositif.

C’est la dernière phrase qu’il faut retenir. Un modèle seul répond à une question puis vous oublie. Un harness demande au modèle quoi faire ensuite, exécute la commande demandée par le modèle, lui renvoie le résultat, puis lui pose de nouveau la question. C’est cette répétition que l’on désigne par le terme « agent ». Si le vocabulaire environnant reste flou, la différence entre un agent d’IA, un LLM et un assistant permet de clarifier les termes avant de choisir un outil.

Le harness n’est pas le modèle

Les deux sont souvent confondus parce que les éditeurs les distribuent sous une même marque.

dsh et DeepSeek sont deux produits différents. DeepSeek Harness, publié à l’adresse github.com/deepseek-ai/deepseek-harness le 13 août 2026 sous licence MIT, est un programme Node que vous installez sur une machine. Les modèles DeepSeek sont des poids servis derrière une API (interface de programmation d’applications). Pointez dsh vers un modèle d’un autre éditeur et il continue de fonctionner, car le harness a seulement besoin d’un service qui accepte des messages et renvoie des appels d’outils.

Claude Code et Claude forment le même duo. Claude Code est un harness : un programme pour le terminal avec une boucle d’exécution, un système de permissions, ainsi que des outils pour les fichiers et le shell. Claude est la famille de modèles qu’il appelle par défaut. Codex et Gemini CLI sont séparés de la même manière.

Voici le test qui permet de trancher à chaque fois. Vous installez un harness. Vous appelez un modèle. Si l’élément possède une version sur votre disque et un fichier de configuration dans votre répertoire personnel, c’est un harness. S’il s’agit d’une chaîne dans ce fichier de configuration, comme deepseek-flash, c’est le modèle.

Ce que fait réellement la boucle

Un tour de boucle du harness se déroule ainsi. Lisez cette liste attentivement : presque toutes les différences entre les harnesses se trouvent dans ces cinq étapes.

  1. Le harness envoie au modèle la conversation en cours, ainsi qu’une liste de définitions d’outils.
  2. Le modèle répond avec du texte ou demande l’appel de l’un de ces outils.
  3. Le harness vérifie cette demande par rapport à ses règles d’autorisation, puis exécute l’outil ou s’arrête pour vous demander confirmation.
  4. Le harness exécute l’outil, capture sa sortie et son code de retour, puis tronque la sortie si elle est très longue.
  5. Le harness ajoute ce résultat à la conversation, puis revient à l’étape 1.

C’est à l’étape 3 que les harnesses diffèrent le plus au quotidien. Un harness qui demande une confirmation avant chaque commande est sûr, mais épuisant. Un harness qui ne demande jamais de confirmation finira par exécuter une commande destructive sur un chemin mal identifié par le modèle. Claude Code propose un réglage intermédiaire : une allowlist de commandes exécutées sans confirmation et une invite pour les autres commandes.

Le reste des différences se trouve à l’étape 1. Le harness écrit également le system prompt transmis avec chacune de ces requêtes. Claude Code vous donne directement accès à ce réglage, car un output style modifie le system prompt qu’il envoie et change donc chaque réponse reçue. La conversation s’allonge à chaque tour et le modèle dispose d’une context window fixe. Le harness doit donc décider ce qu’il faut supprimer, résumer ou écrire dans un fichier pour le relire plus tard. Cette décision explique en grande partie pourquoi deux harnesses pilotant le même modèle produisent des résultats différents. Si ces cinq étapes restent abstraites, écrivez une fois votre propre boucle rudimentaire. C’est exactement ce que un parcours progressif pour apprendre à créer des agents IA vous fait construire dès le début.

La plupart des harnesses connectent désormais des outils externes via MCP (model context protocol), une méthode standard pour exposer un outil à tout harness compatible. Une seule intégration peut ainsi servir à plusieurs harnesses. Exécuter des serveurs MCP sur un VPS traite cet aspect. La recherche Web est généralement le premier outil ajouté. Configurer l’agent pour utiliser votre propre instance SearXNG évite d’envoyer les requêtes à un tiers et montre clairement que chaque page ensuite lue par l’agent est une entrée non fiable reçue à l’intérieur de la boucle.

Harness d’agent ou framework d’agent

Cette question revient chaque fois qu’un nouveau harness apparaît, et les réponses divergent, en partie parce que les fournisseurs ne sont pas d’accord. Voici la distinction qui reste valable.

Un framework est une bibliothèque que vous importez. Vous assemblez l’agent dans le code, en utilisant la boucle du framework ou en écrivant la vôtre. LangChain est l’exemple bien connu : vous disposez de briques et vous assemblez l’agent dans le code.

Un harness est un programme que vous exécutez. La boucle est déjà écrite, les outils existent déjà et le modèle de permissions dispose déjà d’une configuration par défaut. Vous obtenez un agent fonctionnel dès la première commande, puis vous le configurez.

Le test d’installation permet généralement de trancher. Si vous l’installez puis écrivez du code, c’est un framework. Si vous l’installez puis lui parlez, c’est un harness.

La frontière fait réellement débat, et la documentation de LangChain elle-même en fournit la preuve la plus claire. En octobre 2026, elle décrit Deep Agents comme « un harness d’agent » et aussi comme « une bibliothèque autonome construite au-dessus des briques de base de LangChain pour les agents », tandis que le dépôt langchain-ai/deepagents se décrit comme « le harness d’agent batteries incluses ». Les deux descriptions sont justes. Deep Agents est un SDK Python (kit de développement logiciel) que vous importez ; selon le test d’installation, c’est donc une bibliothèque, et il fournit suffisamment de comportement par défaut pour que les utilisateurs l’emploient comme un harness. Microsoft a annoncé la disponibilité générale de Hosted Agents dans Foundry Agent Service le 9 juillet 2026, et sa publication du 22 juillet 2026 annonce la sortie de Microsoft Agent Framework Harness, ce qui montre que le terme désigne désormais une catégorie de produits plutôt qu’un simple jargon.

Posez donc plutôt la question qui permet de prévoir votre charge de travail. Si vous écrivez la boucle, vous en êtes responsable : des nouvelles tentatives, de la réduction du contexte, des demandes d’autorisation et de l’enregistrement de ce qui s’est passé. Si la boucle est fournie, vous héritez de la réponse de quelqu’un d’autre à toutes ces questions : le démarrage est beaucoup plus rapide, mais les modifications ultérieures sont plus difficiles.

Différences entre un harness et une fenêtre de chat

Une fenêtre de chat et un harness affichent tous deux la sortie du modèle. La différence tient à l’ordinateur sur lequel le travail s’effectue. Dans une fenêtre de chat, le code exécuté par le modèle s’exécute dans le sandbox du fournisseur, sur les fichiers que vous avez téléversés. Un harness exécute les outils sur la machine depuis laquelle vous l’avez lancé, avec l’utilisateur qui l’a lancé, sur vos vrais fichiers et avec vos vrais identifiants dans son environnement.

C’est à la fois tout l’avantage et tout le risque, en deux phrases. L’agent peut enfin effectuer le travail. Il peut aussi supprimer ce travail.

Les harnesses réellement utilisés

Cette liste est datée du 19 août 2026 à dessein. La catégorie évolue chaque semaine et tout récapitulatif devient rapidement obsolète.

  • Claude Code et Codex sont des harnesses fournis par des éditeurs. Ils privilégient le terminal, sont liés par défaut aux modèles de leur éditeur et offrent la gestion des permissions la plus aboutie. Comparaison de Claude Code, Cursor, Codex et Copilot les présente en détail.
  • DeepSeek Harness (dsh) est sous licence MIT et repose sur une idée simple : tout est un plugin. Les modèles, les outils, les sessions, les sandbox et l’interface utilisateur sont donc interchangeables. Chaque plugin que vous installez s’exécute avec les permissions de l’agent. Il est donc plus important ici de vérifier ce à quoi un plugin dsh peut accéder avant de l’ajouter qu’avec un harness dont l’ensemble d’outils est fixe.
  • Hermes, développé par Nous Research, est un agent autonome généraliste plutôt qu’un outil de développement. Il est distribué sous licence MIT depuis février 2026 et son stockage intégré est local : ses mémoires et ses skills sont des fichiers sous ~/.hermes, tandis que l’historique des sessions se trouve dans une base SQLite locale. Cela ne constitue plus toute l’architecture lorsque vous activez l’un de ses fournisseurs de mémoire externes optionnels, comme Mem0 ou Hindsight. En octobre 2026, la documentation d’Hermes indique qu’un fournisseur actif reçoit chaque tour de conversation après chaque réponse, ainsi qu’un miroir de chaque écriture effectuée dans la mémoire intégrée. Vos données résident alors également chez ce fournisseur. Comparaison de Hindsight et Mem0 est à lire avant d’en activer un, et Auto-héberger Hermes sur un VPS présente la suite de la procédure.
  • Omnigent est un meta-harness : il pilote d’autres harnesses, notamment Claude Code et Codex, derrière une API unique avec des sessions partagées, des plafonds de dépenses et une sandbox au niveau du système d’exploitation. Omnigent comme harness multi-agent explique ce que cela vous apporte.
  • OneCLI est un harness isolé dans une sandbox et destiné aux équipes. Il repose sur une gateway qui injecte les identifiants dans les requêtes sortantes de l’agent, de sorte que l’agent ne voit jamais les clés réelles.

Trois de ces outils se retrouvent assez souvent dans la même sélection qu’il vaut la peine de lire DeepSeek Harness, Claude Code et Omnigent comparés pour comparer leur couplage aux modèles, leur licence, leur maturité et les ressources nécessaires à leur exécution sur un serveur.

Le démarrage rapide dsh tient en une seule commande. L’exécuter une fois est le moyen le plus rapide de comprendre ce qu’est un harness. Node.js doit être installé sur la machine.

npx @deepseek-ai/dsh web

Cette commande démarre l’interface web sur http://127.0.0.1:3080. Lisez le README avant de vous y fier, car dsh se présente comme une developer preview et indique clairement que des changements incompatibles sont à prévoir. Si cette première commande échoue immédiatement ou récupère un build inattendu, figer une version exacte de dsh et vider le cache npx permet généralement de reprendre la procédure. Exécuter DeepSeek Harness sur un VPS présente l’installation sur le serveur, et pourquoi cette adresse commence par 127.0.0.1 explique le comportement par défaut de la loopback.

Les routeurs se placent au-dessus de l’orchestrateur

Un routeur de modèles est un proxy local entre l’orchestrateur et l’API du fournisseur. Claude Code Router en est l’exemple courant : il écoute par défaut sur 127.0.0.1:3456, accepte les requêtes que Claude Code aurait envoyées à son propre fournisseur, puis les transmet au fournisseur que vous avez configuré. L’orchestrateur ne sait pas que quelque chose a changé.

Les routeurs existent parce que le modèle peut être remplacé. Ils illustrent donc bien le point principal de cet article. Ils concentrent aussi les risques, car le proxy voit chaque prompt et détient chaque clé de fournisseur. Traitez-le comme une infrastructure, pas comme une simple commodité. Où l’orchestrateur conserve ses clés API et les paramètres des modèles pose le même problème, à un niveau inférieur.

Ce qui change lorsque le harness s’exécute sur un VPS

Quatre choses changent lorsque le harness quitte votre ordinateur portable pour s’exécuter sur un serveur que vous louez.

Il continue de fonctionner lorsque vous fermez le capot. Une tâche longue survit à votre trajet et à votre batterie. Lancez-la dans tmux, puis détachez-vous de la session :

tmux new -s agent
# start the harness, then press Ctrl-b and then d to detach
tmux attach -t agent

Pour tout ce qui doit redémarrer après un reboot, un service utilisateur est préférable à une session de terminal :

loginctl enable-linger $USER
systemctl --user status my-agent.service

loginctl enable-linger est le point souvent oublié. Sans ce paramètre, systemd arrête par défaut le service manager de votre utilisateur 10 secondes après la fermeture de votre dernière session. Un service utilisateur ne permet donc pas à l’agent de continuer à fonctionner après la déconnexion. Exécuter dsh sans interface sous systemd contient le fichier d’unité. Dès qu’une session s’exécute sur ce serveur, vous pouvez en démarrer une seconde, et deux sessions Claude Code sur le même serveur peuvent s’envoyer des messages, de sorte que celle démarrée ce matin puisse transmettre une tâche à l’autre sans que vous deviez faire suivre le message manuellement.

Il conserve vos clés. La clé du fournisseur se trouve maintenant dans un fichier de configuration sur ce serveur. Vérifiez qui peut le lire :

ls -l ~/.config

Tout processus exécuté avec votre compte peut lire ce fichier, notamment l’agent et tout ce que l’agent choisit d’exécuter.

Il peut accéder à vos autres machines. Un VPS situé sur le même réseau privé que vos autres machines fournit à l’agent une route vers celles-ci. C’est précisément l’objectif, mais c’est aussi l’étendue des dégâts potentiels.

Il est accessible où que vous soyez. La plupart des harness exposent une interface web, et la plupart la lient à l’interface loopback pour une bonne raison. Vérifiez la vôtre :

ss -tlnp | grep 3080

127.0.0.1:3080 signifie que seul le serveur lui-même peut se connecter. 0.0.0.0:3080 signifie que l’interface web écoute sur toutes les interfaces. Toute personne pouvant atteindre l’adresse publique du serveur peut donc se connecter, sauf si un firewall en amont bloque le port. En octobre 2026, dsh refuse au démarrage une adresse wildcard de ce type, mais de nombreuses autres interfaces web en acceptent une. Accédez à une interface loopback via un tunnel SSH au lieu de modifier l’adresse d’écoute :

ssh -N -L 3080:127.0.0.1:3080 you@your-server

Ouvrez ensuite http://127.0.0.1:3080 dans le navigateur de votre ordinateur portable. Le trafic passe à l’intérieur de la session SSH. Rien de nouveau n’est donc exposé à Internet.

Chacun de ces points constitue aussi un argument de sécurité

Relisez ces quatre propriétés comme le ferait un attaquant.

Le système s’exécute sans intervention, donc personne ne surveille le moment où le modèle interprète mal un chemin. Il contient vos clés, donc un seul fichier de configuration lisible suffit à compromettre tout votre compte fournisseur. Il peut atteindre vos autres machines, donc une prompt injection, c’est-à-dire des instructions dissimulées dans une page web ou un fichier lu par l’agent, peut désormais atteindre votre serveur de base de données. Il est accessible depuis n’importe où, donc une interface web qui écoute sur une adresse publique, sans pare-feu en amont ni authentification propre, constitue un shell pour quiconque la trouve. dsh place un jeton de processus dans l’URL affichée au démarrage, ce qui aide, mais cette URL devient alors un identifiant d’authentification : partagez-la avec autant de précautions qu’un mot de passe.

Dans chaque cas, la correction est simple et toujours identique. Attribuez à l’agent son propre compte utilisateur sans privilèges plutôt que le vôtre :

sudo adduser --disabled-password --gecos "" agent

Laissez l’interface web sur loopback et utilisez-la via SSH. Donnez à l’agent les identifiants les plus limités qui lui permettent encore de terminer sa tâche ; la section conserver les secrets hors des agents IA explique cela correctement. Pour tout ce qui s’exécute lorsque vous ne surveillez pas la machine, une machine jetable est préférable à une machine soigneusement configurée : exécuter des agents de code dans une VM jetable et exécuter Claude Code en toute sécurité sur un VPS suivent tous deux cette approche.

Avez-vous besoin d’un harnais d’agent ?

Si votre travail consiste à traiter une question à la fois, une fenêtre de chat suffit, et un harnais ne fait qu’ajouter une boucle que vous devez superviser. Un harnais commence à être utile lorsqu’une tâche comporte de nombreuses étapes sur de vrais fichiers, ou lorsqu’elle doit continuer à fonctionner pendant votre sommeil.

La plupart des solutions de cette catégorie sont récentes. dsh indique « developer preview » dans son propre README en octobre 2026, et les autres évoluent assez vite pour qu’un fichier de configuration écrit aujourd’hui puisse nécessiter des modifications le mois prochain. C’est une raison de conserver une configuration réduite et reproductible, et de noter les changements effectués. La même retenue est utile à l’intérieur de la boucle : une skill qui pousse l’agent vers la plus petite modification fonctionnelle vous laisse un diff que vous pouvez réellement lire à la fin d’une exécution sans surveillance. Commencez avec un seul harnais sur un seul serveur, confiez-lui une seule tâche et une seule clé aux droits limités, puis élargissez son accès seulement après que cette première tâche a fonctionné sans incident pendant une semaine. Les agents auto-hébergés qui valent la peine d’être exécutés aujourd’hui constituent un point de départ raisonnable pour choisir le premier.

FAQ

Qu’est-ce qu’un agent harness, en termes simples ?

C’est le programme qui entoure le modèle. Le modèle produit du texte et demande à utiliser des outils. Le harness exécute la boucle qui continue à envoyer des requêtes, lance les outils demandés par le modèle, applique les règles qui déterminent quels outils peuvent s’exécuter sans autorisation, et conserve l’état de la session ainsi que les fichiers entre les tours. Si vous remplacez le modèle, le harness continue de fonctionner. C’est le signe le plus clair que les deux sont distincts.

Claude Code est-il un modèle ou un harness ?

Claude Code est un harness. C’est un programme de terminal doté d’une boucle, d’un système d’autorisations et d’outils intégrés pour les fichiers et le shell. Claude est la famille de modèles qu’il appelle par défaut. La même séparation s’applique à DeepSeek Harness (dsh), qui est un programme Node que vous installez, et aux modèles DeepSeek, qui sont fournis via une API. Vous installez un harness sur une machine. Vous appelez un modèle sur le réseau.

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

Un framework est une bibliothèque que vous importez et avec laquelle vous écrivez du code, en utilisant sa boucle ou en développant la vôtre. Un harness est un programme que vous exécutez. La boucle, les nouvelles tentatives et la gestion du contexte sont donc fournies avec des valeurs par défaut que vous configurez, au lieu de les écrire. La distinction est floue en pratique : Deep Agents de LangChain est un SDK importable que son propre dépôt qualifie d’agent harness complet, en octobre 2026. Demandez-vous si vous allez écrire vous-même la boucle. La réponse détermine le terme adapté à votre situation.

Ai-je besoin d’un VPS pour exécuter un agent harness ?

Non. Tous les harness mentionnés ici s’exécutent sur un ordinateur portable. Un serveur change quatre choses : l’agent continue de fonctionner lorsque vous fermez le capot, il conserve vos clés sur une machine toujours allumée, il peut accéder à vos autres serveurs et vous pouvez reprendre la même session depuis n’importe quel appareil. Chacun de ces points constitue aussi un enjeu de sécurité. Donnez donc à l’agent son propre compte utilisateur et liez toute interface web à 127.0.0.1.

Puis-je utiliser un autre modèle dans le même harness ?

Généralement oui, et c’est la propriété qui définit un harness. La plupart acceptent un nom de modèle et une URL de base dans leur configuration. Pointer un harness vers un autre fournisseur consiste donc à modifier la configuration, et non à réécrire le programme. Lorsqu’un harness ne le permet pas facilement, un routeur local tel que Claude Code Router se place entre le harness et le fournisseur et traduit les requêtes. Il se lie par défaut à 127.0.0.1:3456. Soyez prudent avec ce proxy, car il voit chaque prompt et conserve chaque clé.

Cet article vous a-t-il été utile ?