Guideclaude-codeharnessagents-ia

Claude Code Harness : 98,4 % d'infrastructure, 1,6 % d'IA

Le harness de Claude Code expliqué : boucle d'agent, CLAUDE.md, autorisations, hooks, MCP, erreurs à éviter, trois niveaux de réglage et coûts réels.

23 min de lecturePublié le 22 juin 2026Mis à jour le 11 novembre 2026

Geoffrey Harrazi

Directeur produit · Cofondateur Idun Group

Sans changer de modèle, un nouveau harness fait passer un agent de 52,8 % à 66,5 % sur Terminal Bench 2.0, mesure publiée par LangChain.

Le harness de Claude Code désigne tout ce qui, dans l'agent, n'est pas le modèle : la boucle qui envoie la demande à Claude et exécute les actions qu'il propose, les outils qu'il peut appeler, la mémoire du projet, les règles d'autorisation, les contrôles automatiques et les traces. Le mot anglais veut dire « harnais », et c'est bien sa fonction : le modèle fournit la puissance, le harness la canalise. Le terme vaut pour tout agent IA, d'où la formule agent = modèle + harness ; concevoir et régler cette couche, pour Claude Code comme pour Codex ou Cursor, s'appelle le harness engineering. C'est elle qui sépare un agent Claude qui impressionne en démonstration d'un agent fiable sur un dépôt de production.

Ce guide s'adresse d'abord aux équipes qui configurent Claude Code. La question qui vient ensuite, ce que les sièges Claude Code produisent face à ce qu'ils coûtent, est traitée sur notre page Claude en entreprise. Pour le fonctionnement de l'agent lui-même, voir l'agentic coding avec Claude Code. Hors du code, Anthropic propose un agent de bureau, Claude Cowork. Et pour faire relire le code par un second modèle sans quitter la session, voir notre plugin Antigravity pour Claude Code.

Architecture et composants du harness Claude Code

Claude Code repose sur une boucle d'agent et six briques : la mémoire du projet (CLAUDE.md), les outils (Read, Edit, Write, Bash, Grep, WebFetch…), les autorisations (settings.json), les hooks (PreToolUse, PostToolUse), les serveurs MCP et l'observabilité (journaux, compaction du contexte). CLAUDE.md oriente le modèle sans rien imposer. Les autorisations, les hooks et la portée des serveurs MCP décident de ce qui s'exécute, et les journaux en gardent la trace.

Pourquoi estime-t-on que 98,4 % de Claude Code relève du harness ?

Parce que l'essentiel du travail d'un agent de code n'est pas de produire du texte, mais de décider quoi exécuter, avec quels droits, et d'en garder la trace. Une analyse communautaire du code source de Claude Code v2.1.88 (environ 1 884 fichiers et 512 000 lignes de TypeScript) estime que seulement 1,6 % du code relève de la logique de décision de l'IA ; les 98,4 % restants sont de l'infrastructure : barrières d'autorisation, routage des outils, gestion du contexte, reprise sur erreur. Des chercheurs du MBZUAI reprennent cette estimation dans leur étude de Claude Code (Jiacheng Liu, Xiaohan Zhao, Xinyi Shang et Zhiqiang Shen, arXiv, avril 2026). C'est un ordre de grandeur, pas un comptage officiel, mais il dit bien où se trouve le travail.

À modèle égal, c'est donc la configuration qui fait l'écart entre deux équipes : les boucles de vérification, les portes de qualité et la gestion des erreurs pèsent plus lourd qu'un modèle plus puissant. LangChain l'a chiffré, comme on le verra plus bas : 13,7 points de plus sur Terminal Bench 2.0 en ne changeant que la couche autour du modèle.

Comment fonctionne la boucle d'agent de Claude Code ?

Claude Code, comme Cursor, Codex ou un agent construit avec LangGraph, repose sur une boucle d'agent en quatre temps :

  1. Envoyer : transmettre au modèle le message et la liste des outils disponibles.
  2. Vérifier : lire le champ stop_reason de la réponse.
  3. Exécuter : si la réponse est un tool_use, lancer l'outil demandé et ajouter le résultat au contexte.
  4. Recommencer : jusqu'à la réponse finale du modèle.

Le harness gouverne chaque passage de cette boucle. Sans lui, l'agent agit sans contrainte ni trace. Bien réglé, il fait passer chaque action par une vérification d'autorisation, des contrôles de qualité et une journalisation.

Harness ou prompt engineering : quelle différence ?

Le prompt engineering agit sur ce que le modèle dit ; le harness agit sur ce que l'agent fait. Les deux se complètent.

Prompt engineeringHarness
Ce qu'il règleCe que le modèle répondCe que l'agent exécute
PérimètreInstructions, exemples, contexteAppels d'outils, autorisations, hooks, mémoire
EffetQualité des réponsesFiabilité en production
ForceIndicative : le modèle peut s'en écarterBloquante : une action interdite ne s'exécute pas
DuréeUne sessionLa configuration du projet

LangChain l'a mesuré. En ne changeant que son harness (instructions système, outils, middleware), sans toucher au modèle, son agent de code est passé de 52,8 % à 66,5 % de réussite sur Terminal Bench 2.0, soit 13,7 points de plus (LangChain, 2026).

Que révèle la fuite du code source du 31 mars 2026 ?

Le 31 mars 2026, la version 2.1.88 du paquet npm @anthropic-ai/claude-code a été publiée avec un fichier de correspondance (source map) destiné au débogage interne, qui permettait de reconstituer le code source de l'outil. Anthropic a parlé d'une erreur humaine dans l'empaquetage de la version, sans donnée client ni identifiant exposé (VentureBeat, mars 2026).

Au-delà de l'incident, la fuite a ouvert l'architecture de Claude Code à l'analyse publique et universitaire : l'étude du MBZUAI citée plus haut porte sur ce code. Pour une équipe qui conçoit sa propre configuration, ces analyses servent désormais de référence.

Mémoire : que fait CLAUDE.md, et que ne fait-il pas ?

CLAUDE.md est la mémoire du projet. Claude Code le charge à chaque ouverture de session : conventions de code, commandes utiles, contraintes métier. Il oriente le raisonnement du modèle, mais il ne bloque rien. Une consigne écrite dans CLAUDE.md peut être ignorée si le contexte pousse le modèle ailleurs. Toute consigne critique, comme « ne jamais modifier les fichiers de production », doit donc être doublée d'une règle dans permissions.deny.

Outils : quelles actions l'agent peut-il effectuer ?

Le harness expose au modèle quatre familles d'outils :

  • Fichiers : lecture, écriture, modification, recherche ;
  • Shell : commandes bash, scripts, compilation (c'est aussi par là que passe une suppression) ;
  • Réseau : appels HTTP, API externes, services tiers ;
  • Navigateur : navigation, interactions avec une interface, tests.

Dans Claude Code, ce sont notamment Read, Write, Edit, Glob, Grep, Bash, WebFetch et WebSearch. L'inventaire du MBZUAI compte 19 outils intégrés toujours présents, et jusqu'à 54 selon les options activées et le type d'utilisateur, auxquels s'ajoutent les outils des serveurs MCP (avril 2026). C'est par ces outils que l'agent agit, donc par eux que passe l'essentiel du risque. Chacun mérite d'être documenté dans la configuration partagée de l'équipe, avec la portée de chaque serveur MCP.

Autorisations : comment settings.json décide-t-il ?

settings.json porte les autorisations de l'agent en trois listes : ce qu'il fait seul (allow), ce qui demande confirmation (ask), ce qui est interdit (deny). Les règles s'évaluent dans l'ordre deny, puis ask, puis allow. La première qui correspond l'emporte, et une règle allow ne peut pas créer d'exception dans une règle deny (documentation de Claude Code, novembre 2026). Sans règle permissions.deny explicite, la décision revient au modèle ou à la personne qui valide.

Claude Code propose aussi plusieurs modes d'autorisation, du mode par défaut, qui demande avant chaque action sensible, au mode bypassPermissions, qui ne demande plus rien ; l'étude du MBZUAI en compte sept dans le code de la version étudiée, dont cinq visibles pour l'utilisateur. Les réglages ont trois portées : le projet (.claude/settings.json, versionné et partagé par l'équipe), le développeur (~/.claude/settings.json et .claude/settings.local.json, non versionné), et les réglages gérés par l'organisation, que personne ne peut contourner.

Hooks : comment bloquer une action avant qu'elle s'exécute ?

Les hooks sont les portes de qualité automatiques. Un hook PreToolUse s'exécute avant chaque appel d'outil, un hook PostToolUse après. Un PreToolUse qui renvoie le code de sortie 2 bloque l'action : c'est ce qui le distingue d'un simple journal. Un PostToolUse arrive trop tard pour empêcher l'action ; il sert à vérifier le résultat (lancer les tests, un linter) et à renvoyer l'erreur au modèle, qui peut corriger. Un hook ne contourne pas les règles : une règle deny bloque l'appel même si le hook l'a accepté.

MCP : comment ajouter des outils sans exposer les secrets ?

MCP (Model Context Protocol) est le standard qui permet d'ajouter des outils à Claude Code : base de données, API interne, outil métier. Chaque serveur MCP apporte ses outils et garde ses propres identifiants, ce qui évite de confier à l'agent l'ensemble des secrets. La portée de chaque serveur est un réglage critique : un serveur MCP doté de droits d'écriture trop larges devient une porte d'entrée directe. Cursor et Codex reposent sur le même standard.

Observabilité : que gardent les journaux, et combien coûte le contexte ?

L'observabilité remplit deux fonctions. Les journaux de session gardent la trace de chaque action de l'agent : ils servent à relire un incident et à évaluer les sorties après coup. La compaction du contexte résume au fil de l'eau le début d'une longue session pour qu'elle tienne dans la mémoire de travail du modèle : c'est elle qui permet à un agent de travailler plusieurs heures d'affilée (Anthropic Labs, mars 2026, détail plus bas). Claude Code peut aussi exporter ses métriques et ses événements au format OpenTelemetry.

Harness interne ou harness externe ?

Le harness interne vit dans le processus de l'agent : settings.json, hooks, serveurs MCP. Il agit avant l'appel d'outil. Le harness externe agit au niveau du système : conteneur, bac à sable, filtres réseau. Il bloque aussi ce que les règles internes ne voient pas, comme un script Python qui ouvre lui-même un fichier. Claude Code et Cursor fournissent l'interne, et Claude Code propose un bac à sable intégré pour isoler les commandes ; le reste de l'isolation revient en général à l'équipe plateforme.

Quelles sont les erreurs de harness engineering les plus fréquentes ?

Cinq erreurs de configuration reviennent sans cesse, et deux failles publiées en 2025-2026 montrent où se situe le risque. Toutes concernent la configuration autour du modèle, aucune le modèle lui-même.

Erreur 1 : des consignes dans CLAUDE.md sans permissions.deny

C'est la plus répandue. Les consignes de CLAUDE.md sont indicatives : le modèle suit le contexte dont il dispose, pas un fichier de conventions que rien n'applique. Une consigne « ne jamais modifier les fichiers de production » sans règle deny correspondante finit par être enfreinte. CLAUDE.md documente l'intention, settings.json l'applique.

Erreur 2 : des clés d'API en clair dans le dossier de l'agent

Un fichier .env accessible depuis le dossier de travail est un fichier que l'agent peut lire, et qu'un outil réseau peut faire sortir. Les identifiants vont hors de sa portée : fichiers en mode 600 dans un chemin qu'il ne voit pas, ou gestionnaire de secrets. Une règle deny sur Read(./.env) protège des outils de Claude Code, pas d'un script qui ouvrirait le fichier lui-même : pour ce cas, il faut le bac à sable.

Erreur 3 : des hooks qui journalisent sans jamais bloquer

Un hook qui enregistre tout mais ne renvoie jamais le code de sortie 2 donne une illusion de contrôle. Les actions indésirables passent, et la relecture après incident montre des traces parfaites à côté de dégâts réels. Un hook qui ne peut pas bloquer ne protège pas. Même chose pour un hook qui plante ou dont le script est introuvable : par défaut, Claude Code laisse passer l'action, sauf si le hook est réglé avec "onFailure": "block".

Erreur 4 : des droits d'écriture MCP combinés à un shell trop ouvert

Des droits d'écriture larges sur un serveur MCP, ajoutés à une liste de commandes bash permissive, donnent à l'agent deux chemins pour écrire là où personne ne l'a prévu. C'est une voie classique vers des fichiers modifiés hors du périmètre voulu. La règle est celle du moindre privilège : l'écriture limitée aux chemins nécessaires, les commandes bash limitées aux tâches identifiées.

Erreur 5 : le mode bypass sur un dépôt de production

Le mode bypassPermissions (ou l'option --dangerously-skip-permissions) coupe les vérifications. La documentation d'Anthropic le réserve aux environnements isolés, conteneurs ou machines virtuelles. Sur un dépôt de production, c'est une porte ouverte. Une organisation peut l'interdire en réglant permissions.disableBypassPermissionsMode sur "disable" dans ses réglages gérés ; à défaut, le même réglage va dans le .claude/settings.json versionné du projet.

CVE-2025-59536 et CVE-2026-21852 : deux failles dans la couche de configuration

Ces deux failles, publiées par Check Point Research en février 2026, ne touchent pas le modèle. Elles passaient par les fichiers de configuration d'un projet : ouvrir un dépôt piégé pouvait lancer des commandes avant que l'utilisateur accepte le dialogue de confiance (CVE-2025-59536), ou rediriger le trafic d'API vers un serveur tiers pour récupérer la clé (CVE-2026-21852). Toutes deux sont corrigées. Deux réflexes en découlent : mettre Claude Code à jour dès qu'un correctif sort, et relire les dossiers .claude/ et le fichier .mcp.json d'un dépôt inconnu avant de l'ouvrir.

ErreurProbabilitéGravitéCorrection
1. CLAUDE.md sans règle denyTrès élevéeÉlevéeChaque consigne critique de CLAUDE.md a sa règle permissions.deny dans settings.json
2. Clés d'API en clair (.env dans le dossier de l'agent)Très élevéeCritiqueIdentifiants en mode 600 hors du dossier de l'agent, ou gestionnaire de secrets (Vault, AWS Secrets Manager)
3. Hooks qui ne bloquent pas (code de sortie 2 absent)ÉlevéeÉlevéeChaque hook de protection renvoie le code 2 pour bloquer, pas seulement pour journaliser
4. Écriture MCP et bash trop ouvertsÉlevéeCritiqueMoindre privilège : écriture MCP limitée aux chemins nécessaires, liste bash restreinte
5. Mode bypass en productionModéréeCritiqueBypass seulement en environnement isolé ; interdit par les réglages gérés
6. Failles publiées (CVE-2025-59536, CVE-2026-21852)Faible si Claude Code est à jourCritiqueMise à jour dès la sortie du correctif ; relecture de la configuration des dépôts inconnus

Sources : Check Point Research (février 2026) pour les failles, documentation de Claude Code (novembre 2026) pour les corrections. Probabilité et gravité : estimations d'Idun Group.

Configurer votre harness Claude Code en 3 niveaux

Configurer Claude Code revient à régler quatre fichiers : CLAUDE.md pour les consignes, .claude/settings.json pour les autorisations (allow, ask, deny) et les hooks, .mcp.json pour les serveurs MCP, et les réglages gérés de l'organisation. Le niveau d'autonomie se choisit selon le dépôt et la tâche : validation de chaque action en production, liste d'actions autorisées en préproduction, autonomie complète en bac à sable.

NiveauCe qui demande confirmationPour quels dépôtsRéglage dans Claude Code
A. Validation de chaque actionChaque appel d'outil sensibleProduction, contextes réglementés, code partagé entre équipesMode par défaut, règles ask larges, règles deny sur le critique
B. Liste d'actions autoriséesTout ce qui sort de la liste, d'abord les actions destructivesPreuves de concept, préproductionListe allow choisie (lecture, tests, API en lecture seule)
C. Autonomie en bac à sablePresque rienTâches longues en lot, dans un environnement isoléConteneur ou bac à sable, réseau restreint, aucun secret accessible

Niveau A : chaque action demande confirmation

Le point d'entrée recommandé pour les dépôts sensibles et les contextes réglementés. Chaque appel d'outil sensible déclenche une confirmation humaine : la charge de validation est maximale, le risque minimal. Ce réglage convient aux projets en production et aux bases de code partagées entre plusieurs équipes. Comme une personne valide chaque action, il fait aussi office de relecture continue. Le CLAUDE.md ou le README du dépôt précise quelles tâches l'agent peut mener seul et lesquelles demandent une validation.

Niveau B : une liste d'actions autorisées, le reste demande confirmation

Une liste blanche définit ce que l'agent fait seul : lire des fichiers, lancer les tests, appeler des API en lecture seule. Le reste, et d'abord tout ce qui supprime ou écrase, demande confirmation. Ce réglage convient aux preuves de concept et à la préproduction : l'agent avance vite sur les tâches courantes, sans supervision de chaque instant. La liste se versionne dans .claude/settings.json et se documente dans le README. Un exemple de départ, à adapter au dépôt :

json
{ "permissions": { "allow": ["Read", "Grep", "Glob", "Bash(npm run test *)"], "ask": ["Edit", "Write", "Bash(git push *)"], "deny": ["Read(./.env)", "Read(./secrets/**)", "Bash(rm -rf *)"], "disableBypassPermissionsMode": "disable" }, "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": "\"${CLAUDE_PROJECT_DIR}\"/.claude/hooks/verifier-bash.sh", "onFailure": "block" } ] } ] } }

Le script verifier-bash.sh doit exister dans le dépôt et être exécutable : il lit la commande proposée et renvoie le code de sortie 2 pour la bloquer. Son chemin part de la racine du projet (${CLAUDE_PROJECT_DIR}), pour qu'il soit trouvé même après un changement de dossier. Sans "onFailure": "block" (Claude Code v2.1.295 ou plus récent), un script introuvable ou en erreur laisserait passer l'action.

Ces règles s'ajoutent à celles des autres fichiers de réglages, elles ne les remplacent pas : Claude Code fusionne les listes allow, ask et deny de l'utilisateur, du projet et du poste. Une règle allow qu'un développeur a posée dans ses propres réglages reste donc valable, et le fichier du projet ne garantit pas que tout ce qui sort de sa liste demandera confirmation. Les règles allow d'un dépôt ne s'appliquent d'ailleurs qu'une fois le dossier déclaré de confiance ; les règles deny et ask s'appliquent tout de suite. Pour un périmètre commun et fermé, il faut des réglages gérés par l'organisation avec allowManagedPermissionRulesOnly : Claude Code n'applique alors que les règles de ces réglages gérés.

Niveau C : autonomie complète en bac à sable

L'agent travaille dans un conteneur, avec un accès réseau restreint et un système de fichiers limité au seul dossier de travail. La charge de validation est quasi nulle. Ce réglage sert aux longues tâches en lot, souvent lancées le soir : migration d'une base de code, génération de suites de tests, refactorisation à grande échelle. L'isolation garantit que l'agent n'atteint ni les secrets ni les systèmes hors de son périmètre ; c'est le seul cadre où le mode bypass a sa place.

Combien coûte un harness ? Les chiffres d'Anthropic Labs (mars 2026)

Prithvi Rajasekaran, d'Anthropic Labs, a publié le 24 mars 2026 le coût de plusieurs essais où Claude devait construire seul une application complète. Sur la même consigne, un créateur de jeux rétro en 2D, un agent seul a travaillé 20 minutes pour 9 USD ; le harness complet, 6 heures pour 200 USD, plus de 20 fois plus, mais l'application obtenue était bien plus riche et réellement jouable.

ConfigurationCe qu'elle contientApplication construiteDuréeCoût
Agent seulUn agent, sans planificateur ni évaluateurCréateur de jeux rétro en 2D20 min9 USD
Harness completPlanificateur, générateur et évaluateur, Playwright MCP, plusieurs tours de tests, compaction automatique du contexteLa même6 h200 USD
Harness simplifiéVersion allégée, sur un modèle plus récentUne autre : un studio audio dans le navigateur3 h 50124,70 USD

Source : Anthropic Labs, Prithvi Rajasekaran, « Harness design for long-running application development » (24 mars 2026). Les deux premières lignes portent sur la même consigne ; la troisième, sur une autre application, ne se compare pas directement aux deux autres.

Le point clé de l'article est l'évaluateur séparé. Un agent qui note son propre travail le juge trop favorablement ; un agent distinct, réglé pour être exigeant, repère ce qui ne fonctionne pas et le renvoie au générateur. Un harness complet coûte donc plus cher qu'une session nue, mais il livre une application qui fonctionne. Pour une direction, le bon indicateur n'est pas le coût d'une session, mais le coût d'un résultat utilisable.

Peut-on utiliser le harness de Claude Code avec d'autres modèles ?

Pas officiellement. Claude Code est conçu pour les modèles Claude, accessibles par l'API d'Anthropic, Amazon Bedrock, Google Cloud ou Microsoft Foundry. La variable ANTHROPIC_BASE_URL permet de faire passer le trafic par une passerelle LLM d'entreprise, qui centralise les identifiants, les coûts et les journaux. Certaines passerelles savent router vers d'autres modèles, mais Anthropic indique ne pas prendre en charge le routage de Claude Code vers des modèles non Claude (documentation de Claude Code, novembre 2026). Les instructions système et les outils sont réglés pour Claude : avec un autre modèle, les résultats varient.

Ce qui se transpose, ce sont les principes. Le gain de LangChain cité plus haut a été mesuré sur un modèle qui n'était pas Claude, dans un autre harness. Codex, Cursor et les agents open source ont des couches équivalentes : mémoire du projet, autorisations, hooks, MCP. En rendez-vous, un directeur technique nous expliquait ranger les skills de ses équipes dans un outil open source, justement pour pouvoir changer de modèle. Pour garder cette liberté :

  • écrire les conventions du projet dans des fichiers que d'autres agents savent lire (AGENTS.md, reconnu par Codex et plusieurs agents, peut être importé depuis CLAUDE.md) ;
  • garder les contrôles dans des scripts appelés par les hooks, réutilisables ailleurs ;
  • exposer les outils métier en serveurs MCP plutôt qu'en intégrations propres à un agent.

Du harness individuel à la gouvernance d'entreprise

Pourquoi un réglage individuel ne tient-il pas à l'échelle d'une équipe ?

Parce qu'un settings.json posé sur un poste ne se synchronise avec personne. Chaque développeur garde ses propres règles, et les configurations se multiplient sans vue d'ensemble : agents réglés différemment, README absents, interdits qui ne sont pas les mêmes d'un dépôt à l'autre. Dès que plusieurs agents travaillent en parallèle sur des applications métier, il faut un niveau de règles commun.

Claude Code en fournit les moyens. Le fichier .claude/settings.json du projet se versionne avec le code et donne à toute l'équipe une base commune, qui s'ajoute aux réglages de chacun. Les réglages gérés, déployés par l'informatique sur chaque poste, s'imposent à tous et ne se contournent pas : règles deny communes, mode bypass désactivé, liste des serveurs MCP autorisés, passerelle LLM obligatoire, et, avec allowManagedPermissionRulesOnly, des autorisations qui ne viennent que d'eux.

Les quatre étapes de maturité

  1. Réglage individuel. Le développeur règle son agent (Claude Code, Cursor ou Codex) dans un settings.json local. CLAUDE.md fixe les règles du projet ; hooks et serveurs MCP sont activés au cas par cas.
  2. Réglage d'équipe. L'équipe partage un dépôt de configurations : CLAUDE.md versionnés, fichiers de règles, hooks standardisés, README à jour.
  3. Plateforme. Les agents tournent comme des services, avec une observabilité commune (OpenTelemetry, par exemple), une mémoire persistante et des garde-fous centralisés.
  4. Entreprise. Les mêmes règles valent pour tous les outils d'IA de l'entreprise, Claude Code compris : ce qui est interdit partout, qui peut modifier une règle (des rôles, du propriétaire au simple lecteur), comment arrêter un agent en urgence, quelles traces garder pour l'AI Act et l'OWASP.

La quatrième étape relève moins de l'outillage que de l'organisation : qui fixe les règles, qui les fait évoluer, qui peut arrêter un agent. Nous détaillons un cadre de gouvernance des agents IA bâti sur l'usage réel dans un article dédié.

Que demandent l'AI Act et l'OWASP ?

Des traces et une supervision humaine. Un agent de code n'est en général pas un système d'IA à haut risque au sens de l'AI Act. Mais s'il intervient dans un tel système, le texte exige l'enregistrement automatique des événements (article 12), une supervision humaine effective (article 14) et, côté entreprise utilisatrice, des journaux conservés au moins six mois (article 26). Ces règles s'appliquent au 2 décembre 2027 pour les systèmes de l'annexe III, date fixée par l'omnibus IA de juillet 2026 ; le détail de ce que l'AI Act demande aux entreprises qui utilisent l'IA est dans notre guide. L'OWASP a publié en décembre 2025 son cadre de référence pour les applications agentiques, qui attend lui aussi des contrôles vérifiables et une capacité de relecture documentée. La couche de configuration de l'agent est l'endroit naturel où produire ces preuves : chaque instruction donnée à l'agent et chaque action qu'il mène doivent pouvoir être retrouvées.

Les autres agents fonctionnent-ils de la même façon ?

Sur le principe, oui ; dans le détail, non. Claude Code, Codex CLI d'OpenAI ou Aider partagent la même base : une boucle d'agent, des outils que le harness vérifie avant de les exécuter, une mémoire du projet. Les différences portent sur l'endroit où l'on place la frontière de sécurité, et l'étude du MBZUAI les documente (avril 2026) :

  • Claude Code évalue chaque action avant de l'exécuter : règles deny en premier, hooks, classifieur automatique en option et sept modes d'autorisation. La frontière passe entre le modèle et l'environnement d'exécution.
  • SWE-Agent et OpenHands misent sur l'isolation dans un conteneur plutôt que sur des règles action par action.
  • Aider s'appuie d'abord sur Git : on revient en arrière si l'agent s'est trompé.
  • OpenClaw, un assistant open source relié à des messageries, place la frontière à l'entrée de sa passerelle : un seul opérateur de confiance, des listes d'expéditeurs autorisés, et un bac à sable qui n'est pas actif par défaut.

Pour une équipe, la leçon est pratique : avant d'adopter un agent, il faut savoir où il place cette frontière, et ce qu'il faut ajouter autour (conteneur, règles, sauvegardes) pour couvrir le reste.

Ce que la direction doit savoir avant d'étendre les sièges Claude Code

Un harness bien réglé rend Claude Code sûr et fiable. Il ne dit pas si les sièges servent les objectifs de l'entreprise. Avant d'étendre, une direction a besoin de quatre réponses, et ce sont celles qui reviennent quand nous discutons avec des DSI.

  • Quel objectif finance-t-on ? Un responsable des outils de développement nous racontait que, dès qu'il ouvre Claude Code à une équipe, on lui demande quel budget prévoir. Sa réponse : pour quels objectifs ? Sans objectif, le budget se cale sur le nombre de sièges, et le renouvellement se décide sans base. Un membre de comité de direction nous disait la même inquiétude autrement : la peur de perdre le contrôle, et une question simple, ces sièges seront-ils bien utilisés ?
  • Que produisent les sessions ? Les traces disponibles comptent des sessions et des minutes. Dans une grande entreprise, le système de traces ne permettait pas de reconstruire ce qu'une session avait produit. Une durée n'est pas un résultat. Et depuis que les agents se facturent à la consommation, un responsable de l'IA générative nous confiait que son souci n'était plus de faire adopter l'outil, mais de contenir la dépense. Sur les parcs que nous analysons, 20 à 40 % des licences IA payées ne sont pas utilisées.
  • Ce code existait-il déjà ? Un DSI de groupe a découvert des modules développés avec Claude Code alors qu'une fonction standard de son système d'information faisait déjà le travail : il suffisait de l'activer. Un agent rapide produit vite du code dont l'entreprise n'avait pas besoin.
  • Qui porte la sécurité ? Écrire du code, l'IA sait le faire ; c'est la sécurité qui pose problème, résumait un DSI. La réponse est dans les réglages décrits plus haut : réglages gérés, règles deny, mises à jour, bac à sable.

Ces réponses se mesurent par équipe et par tâche, à partir des journaux et des exports que les plateformes produisent déjà, et se croisent avec des entretiens. On analyse des usages, pas des individus. La méthode pour calculer ce que rapporte l'IA à partir de l'usage réel est détaillée dans un article dédié. Idun Group fait ce travail sur Claude Code : nous mesurons l'usage réel à partir de ce que vos plateformes enregistrent, nous le croisons avec des entretiens, et nous disons quoi industrialiser, consolider ou couper. Le détail est sur notre page consacrée à l'usage réel de Claude Code, équipe par équipe.

En résumé : six réglages à vérifier cette semaine

  • Chaque consigne critique de CLAUDE.md a sa règle permissions.deny.
  • Les hooks de protection PreToolUse renvoient le code de sortie 2.
  • Aucune clé d'API n'est lisible depuis le dossier de l'agent.
  • Les serveurs MCP n'ont que les droits d'écriture nécessaires.
  • Le mode bypass est désactivé par les réglages gérés, hors bac à sable.
  • Claude Code est à jour, et les dépôts inconnus sont relus avant d'être ouverts.

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

Questions fréquentes

Le harness de Claude Code est tout ce qui entoure le modèle Claude dans l'agent : la boucle qui lui envoie les demandes et exécute ses actions, les outils, la mémoire du projet (CLAUDE.md), les autorisations (settings.json), les hooks, les serveurs MCP et les journaux. Le modèle propose une action ; le harness décide si elle s'exécute, avec quels droits, et en garde la trace.

À propos de l'auteur

Geoffrey Harrazi« geoffrey »

Directeur produit · Cofondateur Idun Group

Directeur produit et cofondateur d'Idun Group. Produit, business et ventes. Ancien LVMH. Porte Idun Cockpit, qui mesure l'usage réel de l'IA déjà déployée en entreprise : licences, assistants et agents.

LinkedInSite25 articles publiés
Historique des modifications (4)
  • 11 novembre 2026Réécriture : français corrigé, répétitions retirées, section pour la direction, liens internes.
  • 10 novembre 2026Liens internes ajoutés en haut de l'article vers la page Claude en entreprise et les articles voisins ; articles liés recentrés sur Claude.
  • 30 octobre 2026Passages sur l'offre d'Idun Group mis à jour ; appel à l'action actualisé.
  • 10 juin 2026Publication initiale

Recevez nos guides sur la valeur de l'IA chaque mois

Retours de terrain sur l'usage réel de l'IA en entreprise : adoption, coûts, ce qu'elle rapporte et quoi en faire. Pas de spam, jamais, promis.

1 email par mois. Pas plus.

Désinscription à tout moment, par le lien présent dans chaque envoi. Vos données : politique de confidentialité