agentleFS
enzobleuzeenzobleuze/machine-claude/.claude/skills/couts-et-limites/SKILL.md

couts-et-limites

Skill2 starsChanged 20 days agoMITView on GitHub

Explique et règle ce qui consomme le forfait Claude (sessions, sous-agents, appels claude -p de nuit, images, connecteurs) et pose les économies qui ne coûtent rien en qualité : cœur court, planche contact pour les images, texte avant capture, appels de nuit allégés. Utiliser quand l'utilisateur dit « j'ai atteint ma limite », « ça consomme trop », « combien ça coûte », « mes tâches de nuit se sont arrêtées ». Pas pour choisir un modèle (utiliser sous-agents-modeles).

  • Reads credentials
  • Installs packages

The file

Files
SKILL.md

Coûts et limites

Pourquoi

Le système d'origine fait tourner des sessions longues le jour et des dizaines de tâches automatiques la nuit, sur un seul abonnement. Deux fois, la limite de la semaine a été atteinte et les tâches de nuit se sont arrêtées net. En cherchant, on a trouvé où partaient les jetons : un gros cœur relu à chaque appel, des connecteurs chargés pour rien, des images lues une par une. Les corrections n'ont rien enlevé à la qualité. Leçon de l'autre côté : la personne préférait des conversations longues et autonomes à des économies qui font travailler Claude moins bien.

Prérequis

  • coeur-claude-md, sous-agents-modeles.
  • Le socle : scripts/planche.py (copié depuis outils/planche.py). Il demande Python avec Pillow (pip install pillow) et, pour les vidéos, ffmpeg.

Interview

Lis d'abord : wiki/maps/modeles.md, ~/.claude/settings.json (modèle, effort), la liste des connecteurs (claude mcp list), les tâches planifiées s'il y en a (bloc F), log.md (incidents de limite).

Puis demande :

  1. « Quel abonnement as-tu, et as-tu déjà atteint ta limite ? Quand ? »
  2. « Tu préfères que je travaille longtemps et à fond, ou que j'économise au maximum ? » (la réponse la plus fréquente : à fond, tant qu'il reste de la marge).
  3. « As-tu une clé API Anthropic payée à l'usage, en plus de l'abonnement ? » (si oui, elle se facture à part : jamais par accident).
  4. « Tu travailles souvent avec des images ou des vidéos ? » (décide l'importance de la planche contact).

Range : les réponses dans le fichier mémoire feedback_couts.md et dans wiki/maps/couts.md.

Construire

  1. Ce qui consomme, en clair (10 min). Claude écrit wiki/maps/couts.md avec ces repères, vérifiés sur la page officielle du support Anthropic du jour (les règles ont changé plusieurs fois en un an) :
    • L'abonnement a une limite sur quelques heures et une limite par semaine. /usage (ou /cost selon la version) montre où tu en es.
    • Les sessions, les sous-agents et les appels claude -p lancés par des tâches planifiées puisent dans la même limite. Une tâche de nuit gourmande mange la marge du lendemain.
    • Une clé API (ANTHROPIC_API_KEY) se facture à part, au tarif public. Si elle est dans l'environnement, Claude Code peut l'utiliser à la place de l'abonnement : vérifie qu'elle n'y est pas par erreur.
    • Chaque message relit toute la conversation (avec un cache qui rend la relecture moins chère). Plus la conversation est longue, plus chaque message pèse.
    • Chaque appel automatique relit le cœur, la mémoire, la liste des outils et des connecteurs : un coût fixe de plusieurs dizaines de milliers de jetons par appel, avant le moindre travail.
  2. La planche contact pour les images (5 min). Une image lue coûte environ 1 500 jetons et reste dans la conversation à chaque tour. Claude ajoute au cœur : « Avant de regarder une série d'images ou une vidéo : python scripts/planche.py <dossier|motif|vidéo> -o planche.jpg (16 cases maximum, le prix d'une seule image), puis ouvre en grand seulement l'image choisie. » Il teste sur un dossier d'images de la personne.
  3. Le texte avant la capture (2 min). Dans le cœur : « Dans un navigateur, lis le texte de la page avant de prendre une capture. La capture sert à juger un visuel. »
  4. Le cœur court (rappel, 2 min). Le premier levier du coût fixe est la taille du CLAUDE.md et de l'index mémoire (coeur-claude-md). Claude vérifie qu'ils respectent leur plafond.
  5. Les connecteurs inutiles (10 min). Chaque connecteur MCP actif ajoute la liste de ses outils au contexte. Claude liste les connecteurs (/mcp), demande lesquels servent vraiment chaque semaine, et désactive les autres (ils se rebranchent en une commande). Pour les appels de nuit qui n'en utilisent aucun, voir claude-sans-fenetre (option --strict-mcp-config).
  6. Mesurer avant de décider (15 min, quand un doute coûte). Pour un appel automatique, claude -p "<consigne>" --output-format json rend un champ total_cost_usd et le détail des jetons (écrits en cache, relus). Sur abonnement, ce montant est un équivalent au tarif public, utile pour comparer deux réglages, pas une facture. Claude note la mesure avant et après chaque changement dans wiki/maps/couts.md.
  7. Les modèles locaux pour le mécanique (option, voir outils-locaux). Trier, extraire un champ, classer oui ou non peut partir sur un modèle gratuit installé sur l'ordinateur. Jamais un texte dans la voix de la personne.
  8. Le garde-fou de limite (5 min). Dans le cœur : « Si une tâche ou un appel tombe sur une erreur de limite, ne relance pas en boucle : note-le, reporte au lendemain, préviens la personne seulement si c'est urgent. » Les scripts de nuit (bloc F) s'arrêtent proprement sur ce message et reprennent la nuit suivante.

Test

Les deux sont vrais :

  • python scripts/planche.py <un dossier d'images> -o planche.jpg produit une planche, et la ligne affichée annonce un coût en jetons plus petit que la somme des images.
  • wiki/maps/couts.md existe, cite la date de vérification de la page officielle, et liste les connecteurs gardés avec leur raison.

Pièges vécus

  • Un crédit annoncé, puis suspendu. Un changement de facturation des appels automatiques a été annoncé, préparé avec des garde-fous, puis suspendu par l'éditeur. Des alertes ont continué à compter un crédit qui n'existait pas. Relis la page officielle avant de bâtir une règle de coût, et date ta vérification.
  • Le coût fixe de chaque appel. Des tâches de quelques lignes coûtaient cher parce que chaque appel relisait le cœur, la mémoire et la liste de tous les connecteurs. Cœur court et appels allégés l'ont divisé plusieurs fois.
  • Une heure dans le contexte. Une heure injectée au démarrage changeait le début du prompt à chaque minute et empêchait le cache de servir. Rien de changeant au début du contexte.
  • Économiser contre la personne. Un compactage automatique prêt à brancher a été refusé : la personne avait peur que Claude oublie. Les économies gratuites d'abord (planche, texte avant capture, appels de nuit allégés), le reste seulement si la limite bloque.
  • Les images une par une. Juger douze vignettes une à une coûtait douze fois plus que la planche, pour la même décision.

Entretien dans le temps

  • Chaque lundi (plan de la semaine, bloc F), Claude regarde la jauge /usage et la note dans wiki/maps/couts.md.
  • À chaque nouvelle tâche planifiée : sa mesure en jetons dans wiki/maps/couts.md.

Après

Coche la ligne couts-et-limites dans wiki/maps/parcours.md, une ligne dans log.md, puis propose la brique suivante : claude-sans-fenetre.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.