Tout ce que tu dois savoir pour utiliser Claude Code efficacement. Expliqué comme si c'était la première fois. Avec des exemples concrets pour chaque fonction.
Claude Code est un assistant intelligent qui vit dans ton ordinateur. Imagine un collègue développeur, disponible 24h/24, à qui tu parles en français normal, et qui peut :
Quand tu parles à Claude sur le site claude.ai, il ne peut que répondre avec du texte. Il ne peut pas toucher à tes fichiers, il ne peut pas lancer de commandes, il ne connaît pas ton projet.
Claude Code, lui, est branché directement sur ton ordinateur. Il voit tes fichiers, il peut les modifier, il peut déployer ton site. C'est comme donner les clés de ton atelier à un assistant très compétent.
ChatGPT / Claude.ai = un conseiller au téléphone. Il te dit quoi faire, mais c'est toi qui dois tout faire à la main.
Claude Code = un assistant qui est dans la pièce avec toi. Tu lui dis "range ce dossier" et il le range vraiment.
Claude Code a 3 couches qui travaillent ensemble :
C'est l'intelligence artificielle Claude Opus 4.6 qui comprend tes demandes en français et décide quoi faire. Il lit tes messages, analyse la situation, et choisit les bonnes actions.
Ce sont les outils de base que Claude peut utiliser : lire des fichiers, les modifier, chercher dans ton code, lancer des commandes terminal. C'est comme ses mains — toujours disponibles.
Ce sont des extensions qui connectent Claude à des services externes : ton email, tes designs Canva, ton hébergement Cloudflare. C'est comme des outils spécialisés dans sa boîte à outils.
Tu écris dans la zone de saisie en bas de l'écran, tu appuies sur Entrée, et Claude répond. C'est un chat, comme WhatsApp ou iMessage, sauf que ton interlocuteur peut agir sur ton ordinateur.
Parle normalement, en français. Pas besoin de syntaxe spéciale, de mots-clés techniques ou de formules magiques. Plus tu es précis, meilleur sera le résultat.
"Corrige le bug" → Claude ne sait pas de quel bug tu parles. Il va devoir deviner et risque de se tromper.
"Le bouton Valider de la page /checkout ne répond pas au clic sur mobile. Voici l'erreur dans la console : TypeError: handleSubmit is not a function" → Claude sait exactement où chercher et quoi corriger.
C'est la méthode principale. Tu décris ce que tu veux, et Claude fait le reste.
Les commandes slash commencent par /. Elles déclenchent des workflows prédéfinis — des séries d'actions que Claude va suivre à la lettre.
Tu peux coller directement un message d'erreur, un lien URL, ou un extrait de code. Claude comprendra le contexte.
Claude a une mémoire persistante. Tu peux lui dire de retenir des informations pour les prochaines sessions.
Chaque conversation avec Claude Code est une session. Tu peux avoir plusieurs sessions en parallèle (une par projet, par exemple). Chaque session garde son propre fil de discussion.
Quand tu ouvres Claude Code, tu es sur une nouvelle session vide. Si tu veux reprendre une session précédente, utilise le menu des sessions (icone en haut de l'écran) pour retrouver tes conversations passées.
| Raccourci | Ce qu'il fait | Quand l'utiliser |
|---|---|---|
Entrée | Envoyer le message | Pour valider ta demande |
Ctrl + C | Interrompre Claude | Quand Claude fait quelque chose que tu veux arrêter |
Ctrl + L | Rafraîchir l'affichage | Si l'affichage est cassé |
Ctrl + O | Voir le transcript complet | Pour relire toute la conversation |
Ctrl + T | Afficher/masquer la todo list | Pour voir l'avancement des tâches |
Ctrl + R | Chercher dans l'historique | Pour retrouver une commande passée |
Shift + Tab | Changer de mode | Pour basculer entre les modes de réponse |
Escape | Annuler / fermer | Pour annuler la saisie en cours |
Les outils natifs sont les capacités de base de Claude Code. Ils sont toujours disponibles, sans rien installer ni configurer. Tu n'as jamais besoin de les appeler directement — Claude les choisit automatiquement en fonction de ce que tu demandes.
Tu n'as jamais besoin de dire à Claude "utilise l'outil Read" ou "lance l'outil Bash". Dis simplement ce que tu veux en français et il choisira les bons outils tout seul.
Ce que c'est : Claude peut ouvrir et lire n'importe quel fichier sur ton ordinateur. Code source, PDF, images, tableurs, notebooks Jupyter...
Quand ça s'active : Chaque fois que Claude a besoin de voir le contenu d'un fichier pour répondre à ta demande.
Ce que c'est : Claude peut modifier une partie précise d'un fichier existant sans toucher au reste. C'est chirurgical — il remplace exactement ce qui doit être changé.
Quand ça s'active : Quand tu demandes de changer, corriger, ajouter ou supprimer quelque chose dans un fichier existant.
Ce que c'est : Claude peut créer un fichier complètement nouveau à l'endroit que tu veux.
Quand ça s'active : Quand tu demandes de créer quelque chose qui n'existe pas encore — une nouvelle page, un nouveau composant, un fichier de configuration.
Ce que c'est : Claude peut lancer n'importe quelle commande terminal, comme si tu tapais dans le Terminal de ton Mac. Installer des dépendances, lancer un serveur de développement, déployer un site, faire un commit git...
Quand ça s'active : Quand l'action demandée nécessite d'exécuter quelque chose dans le système (pas juste lire ou écrire un fichier).
Ce que c'est : Claude peut trouver des fichiers dans ton projet en utilisant des patterns. Par exemple "tous les fichiers .tsx" ou "tous les fichiers qui contiennent 'sidebar' dans leur nom".
Quand ça s'active : Quand Claude a besoin de trouver un fichier dont il ne connaît pas l'emplacement exact.
Ce que c'est : Claude peut chercher un mot, une variable, une fonction, ou n'importe quel texte à l'intérieur de tous les fichiers du projet.
Quand ça s'active : Quand tu cherches où quelque chose est utilisé, défini, ou mentionné dans le code.
Ce que c'est : Claude peut aller chercher le contenu d'une page internet et te le résumer.
Quand ça s'active : Quand tu colles un lien URL ou que tu demandes d'aller voir un site.
Ce que c'est : Claude peut chercher sur internet pour trouver des informations récentes.
Quand ça s'active : Quand Claude a besoin d'informations qu'il n'a pas dans ses connaissances (actualités, documentation récente, etc.).
Ce que c'est : Pour les tâches complexes, Claude peut lancer des "mini-Claude" spécialisés qui travaillent en parallèle. Par exemple, un agent qui explore le code pendant qu'un autre cherche sur le web.
Quand ça s'active : Automatiquement quand la tâche est trop grosse pour être faite en une seule étape.
Tu n'as rien à faire — Claude décide seul quand déléguer à un sous-agent.
Une commande slash est un raccourci qui déclenche un workflow prédéfini. Au lieu de décrire en détail ce que tu veux, tu tapes /nom-de-la-commande et Claude suit un scénario écrit à l'avance.
C'est comme un bouton "Faire tout ça automatiquement".
Tu tapes le / suivi du nom de la commande dans la zone de saisie, puis Entrée. C'est tout. Claude Code te proposera même l'autocomplétion quand tu commences à taper /.
/fin-de-journee — Ta routine de fin de sessionC'est LA commande la plus importante. Tu la tapes quand tu as fini de travailler sur un projet. Elle fait tout le travail de clôture automatiquement.
Ce qu'elle fait, étape par étape :
Claude regarde quels fichiers tu as modifiés depuis le dernier commit. Il t'affiche un résumé : "12 fichiers modifiés, 2 nouveaux, 1 supprimé". Si rien n'a changé, il s'arrête là.
Claude relit tout ton code modifié et vérifie : pas de bug, pas de faille de sécurité, bonnes pratiques respectées, CSS conforme aux règles (mobile first, variables, etc.). Si un problème critique est détecté, il te le signale et propose de le corriger avant de continuer.
Claude scanne le projet complet (pas juste tes modifs) : performance, dépendances obsolètes ou vulnérables, fichiers inutiles. C'est informatif — il ne corrige rien, il te prévient.
Claude met à jour automatiquement tous les fichiers de documentation du projet : CHANGELOG (historique des modifications), README (présentation du projet), version (numéro de version), mémoire (notes pour les sessions futures), et note de liaison (résumé pour reprendre le travail la prochaine fois).
Claude prépare un commit git avec un message clair qui décrit tes changements. Il te montre le message et attend ta confirmation avant de sauvegarder.
Claude déploie le site en ligne (Cloudflare, ou autre selon le projet). Il te montre la commande et attend ta confirmation avant d'exécuter.
Claude affiche un tableau récapitulatif de tout ce qui a été fait, avec le numéro de version et la note de liaison pour la prochaine session.
Ces commandes viennent des 25 plugins installés. Chacune déclenche un workflow spécialisé.
/commit — Sauvegarder ton travail proprementQuand l'utiliser : Tu viens de finir une modification et tu veux la sauvegarder dans git.
Ce qu'elle fait : Elle analyse toutes tes modifications, génère un message de commit clair qui décrit ce que tu as fait, et crée le commit. Plus besoin d'écrire le message toi-même.
Ce qui se passe sans : Tu devrais taper git add . puis git commit -m "un message" manuellement dans le terminal, et souvent le message est vague ("modifs" ou "fix").
Avant (manuellement) : git commit -m "modifs sidebar" → message vague, inutile dans 3 mois
Après (/commit) : feat(sidebar): ajout filtre par date avec sélection de plage et réinitialisation → message clair et utile
/code-review — Relire ton code avant de déployerQuand l'utiliser : Tu as fini de coder et tu veux vérifier que tout est propre avant de déployer.
Ce qu'elle fait : Elle relit chaque fichier modifié et cherche les problèmes : bugs potentiels, failles de sécurité, code mort, mauvaises pratiques, problèmes de performance, accessibilité manquante.
Pourquoi c'est utile : Même les développeurs expérimentés font des erreurs. Cette commande joue le rôle d'un deuxième paire d'yeux qui vérifie ton travail.
OK : Structure des composants propre, CSS variables utilisées partout
ATTENTION : Image hero.jpg fait 2.4 MB → recommandé de la compresser sous 500 KB
CRITIQUE : Clé API exposée en dur dans config.ts ligne 12 → à déplacer dans .env
/bug-fix — Corriger un bug automatiquementQuand l'utiliser : Tu as une erreur (dans le navigateur, dans la console, au build) et tu ne sais pas comment la corriger.
Ce qu'elle fait : Elle analyse le message d'erreur, remonte jusqu'à la cause racine dans ton code, et propose un correctif. Souvent, elle corrige directement le fichier.
Comment l'utiliser au mieux : Colle le message d'erreur complet juste avant ou juste après avoir tapé /bug-fix.
users.map(...) mais users est undefined au premier rendu car l'API n'a pas encore répondu.users est undefined au lieu d'être un tableau vide.useState() en useState([]) à la ligne 8. C'est fait./audit-project — Scanner la santé du projetQuand l'utiliser : Quand tu veux un bilan général de la qualité de ton projet : sécurité, performance, code mort, dépendances obsolètes.
Ce qu'elle fait : Elle scanne l'ensemble du projet (pas juste les fichiers modifiés) et produit un rapport complet avec des recommandations classées par priorité.
Différence avec /code-review : /code-review regarde tes dernières modifications. /audit-project regarde tout le projet.
/perf — Optimiser la vitesseQuand l'utiliser : Ton site est lent au chargement, le build prend trop de temps, ou l'application rame.
Ce qu'elle fait : Elle identifie les causes de lenteur : images trop lourdes, JavaScript inutile chargé, requêtes trop nombreuses, composants qui se re-rendent inutilement. Puis elle propose des optimisations concrètes.
Bundle JS : 1.8 MB → recommandé < 500 KB. La librairie moment.js (300 KB) peut être remplacée par date-fns (30 KB).
Images : hero-banner.png fait 3.2 MB. En convertissant en WebP : 180 KB.
Chargement : 4 polices Google chargées mais seules 2 sont utilisées.
/frontend-design — Créer une interfaceQuand l'utiliser : Tu veux créer une nouvelle page ou un nouveau composant visuel.
Ce qu'elle fait : Elle génère du HTML/CSS/React avec un design distinctif, pas du générique. Elle respecte les règles du CLAUDE.md (mobile first, bonne police, bonnes couleurs).
/documentation-generator — Documenter un projetQuand l'utiliser : Tu veux un README pour ton projet, une documentation d'API, ou un guide d'installation.
Ce qu'elle fait : Elle analyse la structure du projet, la stack technique, les commandes disponibles, et génère une documentation complète automatiquement.
| Commande | En une phrase | Quand c'est utile |
|---|---|---|
/ship | Fait commit + PR + deploy en une fois | Projets en équipe avec des Pull Requests |
/create-pr | Crée une Pull Request sur GitHub | Quand tu contribues à un projet partagé |
/pr-review | Relit le code d'une Pull Request | Quand quelqu'un propose du code à merger |
/debugger | Session de debug structurée | Bugs complexes qui résistent au /bug-fix |
/test-writer-fixer | Crée ou corrige des tests automatiques | Quand tu mets en place des tests unitaires |
/security-guidance | Audit sécurité détaillé (OWASP) | Avant de mettre un site en production |
/backend-architect | Design d'API et de base de données | Quand tu crées un nouveau backend |
/senior-frontend | Patterns React avancés | Architecture de composants complexes |
/mcp-builder | Crée un serveur MCP (connexion externe) | Connecter Claude à un nouveau service |
/changelog-generator | Génère un changelog depuis les commits | Avant de publier une release |
/canvas-design | Crée des visuels (PNG, PDF) | Générer des images pour les réseaux sociaux |
/artifacts-builder | Crée des pages HTML interactives | Prototypage rapide multi-composants |
/theme-factory | Applique un thème pro à un design | Donner un look fini à un prototype |
/agent-sdk-dev | Aide à construire des agents IA | Développement d'agents autonomes |
/developer-growth-analysis | Analyse tes habitudes de code | Pour identifier tes axes de progression |
/skill-bus | Chaîne des commandes entre elles | Automatiser des workflows complexes |
MCP signifie Model Context Protocol. En langage simple : c'est un pont entre Claude et un service externe.
Imagine que Claude est dans une pièce. Les outils natifs (lire des fichiers, etc.) c'est ce qu'il peut faire dans la pièce. Les MCP, ce sont des portes vers d'autres pièces : Gmail, Canva, Cloudflare, Google Drive...
Les MCP sont complètement transparents. Tu n'as jamais besoin de dire "utilise le MCP Gmail". Tu dis simplement "cherche mes emails de cette semaine" et Claude utilise automatiquement le bon MCP.
Ce qu'il permet : Lire tes emails, chercher des emails par expéditeur/sujet/date, créer des brouillons, lister tes labels.
Ce qu'il ne fait PAS : Il ne peut pas envoyer d'emails à ta place (sécurité) — il crée des brouillons que tu valides toi-même.
"Montre-moi mes emails non lus"
"Cherche les emails de dupont@email.com cette semaine"
"Rédige un brouillon de réponse pour cet email"
"Quels emails ont une pièce jointe ce mois-ci ?"
Ce qu'il permet : Créer des designs (posters, posts Instagram, présentations, flyers, cartes de visite...), modifier des designs existants, exporter en PDF/PNG/JPG.
"Crée un poster Instagram pour la promotion FREEHOME printemps 2026"
"Fais une présentation de 10 slides sur le projet PlanningIA"
"Exporte mon design en PDF"
"Modifie le texte du slide 3 de ma présentation"
Ce qu'il permet : Gérer ton hébergement web — lister tes sites (Workers et Pages), créer des bases de données D1, gérer le stockage KV et R2, déployer du code.
"Liste tous mes sites sur Cloudflare"
"Crée une base de données D1 pour le projet"
"Montre-moi le code du Worker planningia"
Ce qu'il permet : Chercher des documents dans ton Google Drive et lire leur contenu (Google Docs).
"Cherche le document 'cahier des charges' dans mon Drive"
"Lis le Google Doc à cette adresse : https://docs.google.com/..."
Ce qu'il permet : Accéder à la documentation de n8n (outil d'automatisation). Consulter les 1396 nodes disponibles, les templates de workflows, et obtenir de l'aide pour construire des automatisations.
"Comment envoyer un email avec n8n ?"
"Quel node n8n utiliser pour se connecter à une base Postgres ?"
"Montre-moi un template de workflow n8n pour surveiller un site"
Ce qu'il permet : Créer, ouvrir, lire et modifier des fichiers Excel et Word directement. Insérer des formules, formater du texte, créer des graphiques, exporter en PDF.
"Crée un tableau Excel avec les déboursés du mois"
"Ajoute une formule SOMME dans la colonne D"
"Crée un document Word avec le compte-rendu de la réunion"
"Exporte ce fichier Excel en PDF"
Ce qu'il permet : Lire des PDF, extraire du texte, remplir des formulaires PDF, valider des champs, exporter des données en CSV.
"Lis le PDF /Users/imac/Documents/contrat.pdf et résume-le"
"Remplis le formulaire PDF avec mes informations"
"Extrais les données de ces 10 PDF dans un fichier CSV"
Ce qu'ils permettent : Stitch génère des écrans de design haute fidélité et des design systems. Figma permet de lire les designs Figma et d'extraire les composants et styles.
Ce qu'il permet : Claude peut prendre le contrôle de ton écran : déplacer la souris, cliquer, taper du texte, prendre des captures d'écran. C'est comme si quelqu'un utilisait ton ordinateur à distance.
Quand c'est utile : Quand tu as besoin que Claude interagisse avec une application qui n'a pas de MCP dédié (par exemple, remplir un formulaire dans Safari, naviguer dans une application).
Claude te demande toujours la permission avant de prendre le contrôle de ton écran. Il ne peut agir que sur les applications que tu as explicitement autorisées.
Un plugin est une extension qui ajoute des capacités à Claude Code. C'est comme installer une application sur ton téléphone — ça ajoute des fonctions que le téléphone n'avait pas de base.
Tu as deux collections de plugins installées :
Une collection de commandes slash pour le développement. Ce sont eux qui fournissent les commandes /commit, /code-review, /bug-fix, etc. (détaillées dans la section précédente).
Emplacement sur ta machine : ~/.claude/awesome-claude-plugins/
Comment les utiliser : Tape /nom-de-la-commande dans le chat.
Ce plugin est différent des autres : il fonctionne automatiquement en arrière-plan. Tu n'as rien à faire — il se déclenche tout seul.
Ce qu'il fait :
Interface web : Tu peux visualiser toute la mémoire stockée en ouvrant http://localhost:37777 dans ton navigateur (quand Claude Code est lancé).
Emplacement sur ta machine : ~/.claude/claude-mem/
Par défaut, chaque session Claude Code est indépendante. Quand tu ouvres une nouvelle session, Claude ne se souvient pas de ce que vous avez fait la dernière fois. C'est comme parler à quelqu'un qui a la mémoire courte.
Le système de mémoire résout ce problème. Il permet à Claude de retenir des informations d'une session à l'autre.
Comment ça marche : Claude sauvegarde des notes dans des fichiers texte (format Markdown) organisés par projet.
Où c'est stocké : ~/.claude/projects/.../memory/
4 types de notes :
Comment ça marche : Capture automatiquement tout ce que Claude fait et le stocke dans une base de données avec des embeddings vectoriels (recherche intelligente).
Où c'est stocké : Base SQLite dans ~/.claude-mem/
Interface visuelle : http://localhost:37777
Avantage : Complètement automatique, rien à faire.
Un workflow est une série d'étapes que Claude suit automatiquement quand tu lances une commande slash. C'est comme une recette de cuisine : chaque étape est définie à l'avance, dans l'ordre.
Tu peux créer n'importe quel workflow en ajoutant un fichier .md dans le dossier ~/.claude/commands/.
Le nom du fichier devient le nom de la commande. Par exemple, ma-routine.md donne la commande /ma-routine.
En français, décris ce que Claude doit faire, étape par étape. Claude suivra ces instructions à la lettre quand tu taperas la commande.
Tape /ma-routine dans le chat et Claude exécutera tout le workflow.
Fichier ~/.claude/commands/bonjour.md :
---
description: "Routine de début de journée"
---
1. Affiche la date du jour
2. Résume les derniers commits git du projet
3. Liste les fichiers modifiés non committés
4. Rappelle les notes de liaison de la dernière sessionEnsuite, tu tapes /bonjour et Claude fait tout ça automatiquement.
Tout ce qui fait fonctionner Claude Code est stocké dans des fichiers sur ton Mac. Voici la carte complète :
| Fichier / Dossier | Ce que c'est | Ce que tu peux y faire |
|---|---|---|
~/.claude/settings.json |
Le fichier de configuration principal. Il contient la liste des serveurs MCP, des plugins, des hooks et des permissions. | Ajouter/supprimer un MCP ou un plugin. En général, demande à Claude de le modifier plutôt que de le faire à la main. |
~/.claude/CLAUDE.md |
Les règles globales que Claude suit pour TOUS tes projets. C'est là que sont définies les règles de design (mobile first, polices, couleurs par projet, etc.). | Modifier les règles si tu veux changer le comportement par défaut de Claude. |
~/.claude/commands/ |
Tes commandes slash personnalisées. Chaque fichier .md est une commande. | Créer de nouveaux workflows en ajoutant des fichiers .md |
~/.claude/projects/ |
La mémoire de Claude, organisée par projet. | Généralement géré automatiquement par Claude. |
~/.claude/awesome-claude-plugins/ |
Les 25 plugins de développement (commandes /commit, /code-review, etc.). | Mis à jour avec git pull dans ce dossier. |
~/.claude/claude-mem/ |
Le plugin de mémoire persistante. | Interface web sur localhost:37777. |
.claude/CLAUDE.md (dans un projet) |
Règles spécifiques à ce projet (en plus des règles globales). | Ajouter des règles qui ne s'appliquent qu'à ce projet. |
Le symbole ~ représente ton dossier personnel. Sur ton Mac, ~ = /Users/imac. Donc ~/.claude/ = /Users/imac/.claude/. C'est un dossier caché (le point devant le nom le rend invisible dans le Finder par défaut).
Appuie sur Ctrl + C pour l'interrompre. Si ça ne marche pas, ferme et relance Claude Code. Tes fichiers ne sont pas perdus — seule la session en cours est affectée.
Vérifie que tu as bien relancé Claude Code après l'installation des plugins. Les plugins ne sont chargés qu'au démarrage.
Vérifie que le plugin claude-mem est bien dans la liste des plugins de ~/.claude/settings.json. Tu peux aussi lui dire explicitement "rappelle-toi de X" pour forcer la sauvegarde.
cd ~/.claude/awesome-claude-plugins && git pull
cd ~/.claude/claude-mem && git pullDemande à Claude : "Désactive le plugin X" ou "Retire le MCP Y de ma configuration". Il modifiera settings.json pour toi.
Claude fait des erreurs parfois, comme tout développeur. C'est pour ça que /fin-de-journee inclut un code review avant le commit. Et si quelque chose va vraiment mal, tu as git pour revenir en arrière : git checkout . annule toutes les modifications non committées.
Crée un fichier .md dans ~/.claude/commands/. Le nom du fichier = le nom de la commande. Décris les instructions en français à l'intérieur. Voir la section Workflows.
C'est un fichier de règles que Claude lit au démarrage de chaque session. Il contient tes préférences de design (polices, couleurs, mobile first), les interdits (pas d'Arial, pas de gradient violet), et les bonnes pratiques à suivre. C'est comme un cahier des charges permanent.
MCP = connexion à un service externe (Gmail, Canva...). Toujours actif, transparent, Claude l'utilise quand il en a besoin.
Plugin = extension locale qui ajoute des commandes slash ou des hooks. S'active manuellement (commandes) ou automatiquement (hooks).