Qu'est-ce qu'un harness ? Claude Code vs Codex vs Pi vs OpenCode

Vue d'ensemble

Le modèle est le moteur. Le harness est la voiture autour : la direction, les pédales et les outils qui font vraiment rouler le moteur quelque part. Un harness donne au modèle la capacité de lire et écrire des fichiers, d'exécuter des commandes de terminal, de voir les résultats et de boucler jusqu'à ce que le job soit fait. Cette leçon définit le harness et compare les quatre qu'il faut connaître en 2026, pour que vous cessiez de confondre le modèle avec l'outil qui l'entoure.

Ce que vous allez apprendre

Vous allez apprendre ce que fait un harness, pourquoi le même modèle se comporte très différemment selon les harness, et comment Claude Code, Codex, Pi et OpenCode se comparent en philosophie, contrôle et intégration. Vous repartez avec une règle de décision, y compris le cas non évident où le minuscule harness Pi bat le puissant Claude Code.

Prérequis

Les deux leçons précédentes. Vous devez être à l'aise avec le fait qu'un modèle ne fait que prédire des tokens et que la discipline de contexte compte, car un harness est largement une machine à nourrir le modèle du bon contexte et à réagir à son output.

Le problème

Les gens disent « Claude est meilleur que GPT » ou « Codex ne sait pas faire X », mais ils parlent en fait du harness, pas du modèle. Le même modèle Claude paraît brillant dans un outil et pataud dans un autre, parce que le harness décide quels fichiers il voit, quelles commandes il a le droit d'exécuter et comment il boucle. Si vous ne séparez pas le modèle et le harness dans votre tête, vous tirez de mauvaises conclusions et choisissez le mauvais outil.

Ce qu'un harness fait réellement

Un harness est le programme qui s'intercale entre vous et le modèle et donne des mains au modèle. À chaque étape, il rassemble le contexte (votre instruction plus les fichiers pertinents et les sorties de commandes), l'envoie au modèle, relit l'action proposée, exécute cette action dans votre environnement et renvoie le résultat pour que le modèle décide de l'étape suivante. Cette boucle - contexte, modèle, action, résultat, recommencer - c'est tout le jeu. Tout ce qui rend un harness meilleur qu'un autre est une variation de la qualité avec laquelle il gère cette boucle.

• Lit et modifie les fichiers de votre projet.
• Exécute des commandes de terminal et lit leur sortie (tests, builds, Git).
• Gère le context window : décide quoi y mettre et quand compresser.
• Tourne en autonomie en boucle jusqu'à ce que la tâche soit finie ou qu'il ait besoin de vous.

Claude Code

Claude Code est le harness en ligne de commande officiel d'Anthropic, bâti autour des modèles Claude. C'est le poids lourd : intégration profonde du projet, un système de permissions riche, la prise en charge de règles de projet dans un fichier CLAUDE.md, des skills réutilisables, des hooks et des sub-agents. C'est l'outil avec lequel ce cours-ci est construit et maintenu. Si vous voulez un agent qui vit dans un vrai repository, fait tourner vos tests, respecte vos conventions et abat un travail en plusieurs étapes, Claude Code est la recommandation par défaut. Le hic, c'est qu'il est opinionné et assez puissant pour paraître lourd sur de minuscules jobs uniques.

Codex

Codex est l'agent de coding en ligne de commande d'OpenAI, qui enveloppe les modèles GPT. Il est pragmatique et fort pour lire du code inconnu, l'expliquer et faire des changements ciblés et bien délimités. Si vous vivez dans l'écosystème OpenAI ou voulez un deuxième avis d'un modèle de la famille GPT sur un changement délicat, Codex est une prise naturelle. Traitez-le comme un collègue capable de Claude Code plutôt qu'un rival à craindre : beaucoup de builders sérieux ont les deux installés et choisissent selon la tâche.

Pi et OpenCode

Pi est le minimaliste. C'est un harness volontairement minuscule, transparent, extensible : vous voyez exactement ce qu'il fait, et vous le pliez à votre workflow plutôt que l'inverse. OpenCode est un harness open source dans le même esprit, agnostique au modèle et porté par la communauté, souvent utilisé avec des modèles routés via OpenRouter. Les deux échangent la conduite à la main contre le contrôle et la transparence. La vérité surprenante, c'est que pour certains jobs - une tâche rapide scriptée, une boucle sur mesure, un setup où vous voulez pleine visibilité et zéro magie - le harness minimal bat le poids lourd, parce qu'il y a moins de choses entre vous et le modèle et que rien n'est caché.

• Pi : minimal, transparent, hautement extensible. Vous possédez le comportement.
• OpenCode : open source, agnostique au modèle, s'accorde bien avec OpenRouter.
• Quand le minimal gagne : tâches scriptées ou répétables, setups à pleine visibilité, boucles sur mesure, ou quand un harness lourd se bat contre votre workflow.

Pas à pas : une règle de décision

Vous n'avez pas à vous torturer. Faites passer votre tâche par cette règle et choisissez en quelques secondes. Le but est de cesser de traiter le choix comme une question de loyauté et de le traiter comme une question d'adéquation.

• Travail profond dans un vrai repo avec tests, conventions et changements multi-étapes : Claude Code.
• Lire ou expliquer du code inconnu, ou un deuxième avis de GPT : Codex.
• Une boucle scriptée, répétable ou totalement transparente sur mesure : Pi.
• Un setup open source, agnostique au modèle, routé via OpenRouter : OpenCode.
• Incertain : commencez avec Claude Code, car le reste de ce cours le suppose.

Erreurs fréquentes

La grosse erreur est de reprocher au modèle ce qui relève du harness. La deuxième est le tribalisme d'outil - insister sur le fait qu'un harness est universellement le meilleur alors que la réponse honnête est « ça dépend de la tâche ». La troisième est de saisir l'outil le plus lourd pour des jobs triviaux, là où un harness minuscule ou même un simple chat serait plus rapide. Gardez deux harness installés et laissez la tâche décider.

ROI business

Choisir le bon harness, c'est choisir combien du travail de votre équipe vous pouvez déléguer sereinement à un agent. Un harness lourd avec de bonnes règles de projet vous permet de céder de vraies tâches d'engineering du début à la fin, et c'est là que les gains de temps s'accumulent. Un harness minimal vous permet de bâtir des automatisations bon marché, transparentes et répétables. Connaître les deux fait que vous ne payez jamais trop de complexité pour un job simple ni ne sous-armez jamais un job difficile.

Checklist

Assurez-vous de savoir faire ce qui suit avant d'avancer, car la prochaine leçon devient pratique avec l'installation.

• Expliquer la différence entre un modèle et un harness en une phrase.
• Décrire la boucle contexte-modèle-action-résultat.
• Attribuer une tâche à Claude Code, Codex, Pi ou OpenCode.
• Citer un exemple où un harness minimal bat Claude Code.

Ressources

Vous n'avez encore rien à installer - la prochaine leçon parcourt l'installation pas à pas. Pour l'instant, retenez juste le modèle mental : le modèle est le moteur, le harness est la voiture. La page de fondamentaux sur le terminal aide si la ligne de commande vous semble encore étrangère.

Votre mission

Écrivez la seule tâche que vous aimeriez le plus voir un agent abattre cette semaine, appliquez ensuite la règle de décision et nommez le harness que vous utiliseriez. Vous l'installerez à la prochaine leçon, alors choisissez quelque chose de réel.

Prochaine leçon

Le moment de cesser de lire et de commencer à installer. La prochaine leçon met Claude Code et Codex en marche sur votre machine, explique les plans de subscription et défend l'idée que le plan à 200 dollars par mois est en fait bon marché pour un builder sérieux.