# 4 outils à installer avant de vibe coder avec Claude Code À la fin, Claude Code écrira moins de code inutile, connaîtra mieux ton projet, suivra des workflows d’ingénierie et pourra basculer vers un autre fournisseur quand ton modèle principal n’est plus disponible. Compte environ 30 minutes pour le setup, plus le temps du premier index Graphify si ton projet est gros. Il te faut Claude Code déjà installé, un terminal, Python 3.10+ pour Graphify et une version compatible de Node.js pour Ponytail et OmniRoute. Un **token** est un petit morceau de texte traité par un modèle. Moins de tokens inutiles signifie généralement moins de contexte envoyé, moins de coût et des réponses plus rapides. ## Vue d’ensemble | Outil | Ce que ça fait | Quand tu en as besoin | Temps d’installation | Niveau | |---|---|---|---:|---| | Ponytail | Pousse Claude à choisir la solution la plus simple qui répond au besoin | Quand Claude sur-construit des composants ou ajoute trop de code | 3 à 5 min | Débutant | | Graphify | Transforme ton projet en graphe de connaissances interrogeable | Quand Claude relit trop de fichiers ou comprend mal l’architecture | 8 à 15 min | Intermédiaire | | Agent Skills | Ajoute 25 workflows pour définir, planifier, coder, tester, revoir et livrer | Quand tu veux une méthode plus rigoureuse de bout en bout | 3 à 5 min | Débutant | | OmniRoute | Route Claude Code vers plusieurs fournisseurs et gère des fallbacks | Quand tu atteins une limite ou veux une solution de secours | 10 à 15 min | Intermédiaire | > Les temps sont des estimations pour un Mac déjà configuré. Le premier graphe Graphify peut prendre plus longtemps sur un gros dépôt. ## Avant d’installer quoi que ce soit - Lis le README et tout script d’installation avant de l’exécuter. Évite les commandes `curl | sh` que tu n’as pas inspectées. - Garde tes clés API dans des variables d’environnement ou dans un fichier `.env` local ajouté à `.gitignore`. - Ne mets jamais une clé dans une capture, un message public ou un dépôt GitHub. - Les quatre projets sont indépendants. Installe-les un par un et vérifie chaque outil avant de continuer. ## 1. Ponytail ### À quoi ça sert Ponytail oblige l’agent à vérifier d’abord si une fonctionnalité peut être évitée, réutilisée ou réalisée avec une fonction native avant d’ajouter une dépendance ou du code. Le benchmark officiel actuel mesure en moyenne **54 % de lignes de code en moins** et **22 % de tokens en moins** sur douze tâches, pas 50 % de tokens. Le gain varie fortement selon la tâche. Il peut être presque nul sur du code déjà minimal et beaucoup plus élevé quand Claude allait construire un composant inutilement complexe. ### Installation pas à pas 1. Vérifie que Node.js est disponible. Les hooks automatiques en ont besoin. macOS, Windows ou Linux, Terminal : ```bash node --version ``` 2. Ajoute le marketplace Ponytail dans Claude Code. Claude Code, tous les OS : ```text /plugin marketplace add DietrichGebert/ponytail ``` 3. Envoie ensuite cette seconde commande dans un nouveau message. Claude Code, tous les OS : ```text /plugin install ponytail@ponytail ``` 4. Démarre une nouvelle session Claude Code pour charger le plugin. ### Comment vérifier que ça marche Claude Code, tous les OS : ```text /ponytail ``` Résultat attendu : Ponytail affiche le niveau actif. Sur un projet avec des modifications non commitées, tu peux aussi lancer : ```text /ponytail-review ``` Résultat attendu : une revue du diff courant avec une liste de simplifications possibles. ### Premier usage Claude Code, tous les OS : ```text Utilise Ponytail en mode full. Ajoute une validation simple à ce formulaire en réutilisant d’abord ce qui existe déjà dans le projet. Ne crée aucun composant ou package qui n’est pas nécessaire. ``` ### Erreurs fréquentes 1. **Tu colles les deux commandes d’installation ensemble.** Le README demande de les envoyer séparément. 2. **Ponytail est installé mais ne s’active pas automatiquement.** Vérifie que `node` est visible dans le `PATH` du shell non interactif utilisé par Claude Code. 3. **Les commandes n’apparaissent pas.** Relance Claude Code ou recharge les plugins. ### Désinstaller ou désactiver Pour désactiver Ponytail pendant la session : ```text /ponytail off ``` Pour supprimer le plugin : ```text /plugin remove ponytail ``` ## 2. Graphify ### À quoi ça sert Graphify transforme les fichiers de ton projet en **graphe de connaissances**, c’est-à-dire une carte des fichiers, fonctions et relations du code. Claude peut interroger cette carte avant d’ouvrir des dizaines de fichiers. Le code est analysé localement avec tree-sitter. Les documents, PDF, images et vidéos peuvent utiliser un modèle selon le mode choisi. Le mode strict redirige la première lecture brute d’une session vers le graphe, puis laisse Claude continuer normalement. ### Installation pas à pas 1. Vérifie Python et `uv`. macOS, Terminal : ```bash python3 --version uv --version ``` 2. Si `uv` manque, installe Python et `uv` avec Homebrew. macOS, Terminal : ```bash brew install python@3.12 uv ``` Windows, PowerShell, uniquement si `uv` manque : ```powershell winget install astral-sh.uv ``` 3. Installe le paquet officiel. Il s’appelle `graphifyy` avec deux `y`, mais la commande reste `graphify`. macOS, Windows ou Linux, Terminal : ```bash uv tool install graphifyy ``` 4. Place-toi dans ton projet. macOS ou Linux, Terminal : ```bash cd /chemin/vers/ton-projet ``` Windows, PowerShell : ```powershell cd C:\chemin\vers\ton-projet ``` 5. Installe Graphify dans ce projet avec le mode strict. macOS, Windows ou Linux, Terminal : ```bash graphify install --project --strict ``` 6. Construis le premier graphe dans Claude Code. Claude Code, macOS ou Linux : ```text /graphify . ``` Sous PowerShell, utilise la commande sans slash : ```powershell graphify . ``` ### Comment vérifier que ça marche macOS, Windows ou Linux, Terminal, depuis le projet : ```bash graphify query "où se trouve l’authentification et quels modules l’utilisent ?" ``` Résultat attendu : Graphify renvoie des nœuds et des relations liés à l’authentification. Le dossier `graphify-out/` et le fichier de graphe doivent aussi avoir été créés. ### Premier usage Claude Code, tous les OS : ```text Avant d’ouvrir les fichiers un par un, interroge Graphify pour comprendre où se trouvent l’authentification, les appels API et les composants qui en dépendent. Résume la carte, puis propose le plus petit plan de modification. ``` ### Erreurs fréquentes 1. **`graphify: command not found`.** Lance `uv tool update-shell`, ferme le terminal et ouvre-en un nouveau. 2. **Tu as installé `graphify` depuis PyPI.** Le paquet officiel est `graphifyy`. 3. **`/graphify .` est interprété comme un chemin dans PowerShell.** Utilise `graphify .` sans slash. ### Désinstaller ou désactiver Pour retirer l’intégration du projet : ```bash graphify uninstall --project ``` Pour tout retirer et supprimer aussi les fichiers générés : ```bash graphify uninstall --purge ``` ## 3. Agent Skills d’Addy Osmani ### À quoi ça sert Un **skill** est un fichier d’instructions réutilisable qui dit à l’agent quand et comment suivre un workflow. Le pack d’Addy Osmani contient aujourd’hui **25 skills** pour cadrer une idée, écrire une spec, planifier, coder, tester, revoir la qualité et préparer la mise en ligne. Addy Osmani travaille aujourd’hui chez Anthropic sur Claude Code. Il a auparavant été directeur chez Google Cloud AI. ### Installation pas à pas 1. Ajoute le marketplace dans Claude Code. Claude Code, tous les OS : ```text /plugin marketplace add addyosmani/agent-skills ``` 2. Installe le pack complet. Claude Code, tous les OS : ```text /plugin install agent-skills@addy-agent-skills ``` 3. Démarre une nouvelle session Claude Code. ### Comment vérifier que ça marche Claude Code, tous les OS : ```text /spec ``` Résultat attendu : Claude démarre le workflow de définition du projet au lieu de coder immédiatement. Les commandes `/plan`, `/build`, `/test`, `/review` et `/ship` doivent aussi être disponibles. ### Premier usage Claude Code, tous les OS : ```text /spec Crée une landing page responsive pour un service de coaching. Commence par clarifier le public, la promesse, les sections et les contraintes avant de proposer l’implémentation. ``` ### Erreurs fréquentes 1. **Erreur SSH pendant l’ajout du marketplace.** Utilise l’URL HTTPS complète : ```text /plugin marketplace add https://github.com/addyosmani/agent-skills.git ``` 2. **Tu n’as installé qu’un skill avec `npx`.** Certaines références partagées ne sont alors pas copiées. Utilise le plugin complet pour ce guide. 3. **Les commandes ne se chargent pas.** Vérifie le plugin dans `/plugin`, puis redémarre la session. ### Désinstaller ou désactiver Pour désactiver sans supprimer, ouvre `/plugin`, sélectionne le plugin installé et choisis **Disable**. Pour le supprimer : ```text /plugin uninstall agent-skills@addy-agent-skills ``` ## 4. OmniRoute ### À quoi ça sert OmniRoute est un routeur local. Claude Code lui envoie une requête, puis OmniRoute choisit le fournisseur et le modèle configurés. Si la première cible renvoie une limite ou devient indisponible, un combo en stratégie `priority` essaie la suivante. Il ne contourne pas les limites Anthropic. Il utilise simplement d’autres fournisseurs que tu as configurés et dont tu acceptes les conditions. ```text Claude Code | v OmniRoute | +--> 1. Claude Code / modèle principal | | | +--> quota atteint, 429 ou cible indisponible | +--> 2. Groq / modèle gratuit configuré | +--> 3. autre fournisseur autorisé, si tu en ajoutes un ``` Un **MCP** est un protocole qui permet à un assistant d’utiliser des outils externes. OmniRoute peut exposer ses propres outils par MCP, mais ce n’est pas nécessaire pour faire fonctionner le fallback décrit ici. ### Offres gratuites vérifiées le 3 octobre 2026 | Fournisseur | Offre réellement documentée | Limite vérifiée | À retenir | |---|---|---|---| | Groq Free Plan | Oui | Pour `openai/gpt-oss-120b` : 30 RPM, 1 000 requêtes/jour, 8 000 tokens/minute et 200 000 tokens/jour | Les limites varient par modèle et par organisation | | OpenRouter `:free` | Oui | 50 requêtes gratuites/jour sans achat de crédits, 20 RPM ; 1 000/jour après au moins 10 $ de crédits achetés | Utilise uniquement les variantes `:free` ou `openrouter/free` | | Mistral Experiment | Oui, mais chiffre visible dans la console | Environ 1 milliard de tokens/mois par organisation selon l’audit OmniRoute du 2 septembre 2026 | À vérifier dans ton compte avant de t’y fier | | Gemini API Free Tier | Oui | Aucun plafond de tokens stable et public dans la source consultée | Vérifie la console Google AI Studio | Les quotas et les conditions changent. Vérifie toujours la page du fournisseur. Kiro et OpenCode Free ne sont pas recommandés ici comme fallbacks génériques : les propres notes d’OmniRoute signalent des restrictions de conditions ou de client. ### Installation pas à pas 1. Vérifie ta version de Node.js. OmniRoute demande `>=22.22.2 <23` ou `>=24.0.0 <27`. macOS, Windows ou Linux, Terminal : ```bash node --version ``` 2. Installe OmniRoute. macOS, Windows ou Linux, Terminal : ```bash npm install -g omniroute ``` 3. Lance le setup local. macOS, Windows ou Linux, Terminal : ```bash omniroute ``` Résultat attendu : le tableau de bord s’ouvre sur `http://localhost:20128`. 4. Connecte tes fournisseurs dans le tableau de bord. Navigateur, tous les OS : ```text Dashboard → Providers → Connect Claude Code Dashboard → Providers → Connect Groq ``` Pour Groq, crée une clé dans la console Groq et colle-la uniquement dans le champ prévu. Ne la mets pas dans le projet. 5. Crée une clé OmniRoute pour Claude Code. Navigateur, tous les OS : ```text Dashboard → Endpoints → Create API key ``` 6. Crée le combo de fallback. Navigateur, tous les OS : ```text Dashboard → Combos → Create New Name: claude-puis-gratuit Strategy: priority 1. cc/claude-sonnet-4-6 2. groq/openai/gpt-oss-120b ``` La syntaxe API officielle équivalente est ci-dessous. Elle est optionnelle et demande une clé OmniRoute avec le scope `manage`. macOS ou Linux, Terminal : ```bash export OMNIROUTE_MANAGE_KEY="colle-ta-cle-manage-ici" curl -X POST http://localhost:20128/api/combos \ -H "Authorization: Bearer $OMNIROUTE_MANAGE_KEY" \ -H "Content-Type: application/json" \ -d '{"name":"claude-puis-gratuit","strategy":"priority","models":[{"model":"cc/claude-sonnet-4-6"},{"model":"groq/openai/gpt-oss-120b"}]}' ``` Windows, PowerShell : ```powershell $env:OMNIROUTE_MANAGE_KEY="colle-ta-cle-manage-ici" curl.exe -X POST http://localhost:20128/api/combos ` -H "Authorization: Bearer $env:OMNIROUTE_MANAGE_KEY" ` -H "Content-Type: application/json" ` -d '{"name":"claude-puis-gratuit","strategy":"priority","models":[{"model":"cc/claude-sonnet-4-6"},{"model":"groq/openai/gpt-oss-120b"}]}' ``` 7. Définis ce combo comme choix par défaut. macOS, Windows ou Linux, Terminal : ```bash omniroute combos switch claude-puis-gratuit ``` 8. Lance Claude Code à travers OmniRoute. macOS, Windows ou Linux, Terminal : ```bash omniroute launch ``` La méthode manuelle documentée utilise ces variables. L’URL Anthropic ne doit pas contenir `/v1`. macOS ou Linux, Terminal : ```bash export ANTHROPIC_BASE_URL="http://localhost:20128" export ANTHROPIC_AUTH_TOKEN="$OMNIROUTE_API_KEY" claude ``` ### Comment vérifier que ça marche macOS ou Linux, Terminal : ```bash curl http://localhost:20128/v1/models \ -H "Authorization: Bearer $OMNIROUTE_API_KEY" ``` Résultat attendu : la réponse contient les modèles connectés. Dans OmniRoute, la page de logs doit ensuite montrer les requêtes envoyées par Claude Code et le modèle réellement utilisé. ### Premier usage Claude Code, tous les OS : ```text Crée une landing page très simple avec un titre, trois bénéfices et un bouton. Avant de coder, confirme le modèle actif. Si OmniRoute bascule vers un fallback, indique-le dans ton résumé final sans interrompre la tâche. ``` ### Erreurs fréquentes 1. **Claude Code ignore OmniRoute.** Vérifie que `ANTHROPIC_BASE_URL` ne contient pas `/v1`, puis redémarre Claude Code. 2. **Erreur d’authentification.** Le profil ne stocke pas la clé. Utilise `omniroute launch` ou exporte `ANTHROPIC_AUTH_TOKEN`. 3. **Le modèle gratuit ne fonctionne plus.** Vérifie le quota et les conditions sur le site du fournisseur, puis remplace le modèle dans le combo. ### Désinstaller ou désactiver Arrête OmniRoute dans son terminal avec `Ctrl+C`. Pour supprimer le paquet global tout en gardant les données locales : ```bash npm uninstall -g omniroute ``` Les configurations restent dans `~/.omniroute/`. Consulte le guide officiel de désinstallation avant de supprimer ce dossier, car cette suppression efface les clés, les combos et l’historique. ## Le workflow complet Voici une routine simple pour créer une landing page avec les quatre outils. 1. Installe Ponytail, Graphify, Agent Skills, puis OmniRoute dans cet ordre. 2. Ouvre le dossier du projet dans le terminal. 3. Lance `/graphify .` une fois pour cartographier le projet. 4. Utilise `/spec` pour définir le public, la promesse et les contraintes. 5. Lance `/plan` pour obtenir de petites tâches vérifiables. 6. Active `/ponytail full` avant la construction. 7. Lance `/build` pour implémenter une tranche à la fois. 8. Utilise `/test`, puis `/ponytail-review` pour vérifier et simplifier le diff. 9. Garde `claude-puis-gratuit` actif dans OmniRoute pendant le travail. 10. Si Claude atteint sa limite, vérifie dans les logs qu’OmniRoute a basculé vers Groq avant de continuer. ## Check-list finale - [ ] `node --version` correspond aux exigences d’OmniRoute. - [ ] `/ponytail` affiche un niveau actif. - [ ] `graphify query "..."` renvoie des éléments du projet. - [ ] `/spec`, `/plan`, `/build`, `/test` et `/ship` sont disponibles. - [ ] OmniRoute répond sur `http://localhost:20128`. - [ ] Les modèles apparaissent dans `/v1/models`. - [ ] Le combo place Claude en premier et le modèle gratuit en second. - [ ] Un test réel apparaît dans les logs OmniRoute. - [ ] Aucune clé n’est enregistrée dans Git ou visible dans une capture. - [ ] Tu as relu les conditions du fournisseur gratuit choisi. ## Si ça ne marche pas N’envoie pas tes clés API par DM. Ouvre une issue dans le dépôt concerné avec ta version, ton système, la commande lancée et le message d’erreur, sans secret : - Ponytail : https://github.com/DietrichGebert/ponytail/issues - Graphify : https://github.com/Graphify-Labs/graphify/issues - Agent Skills : https://github.com/addyosmani/agent-skills/issues - OmniRoute : https://github.com/diegosouzapw/OmniRoute/issues ## Sources Toutes les sources ont été lues le 3 octobre 2026. - https://github.com/DietrichGebert/ponytail - https://github.com/DietrichGebert/ponytail/blob/HEAD/benchmarks/results/2026-06-18-agentic.md - https://github.com/Graphify-Labs/graphify - https://github.com/addyosmani/agent-skills - https://addyosmani.com/ - https://code.claude.com/docs/en/plugins/install - https://github.com/diegosouzapw/OmniRoute - https://github.com/diegosouzapw/OmniRoute/blob/HEAD/docs/guides/SETUP_GUIDE.md - https://github.com/diegosouzapw/OmniRoute/blob/HEAD/docs/guides/USER_GUIDE.md - https://github.com/diegosouzapw/OmniRoute/blob/HEAD/docs/guides/CLAUDE-CODE-CONFIGURATION.md - https://github.com/diegosouzapw/OmniRoute/blob/HEAD/docs/reference/FREE_TIERS.md - https://github.com/diegosouzapw/OmniRoute/blob/HEAD/docs/guides/UNINSTALL.md - https://console.groq.com/docs/rate-limits - https://openrouter.ai/docs/api_reference/limits ## Pour continuer Suis **@dbg_lab** pour d’autres guides pratiques sur Claude Code, les agents IA et les outils qui font gagner du temps.