En résumé : le choix entre Pi et Claude Code se résume à une question de configuration par défaut face au contrôle. Pi est un agent de programmation en terminal gratuit et sous licence MIT. Léger par conception, il fait l'impasse sur les sous-agents, le mode planification et les fenêtres de confirmation d'autorisation, tout en vous permettant d'ajouter les fonctionnalités souhaitées via des extensions TypeScript. Claude Code intègre nativement ces flux de travail. Pi est totalement gratuit à installer ; vous ne payez que le fournisseur de modèle auquel vous vous connectez.
Un fil Hacker News intitulé « Goodbye Claude, hello Pi » a dépassé les 700 points et 430 commentaires cette semaine, ce qui fait beaucoup de développeurs en train de débattre au sujet d'un programme en terminal. Si vous utilisez quotidiennement des agents de code, la question de fond est essentielle : votre environnement d'exécution (le « harness », ce programme qui encapsule le modèle, les outils et le prompt) doit-il être configuré sur mesure ou subi au quotidien ?
Ce guide vous présente ce qu'est Pi, ce qu'il coûte, comment l'installer, ainsi qu'une comparaison sans fard avec Claude Code, incluant les retours des deux camps exprimés dans ce fil. Il se termine par la méthode pour exécuter les deux sans avoir à repenser votre flux de travail, puisque Sharkly propose Pi et Claude Code en tant que Runtimes sur la même Machine.
Qu'est-ce que l'agent de code Pi ?
Pi se définit comme « un harness d'agent minimaliste et extensible que vous pouvez vous approprier ». Il fonctionne dans votre terminal, lit et modifie des fichiers, exécute des commandes et communique avec le modèle de votre choix. Mario Zechner a initié le projet dans le dépôt pi-mono ; il est désormais hébergé sous l'organisation Earendil, et la version npm actuelle est la 1.5.0.
Quatre caractéristiques le définissent :
- Indépendant des fournisseurs. Le site de Pi répertorie plus de 15 fournisseurs et des centaines de modèles : Anthropic, OpenAI, Google, Bedrock, Mistral, Groq, OpenRouter, Ollama et bien d'autres. Vous pouvez changer de modèle en cours de session avec
/model. - Volontairement minimaliste. La liste « Ce que nous n'avons pas développé » sur le site mentionne les sous-agents, les pop-ups d'autorisation, le mode planification, les to-dos intégrées et les tâches bash en arrière-plan.
- Extensible en TypeScript. Les extensions permettent d'enregistrer des outils, des commandes, des raccourcis, des fournisseurs et des interfaces de terminal (TUI). Les compétences (skills), modèles de prompts et thèmes sont distribués sous forme de paquets Pi via npm ou git.
- Scriptable. TUI interactive, modes d'affichage texte brut et JSON (
pi -p), protocole RPC via stdin et stdout, et SDK TypeScript.
Les sessions sont conservées sous forme d'arborescence, ce qui permet à la commande /tree de revenir à un point antérieur pour créer une nouvelle branche à partir de là. Un utilisateur sur HN a d'ailleurs confié qu'il « ne pourrait plus se passer de /tree ».
Pi est-il gratuit ?
Oui. Pi est sous licence MIT et son installation coûte 0 $. Vous ne payez que pour l'utilisation du modèle. Le guide de démarrage rapide indique que vous devez disposer d'un accès à un modèle « via un fournisseur pris en charge. Il peut s'agir d'un abonnement, d'une clé d'API ou d'un modèle local ».
Trois options s'offrent donc à vous concernant les coûts :
| Option | Ce que vous payez | Configuration |
|---|---|---|
| Clé d'API | Facturation au jeton du fournisseur | export ANTHROPIC_API_KEY=... puis pi |
Abonnement via /login |
Votre forfait existant | /login, choisissez un fournisseur, suivez le flux OAuth |
| Modèle local (Ollama, llama.cpp) | Votre propre matériel | Pointez Pi vers le serveur local |
Une mise en garde toutefois concernant l'option de l'abonnement. Un internaute défendant Claude Code a souligné un « risque de bannissement pour violation des conditions d'utilisation » lorsqu'un abonnement est utilisé au sein d'un harness tiers. La documentation de Pi ne tranche pas cette question. Lisez attentivement les conditions d'utilisation de votre fournisseur avant d'associer un forfait payant, ou privilégiez une clé d'API, qui ne comporte aucune ambiguïté de ce genre.
Comment installer et configurer Pi
La configuration ne requiert que deux commandes si vous disposez de Node.js 22.19 ou d'une version plus récente.
# Option 1: the installer (pins dependencies, updates with `pi update`)
curl -fsSL https://pi.dev/install.sh | sh
# Option 2: npm
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
# Start it in your project
cd ~/code/my-service
pi
Dans Pi, exécutez /login pour vous connecter à un fournisseur, puis /model pour sélectionner un modèle. Pi prend en charge les fichiers de contexte AGENTS.md et CLAUDE.md ; un dépôt déjà configuré pour Claude Code conserve donc l'ensemble de ses instructions.
Avant de lancer votre première tâche sérieuse, prenez le temps de consulter la page de sécurité de Pi. Elle précise que Pi « ne demande pas de confirmation avant chaque appel d'outil » et s'exécute avec les privilèges du compte qui l'a lancé. La documentation souligne qu'un conteneur, une machine virtuelle ou un bac à sable constitue « généralement la solution pratique la plus robuste ».
Pi vs Claude Code : le comparatif objectif
Claude Code est l'agent de programmation d'Anthropic. Il intègre des sous-agents, des hooks, le protocole MCP, un mode planification et un système d'autorisations qui requiert une validation avant toute action risquée. Pi, de son côté, propose un cœur bien plus compact et vous laisse ajouter les éléments dont vous avez besoin.
| Pi | Claude Code | |
|---|---|---|
| Licence | MIT | Propriétaire, signée Anthropic |
| Modèles | Plus de 15 fournisseurs, modèles locaux | Modèles Claude |
| Sous-agents | Non intégrés ; ajout via extension | Intégrés nativement |
| Mode planification | Non intégré | Intégré nativement |
| Demandes d'autorisation | Aucune par conception ; isolation recommandée via conteneur | Approbations configurables |
| Personnalisation | Extensions TypeScript, paquets | Hooks, MCP, compétences (skills), réglages |
| Utilisation headless | Print, JSON, RPC, SDK | Mode print, SDK Agent |
Pourquoi des développeurs décident de passer à Pi
L'article à l'origine du fil de discussion, Goodbye Claude, hello Pi de Caleb, pointe du doigt « une accumulation de petites frustrations », plutôt qu'un bug isolé. Plus précisément :
- Instabilité des prompts (prompt churn). L'auteur a comptabilisé 244 versions de Claude Code cette année et relève que plus des trois quarts modifiaient le prompt système ou la description des outils, ce qui peut altérer le comportement du modèle sur un environnement finement ajusté.
- Surcharge en jetons (token overhead). La description par défaut de l'outil Bash consomme « près de 3 000 jetons » selon les calculs de l'auteur, principalement pour documenter git et les pull requests.
- Friction avec l'IDE. Une seule session VS Code pouvait se connecter à la fois. L'auteur a résolu ce problème dans Pi grâce à une extension écrite en une vingtaine de minutes.
- Périmètre fonctionnel. Les équipes d'agents et les modes de revue semblent conçus, selon l'auteur, pour gonfler la consommation de jetons en entreprise plutôt que pour servir les besoins d'un développeur individuel.
D'autres intervenants ont mentionné des bugs de rendu dans le terminal et d'historique de défilement (scrollback), ainsi que la prise en charge tardive du fichier AGENTS.md.
Pourquoi certains développeurs restent fidèles à Claude Code
Le fil apporte également la contradiction. Un participant a souligné que Pi « exige énormément de bricolage » pour égaler les fonctionnalités de Claude Code, qualifiant les extensions de « quasi incontournables ». Ce même intervenant a jugé supérieurs la compaction de contexte et le cache de prompts proposés par Claude Code sur les modèles Anthropic. D'autres ont rappelé que l'installation d'extensions tierces implique d'accorder sa confiance à du code ayant accès à vos jetons OAuth.
L'argument financier pèse également. Un utilisateur reste sur Claude Code en raison des « subventions colossales dont nous bénéficions » via le forfait d'abonnement, par rapport à une facturation au jeton. Si vous atteignez les plafonds, notre guide sur les limites d'utilisation de Claude Code détaille ce que chaque forfait autorise.
Lequel choisir selon vos besoins ?
Optez pour Pi si vous souhaitez maîtriser votre harness, changer de modèle à la volée, conserver un prompt léger et stable, et que l'exécution d'agents dans un conteneur ne vous pose pas de problème. Choisissez Claude Code si vous voulez disposer de sous-agents, d'un mode planification et d'invites de confirmation opérationnels dès le premier jour, et que vous travaillez principalement avec les modèles Claude. De nombreux développeurs choisissent d'ailleurs d'utiliser les deux, ce qui nous amène à la section suivante.
Exécuter Pi et Claude Code côte à côte dans Sharkly
Changer de harness ne coûte pas grand-chose. Changer l'environnement de travail qui l'entoure est une autre histoire. Les tâches, le contexte, l'avancement et les revues restent souvent confinés à la session d'un agent donné, ce qui signifie qu'un nouvel agent impose un nouveau flux de travail.
Sharkly constitue la couche située au-dessus de l'agent. Vous créez une tâche, vous l'assignez à un Agent, et cet Agent s'exécute sur un Computer (un ordinateur portable, un serveur ou une VM que vous connectez) par l'intermédiaire d'un Runtime (l'agent de code qui y est installé). La liste des Runtimes d'un Computer intègre déjà Claude Code, et Pi figure parmi les Runtimes pris en charge :
Pour l'essayer, installez Pi sur le Computer, puis cliquez sur Detect again sur la page de détails du Computer. La documentation de Sharkly détaille les différents statuts : un Runtime marqué comme Not installed nécessite l'installation de l'outil, et seul un Runtime Available peut exécuter les tâches confiées aux Agents.
# On the Computer that runs your agents
curl -fsSL https://pi.dev/install.sh | sh
sharkly computer register --install-token <install-token> # once per Computer
sharkly computer list # confirm it is online
Dès lors, le même tableau de tâches alimente les deux agents. Confiez un refactoring à un Agent sous Claude Code et une mise à jour de dépendances à un Agent sous Pi, puis examinez les deux résultats au même endroit. La consommation du modèle reste rattachée au forfait ou à la clé déjà utilisée par chaque Runtime, puisque Sharkly ne revend pas de jetons. Le forfait Free est à 0 $ pour les organisations comptant jusqu'à 5 personnes, d'après la page des tarifs (consultée le 9 novembre 2026).
Pour en savoir plus sur l'exécution simultanée de plusieurs agents, consultez notre guide : comment exécuter plusieurs agents Claude Code.
Exemples de configurations concrètes
- Développeur indépendant soucieux des coûts. Pi associé à un modèle local pour les travaux d'exploration, Claude Code pour les refactorings complexes.
- Équipe aux préférences variées. Certains développeurs sur Pi, d'autres sur Claude Code, et toutes les tâches regroupées sur un même tableau pour éviter de se demander « dans quelle session c'était déjà ? ».
- Automatisation. Les modes JSON et RPC de Pi se prêtent parfaitement aux exécutions scriptées ; renvoyez les résultats directement vers une tâche plutôt que dans un simple fichier de log.
Conclusion
Pi et Claude Code répondent à des problématiques différentes. Pi cherche à déterminer à quel point un harness peut être minimaliste si vous êtes prêt à bâtir le reste vous-même. Claude Code cherche à fournir d'emblée un flux de travail complet et clé en main. Ce choix n'a rien d'irréversible. Installez Pi dès aujourd'hui sur un Computer, confiez-lui une tâche sans risque dans Sharkly, et comparez le résultat avec la même tâche exécutée sur Claude Code.
FAQ
Pi est-il meilleur que Claude Code ?
Aucun des deux ne l'emporte nettement. Pi est plus compact, indépendant des fournisseurs et hautement extensible ; Claude Code intègre nativement des sous-agents, un mode planification et des demandes de confirmation. Le meilleur choix dépend avant tout de votre volonté : préférez-vous construire votre propre flux de travail ou en adopter un prêt à l'emploi ?
Pi est-il open source ?
Pi est publié sous licence MIT et son code source est disponible sur GitHub sous earendil-works/pi. Les modèles auxquels vous vous connectez conservent leurs propres licences et conditions d'utilisation.
Puis-je utiliser mon abonnement Claude avec Pi ?
La commande /login de Pi prend en charge les abonnements via OAuth pour les fournisseurs intégrés. Vérifiez toutefois les conditions d'utilisation de votre fournisseur avant d'exploiter un forfait grand public dans un harness tiers ; l'utilisation d'une clé d'API permet d'éviter toute ambiguïté.
Pi prend-il en charge le protocole MCP ?
Oui. Le site de Pi indique que le support de MCP est désormais intégré nativement, tout en maintenant la prise en charge des extensions MCP. Les versions précédentes ne l'incluaient pas.
Pi lit-il le fichier CLAUDE.md ?
Oui. La documentation de sécurité de Pi indique qu'il charge AGENTS.override.md, AGENTS.md et CLAUDE.md en tant que fichiers de contexte.
Est-il sûr d'exécuter Pi sur son ordinateur portable ?
Pi ne sollicite pas de confirmation avant chaque appel d'outil. Sa documentation recommande d'utiliser un conteneur, une machine virtuelle ou un bac à sable comme barrière de sécurité pratique la plus efficace.
Qui développe Pi ?
Mario Zechner est le créateur de Pi. Le projet est aujourd'hui édité par Earendil Inc. et ses contributeurs.
