Claude Code pour débutants.

Ce qu'est Claude Code, et ce que ce n'est pas

Claude Code est un agent. C'est-à-dire un assistant qui ne se contente pas de répondre dans une fenêtre de chat, mais qui peut agir sur ton ordinateur : lire un fichier, écrire un nouveau fichier, modifier le code existant, lancer une commande dans le terminal, faire une recherche web, exécuter un test. À la fin de chaque action, il observe le résultat et planifie la suite.

Comparaison rapide avec d'autres outils :

Claude Code n'est pas un éditeur de texte. Tu peux très bien travailler dans un éditeur séparé (VS Code, Sublime Text, Zed) et utiliser Claude Code à côté, dans une fenêtre de terminal. C'est le mode que je préfère.

Installer Claude Code en cinq minutes

Prérequis minimaux : un Mac, un PC Windows ou Linux, un abonnement Claude Pro ou supérieur, et le terminal installé (présent par défaut partout).

1. Ouvrir le terminal.
   • Mac : Cmd + Espace, taper « Terminal », entrée.
   • Windows : touche Windows, taper « PowerShell », entrée.
2. Installer Node.js si ce n'est pas déjà fait. Aller sur nodejs.org, télécharger la version LTS, l'installer.
3. Installer Claude Code. Dans le terminal, taper :

   npm install -g @anthropic-ai/claude-code

   et attendre que l'installation se termine.
4. Se connecter. Toujours dans le terminal :

   claude

   Une URL apparaît, on la colle dans le navigateur, on se connecte avec son compte Anthropic, et c'est prêt.
5. Naviguer vers ton dossier de projet. Par exemple si ton projet est sur le Bureau :

   cd ~/Desktop/mon-projet

   Puis lancer Claude Code :

   claude

Première conversation, ce qui change

Une fois lancé, Claude Code attend ton message. Tu peux taper en français, en phrases naturelles. La différence fondamentale avec Claude.ai : il voit ton dossier. Tu peux écrire :

Liste les fichiers de ce dossier et dis-moi en une
phrase ce que contient chacun.

Il va lire les fichiers et te répondre. Tu peux aussi lui demander :

Dans le fichier README.md, corrige les fautes
d'orthographe sans changer le sens.

Il va proposer une modification, te montrer le « diff » (ce qui change), et te demander confirmation avant d'appliquer.

C'est cette boucle qui change tout : tu décris une intention, il propose, tu valides ou tu corriges. Tu n'écris plus de code, tu pilotes.

Permissions, le garde-fou indispensable

Par défaut, Claude Code demande l'autorisation avant chaque action sensible : modifier un fichier, lancer une commande, faire une recherche web. C'est volontairement verbeux, parce qu'un agent qui fait n'importe quoi sans confirmation peut casser ton projet.

Trois niveaux d'autorisation, à connaître :

• Une fois. L'action se fait maintenant, et la prochaine fois Claude redemande.
• Pour cette session. Tu autorises jusqu'à ce que tu fermes Claude Code. Pratique pour les commandes inoffensives comme npm test.
• Toujours. Tu autorises de manière permanente. À réserver aux commandes vraiment sûres (git status, ls).

Pour gérer les permissions enregistrées, tape /permissions. Tu vois la liste, tu peux supprimer ce que tu n'utilises plus.

Les slash commands, raccourcis utiles

Quand tu tapes / au début d'un message, une liste de raccourcis s'affiche. Les plus utiles à connaître tout de suite :

• /help : affiche l'aide.
• /clear : efface la conversation et repart de zéro. Très utile quand la conversation s'est embourbée et que les corrections successives n'aident plus.
• /init : crée un fichier CLAUDE.md qui décrit ton projet (voir section suivante). À lancer dès que tu démarres un nouveau projet.
• /permissions : gère les autorisations enregistrées.
• /config : ouvre les réglages (modèle, thème, raccourcis).
• /mcp : gère les serveurs MCP (voir plus bas).
• /cost : affiche combien tu as consommé en tokens depuis le début de la session.
• /exit ou Ctrl + D : quitte Claude Code.

La liste complète apparaît avec /help. Pas besoin de tout retenir, juste de savoir que la touche / existe.

Les fichiers .md qui changent tout

Markdown (.md) est le format de texte structuré utilisé partout dans l'écosystème Claude Code. Plusieurs fichiers ont des rôles particuliers.

CLAUDE.md, l'instruction permanente du projet

C'est le fichier le plus important. Placé à la racine de ton projet, il est lu automatiquement par Claude Code à chaque ouverture. Il sert à décrire :

• De quoi le projet parle, en une ou deux phrases.
• La stack technique utilisée (langages, frameworks).
• La structure des dossiers.
• Les conventions de code (nommage, formatage).
• Les commandes utiles (npm run dev, npm test).
• Les choses à éviter dans ce projet précis.

Tu peux le générer automatiquement avec /init, puis l'affiner à la main. Plus il est précis, moins tu as besoin de réexpliquer le contexte à chaque session. Pour ce site, le CLAUDE.md dit en gros « site HTML/CSS vanilla, pas de framework, journal en Markdown, déploiement Vercel automatique ».

Les autres fichiers Markdown importants

• README.md : la documentation pour les humains qui ouvrent le projet (toi, dans six mois). Pas nécessaire à Claude Code lui-même, mais il sait le lire quand tu le lui demandes.
• AUDIT.md, MEMORY.md, NOTES.md : tu peux créer n'importe quel fichier Markdown que tu veux consulter. Claude Code le lira si tu lui demandes explicitement.
• .claude/skills/*.md : les fichiers qui définissent tes Skills (voir section suivante).

Skills, les compétences réutilisables

Un Skill est un fichier Markdown qui décrit une compétence ou un savoir-faire spécialisé que Claude Code peut invoquer. Quand tu as une tâche récurrente avec un protocole précis, tu en fais un Skill au lieu de réexpliquer à chaque fois.

Exemples concrets de Skills utiles :

• « relire-un-pdf » : décrit la procédure pour extraire le contenu d'un PDF scientifique, le résumer, en sortir un tableau de références.
• « publier-entree-journal » : automatise la création d'une nouvelle entrée dans le journal de bord de ce site (création du fichier MD, mise à jour de l'index, vérification).
• « generer-presentation » : produit un fichier .pptx à partir d'un brief.

Un Skill se définit dans .claude/skills/nom-du-skill/SKILL.md avec un front-matter qui contient son nom, sa description, et quand l'utiliser. Quand l'utilisateur formule une demande qui correspond, Claude Code propose d'invoquer le Skill.

Anthropic fournit déjà une bibliothèque de Skills officiels (PDF, PowerPoint, Excel, Word, design, algorithmic art). Tu peux aussi créer les tiens, ou installer ceux partagés par la communauté.

Sub-agents, déléguer une tâche

Quand une tâche est volumineuse ou autonome, Claude Code peut la déléguer à un sous-agent. Le sous-agent travaille dans son propre contexte (sa propre mémoire de conversation), revient avec un résumé, et le contexte principal reste léger.

Cas d'usage typiques :

• Recherche : « lis tous les fichiers de ce dossier et fais-moi un rapport de 300 mots sur ce qu'ils contiennent ». Le sous-agent ouvre dix fichiers en interne, ton contexte principal ne reçoit que le résumé.
• Plan : avant un gros changement, un sous-agent dédié réfléchit au plan et te le présente avant exécution.
• Revue de code : un sous-agent spécialisé regarde un diff et donne un avis indépendant.

Tu n'as pas besoin d'appeler les sous-agents manuellement au début : Claude Code décide souvent seul de déléguer quand c'est pertinent. Avec l'expérience, tu peux dire explicitement « confie cette tâche à un sous-agent Explore » pour économiser ton contexte.

MCP, brancher des outils tiers

MCP (Model Context Protocol) est le standard ouvert qui permet à Claude Code d'utiliser des outils externes. Tu installes un serveur MCP, et son catalogue d'actions devient disponible dans Claude Code, au même titre que la lecture de fichier ou l'exécution de commande.

Quelques serveurs MCP utiles pour démarrer :

• Notion, Linear, Asana : lire et écrire dans tes outils de gestion de projet.
• GitHub : créer une issue, ouvrir une pull request, lire un dépôt.
• Figma : extraire les tokens de design d'une maquette.
• Vercel : déployer, consulter les logs.
• Filesystem, recherche web, navigation navigateur : étendre les capacités d'accès.

Pour ajouter un MCP, on tape /mcp dans Claude Code, on choisit le service, on se connecte. Une fois connecté, ses actions s'utilisent dans la conversation normale, sans syntaxe particulière.

Plugins, le store de capacités

Les plugins sont des paquets prêts à l'emploi qui regroupent des Skills, des serveurs MCP, des commandes personnalisées et des hooks autour d'un usage métier. Anthropic et la communauté en proposent dans le plugin store accessible via /plugin.

Exemples :

• Plugin design : Skills pour générer des composants UI cohérents, MCP Figma intégré.
• Plugin marketing : Skills pour rédiger des contenus, MCP HubSpot, MCP Canva.
• Plugin productivité : MCP Notion, MCP ClickUp, Skills de prise de note.

Pour les débutants : ne pas installer trente plugins par curiosité. Démarre avec deux ou trois liés à ton métier réel, et n'en ajoute un nouveau que quand un besoin précis émerge.

Hooks, l'automatisation discrète

Les hooks sont des actions que Claude Code déclenche automatiquement à des moments précis : après une modification de fichier, avant un commit, à la fin d'une session. Tu les configures dans .claude/settings.json.

Usages typiques :

• Lancer le formateur de code (prettier, black) automatiquement après chaque modification.
• Lancer les tests automatiquement avant chaque commit.
• Envoyer une notification sur ton téléphone quand un long agent termine sa tâche.
• Bloquer toute modification dans un dossier sensible (par exemple .env).

Pour un débutant : pas besoin de toucher aux hooks dans les premières semaines. Tu y reviendras quand tu auras identifié une action récurrente que tu oublies de faire à la main.

Workflow type, une journée concrète

Voici une session typique sur un projet, pour donner du relief à tout ce qui précède. Imagine que tu veux ajouter une nouvelle entrée au journal de bord de ce site.

1. Tu ouvres ton terminal dans le dossier du site, tu lances claude.
2. Claude Code lit automatiquement CLAUDE.md et sait qu'il s'agit d'un site statique avec un journal en Markdown.
3. Tu écris : « Crée une entrée de journal pour aujourd'hui, titre "Première démo aux collègues", avec ce contenu : [tu colles tes notes brutes]. »
4. Claude Code crée le bon fichier Markdown, met à jour journal/entries/index.json, te montre le diff. Tu valides.
5. Tu écris : « Lance le serveur local pour que je vérifie. » Il lance python3 -m http.server 3000.
6. Tu vérifies dans ton navigateur. Tout est bon.
7. Tu écris : « Commit et push. » Il compose un message de commit propre, te le soumet, fait le push.
8. Vercel redéploie automatiquement. Trente secondes plus tard, la nouvelle entrée est en ligne.

Temps total : cinq minutes pour quelqu'un qui ne code pas. Avant Claude Code, c'était soit une heure de patouillage, soit la dépendance à quelqu'un d'autre.

Erreurs fréquentes à éviter

• Ne pas écrire de CLAUDE.md. Sans contexte projet, l'agent réinvente la roue à chaque session. Cinq minutes investies, beaucoup de temps gagné.
• Tout autoriser sans réfléchir. Mauvais réflexe. Garde la confirmation manuelle sur les actions irréversibles, surtout au début.
• Continuer une session embourbée. Quand l'agent boucle ou se contredit, fais /clear et repars d'un prompt clair. Plus rapide que de corriger des erreurs en cascade.
• Ne pas lire les diffs. La confirmation avant modification n'est utile que si tu regardes ce qui change. Au minimum, lis la liste des fichiers touchés.
• Installer trente plugins par curiosité. Chaque plugin alourdit le contexte et les choix possibles. Mieux : deux ou trois bien choisis.
• Travailler sans Git. Si Claude Code casse quelque chose, git checkout répare instantanément. Sans Git, c'est la panique.
• Coller des données sensibles. Pas de données nominatives, pas de secrets, pas de mots de passe dans la conversation. C'est aussi vrai dans Claude Code que partout ailleurs.

Premier petit projet pour s'entraîner

Pour se faire la main, choisis un mini-projet sans enjeu :

1. Crée un dossier mon-cv sur ton bureau.
2. Lance Claude Code dedans.
3. Demande : « Fais-moi un /init pour ce projet de CV personnel en HTML/CSS. »
4. Puis : « Crée un CV en une page, sobre, en français, avec mes informations [tu colles]. Style éditorial, police serif élégante, palette papier crème. »
5. Itère. Ajuste les couleurs, la mise en page, les sections.
6. Quand tu es satisfait, demande à Claude Code d'exporter en PDF.

En deux heures, tu auras un CV soigné et tu auras compris le mode de pilotage. C'est l'investissement le plus rentable que tu puisses faire en 2026 pour ton confort de travail futur.