Claude Code et ses limites : retour d’expérience

L’objectif : tester les nouvelles fonctionnalités

J’ai voulu retester Claude Code pour voir les améliorations depuis mon dernier test. Depuis, de nouvelles fonctionnalités sont apparues : la possibilité de créer un plan complet + tâches, d’ajouter des skills, des commandes et des sous-agents.

Le principe est simple : en mode plan, vous travaillez avec l’IA pour structurer votre projet étape par étape. L’idée est d’être le plus explicite possible dans la description de votre projet afin que Claude génère un plan détaillé et exploitable.

Une fois le plan établi, Claude peut commencer à développer. Et honnêtement, le développement fonctionne bien… à condition d’avoir bien précisé comment vous voulez qu’il travaille.

Le fichier claude.md : le cœur du dispositif

Ce fichier à la racine de votre projet est le point névralgique de Claude Code. C’est là que vous précisez tous les éléments importants pour optimiser vos interactions et limiter la consommation de tokens.

Structure et commandes essentielles

J’y définis d’abord les commandes bash utilisables (Composer, NPM, etc.) et l’architecture du projet : dossiers app, test, assets, build… Sans rentrer dans les détails excessifs.

Conventions de développement

J’indique ensuite la nomenclature, la structure, les namespaces (PSR4 dans mon cas). Pour mon projet de plugin de gamification WordPress, j’ai spécifié :

• Deux hooks WordPress à utiliser exclusivement
• Architecture orientée objet stricte
• Utilisation de l’API REST WordPress
• Vanilla JavaScript sans framework

Contexte projet et détails techniques

Je décris les grandes lignes du plugin pour donner un contexte global à Claude Code. Cette étape nécessite de connaitre WordPress, de savoir ce qu’on souhaite, mais permet de gagner un temps précieux : moins d’interactions avec l’IA, moins de messages, moins de tokens, donc moins d’argent.

J’ai également détaillé :

• Les endpoints REST API personnalisés
• Ma vision du front-end et workflow
• Les tests unitaires attendus
• La liste des fichiers clés du projet

Sécurité et problèmes connus

Je termine par deux sections cruciales dans le fichier claude.md :

1. Problèmes connus : anticipation des difficultés (points d’attention spécifiques)
2. Points de sécurité : vérification entrées, échappement variables, vérification nonces pour l’API REST

Commandes, skills et agents : le piège de la contextualisation

Je me suis posé la question : aurais-je besoin d’un agent WordPress spécialisé, de commandes ou de skills ? J’ai commencé à en créer au niveau global (review de code, debug) pour les réutiliser sur tous mes projets. Il existe d’ailleurs des sites référençant des agents (comme celui-ci), commandes et skills prêts à l’emploi.

Le problème critique de la session

Mais voilà où ça se complique avec Claude Code : dès l’ouverture d’une session, avant même de commencer quoi que ce soit, ma session de 5 heures avait déjà démarré avec une consommation tokens significative.

Pire encore, dès que j’ai commencé à réfléchir au plan, j’ai vu mon quota fondre rapidement.

Découverte du problème avec /context et /usage

En utilisant les commandes /context et /usage dans Claude Code, j’ai découvert le problème : tous les agents, commandes et skills de ma configuration globale sont envoyés dans chaque session, consommant énormément de tokens avant même de travailler.

Si vous ajoutez des éléments au niveau projet, la contextualisation peut devenir écrasante et griller votre quota rapidement.

Voici un exemple de contexte optimisé (pour moi), c’est-à-dire sans agents, commandes ou skills créés inutilement. -> En somme, pas grand chose 🤓 car mode économie des tokens $ (j’ai une version pro donc chaque interaction doit être optimisé)

L’impact selon votre licence Claude Code : Pro vs Max

Ce n’est pas dramatique… sauf si vous avez une licence Claude Pro limitée. Avec ma version Pro, je suis limité à environ 45 messages toutes les 5 heures, plus une limite hebdomadaire.

Comparaison des licences Claude Code :

• Licence Pro : ~45 messages/5h
• Licence Max 5x : ~225 messages/5h
• Licence Max 20x : ~900+ messages/5h

Plus je contextualise via des fichiers markdown, moins je peux échanger avec Claude Code. Selon la documentation des licences Max, la marge est bien plus confortable avec Max. Mais sur une licence Pro, chaque token compte.

Rien que pour la réflexion du plan, j’ai atteint 20% de mon quota de session sur ma licence Pro. Et si on reprends une conversation via /resume -> on peut potentiellement déjà manger du quota alors qu’on se remet juste sur le projet.

Une solution possible : externaliser la conception du plan Claude Code

J’ai initialement créé plusieurs fichiers de référence dans Claude Code, puis je les ai supprimés pour n’en garder qu’un seul, le plus clair possible. Mais surtout, je me suis demandé : le plan ne pourrait-il pas être généré autrement ?

Retour à Dust

Je suis revenu à ma méthode précédente : préparer mon plan avec Dust, plateforme d’orchestration d’IA (qui me permet d’échanger avec ChatGPT ou Claude). L’intérêt ? Séparer les étapes pour me concentrer sur le concret dans Claude Code.

Je crée mon cahier des charges avec l’IA en dehors de Claude Code. Je détaille, j’explique, je réfléchis aux fonctionnalités point par point, sans demander de code. Juste la spec pure :

• Plugin de gamification WordPress
• Gestion transients
• Barre de vie dynamique
• Différents stades de vie
• SVG pour rendus visuels
• Emplacement des affichages admin/front
• etc.

Le principe ici c’est orchestrer ce que Claude Code va faire. Je lui donne mes limites du terrain de jeu, ce qu’il ne doit pas faire, ce que je veux qu’il respecte. Tout le contexte nécessaire afin d’arriver à l’objectif.

Optimisation du plan et injection dans Claude Code

L’avantage majeur : une fois le plan créé, je peux le retravailler et l’optimiser en conservant les éléments essentiels pour l’IA.

Je crée ensuite le fichier dans le projet (le nom correspond au nom de la session en cours) :

.claude/plans/joyful-forging-ladybug.md

Pour éviter toute recherche inutile dans ma conversation en mode plan, je donne directement la référence au plan via :

 @.claude/plans/joyful-forging-ladybug.md

L’objectif n’est pas d’interdire le mode plan de Claude Code, mais d’économiser les tokens sur l’étape de conception. C’est crucial avec la licence Pro où chaque token compte.

L’expérience de développement avec Claude Code

Une fois mon plan et mes étapes préparés, j’ai lancé Claude Code pour réaliser mon plugin de gamification. Concrètement, il a pu suivre les étapes et les tokens ont été utilisés au fur et à mesure de manière optimisée.

Le premier résultat fonctionnel

L’avantage par rapport à mon dernier test critique de Claude Code, c’est qu’à ce stade – et je pense que c’est exclusivement grâce au mode plan et aux tâches générées – mon plugin était fonctionnel dès la première itération. J’ai pu le tester sans erreurs ! Petite victoire très sympathique.

Je me corrige sur le « exclusivement », c’est clairement une étape du succès mais ce qui fait également la différence, c’est la connaissance que l’on peut avoir de la technologie utilisée. WordPress fonctionne avec des hooks si on souhaite se greffer à des endroits. Sans en avoir une bonne maîtrise, Claude Code m’aurait fait plusieurs erreurs → typiquement sur les ordres de priorité et le fait d’appeler tel hook au bon moment, ce qui peut drastiquement réduire votre productivité.

Après environ une heure de travail avec Claude Code, j’ai atteint ma limite de session et dû attendre 4 heures pour réutiliser une nouvelle session Pro. C’est là qu’une autre fonctionnalité devient intéressante : la possibilité de payer ponctuellement pour étendre le temps, en plus de sa licence.

Extension payante de session

Si vous êtes sur une version Pro avec une fonctionnalité à développer dans un temps imparti, mais que vous ne voulez pas partir sur une licence Max à 100€/mois, c’est un bon compromis pour Claude Code.

Fonctionnement de l’extension (pour le détail la doc) :

1. Activer l’usage supplémentaire dans paramètres
2. Ajouter le montant souhaité
3. Basculer automatiquement sur le crédit quand la limite est dépassée

Le temps réel de développement et résultats

Durée totale du projet

Je vous épargne toutes mes relances de sessions Claude Code, mais globalement, le projet m’a pris 4-5 jours. Cela ne signifie pas que j’ai développé en continu : au fur et à mesure des relances de session avec ma licence Pro, cela s’est étalé sur cette période.

Si je mets bout à bout le temps réellement passé : environ 10 heures de travail effectif (plan + code + tests).

Pro vs Max : quelle licence Claude Code choisir ?

Concrètement, 10 heures de travail sur 4-5 jours, ce n’est pas énorme. Ce qui fera vraiment la différence pour switcher d’un compte Pro à un compte Max avec Claude Code, c’est :

Pouvez-vous vous permettre ce délai pour réaliser votre plugin ou fonctionnalité, ou faut-il livrer le plus rapidement possible ?

• Livraison urgente : Compte Max recommandé si rentable financièrement
• Délai raisonnable : Compte Pro suffisant avec optimisation des échanges

Et raison simple 😃 vous voulez tout simplement pouvoir l’utiliser plus longtemps.

L’importance cruciale de la qualité des prompts

La qualité de vos prompts et de vos échanges avec Claude Code est cruciale. Plus vous êtes précis, plus vous maîtrisez votre sujet, plus l’IA sera facilitée.

Résultat :

• Économie du temps de recherche pour l’IA
• Réduction consommation tokens
• Gain de rapidité significatif

Besoin d’améliorer vos prompts ? Consultez mon guide complet du prompt engineering 2025.

L’importance de stopper Claude Code

Oui oui vous avez bien entendu ! Parfois, il peut se lancer sur des tâches non voulues et même vous faire de simples commandes npm run build, composer install, etc., ce qui consomme des tokens et ce n’est clairement pas vital ! Donc on le stoppe avant d’en perdre dans le vide.

Exemple rapide : jeu Snake en 10 minutes

Pour illustrer la puissance du mode plan : j’ai conçu un plan de jeu Snake en vanilla JS avec Dust (on pense économie de tokens), puis je l’ai donné à Claude Code. Il l’a analysé, vérifié s’il manquait des informations, créé ses tâches et commencé à développer.

Résultat avec licence Pro :

• Temps de réalisation : 10 minutes totales (90% pour le plan)
• Consommation : seulement 2% du quota de session
• Fonctionnalité : jeu Snake fonctionnel sans bug

Résultat visuel du plugin gamification

Autre point positif : visuellement, le plugin WordPress développé avec Claude Code fonctionne parfaitement. Vous pouvez facilement obtenir quelque chose de propre et qualitatif.

Conclusion : mon constat a évolué sur Claude Code

Aujourd’hui, mon constat a évolué par rapport à mon dernier test où je lui préférais Cursor et SuperMavent. Clairement, oui, je vais repartir sur Claude Code que j’avais mis de côté pour réaliser de nombreuses fonctionnalités et optimiser toutes mes interactions.

Le mode plan et la possibilité de créer des tâches représentent pour moi la frontière qui permet de réaliser quelque chose de clair, propre et cohérent avec Claude Code.

Maintenant, je vais conserver une partie de la réflexion de ce que je veux produire dans un autre outil (Dust). C’est plus simple et pertinent dans mon fonctionnement : cela me permet de faire beaucoup plus de réflexion et de recherche sur ces points-là, avant de donner tout ça à manger à Claude Code.

Ma méthodologie optimisée finale :

1. Conception externe : Dust pour cahier des charges détaillé
2. Plan structuré : Markdown optimisé avec tâches séquentielles
3. Configuration claude.md : Conventions, hooks, sécurité, architecture
4. Développement Claude Code : Mode plan avec référence @fichier
5. Tests et ajustements : Itérations ciblées économes en tokens

Cette approche me permet d’obtenir des résultats fonctionnels beaucoup plus rapidement, avec une consommation tokens optimale même sur licence Pro. Claude Code devient alors un outil efficace plutôt qu’un gouffre à tokens

Les images du plugin :

Bien évidemment, pendant ce mois de test, je ne me suis pas arrêté à un simple plugin de gamification WordPress. J’ai en parallèle mis en place mon plugin Firewall (la suite de mon article https://www.samy-kantari.fr/register-shutdown-function-php-guide-securite/) avec du bannissement, du check du trafic, une analyse de pattern, des statistiques, etc., ou encore la conception d’un outil de monitoring + webhook (les lumières deviennent rouges à la maison si un site est down 😂), etc.

Et avec tout cela, est-ce que je vais rester sur la licence Pro ? Eh bien non 😀 Je pense passer à la Max à 100 € par mois, car même si je m’en sors bien, je veux pouvoir encore mieux gérer le contexte de Claude et lui donner plus d’informations. Donc oui, je pense partir sur la version supérieure afin de mieux l’orchestrer. 🧙