Graphify : le plugin qui divise par 70 la consommation de Claude sur tes documents

Graphify est un plugin pour Claude Code qui construit une carte de tes documents business (contrats, devis, rapports, procédures) pour qu'il puisse répondre à tes questions sans avoir à tout relire à chaque fois. Au lieu de recharger 300 documents en mémoire chaque matin, Claude Code consulte une carte préparée une seule fois, qui sait où sont les infos et comment elles se recoupent. Résultat mesuré : jusqu'à 70 fois moins d'unités de texte consommées sur certaines questions (les unités de texte, qu'on appelle aussi tokens, sont ce que Claude facture). Le plugin a été rodé en interne chez Cypher IA sur un projet de plus de 600 pages avant d'être packagé et partagé avec nos clients. Il est distribué publiquement sur GitHub par son auteur, Safi Shamsi.

Sommaire

• Pourquoi Claude te coûte cher dès que tu lui donnes beaucoup de documents
• Ce que fait Graphify, concrètement
• Les 70× économisés : d'où vient le chiffre
• Comment installer Graphify en 30 secondes
• Quand utiliser la carte, quand rester sur la lecture classique
• Limites et alternatives honnêtes
• Questions fréquentes

Chez Cypher, on accompagne régulièrement des dirigeants qui alimentent Claude avec leurs contrats, leurs devis, leurs rapports, leurs procédures qualité — et qui atteignent leur limite avant midi sans comprendre pourquoi. Le vrai coupable est presque toujours une charge cachée au début de chaque session, quand Claude "ouvre" tous les documents pour "comprendre" la base. Graphify règle ce problème à la racine, et c'est un des leviers qu'on intègre dans nos missions d'audit IA.

Pourquoi Claude te coûte cher dès que tu lui donnes beaucoup de documents

Petit repère avant d'aller plus loin : quand tu parles à Claude, il compte ce que tu écris et ce qu'il lit en unités de texte. En gros, un mot courant = 1 à 2 unités. Plus il y a de texte à lire pour répondre, plus ça consomme, et c'est ce qu'Anthropic facture via sa grille publique. On va simplifier et dire "tokens" dans la suite, c'est le terme officiel.

Première idée à liquider : Claude ne se souvient de rien d'une session à l'autre. Si tu lui as envoyé tes 40 contrats clients lundi matin, mardi matin il ne les a plus en tête. Tu rouvres la conversation, et il repart de zéro.

Pour "comprendre" ta base, Claude fait la chose la plus simple : il relit. Il ouvre les documents qu'il estime pertinents et les charge dans sa mémoire de conversation. C'est invisible côté utilisateur, mais chaque document lu consomme des tokens facturés.

Un exemple concret : un cabinet d'expertise comptable qui veut faire synthétiser à Claude les 300 devis envoyés en 2024 pour identifier les clients les plus profitables. Sans carte, les premières minutes de la journée partent à relire passivement le dossier. Tu tapes deux questions, et tu es déjà à 40 % de ta limite quotidienne. Tu ne vois pas venir la consommation parce qu'elle est planquée dans des actions internes.

La mémoire de conversation de Claude, aussi large soit-elle (plusieurs centaines de milliers de tokens selon la version), n'est jamais assez grande face à une approche qui consiste à tout relire à chaque fois. Dès que ta base dépasse 150-200 documents, la méthode brute devient intenable.

Ce que fait Graphify, concrètement

Graphify est un plugin qui s'inscrit dans une famille d'approches popularisées par le projet de recherche Microsoft en 2024 et reprises depuis par Neo4j et d'autres. Le principe tient en une phrase : remplacer la relecture brute de documents par une consultation ciblée d'une carte structurée.

Une analogie : imagine que tu débarques dans une ville inconnue. Sans carte, tu dois parcourir chaque rue pour savoir ce qui s'y trouve — c'est la lecture brute. Avec un plan du métro, tu sais immédiatement où sont les quartiers, quelles lignes relient quoi, et tu te déplaces en quelques stations. Graphify, c'est le plan du métro de ta base documentaire.

Appliqué à ton entreprise, le flux est le suivant.

1. Tu pointes Claude Code vers le dossier où tu ranges tes documents business (contrats clients, devis, procédures, réglementation métier, base produit…). Le plugin lit tout, une seule fois.
2. Il extrait les entités importantes : noms de clients, secteurs, montants, clauses récurrentes, thèmes des procédures, produits référencés.
3. Il regroupe ces entités par proximité de sens. Une base type cabinet d'assurance aura typiquement un groupe "sinistres auto", un groupe "sinistres habitation", un groupe "réglementation", un groupe "fournisseurs experts".
4. Le tout est sauvegardé comme une carte attachée à ton dossier, que tu peux partager avec ton équipe ou garder pour toi.

À la session suivante, Claude Code ne rouvre plus les documents bruts pour "comprendre" la base. Il consulte la carte. Quand tu poses une question qui touche plusieurs dossiers — par exemple "quels clients BTP ont signé une clause de pénalité supérieure à 5 % en 2024 ?" — l'outil parcourt les nœuds concernés de la carte, récupère uniquement les chemins pertinents, et formule une réponse à partir d'une fraction minuscule du contenu initial.

Les 70× économisés : d'où vient le chiffre

Le ratio 70× est mesuré sur des questions qui touchent plusieurs documents en même temps — celles qui auraient demandé à Claude d'ouvrir dix à vingt contrats, devis ou rapports dispersés pour reconstituer une réponse complète. Typiquement : "fais-moi la synthèse des engagements de confidentialité pris sur nos 40 contrats clients 2024" ou "quels sont les motifs récurrents de refus de devis sur les 12 derniers mois ?".

Sans carte, Claude doit lire le contrat qui contient la première info, puis chercher les suivants, puis les annexes, puis les avenants. On parle facilement de 30 000 à 50 000 tokens consommés juste pour cadrer le problème, avant même la première phrase de réponse utile.

Avec Graphify, la même question déclenche une exploration de la carte : cinq à sept points remontent avec leurs connexions, Claude récupère un résumé structuré de 400 à 800 tokens, et formule une réponse équivalente. Ratio observé dans les tests qu'on a faits en interne : entre 40× et 70× selon la densité de la base et la profondeur de la question.

Le gain est donc très variable. Sur une question locale (un document précis, connu à l'avance), Graphify ne sert presque à rien, et c'est normal : il n'y a rien à recouper. C'est sur les questions de synthèse, de recoupement, de "où est-ce qu'on a déjà traité ce cas" que l'économie devient spectaculaire.

Pour un dirigeant qui utilise Claude tous les jours avec sa base documentaire, l'économie cumulée compte autant sur la facture que sur la fluidité. Tu n'atteins plus ta limite quotidienne, et tu enchaînes les vraies analyses sans te faire couper.

Si tu veux qu'on regarde où ton ratio gagne le plus sur ta propre base, un diagnostic IA de 15 minutes suffit à identifier les deux ou trois usages où l'impact sera le plus net.

Comment installer Graphify en 30 secondes

Avant de cliquer : deux mots importants à distinguer. Claude Desktop (ou claude.ai) est la fenêtre de chat classique où tu poses tes questions au quotidien. Claude Code est un deuxième outil d'Anthropic, distinct, qui peut exécuter des commandes sur ta machine — c'est lui qui installe et pilote les plugins comme Graphify. Tu ouvres Claude Code depuis ton application Claude, puis tu lui parles exactement comme tu parles à Claude dans le chat. La seule différence : lui, il peut agir.

Étape 1 — Ouvre Claude Code dans ton application Claude

Claude Code est l'outil d'Anthropic qui peut exécuter des commandes pour toi. C'est lui qui installe le plugin — pas la fenêtre de chat classique. Ouvre-le depuis ton application Claude (dans le menu ou via le raccourci clavier fourni par Anthropic selon ta plateforme). Si tu n'as pas encore Claude Code, la page officielle Anthropic couvre l'installation en un clic sur Mac, Windows et Linux.

Étape 2 — Colle le lien GitHub et demande à Claude Code d'installer

Voici le lien officiel du plugin : https://github.com/safishamsi/graphify

Tu le colles dans la barre de Claude Code avec une phrase simple — littéralement "Installe ce repo : https://github.com/safishamsi/graphify". Il télécharge la bibliothèque Python publiée sur PyPI sous le nom graphifyy (avec deux "y", c'est voulu), l'installe au bon endroit, et enregistre le plugin dans son environnement. Tu n'as pas besoin d'ouvrir un terminal, ni de savoir ce qu'est un paquet Python.

Si tu préfères avoir la référence sous la main : le package PyPI est `graphifyy`, les issues et le support vivent sur le tracker GitHub, et le détail technique des commandes plugin côté Anthropic est sur la doc officielle Claude Code. Mais du point de vue utilisateur, tu n'as rien à retenir : tu colles le lien, tu demandes l'install, Claude Code fait.

Étape 3 — Demande à Claude Code de cartographier ton dossier

Tu pointes Claude Code vers le dossier où tu ranges tes documents business (ça peut être un dossier sur ton ordinateur, ou un dossier Drive synchronisé localement — contrats, devis, rapports, procédures internes, base produit, peu importe). Tu lui dis simplement : "utilise graphify pour cartographier ce dossier" en lui donnant le chemin.

Claude Code lit chaque document, identifie les grands thèmes, les relations entre eux, et construit la carte. Selon la taille de ta base, ça prend entre deux et dix minutes la première fois. Tu n'as rien à faire pendant ce temps. À la fin, Claude Code te confirme qu'il a bien cartographié ton entreprise.

Étape 4 — Pose tes questions business comme d'habitude

À partir de ce moment, tu peux poser toutes tes questions à Claude Code comme avant — sauf que maintenant, il répond sans devoir tout relire. Les questions qui te coûtaient une fortune en consommation (synthèse de contrats, recoupement de devis, identification de patterns dans tes rapports) deviennent instantanées et 40 à 70 fois moins coûteuses.

La mise à jour de la carte se fait automatiquement dès que tu ajoutes ou modifies des documents dans le dossier. Tu n'as rien à gérer.

Quand utiliser la carte, quand rester sur la lecture classique

Graphify n'est pas une baguette magique qui remplace toutes les lectures. C'est un outil à utiliser au bon moment, sinon tu perds en précision sans gagner grand-chose.

Utilise la carte en priorité quand :

• Tu poses une question qui touche plusieurs documents à la fois ("quels clients BTP ont eu des avenants en 2024", "combien de devis refusés pour cause de prix en T4").
• Tu cherches "où est-ce qu'on a déjà traité ce cas" dans une base que tu connais mal.
• Tu fais un audit de cohérence sur tes contrats ou tes procédures.
• Tu veux comprendre les liens entre deux parties éloignées de ta base (par exemple : quelles procédures internes sont impactées par la nouvelle réglementation métier).

Reste sur la lecture classique quand :

• Tu sais exactement quel document tu veux analyser.
• Tu veux la valeur exacte d'un montant dans un devis précis.
• Tu fais relire un document court pour validation finale.
• Tu ne travailles que sur un seul dossier de moins de 10 pages.

La règle tient en une phrase : la carte est faite pour les questions de synthèse, la lecture classique est faite pour le travail sur un document connu. Quand tu sais quoi ouvrir, tu ouvres. Quand tu cherches à comprendre un ensemble, tu interroges la carte.

Côté Cypher, on applique cette hiérarchie sur les projets où on déploie Claude Code comme assistant intégré aux outils internes du client : la carte sert de premier filtre, la lecture classique arrive en second recours. La différence entre un dirigeant qui épuise sa limite Claude en trois heures et un dirigeant qui tient une journée complète, c'est souvent ce seul réflexe. Voir aussi notre cas client BTP appels d'offres, où ce pattern a été déployé sur une base de 400 dossiers.

Limites et alternatives honnêtes

Restons lucides : Graphify ne résout pas tout.

Limite 1 — la qualité de la carte dépend de la qualité de tes documents. Si tes contrats sont mal nommés, tes devis mélangés dans un dossier bazar, tes procédures sans intitulé clair, l'extraction est moins fiable. Avant d'en vouloir à l'outil, passe dix minutes à vérifier que la carte a bien regroupé les bons documents ensemble.

Limite 2 — le gain est nul sur les petites bases. Si tu as 20 documents en tout, Claude Code les lit tous en un appel sans problème. Graphify devient réellement intéressant à partir d'une centaine de documents, ou d'une arborescence complexe (sous-dossiers par client, par année, par secteur).

Limite 3 — pas de magie sur la compréhension profonde. La carte te dit où se trouve une info. Elle ne remplace pas la lecture attentive quand tu dois comprendre pourquoi une clause a été rédigée comme ça dans un contrat sensible. Pour ça, l'échange direct avec le document reste le bon réflexe.

Côté alternatives, trois approches méritent d'être citées.

Graphify est le choix pragmatique si tu utilises déjà Claude Code au quotidien et que tu veux zéro intégration complexe. Pour un besoin plus lourd (partage multi-outils, intégration avec un SI complexe), une solution sur mesure aura plus de sens — c'est exactement le type de choix qu'on aide à arbitrer en diagnostic.

Questions fréquentes

Est-ce que Graphify fonctionne avec tous les types de documents ?

Oui. Graphify couvre les formats que Claude Code sait déjà lire : Word, PDF, Excel, fichiers texte, markdown. Pour des formats plus spécifiques (scans d'images, documents chiffrés), il faut d'abord les rendre lisibles par Claude Code (OCR pour les scans). La carte est ensuite construite de la même façon. La liste à jour des formats supportés est maintenue sur le dépôt GitHub officiel.

Mes documents sont-ils envoyés à un serveur externe ?

Pour construire la carte, Claude Code lit tes documents via l'API Anthropic habituelle (celle que tu utilises déjà pour toutes tes conversations Claude). Il n'y a pas de serveur Graphify tiers qui stocke tes documents — le plugin est un package Python open source, pas un service hébergé. La carte finale reste sur ta machine (ou sur ton dossier Drive, selon ton organisation). Les règles de confidentialité d'Anthropic s'appliquent exactement comme pour tes conversations normales — elles sont détaillées sur la page produit Claude Code.

Combien coûte la construction initiale de la carte ?

Pour une base de 300 documents business (mix contrats, devis, rapports), la construction consomme environ 50 000 à 100 000 tokens en une seule passe. Au tarif Anthropic, ça représente quelques euros. Ensuite, les mises à jour quand tu ajoutes un nouveau document sont quasi gratuites. Comparé aux économies sur tes sessions suivantes, le coût est amorti en deux ou trois jours d'usage.

Est-ce que Graphify remplace ma GED ou mon CRM ?

Non. Graphify ne remplace pas les outils métier où tu stockes tes documents. Il vient se brancher sur le dossier où ils sont rangés (GED, Drive, SharePoint synchronisé en local) pour permettre à Claude Code de raisonner dessus sans tout relire. Ta GED reste ta GED, ton CRM reste ton CRM.

Faut-il reconstruire la carte à chaque nouveau document ?

Non. La carte se met à jour toute seule quand tu ajoutes ou modifies un document. Tu n'as rien à relancer manuellement. Une fois par mois, il est recommandé de demander à Claude Code un "grand rafraîchissement" pour que les regroupements par thèmes reflètent l'évolution réelle de ton activité — surtout si tu as beaucoup ajouté de nouveaux clients ou de nouvelles procédures.

Graphify fonctionne-t-il sur des bases sensibles (santé, finance réglementée) ?

Oui, avec les mêmes garanties que Claude Code lui-même. Pour des environnements particulièrement sensibles, il reste recommandé de valider le périmètre de ce qui est envoyé aux modèles, comme pour tout outil IA. Chez Cypher, on accompagne cette étape dans nos missions de stratégie IA, avec un audit préalable des documents qu'il est ou non pertinent d'exposer à un modèle externe.

Où signaler un bug ou demander une fonctionnalité ?

Le projet est open source. Les bugs, demandes d'évolution et discussions techniques passent par le tracker d'issues GitHub. Pour une intégration Graphify dans un environnement client (déploiement équipe, couplage outils métier, formation dirigeant), on prend le relais chez Cypher sur la partie accompagnement.

Prochaine étape

Le gain 70× est réel mais conditionné : il apparaît sur les questions qui croisent plusieurs documents, pas sur les lectures ponctuelles. Commence par prendre une base que tu utilises tous les jours (40 contrats, 300 devis, tes procédures internes), ouvre Claude Code, installe Graphify via le lien https://github.com/safishamsi/graphify, demande la carte, et observe sur une semaine comment tes questions changent.

Si tu veux qu'on pose un plan d'intégration précis sur ta base (Graphify + Claude Code + tes outils existants), on a une offre d'audit IA dédiée aux dirigeants qui veulent passer de "je teste l'IA" à "j'ai un vrai assistant qui connaît mon entreprise". Prends un créneau sur cal.com/paul-slama-s1ctqd/15min et on en discute.

Sources et références

• Dépôt GitHub officiel Graphify : github.com/safishamsi/graphify
• Package PyPI : `graphifyy` (v0.4.21 au 2026-04-23)
• Issues et support : github.com/safishamsi/graphify/issues
• Doc plugins Claude Code : docs.claude.com/en/docs/claude-code/plugins
• Page produit Claude Code : anthropic.com/claude-code