SSD Nodes Learn Hosting plans →
Guides Matt ConnorPar Matt Connor

Graphify et vos limites Claude : qui paie quoi

On lit partout « 70x moins de tokens ». Voici ce qui puise dans votre forfait Claude Pro ou Max, ce qui reste local, et comment mesurer avec /usage.

Graphify et vos limites Claude : la réponse courte

Graphify et vos limites Claude ne se croisent qu'à un seul endroit : les documents. Graphify analyse le code de votre dépôt en local, sans appeler de modèle, donc ce code ne consomme rien sur votre forfait Pro ou Max. Les fichiers Markdown, les PDF et les images, eux, sont lus par le modèle de votre session Claude Code, sauf si une clé Gemini est définie dans votre environnement. Cette lecture compte dans votre limite de cinq heures et dans votre limite hebdomadaire.

Le reste dépend de vos réglages. Les hooks ajoutent un peu de contexte à certaines requêtes. Le mode headless (graphify extract) peut passer par votre forfait, par une clé API facturée à part ou par un serveur à l'étranger. Tout dépend des variables d'environnement présentes dans votre shell. Quant au gain annoncé, un test indépendant sur quatre tâches dans Claude Code n'a pas montré d'économie de tokens. Ce guide vous montre donc comment le mesurer vous-même.

Qu'est-ce que Graphify, concrètement ?

Graphify transforme un dépôt en graphe de connaissances. Pour le code, il utilise tree-sitter, une bibliothèque qui construit un AST (arbre syntaxique abstrait) pour chaque fichier. Le README du projet le dit clairement : « Code is parsed with tree-sitter AST: deterministic, no LLM, nothing leaves your machine. » Les fonctions, les classes et les modules deviennent des nœuds. Leurs relations deviennent des arêtes.

Les résultats sont écrits dans le dossier graphify-out/ :

  • graph.html : une vue interactive à ouvrir dans un navigateur, avec recherche et filtres.
  • GRAPH_REPORT.md : les points importants, c'est-à-dire les concepts clés, les connexions inattendues et des questions suggérées.
  • graph.json : le graphe complet, que l'on peut interroger sans relire les fichiers.
  • cost.json : écrit par le skill, avec le décompte de tokens de la construction.

Dans Claude Code, Graphify s'installe comme un skill, /graphify. Il peut aussi ajouter des hooks qui orientent Claude vers le graphe avant qu'il ouvre vos fichiers un par un. L'idée est simple : une question sur l'architecture coûte moins cher si Claude lit un extrait du graphe au lieu de parcourir des dizaines de fichiers. Si ces mécanismes sont nouveaux pour vous, lisez d'abord le fonctionnement des hooks de Claude Code et la différence entre skills, MCP et fichiers de règles.

Installer une version épinglée de graphifyy

Le paquet PyPI s'appelle graphifyy, avec deux y. La commande s'appelle graphify, avec un seul. La documentation d'installation prévient que d'autres paquets au nom proche ne viennent pas de Graphify Labs. Vérifiez donc l'orthographe avant de valider. Au 13 novembre 2026, la dernière version sur PyPI est la 0.9.108, publiée le 12 novembre 2026, sous licence Apache-2.0. Elle demande Python 3.10 à 3.14 (>=3.10,<3.15).

Le projet publie une version presque chaque jour. Épinglez la version, pour que ce que vous lisez ici corresponde à ce que vous exécutez :

uv tool install graphifyy==0.9.108
uv tool list
graphify install --platform claude

uv tool list doit afficher graphifyy v0.9.108, suivi des commandes installées, dont graphify. Si votre shell répond graphify: command not found, le dossier des outils uv n'est pas dans votre PATH. Lancez uv tool update-shell, puis ouvrez un nouveau terminal. Avec pipx, la ligne équivalente est pipx install graphifyy==0.9.108, suivie de pipx ensurepath si besoin.

Pour passer à une version plus récente, changez le numéro et réinstallez. La documentation demande ensuite de relancer graphify install, et graphify hook install si vous utilisez les hooks git.

Quels fichiers Graphify modifie-t-il ?

Trois commandes se ressemblent, mais elles ne touchent pas les mêmes fichiers. La page d'installation officielle dit seulement « Read the installer's list of files before committing them. » Elle ne donne pas cette liste. Celle qui suit vient du code source, le fichier graphify/install.py de la branche par défaut du dépôt (v8), et du cookbook Claude Code de Graphify.

graphify install agit dans votre profil utilisateur :

  • il copie le skill dans ~/.claude/skills/graphify/SKILL.md, ou dans $CLAUDE_CONFIG_DIR/skills/graphify/SKILL.md si cette variable est définie ;
  • il écrit à côté un dossier references/ et un fichier .graphify_version ;
  • si un ancien SKILL.md différent existe, il le garde sous le nom SKILL.md.bak ;
  • il ajoute ou rafraîchit un bloc # graphify dans ~/.claude/CLAUDE.md, ou dans $CLAUDE_CONFIG_DIR/CLAUDE.md si cette variable est définie.

Ce dernier point surprend souvent. Même la commande la plus simple modifie un CLAUDE.md : celui de votre configuration utilisateur. Claude Code charge ce fichier dans toutes vos sessions, quel que soit le projet.

graphify claude install agit dans le projet courant :

  • il crée ou complète CLAUDE.md à la racine du dépôt avec une section ## graphify, qui demande à Claude d'interroger le graphe avant sa première recherche ;
  • il modifie .claude/settings.json pour y placer les hooks de Graphify, remplace les anciennes entrées Graphify et garde une sauvegarde.

Le code source précise qu'il ne touche ni .claude/settings.local.json ni ~/.claude/settings.json. Si vous le relancez sans changement, il répond no change.

graphify install --project installe le skill dans le dépôt, sous .claude/skills/graphify/SKILL.md, et écrit le bloc d'enregistrement dans .claude/CLAUDE.md. Dans le code, cette option appelle aussi la même routine que graphify claude install. Vous obtenez donc en plus le CLAUDE.md à la racine et .claude/settings.json. La commande affiche ensuite une suggestion de git add pour .claude et CLAUDE.md. Les hooks d'un projet appellent la commande graphify sans chemin absolu, pour que la configuration commitée fonctionne aussi sur la machine d'un collègue. Ce collègue doit donc avoir installé Graphify lui aussi.

Vérifiez ce qui a changé avant de commiter :

cd ~/projets/mon-api
graphify claude install
git status --short
grep -n 'hook-guard' .claude/settings.json

git status --short doit lister CLAUDE.md et .claude/settings.json. Le grep doit trouver les commandes graphify hook-guard search, graphify hook-guard read et graphify hook-guard compact. Si le grep ne trouve rien, l'installation n'a pas écrit les hooks dans ce projet. Vérifiez que vous étiez bien à la racine du dépôt.

Que font les hooks de Graphify, et que coûtent-ils ?

Un hook PreToolUse est une commande que Claude Code exécute juste avant d'appeler un outil. Graphify pose deux hooks PreToolUse et un hook SessionStart :

  • le matcher Bash|Grep lance graphify hook-guard search ;
  • le matcher Read|Glob lance graphify hook-guard read ;
  • le hook SessionStart avec le matcher compact lance graphify hook-guard compact après une compaction du contexte.

Chaque hook a un délai maximum de 10 secondes. La présence de Bash dans le premier matcher est importante. Sur macOS, Linux et WSL, Claude Code n'inclut pas les outils Glob et Grep dans son jeu d'outils par défaut, d'après la référence des outils. Claude cherche alors avec find et grep à travers l'outil Bash. Un ancien matcher de Graphify, Glob|Grep, ne se déclenchait donc plus à partir de Claude Code v2.1.117. Le ticket #578 du dépôt Graphify décrit ce problème, et il a été fermé le 27 avril 2026. Si vous avez installé les hooks il y a plusieurs mois, relancez l'installation avec la 0.9.108.

Par défaut, ces hooks ne bloquent rien. Quand graphify-out/graph.json existe, ils ajoutent un rappel qui pointe vers le graphe. Quand il n'existe pas, ils n'affichent rien. En cas d'erreur, ils laissent passer l'appel. Le nombre de rappels est plafonné par agent par la variable GRAPHIFY_HOOK_NUDGE_CAP, qui vaut 5 par défaut. Les sous-agents qui partagent une session ont chacun leur propre budget. Une compaction réinitialise ces budgets : cinq n'est donc pas un plafond pour toute la session.

Le mode strict va plus loin, mais moins loin que son nom le laisse penser :

graphify install --project --strict

Avec --strict, un appel Read et un appel Grep dédié partagent un seul refus par session, réinitialisé après une compaction. Ce refus ne s'applique pas si une commande graphify query, graphify explain ou graphify path a tourné dans les 1800 dernières secondes (variable GRAPHIFY_HOOK_STRICT_TTL). Bash et Glob restent en mode rappel. GRAPHIFY_HOOK_STRICT=1 ou GRAPHIFY_HOOK_STRICT=0 force le mode strict, ou le coupe, sans réinstaller.

Et le coût ? Selon la documentation des hooks, le champ additionalContext d'un hook passe dans la fenêtre de contexte de Claude, sous forme de rappel système. Chaque rappel de Graphify est donc du texte en plus dans la requête. Le CLAUDE.md est aussi chargé au début de chaque session, d'après la page sur les coûts de Claude Code. Anthropic ne publie pas le poids exact de ce texte sur votre forfait. Ces deux postes sont permanents, alors que le gain n'existe que si Claude lit vraiment moins de fichiers. Pour voir où partent vos tokens en général, l'explication de la consommation de tokens dans Claude Code détaille chaque poste.

Le code ne coûte rien, mais la documentation passe par votre forfait

Le blog de Graphify résume la règle en une phrase : « In Claude Code, the docs go to the model your session already uses. » Le même article précise que le code reste analysé en local, sans modèle, et que seuls les documents coûtent des tokens. Pour cette route, il n'y a pas besoin de clé API séparée.

Pour un abonné Pro ou Max, cela a une conséquence directe. L'aide Claude indique que Pro et Max ont une limite de session de cinq heures et une limite hebdomadaire. Ces limites sont partagées entre Claude et Claude Code. Sans clé Gemini dans votre environnement (voir plus bas), chaque document lu par /graphify compte donc dans les mêmes limites que vos conversations sur claude.ai.

Le skill ne lit pas tout en une seule fois. D'après son fichier skill.md (branche v8), la passe sémantique lance des sous-agents en parallèle avec l'outil Agent. Chaque sous-agent reçoit un lot de 20 à 25 fichiers, pour environ 6000 lignes au maximum. Le nombre de sous-agents est estimé à un pour 22 fichiers non-code qui ne sont pas encore en cache. La page sur les coûts de Claude Code le confirme : les requêtes d'un sous-agent puisent elles aussi dans votre usage. Le skill prévient lui-même que l'extraction « can cost minutes and tens of thousands of tokens ». Au-delà de 2 000 000 de mots ou de 500 fichiers, il vous demande de choisir un sous-dossier si des sous-dossiers existent. Si tous les fichiers sont à la racine, il poursuit et suggère --no-cluster pour éviter l'étape coûteuse de regroupement.

Quel modèle utilisent ces sous-agents ? Graphify n'en nomme aucun. La page sur les coûts de Claude Code indique que certains sous-agents héritent du modèle de la session. Ne supposez rien : vérifiez la ligne des sous-agents dans /usage après la construction.

Ce qui compte comme document est plus large qu'on ne le croit. Les fichiers .md, .mdx, .txt, .rst et .html en font partie. La page de Graphify sur les économies de tokens le dit : « A README and a folder of screenshots are enough to trigger it. » Un dépôt avec un dossier docs/ bien rempli déclenche donc une vraie passe de modèle au premier /graphify ..

Quatre leviers gardent cette passe sous contrôle :

  • construire le graphe du code seul avec graphify extract . --code-only, qui n'appelle aucun modèle ;
  • exclure durablement les dossiers de documentation avec un fichier .graphifyignore ;
  • mettre à jour avec graphify update ., qui n'appelle jamais de modèle ;
  • compter sur le cache : les documents inchangés réutilisent les résultats déjà extraits.

Les hooks git (graphify hook install) se branchent sur post-commit, post-checkout, post-merge et post-rewrite. Ils reconstruisent le graphe dans un processus en arrière-plan et ne bloquent jamais une opération git. La reconstruction respecte le choix --code-only enregistré lors de la construction.

graphify extract en mode headless : quel backend paie ?

Hors de Claude Code, graphify extract fait la passe sémantique lui-même, avec un backend. La documentation des fournisseurs liste gemini, kimi, claude (l'API Anthropic), openai, deepseek, azure, bedrock, ollama et claude-cli. Sans choix explicite, Graphify choisit selon les clés API présentes dans l'environnement, dans cet ordre : Gemini, Kimi, Claude, OpenAI, DeepSeek, Azure, Bedrock, Ollama.

D'après cet ordre, une MOONSHOT_API_KEY oubliée dans votre .bashrc passe avant votre clé Anthropic. Regardez ce que votre shell exporte, puis passez toujours --backend :

env | grep -i '_API_KEY'

Si la commande n'affiche rien, Bedrock peut encore être choisi via AWS_PROFILE, AWS_REGION ou AWS_DEFAULT_REGION, et GRAPHIFY_BACKEND peut imposer un backend. Si elle affiche une clé que vous n'utilisez plus, retirez-la de votre profil shell.

Le backend claude-cli utilise votre forfait. Il lance la commande claude installée en local, avec -p --output-format json. Il passe donc par votre connexion Claude Code au lieu d'une clé API. Il n'est jamais détecté automatiquement : il faut écrire --backend claude-cli. Sur le modèle utilisé, les pages de Graphify ne sont pas d'accord. Le README dit que le modèle par défaut est Opus. La page des variables d'environnement dit « plan default ». Dans le code (llm.py), aucune option --model n'est passée si la variable n'est pas définie, donc c'est le modèle par défaut de votre Claude Code qui s'applique. Ne laissez pas ce choix au hasard :

GRAPHIFY_CLAUDE_CLI_MODEL=sonnet graphify extract . --backend claude-cli

Le README note que haiku ou sonnet suffisent en général pour nommer les communautés du graphe, et que l'extraction sémantique profite d'un modèle plus grand. Le choix se fait entre qualité d'extraction et limite hebdomadaire.

Un piège à connaître : si ANTHROPIC_API_KEY est définie, Claude Code utilise cette clé à la place de votre abonnement, d'après l'aide Claude. L'usage est alors facturé au tarif de l'API, et il ne compte plus dans votre forfait. Le backend claude-cli appelle claude, donc la même règle devrait s'appliquer à vos extractions. Nous ne l'avons pas testé. Lancez unset ANTHROPIC_API_KEY dans le shell avant l'extraction pour écarter ce cas. La différence entre connexion par abonnement et par clé API explique comment voir quel mode est actif.

Le backend claude (API Anthropic) est facturé à part. Il utilise ANTHROPIC_API_KEY et se paie au token, en dehors de l'abonnement. Son modèle par défaut dans Graphify est claude-sonnet-4-6, un modèle plus ancien que la gamme 5.5 actuelle. Définissez ANTHROPIC_MODEL si vous voulez un autre modèle. Pour comparer, la page de tarifs de l'API donne 2 $ par million de tokens en entrée et 10 $ en sortie pour Sonnet 5.5.

Kimi, Ollama ou rien : où partent vos fichiers ?

Pour une entreprise française, la question n'est pas seulement le coût. Le README est explicite : « Kimi (MOONSHOT_API_KEY) routes to Moonshot AI servers in China. » Le point d'accès par défaut est https://api.moonshot.ai/v1. Selon la documentation, les backends reçoivent les fichiers non-code (documents, PDF, images, transcriptions) et les libellés des nœuds. Ces envois passent d'abord par les règles d'exclusion et par un filtre de fichiers sensibles. Les libellés des nœuds peuvent reprendre des noms tirés de votre code.

Si ces fichiers contiennent des données personnelles, leur envoi vers la Chine est un transfert hors de l'Union européenne. Le RGPD (règlement général sur la protection des données) encadre ce type de transfert. Parlez-en à votre DPO (délégué à la protection des données) avant le premier essai. Graphify propose un accord de traitement des données (DPA) sur demande.

Pour tout garder sur votre machine, trois commandes suffisent :

GRAPHIFY_BACKEND=none graphify extract .
graphify extract . --code-only
graphify extract . --backend ollama

GRAPHIFY_BACKEND=none (ou off, ou disabled) saute tous les appels de modèle. La passe locale sur le code tourne quand même. --code-only ignore les documents, les articles et les images, et n'a besoin d'aucune clé. --backend ollama fait la passe sémantique avec un modèle Ollama local, et la documentation dit que rien ne quitte votre machine. Il vous faut alors un serveur Ollama en marche et l'extra ollama de Graphify :

uv tool install 'graphifyy[ollama]==0.9.108'

Attention : ces réglages ne concernent que le CLI. Le skill /graphify dans Claude Code est une autre route, et son fichier skill.md ne mentionne pas GRAPHIFY_BACKEND. Si GEMINI_API_KEY ou GOOGLE_API_KEY est définie, le skill envoie les documents à Gemini, chez Google (modèle par défaut gemini-3-flash-preview), au lieu de lancer des sous-agents. Sinon, c'est le modèle de votre session qui les lit, donc chez Anthropic.

D'où viennent les « 70x moins de tokens » ?

Les articles sur Graphify parlent souvent de 70x moins de tokens. Voici ce que disent les pages primaires que nous avons ouvertes :

  • La page d'accueil graphify.com affiche « 79× fewer tokens » dans un témoignage client. C'est un témoignage, pas une mesure, et la page ne donne pas de chiffre 70x.
  • La page benchmark de la documentation donne 136,8x sur un graphe de démonstration.
  • Le cookbook Claude Code annonce 791,0x sur le dépôt de Graphify lui-même, et précise : « It's an estimate, not a measurement of a real Claude session. »
  • Le fichier BENCHMARKS.md du dépôt rapporte environ 140 000 tokens par question sur un corpus ERPNext d'environ un million de lignes, avec six questions.

La commande graphify benchmark calcule ses ratios d'une façon précise. Le côté « naïf » est le corpus entier, converti à environ 133 tokens pour 100 mots. Chaque réponse du graphe est mesurée à environ 4 caractères par token. Cinq questions types tournent hors ligne contre graph.json. Le ratio est le coût naïf divisé par la réponse moyenne. La documentation précise que l'outil compare des tokens et ne vérifie pas si la réponse est juste. Elle ajoute qu'un corpus de moins de 50 000 mots environ peut montrer une faible réduction.

Le vrai problème est la base de comparaison. Claude Code ne charge pas tout votre dépôt pour répondre à une question : il cherche, puis ouvre les fichiers qui semblent utiles. Le gain réel est donc l'écart entre ces lectures ciblées et une requête au graphe. Le benchmark ERPNext de Graphify compare bien un agent avec graphe à un agent qui cherche et lit les fichiers, sur six questions ; il ne mesure pas l'économie de votre forfait Claude Code.

Un test indépendant de Quang Rau sur GonnaCrash compare quatre tâches dans des sous-agents Claude Code avec Sonnet, avec et sans Graphify. Il mesure les tokens, les appels d'outils, le temps et la justesse, et ne constate aucune économie de tokens avec Graphify. Ce petit échantillon ne permet pas de généraliser. Nous ne donnons donc pas de ratio à notre tour. La seule mesure qui compte est la vôtre, sur votre dépôt.

Comment comparer une session avec et sans le graphe dans /usage ?

Claude Code affiche sa propre consommation avec la commande /usage. Sur Pro, Max, Ultra, Team ou Enterprise, elle montre les barres d'usage du forfait. Elle montre aussi une répartition de l'usage récent par skill, sous-agent, plugin et serveur MCP. La page sur les coûts précise un point important : le montant en dollars du bloc Session vise les utilisateurs de l'API, et il ne sert pas à la facturation d'un abonné. Lisez donc les barres et la répartition, pas le dollar. L'aide Claude cite aussi /status pour suivre l'usage. Si l'une des deux commandes manque, votre version de Claude Code n'est sans doute pas à jour.

Voici une méthode simple :

  1. Vérifiez votre version avec claude --version. La remise à zéro des totaux de session par /clear existe depuis la v2.1.211, et la ligne Prompt cache (main) depuis la v2.1.251.
  2. Choisissez quelques tâches réelles et répétables sur votre dépôt, par exemple « où est validé le jeton d'authentification, et qui appelle cette fonction ? ». Gardez le texte exact du prompt dans un fichier, pour le coller à l'identique.
  3. Session A, sans graphe : avant toute installation dans ce projet, ouvrez Claude Code, lancez /usage et notez la position des barres. Collez la tâche, attendez la fin, puis relancez /usage.
  4. Construisez le graphe du code seul avec graphify extract . --code-only, qui n'appelle aucun modèle. Lancez ensuite graphify claude install.
  5. Session B, avec graphe : tapez /clear, gardez le même modèle et le même niveau d'effort, collez le même prompt. Relevez /usage avant et après.
  6. Répétez plusieurs paires A et B. Une seule paire ne prouve rien, parce que Claude ne suit pas deux fois le même chemin.

Le /clear de l'étape 5 compte aussi pour une autre raison. D'après la page sur le cache de prompts, un CLAUDE.md modifié en cours de session ne s'applique qu'après /clear, /compact ou un redémarrage. Sans ce /clear, la session B ne voit pas la section ## graphify.

Trois précautions rendent la comparaison honnête. D'abord, les barres du forfait couvrent tout votre compte. N'utilisez pas claude.ai ni une autre machine pendant le test, sinon leur activité se mélange à la vôtre. La répartition par skill et sous-agent, elle, est calculée à partir de l'historique local de cette machine, et elle est approximative. Ensuite, le cache compte. Sur un abonnement, tant que vous restez dans l'usage inclus, Claude Code demande une durée de vie de cache d'une heure pour la conversation principale, et cinq minutes pour les sous-agents. Après une longue pause, le premier tour reconstruit le cache. Enchaînez donc A et B sans longue interruption. Enfin, la construction du graphe est un coût d'entrée. Si vous construisez avec /graphify . sur un dépôt riche en documents, cette construction apparaît dans /usage côté skill et sous-agents. Il faut la compter, puis voir en combien de sessions elle est remboursée.

Si votre limite tombe déjà souvent, mesurez d'abord ce qui la consomme. Ce qui consomme votre limite Claude Pro et la gestion du contexte dans Claude Code couvrent les causes les plus fréquentes, qui n'ont souvent rien à voir avec la recherche dans le code. Et si la limite est atteinte en plein travail, que faire quand la limite Claude est atteinte liste les options.

Comment désinstaller Graphify proprement ?

graphify claude uninstall
graphify uninstall
uv tool uninstall graphifyy

graphify claude uninstall retire les sections Graphify de CLAUDE.md, de CLAUDE.local.md et de .claude/CLAUDE.local.md. Il retire aussi les hooks de .claude/settings.json et de .claude/settings.local.json. graphify uninstall retire les enregistrements de votre profil. Sans --project, il retire aussi les hooks git et le merge driver. Ajoutez --purge pour supprimer graphify-out/. Sans cette option, le graphe reste sur le disque. Lancez ensuite git status --short : CLAUDE.md doit apparaître comme modifié ou supprimé s'il ne contenait que Graphify, et .claude/settings.json comme modifié, avec les hooks Graphify retirés.

Graft ou Graphify ?

Si vous venez de notre guide sur Graft, la carte de code pour agents, les deux outils visent le même problème avec des choix différents. Graft demande Node.js 22.3 ou plus récent, ou Node.js 20.16 et plus dans la branche 20 : son fichier package.json déclare ^20.16.0 || >=22.3.0, ce qui exclut Node 20.0 à 20.15 et tout Node 21. Il écrit un dossier de nœuds Markdown liés dans graft/ et sert ses outils de recherche par MCP (Model Context Protocol). Graphify est un paquet Python : un skill, des hooks qui orientent Claude vers le graphe, et un fichier graph.json. Il peut aussi servir son graphe par MCP. Le cookbook utilise pour cela l'extra mcp et la commande claude mcp add graphify -- graphify-mcp graphify-out/graph.json.

En pratique, la différence tient au mode d'accès. Avec Graft, l'agent consulte la carte quand il appelle un outil MCP. Avec les hooks de Graphify, Claude reçoit un rappel au moment où il s'apprête à chercher ou à lire. Si votre équipe travaille surtout en Node et veut une carte lisible en Markdown, Graft s'intègre mieux. Si vous voulez que Claude soit poussé vers le graphe à chaque recherche, les hooks de Graphify font ce travail.

Un dernier point, pour ne pas confondre : Graphify Cloud est un produit hébergé séparé, sur app.graphify.com. Selon sa politique de confidentialité, le service hébergé envoie le code et le contenu à ses sous-traitants LLM, OpenAI et Anthropic. Les graphes sont conservés jusqu'à leur suppression ou la fermeture du compte, puis retirés des systèmes actifs sous 30 jours. Rien de cela ne s'applique au CLI open source décrit dans ce guide.

FAQ

Graphify consomme-t-il ma limite Claude Pro ou Max ?

L'analyse du code ne consomme rien : Graphify la fait en local avec tree-sitter, sans appel à un modèle. Sans GEMINI_API_KEY ni GOOGLE_API_KEY dans l'environnement, les documents, les PDF et les images sont lus par le modèle de votre session Claude Code quand vous lancez /graphify, à travers des sous-agents. Cette lecture compte dans votre limite de cinq heures et dans votre limite hebdomadaire, qui sont partagées entre Claude et Claude Code. Les rappels des hooks ajoutent aussi un peu de contexte aux requêtes concernées. Construisez avec graphify extract . --code-only pour éviter toute passe de modèle.

Faut-il une clé API Anthropic pour utiliser Graphify ?

Non. Dans Claude Code, le skill /graphify utilise le modèle de votre session, sans clé séparée. En mode headless, le backend --backend claude-cli passe par votre connexion Claude Code. Une clé ANTHROPIC_API_KEY sert seulement au backend claude, facturé au token en dehors de l'abonnement. Si cette variable est définie, Claude Code lui-même l'utilise à la place de votre abonnement, donc retirez-la avec unset ANTHROPIC_API_KEY si vous voulez rester sur votre forfait.

Est-ce que --strict empêche Claude de lire mes fichiers ?

Non. Avec graphify install --project --strict, un appel Read et un appel Grep dédié partagent un seul refus par session, réinitialisé après une compaction. Ce refus ne s'applique pas si une commande graphify query, explain ou path a tourné dans les 1800 dernières secondes. Les recherches par Bash et Glob restent de simples rappels. Comme Claude Code cherche surtout via Bash sur Linux, macOS et WSL, le mode strict agit sur une petite partie des lectures.

Mes documents peuvent-ils partir en Chine avec Graphify ?

Oui, si graphify extract choisit le backend Kimi. Le README indique que Kimi (MOONSHOT_API_KEY) passe par les serveurs de Moonshot AI en Chine. Kimi arrive en deuxième position dans l'ordre de détection automatique des clés, juste après Gemini. Passez toujours --backend de façon explicite. Pour tout garder en local, utilisez GRAPHIFY_BACKEND=none, --code-only ou --backend ollama.

Graphify divise-t-il vraiment les tokens par 70 ?

Aucune page primaire que nous avons lue ne mesure cela sur de vraies sessions Claude. Les ratios de Graphify (136,8x sur un graphe de démonstration, 791,0x sur son propre dépôt) comparent une réponse du graphe avec la lecture du corpus entier. Claude Code ne lit jamais tout le dépôt. Le cookbook dit lui-même que ce chiffre est une estimation. Comparez plutôt vos propres sessions, avec et sans graphe, dans /usage.

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