Les commandes slash essentielles - Erreurs courantes

Les commandes slash de Claude Code (/help, /init, /compact, /cost…) sont indispensables, mais mal utilisées, elles provoquent des pertes de contexte, des surcoûts de tokens et des configurations bancales. Voici les erreurs les plus fréquentes, classées par gravité, avec les corrections concrètes à appliquer immédiatement pour maîtriser vos slash commands.

Les commandes slash essentielles de Claude Code sont un ensemble de raccourcis intégrés (/help, /init, /clear, /compact, /cost, /config, /model, /login, /logout, /memory, /doctor) qui pilotent la session, le contexte et la configuration directement depuis le terminal. Claude Code propose des dizaines de commandes slash natives. Mal employées, elles constituent une source fréquente d'erreurs pour les nouveaux utilisateurs.

Pour une vue d'ensemble de chaque commande et de sa syntaxe, consultez le tutoriel complet des commandes slash avant de poursuivre.

Comment éviter les erreurs critiques avec les commandes slash de Claude Code ?

Les erreurs ci-dessous sont classées de la plus grave à la plus bénigne. Chaque slash command mal utilisée produit un effet différent : perte de travail, surconsommation de tokens ou configuration silencieusement ignorée.

En pratique, la majorité des incidents remontés sur les forums concernent les 4 erreurs critiques détaillées en premier. Référez-vous à l'aide-mémoire des commandes slash pour garder la syntaxe sous les yeux.

À retenir : classez vos efforts de correction sur les erreurs critiques en priorité, elles représentent la majorité des incidents.

Pourquoi /clear provoque-t-il des pertes de travail irréversibles ?

Sévérité : Critique

/clear efface l'intégralité de l'historique de conversation sans demander confirmation. Utiliser /clear en pensant simplement « repartir au propre » détruit le contexte accumulé, y compris les instructions, fichiers lus et décisions prises.

Concrètement, /clear supprime 100 % des messages précédents en une fraction de seconde. Aucun mécanisme d'annulation n'existe après exécution.

❌ Incorrect
# Vous avez passé 20 minutes à charger des fichiers et affiner des instructions
/clear
# Tout est perdu - impossible de revenir en arrière

✅ Correct
# Utilisez /compact pour réduire le contexte SANS perdre le résumé
/compact
# Ou sauvegardez le contexte critique dans /memory avant de nettoyer
/memory
# Puis seulement si nécessaire :
/clear

Avant tout /clear, exécutez /memory pour persister les éléments essentiels. Vous trouverez les bonnes pratiques de sauvegarde dans le guide sur la gestion du contexte.

À retenir : ne lancez jamais /clear sans avoir d'abord sauvegardé votre contexte avec /memory. La suppression est instantanée et irréversible.

Comment /compact peut-il dégrader vos résultats si vous l'utilisez trop tôt ?

Sévérité : Critique

/compact est un outil de compression du contexte qui résume la conversation pour libérer des tokens. L'erreur fréquente consiste à l'appeler dès les premières minutes de session, alors que le contexte est encore peu volumineux.

/compact résume la conversation pour libérer une part significative de la fenêtre de contexte (le gain dépend de la longueur et de la redondance de la conversation). Mais appliqué sur un contexte encore court, la compression produit un résumé appauvri qui perd des nuances.

❌ Incorrect
# Début de session - 3 messages échangés
/compact
# Le résumé généré est trop vague pour être utile

✅ Correct
# Attendez que le contexte occupe une bonne part de la fenêtre
/cost
# Vérifiez le volume de tokens consommés
# Quand le coût augmente significativement :
/compact

Vérifiez toujours le niveau de remplissage avec /cost avant de compacter. En pratique, /compact devient pertinent quand le contexte dépasse une bonne moitié de la fenêtre. Selon le modèle, cette fenêtre va jusqu'à 1 million de tokens sur les modèles actuels (Opus 4.6+/Sonnet 4.6) et reste à 200 000 tokens sur les modèles plus anciens ou les déploiements Bedrock/Vertex par défaut. Consultez les astuces avancées des commandes slash pour des stratégies de compression optimales.

À retenir : /compact n'est utile que lorsque votre contexte occupe une bonne part de la fenêtre. L'utiliser trop tôt produit un résumé inutilisable.

Pourquoi /init écrase-t-il votre fichier CLAUDE.md existant ?

Sévérité : Critique

/init est la commande d'initialisation qui génère un fichier CLAUDE.md à la racine du projet. L'erreur critique : l'exécuter dans un projet qui possède déjà un CLAUDE.md personnalisé.

Par défaut, /init analyse le dépôt et génère un nouveau fichier de configuration. Si un CLAUDE.md existe, le contenu personnalisé risque d'être écrasé ou fusionné de manière imprévisible.

❌ Incorrect
# Votre CLAUDE.md contient 50 lignes de règles personnalisées
/init
# Le fichier est régénéré - vos règles sont perdues

✅ Correct
# Vérifiez d'abord si CLAUDE.md existe
ls -la CLAUDE.md
# Si oui, éditez-le manuellement au lieu de relancer /init
# Ou sauvegardez avant :
cp CLAUDE.md CLAUDE.md.backup
/init

Sauvegardez systématiquement votre CLAUDE.md avant tout /init. Le fichier CLAUDE.md est le cerveau persistant de votre projet : c'est là que sont stockées vos instructions projet. Reportez-vous à la checklist d'installation pour la procédure d'initialisation sécurisée.

À retenir : /init régénère le fichier CLAUDE.md. Sauvegardez l'existant avant chaque exécution pour éviter de perdre vos règles personnalisées.

Que faire quand la fenêtre de contexte se remplit et que Claude Code oublie des instructions ?

Sévérité : Critique

La fenêtre de contexte de Claude Code va jusqu'à 1 million de tokens sur les modèles actuels (Opus 4.6+/Sonnet 4.6) et reste à 200 000 tokens sur les modèles plus anciens ou les déploiements Bedrock/Vertex par défaut. Quelle que soit sa taille, lorsqu'elle se remplit, Claude Code commence à perdre les instructions données en début de session et la qualité des réponses se dégrade.

Les signes d'un contexte saturé : Claude Code oublie vos conventions, répète des erreurs déjà corrigées, ou produit des réponses incohérentes avec le début de la conversation.

❌ Incorrect
# Vous continuez à travailler sans surveiller le contexte
# Après 45 minutes, Claude Code oublie vos instructions
# Vous répétez les mêmes consignes sans comprendre pourquoi

✅ Correct
# Surveillez régulièrement votre consommation
/cost
# Quand le volume de tokens augmente significativement :
/compact
# Ou si vous changez de sujet :
/clear

Surveillez votre consommation avec /cost et utilisez /compact proactivement avant que le contexte ne sature. Pour les erreurs de contexte plus complexes, consultez le guide de dépannage du contexte.

À retenir : surveillez votre consommation avec /cost et compressez avec /compact avant que le contexte ne sature.

Comment /cost est-il mal interprété par la majorité des utilisateurs ?

Sévérité : Avertissement

/cost affiche le coût en tokens et en dollars de la session courante. L'erreur : croire que ce coût inclut les sessions précédentes ou représente la facture mensuelle totale.

la majorité des utilisateurs confondent le coût de session avec le coût cumulé. /cost ne rapporte que la session active : les tokens consommés depuis le dernier lancement de Claude Code.

❌ Incorrect
/cost
# "0.43$ - c'est mon coût total du mois"
# Faux : c'est uniquement la session en cours

✅ Correct
/cost
# "0.43$ - coût de MA SESSION actuelle uniquement"
# Pour le coût global, consultez le dashboard Anthropic

Consultez le tableau de bord Anthropic pour votre consommation mensuelle réelle. Le coût d'une session varie fortement selon le modèle utilisé, le volume de tokens et la complexité de la tâche. Retrouvez d'autres pièges similaires dans la FAQ des commandes slash.

À retenir : /cost ne montre que la session courante. Consultez le dashboard Anthropic pour votre consommation globale.

Pourquoi /config ne persiste-t-il pas toujours vos modifications ?

Sévérité : Avertissement

/config ouvre l'interface de configuration de Claude Code. L'erreur classique : modifier des paramètres via /config en pensant qu'ils persistent automatiquement entre les sessions.

Certains paramètres définis via /config sont limités à la session courante, tandis que d'autres s'écrivent dans ~/.claude/settings.json. La distinction n'est pas toujours évidente.

❌ Incorrect
/config
# Vous changez le modèle via /config
# Vous fermez le terminal
# Au redémarrage, le modèle est revenu au défaut

✅ Correct
# Pour un changement persistant de modèle :
/model
# Sélectionnez le modèle voulu
# OU ajoutez la préférence dans CLAUDE.md :
echo "Utiliser le modèle claude-opus-4-8" >> CLAUDE.md

Distinguez les paramètres de session des paramètres persistants. Pour les réglages critiques, inscrivez-les dans CLAUDE.md ou ~/.claude/settings.json. Consultez le guide sur les permissions et sécurité pour les paramètres sensibles.

À retenir : vérifiez si un paramètre modifié via /config persiste en redémarrant Claude Code. Sinon, écrivez-le dans le fichier de configuration approprié.

Comment /model peut-il générer des erreurs silencieuses ?

Sévérité : Avertissement

/model permet de changer le modèle Claude utilisé pendant la session. L'erreur : sélectionner un modèle auquel votre plan API n'a pas accès, ce qui provoque des échecs silencieux ou des fallbacks non documentés.

En pratique, Claude Code supporte plusieurs modèles : claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5. Sélectionner un modèle non disponible sur votre plan peut entraîner un basculement automatique vers un modèle inférieur sans avertissement visible.

❌ Incorrect
/model
# Sélection de claude-opus-4-6 avec un plan qui ne le supporte pas
# Claude bascule silencieusement sur Sonnet - vous ne le remarquez pas

✅ Correct
/model
# Sélectionnez votre modèle
/status
# Le modèle actif y est affiché

Vérifiez le modèle actif après chaque changement avec /status (ou en rouvrant /model). Concrètement, le coût par token est sensiblement plus élevé sur Opus que sur Haiku. Pour approfondir les modèles disponibles et leur configuration, la formation Claude Code de SFEIR couvre en 1 jour les bonnes pratiques de sélection de modèle, de gestion du contexte et d'optimisation des coûts via des labs pratiques.

À retenir : après chaque /model, confirmez le modèle actif avec /status pour éviter les basculements silencieux.

Pourquoi /login et /logout posent-ils des problèmes en environnement partagé ?

Sévérité : Avertissement

/login authentifie votre session Claude Code auprès de l'API Anthropic. /logout la déconnecte. L'erreur majeure : utiliser /login sur une machine partagée sans /logout en fin de session.

Les credentials sont stockées localement dans ~/.claude/. Sur un serveur partagé ou une machine de développement commune, un oubli de /logout expose votre clé API aux autres utilisateurs.

❌ Incorrect
# Sur un serveur de dev partagé
/login
# Travail...
# Vous fermez le terminal sans /logout
# Votre collègue lance Claude Code - il utilise VOTRE clé API

✅ Correct
# Sur une machine partagée
/login
# Travail...
/cost
# Vérifiez la consommation avant de quitter
/logout
# Confirmez la déconnexion

Exécutez systématiquement /logout avant de quitter une machine partagée. Une clé API exposée peut entraîner une consommation non autorisée importante. Retrouvez les bonnes pratiques de sécurité dans le guide des erreurs de permissions.

À retenir : sur une machine partagée, /logout est obligatoire en fin de session. Une clé exposée peut entraîner une facturation imprévue.

Comment /memory est-il sous-utilisé par les développeurs ?

Sévérité : Avertissement

/memory permet de consulter et modifier les fichiers CLAUDE.md qui stockent les instructions persistantes du projet. L'erreur : ne jamais utiliser /memory et perdre les mêmes instructions à chaque nouvelle session.

Beaucoup d'utilisateurs ne configurent jamais leur CLAUDE.md et répètent les mêmes instructions à chaque session, ce qui gaspille du temps et des tokens.

❌ Incorrect
# Chaque nouvelle session :
"Utilise TypeScript strict, ESLint Airbnb, et teste avec Vitest"
# Copié-collé à chaque fois - des tokens gaspillés à chaque session

✅ Correct
/memory
# Ajoutez vos règles dans CLAUDE.md :
# - TypeScript strict
# - ESLint Airbnb
# - Tests avec Vitest
# Ces instructions seront chargées automatiquement à chaque session

Ouvrez /memory dès le premier jour sur un projet et inscrivez vos conventions. Configurer CLAUDE.md évite de répéter les mêmes instructions à chaque session, ce qui économise des tokens et du temps. Pour aller plus loin, la formation Développeur Augmenté par l'IA de SFEIR consacre une journée entière sur deux à la configuration avancée des agents IA, incluant la gestion des fichiers mémoire et l'optimisation du contexte en conditions réelles.

À retenir : /memory vous fait économiser des tokens à chaque session. Configurez votre CLAUDE.md dès le premier jour.

Quels risques pose /doctor quand on ignore ses résultats ?

Sévérité : Mineur

/doctor est l'outil de diagnostic intégré qui vérifie l'état de votre installation Claude Code. L'erreur : lancer /doctor, lire "tout est OK" en diagonale, et ignorer les avertissements non bloquants.

/doctor distingue trois niveaux : erreurs (bloquantes), avertissements (dégradation possible) et informations. Les avertissements signalent des versions obsolètes de Node.js ou des permissions trop ouvertes.

❌ Incorrect
/doctor
# "✓ All checks passed" - vous passez à la suite
# Mais un warning "Node.js 18 detected, 22+ recommended" est ignoré

✅ Correct
/doctor
# Lisez CHAQUE ligne, y compris les warnings
# Mettez à jour Node.js si recommandé :
nvm install 22
nvm use 22
# Relancez le diagnostic :
/doctor

Lisez chaque ligne de la sortie de /doctor, pas uniquement le résumé final. Node.js 22 est la version LTS recommandée pour Claude Code. Consultez le guide de dépannage de l'installation pour résoudre les avertissements courants.

À retenir : /doctor affiche des avertissements non bloquants qu'il faut traiter. Ne vous arrêtez pas au simple "checks passed".

Comment éviter les erreurs de syntaxe avec /help et les commandes slash ?

Sévérité : Mineur

/help affiche l'aide générale de Claude Code. L'erreur commune : ajouter des arguments à des commandes qui n'en acceptent pas.

/help ne prend aucun argument. Taper /help compact n'affichera pas l'aide spécifique de /compact. De même, il n'existe pas de flag --help pour les commandes : /compact --help ne fonctionne pas. Certaines commandes acceptent toutefois des arguments ou des flags spécifiques (par ex. /compact accepte un texte d'instruction, /code-review accepte --fix et --comment). Vérifiez la syntaxe propre à chaque commande.

❌ Incorrect
/help compact
# /help ne prend pas d'arguments
/compact --help
# Il n'existe pas de flag --help pour les commandes slash

✅ Correct
/help
# Consultez la liste complète des commandes
/compact focus on the database migration
# /compact accepte du texte libre pour guider la compression

Référez-vous au guide principal des commandes slash pour la syntaxe exacte de chaque commande.

À retenir : /help ne prend pas d'arguments et il n'existe pas de flag --help. Certaines commandes acceptent toutefois leurs propres arguments ou flags (par ex. /compact avec un texte d'instruction, /code-review avec --fix ou --comment) : vérifiez la syntaxe de chacune.

Peut-on combiner plusieurs commandes slash sans risque ?

Sévérité : Mineur

Certains utilisateurs enchaînent plusieurs commandes slash en séquence rapide, comme /compact suivi de /clear. Ces combinaisons peuvent produire des effets indésirables.

❌ Incorrect
/compact
/clear
# Double peine : vous avez compressé puis tout effacé

✅ Correct
/compact
# Continuez à travailler avec le contexte compressé
# /clear uniquement si vous voulez VRAIMENT repartir de zéro

Planifiez vos commandes slash avant de les exécuter. Voici comment procéder : exécutez une commande, observez le résultat, puis décidez de la suivante. Pour maîtriser ces enchaînements, la formation Développeur Augmenté par l'IA – Avancé de SFEIR propose en 1 jour des exercices pratiques sur l'orchestration avancée des commandes et la gestion fine du contexte dans des scénarios complexes.

À retenir : n'enchaînez jamais /compact et /clear. La première compresse, la seconde supprime tout, y compris le résumé.

Quels réflexes adopter pour ne plus jamais mal utiliser les commandes slash ?

Voici un récapitulatif des 12 erreurs classées par sévérité et fréquence :

1. /clear sans sauvegarde : perte irréversible du contexte entier.
2. /compact trop précoce : résumé appauvri, contexte dégradé.
3. /init sur un projet existant : écrasement du CLAUDE.md personnalisé.
4. Contexte saturé non détecté : oubli des instructions et dégradation des réponses.
5. /cost mal interprété : confusion session/total mensuel.
6. /config non persistant : paramètres perdus au redémarrage.
7. /model sans vérification : basculement silencieux de modèle.
8. /login sans /logout : exposition de clé API sur machine partagée.
9. /memory jamais utilisé : tokens gaspillés à chaque session.
10. /doctor survolé : avertissements ignorés.
11. /help avec arguments : /help ne prend pas d'arguments.
12. Combinaisons dangereuses : /compact + /clear = perte totale.

Appliquez ces corrections une par une en commençant par les erreurs critiques. Retrouvez la syntaxe complète dans l'aide-mémoire des commandes slash et testez vos connaissances avec les exercices pratiques du tutoriel.

Pour consolider ces bonnes pratiques dans un cadre structuré, la formation Claude Code de SFEIR Institute vous guide en 1 jour à travers tous ces pièges avec des labs interactifs sur chaque commande.

À retenir : les 4 erreurs critiques (/clear, /compact, /init, contexte saturé) sont les plus fréquentes. Corrigez-les en priorité.