Tuto Claude Code gratuit : de débutant à expert

Réponse courte

Ce tuto Claude Code gratuit reprend la vidéo de 49 minutes et la complète par écrit : installer l'outil, ouvrir une première session, poser un fichier CLAUDE.md, puis utiliser les commandes, les skills, le MCP et les sous-agents. Tu suis les étapes dans l'ordre, avec les commandes à copier et les mises à jour de la documentation officielle depuis le tournage. Pour un parcours accompagné, avec des cas concrets filmés pas à pas, la page dédiée est séparée de ce tutoriel.

« Claude Code, c'est un truc de développeur. Le terminal, ça me fait peur. »

Je l'entends à chaque fois que je présente l'outil.

Mais le problème n'a jamais été le terminal.

Le problème, c'est que personne ne t'a montré dans quel ordre apprendre les choses.

Sur les 61 jours avant le tournage, je n'ai pas raté un seul jour dans Claude Code. Dans cette vidéo, je t'ai filtré ce qui compte vraiment. Cet article est le mode d'emploi qui va avec : le même parcours, plus le fichier mémoire, les commandes slash et le branchement d'outils, que 49 minutes ne suffisaient pas à dérouler.

Le parcours en 5 étapes

Le schéma ci-dessous est la carte du tuto. Les sections qui suivent détaillent chaque étape, dans le même ordre que la vidéo quand elle couvre le sujet, et avec le complément écrit quand la vidéo n'a pas eu le temps.

Si tu débutes, suis l'ordre. Installer sans ouvrir de session ne t'apprend rien. Ouvrir une session sans fichier mémoire te fait répéter les mêmes consignes. Enchaîner les skills avant de savoir lancer claude dans le bon dossier te fait perdre du temps.

La vidéo en haut de la page montre l'installation, le choix du modèle, les sous-agents, les skills, les agent teams et une application construite en deux prompts. Les étapes 3 (CLAUDE.md et commandes) et le MCP de l'étape 4 sont le complément de ce texte : je le disais déjà après le tournage, 49 minutes ne laissent pas la place à tout.

Étape 1 : installer Claude Code

Ce que tu installes

Claude Code est un outil agentique : il lit ton projet, modifie des fichiers, lance des commandes. Tu peux t'en servir dans le terminal, dans un IDE, dans l'application de bureau ou dans le navigateur. Pour ce tuto, on part du terminal. C'est le chemin le plus direct, et c'est celui que je montre dans la vidéo.

La documentation d'installation recommande l'installation native. C'est aussi celle que j'utilise.

Sur macOS, Linux ou WSL, ouvre un terminal et colle :

curl -fsSL https://claude.ai/install.sh | bash

Sur Windows, dans PowerShell (l'invite affiche PS) :

irm https://claude.ai/install.ps1 | iex

Sur Windows, dans l'invite de commandes CMD (l'invite affiche C:\ sans PS) :

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Si tu vois que && n'est pas un séparateur valide, tu es dans PowerShell : utilise la commande irm. Si irm n'est pas reconnu, tu es dans CMD : utilise la commande curl. Sur Windows natif, Git for Windows est recommandé pour que Claude Code dispose de Bash. Sous WSL, tu n'en as pas besoin.

Deux autres méthodes officielles, si tu préfères un gestionnaire de paquets :

brew install --cask claude-code

winget install Anthropic.ClaudeCode

L'installation native se met à jour toute seule en arrière-plan. Homebrew et WinGet non : il faut lancer brew upgrade claude-code ou winget upgrade Anthropic.ClaudeCode. La méthode npm existe toujours (npm install -g @anthropic-ai/claude-code). Le paquet demande Node.js 22 ou plus récent. Ne la lance pas avec sudo.

Ensuite, ouvre un nouveau terminal et vérifie :

claude --version

Si un numéro de version s'affiche, l'installation a fonctionné. S'il te dit que claude est introuvable, le dossier d'installation n'est pas encore dans le PATH : la page de dépannage de la doc indique comment le corriger. La commande /doctor, une fois dans une session, fait aussi un contrôle de l'installation.

Étape 2 : la première session

Se placer dans le bon dossier

Claude Code travaille sur les fichiers du dossier où tu le lances. Ce n'est pas un chat dans un navigateur à qui tu colles des extraits. Place-toi dans un projet, ou crée un dossier vide pour t'entraîner :

mkdir -p ~/essai-claude && cd ~/essai-claude
claude

Au premier lancement, Claude Code ouvre le navigateur pour que tu te connectes. Si tu changes de compte plus tard, tape /login dans une session.

Si la variable d'environnement ANTHROPIC_API_KEY est déjà définie et que tu acceptes de l'utiliser, l'écran de connexion peut être sauté. Pour débuter, la connexion par le navigateur est le chemin le plus simple.

Le premier prompt

Une fois la session ouverte, demande quelque chose de petit et de vérifiable. Dans un dossier vide :

Crée un fichier notes.md avec trois idées de tâches que je pourrais automatiser cette semaine. N'invente pas d'outils que je n'ai pas.

Dans un vrai projet :

Décris la structure de ce dossier en dix lignes : à quoi il sert, comment on le lance, et quels fichiers je ne devrais pas modifier.

Claude propose un plan, agit, puis te montre le résultat. Tu valides les actions quand il te le demande. Lis ce qu'il veut faire avant d'accepter, surtout la première semaine. La commande /permissions sert ensuite à mémoriser ce que tu acceptes toujours, ce que tu veux revoir, et ce que tu refuses.

La boucle agentique

« Agentique » veut dire qu'il ne s'arrête pas à une réponse à copier-coller. Quand tu lui demandes un résultat, il suit une boucle :

1. Il planifie les actions nécessaires.
2. Il agit : créer un fichier, lancer une commande, lire un résultat.
3. Il observe : le fichier est-il là, la commande a-t-elle échoué.
4. Il recommence s'il faut corriger, jusqu'à un résultat qu'il peut te montrer.

Tu récupères un travail vérifié dans ton dossier, pas un pavé à recoller à la main.

Opus ou Sonnet

Plusieurs modèles existent. Pour débuter, retiens deux noms, comme dans la vidéo.

La règle que je donne dans la vidéo : n'utilise pas Opus pour écrire un mail. C'est comme prendre un camion pour aller chercher le pain.

Tu changes de modèle en cours de session avec /model. Sans argument, un sélecteur s'ouvre. Avec un argument, par exemple /model sonnet, tu bascules directement. Le choix pèse sur ta consommation : suis-la avec /usage.

L'abonnement

La documentation d'installation est claire : Claude Code demande un compte Pro, Max, Team, Enterprise ou Console (API). L'offre gratuite de claude.ai n'inclut pas Claude Code. Tu peux aussi passer par un fournisseur comme Amazon Bedrock, Google Cloud ou Microsoft Foundry, ce qui dépasse ce tuto.

Deux grandes options, déjà dans la vidéo :

• Un abonnement Claude : tu paies un forfait, et Claude Code est inclus à partir de Pro.
• La facturation à l'usage via l'API : tu paies les tokens consommés. Je ne l'utilise pas pour mon usage quotidien, la facture peut monter vite. Si tu pars là-dessus, pose des plafonds de dépense dès le premier jour.

Les montants changent. Je ne les recopie pas ici : la page tarifs officielle fait foi. Dans la vidéo, je compare les offres individuelles selon que tu découvres l'outil ou que tu t'en sers tous les jours, et je dis que je suis moi-même entre Max 5x et Max 20x parce que c'est mon métier.

Même avec un abonnement, l'usage n'est pas illimité. Le centre d'aide Claude décrit deux limites qui se cumulent : une limite par session de 5 heures, qui se remet à zéro, et une limite hebdomadaire, qui s'applique à tous les modèles. Si tu pousses fort trois jours, tu peux être bloqué le reste de la semaine. /usage et la rubrique Usage du compte te montrent où tu en es.

Les premiers réflexes utiles

Si tu développes, commence par le refactoring (rendre un code plus lisible sans changer ce qu'il fait) et les tests (longs, répétitifs, pleins de cas). Claude Code s'en charge proprement quand le dossier est le bon et que la demande est précise.

Si tu l'utilises comme un chat, question après question, sans fichier et sans commande, tu passes à côté de l'outil. Les trois étapes suivantes font la différence.

Étape 3 : CLAUDE.md et les commandes

À quoi sert CLAUDE.md

Chaque session démarre avec une fenêtre de contexte vide. CLAUDE.md est le fichier d'instructions que Claude Code relit au début, pour ne pas repartir de zéro. Tu y mets ce que tu te fatigues à répéter : la stack, les commandes de build, les conventions, ce qu'il ne doit pas toucher.

Ce n'est pas un README pour les humains. Ce n'est pas non plus un prompt jetable. C'est la mémoire du projet. Le guide détaillé est dans mon article sur le fichier CLAUDE.md. Ici, tu fais le minimum utile pour finir le tuto.

La doc recommande de viser moins de 200 lignes. Au-delà, Claude noie l'essentiel et suit moins bien. Une consigne utile est concrète : « lance npm test avant de committer », pas « pense à tester ». Si deux lignes se contredisent, il peut en choisir une au hasard.

Créer le fichier avec /init

Dans la session, à la racine du projet :

/init

Claude parcourt le dépôt et propose un CLAUDE.md de départ : commandes de build, tests, conventions qu'il a vues. S'il existe déjà un fichier, /init suggère des améliorations au lieu de l'écraser. Tu relis, tu coupes le vague, tu ajoutes les interdits qu'aucun scan ne peut deviner (secrets, production, dossiers générés). Ensuite tu committes le fichier projet.

Pour vérifier qu'il est bien chargé, lance /context et regarde la liste des fichiers mémoire.

Un squelette suffit pour un premier projet :

# Projet
Application de prise de notes locale. Stack : fichiers Markdown, pas de base de données.

# Commandes
- Lancer : npm run dev
- Vérifier : npm test

# Interdits
- Ne pas modifier .env ni le dossier .next
- Ne pas committer de clé API

Remplace les commandes par celles de ton dépôt. Une commande inventée fait perdre un tour complet.

Si le dépôt a déjà un AGENTS.md pour d'autres agents, Claude Code peut le lire à la place d'un CLAUDE.md. Pour Claude Code, le fichier natif reste CLAUDE.md.

Les commandes slash à connaître

Une commande slash n'est reconnue qu'en début de message. Le texte qui suit devient son argument. Tu n'as pas à toutes les apprendre. Voici celles qui servent pendant ce tuto, d'après la référence des commandes.

/clear efface la conversation, pas le CLAUDE.md. /compact garde le fil en le raccourcissant. Quand la session devient longue et que Claude oublie le début, c'est l'un de ces deux réflexes, ou un sous-agent (étape 4), qu'il te faut.

/plan est utile avant une modification large : Claude décrit ce qu'il va faire, tu valides, ensuite il exécute. Sur une première session, prends cette habitude.

Anatomie d'un projet

Avant d'ajouter des briques, regarde comment elles se rangent. Quatre mécanismes, quatre rôles. Le schéma les sépare pour que tu ne mettes pas une procédure dans le fichier mémoire, ni un connecteur externe dans un prompt.

La doc officielle range les extensions dans cet ordre d'apparition : d'abord la mémoire, ensuite les skills, ensuite les connecteurs, ensuite les workers isolés. C'est le même ordre que ce tuto.

Étape 4 : skills, MCP et sous-agents

Les skills, des procédures réutilisables

Un skill est un dossier qui contient un fichier SKILL.md : le prompt, parfois des scripts ou des documents. Tu l'appelles quand tu en as besoin, et Claude déroule la procédure sans que tu réécrives le prompt. Les commandes personnalisées et les skills sont le même mécanisme : un fichier de commande et un SKILL.md créent tous les deux une commande slash.

~/.claude/skills/mon-skill/SKILL.md   # personnel, tous tes projets
.claude/skills/mon-skill/SKILL.md     # réservé à ce projet, à committer

Tu listes tes skills avec /skills. Tu en lances un avec /nom-du-skill. Le détail pour en écrire un propre est dans mon article créer un skill. La référence officielle est la documentation des skills.

Dans la vidéo, j'utilise le skill last30days pour une veille sur les sujets qui bougent. Je lui demande les trois derniers jours sur le SaaS, l'IA et les agents IA. Résultat : des sujets sourcés depuis le web. Ça n'a pas marché du premier coup : Claude ne trouvait pas le skill. Après avoir fermé le fichier ouvert et relancé la demande, il l'a trouvé. Si un skill n'est pas détecté, vérifie le dossier, puis /skills.

Il existe un skill qui crée des skills. Tu le lances, il te pose des questions (objectif, problème, deux ou trois exemples) et il génère le dossier. Un skill peut en appeler d'autres.

Pour installer un skill publié par quelqu'un d'autre, le site que je montre est skills.sh. La commande ressemble à ceci :

npx skills add <proprietaire/depot>

Dans la vidéo, j'installe un skill de génération vidéo. L'installateur demande pour quels agents, puis si je le veux en global (tous les projets) ou en local (un seul). Je relance Claude, /skills le liste, et je lui demande ce qu'il sait faire.

Sans ce dossier, la même méthode se reconstruit dans une conversation à rallonge, et tu brûles des tokens pour rien.

Le MCP, pour les outils hors du dépôt

Le Model Context Protocol (MCP) est le standard qui relie Claude Code à un outil externe : un suivi de tickets, une base, un navigateur, une documentation. CLAUDE.md dit comment travailler. Le MCP donne accès à un service que les fichiers du dépôt ne contiennent pas. Le fonctionnement côté entreprise est détaillé dans mon article sur le Model Context Protocol.

Le premier branchement, tel que le guide officiel le montre, sert à vérifier que le mécanisme marche. Tu le lances dans le terminal, en dehors d'une session claude :

claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp

Puis tu contrôles :

claude mcp list

Un statut connecté veut dire que le serveur répond. Tu ouvres ensuite claude et tu peux demander d'utiliser ce serveur par son nom. Dans la session, /mcp gère les serveurs déjà ajoutés (reconnecter, activer, désactiver).

Trois portées existent :

Pour la portée utilisateur : claude mcp add --scope user --transport http .... Pour partager avec l'équipe : --scope project.

Quand tu as fini l'essai, retire le serveur de démo :

claude mcp remove claude-code-docs

Chaque serveur chargé occupe de la place dans la fenêtre de contexte, parce que ses outils sont annoncés à Claude. Tu ne connectes pas dix services « au cas où ». Tu connectes celui dont la tâche a besoin.

Ce tuto ne te fait pas brancher ton CRM ou ta comptabilité. Le serveur de documentation ci-dessus est l'exemple officiel, sans clé, pour voir le cycle ajouter, vérifier, utiliser, retirer. Tes vrais serveurs suivent le même cycle, avec souvent une connexion navigateur en plus.

Les sous-agents

Un sous-agent est un worker spécialisé dans sa propre fenêtre de contexte. Il fait le travail de son côté, puis il renvoie un résumé à la conversation principale. Ton fil reste lisible.

L'image que j'utilise dans la vidéo : un bureau. Chaque information est un livre posé dessus. Le bureau a une taille limite. À un moment, les premiers livres tombent. C'est la fenêtre de contexte. Le sous-agent travaille sur un autre bureau et ne te rend que la synthèse.

Les fichiers se rangent ici (doc des sous-agents) :

~/.claude/agents/   # personnels, tous les projets
.claude/agents/     # ce projet

Depuis Claude Code v2.1.198, /agents n'ouvre plus l'assistant interactif des versions 2.1.197 et antérieures (celui de la vidéo). La commande te rappelle de demander à Claude de créer le fichier, ou de l'écrire toi-même dans l'un des deux dossiers.

Dans la vidéo, je fais deux essais. D'abord une recherche web : je demande d'analyser un site, et Claude choisit seul l'agent de recherche. Ensuite je nomme l'agent d'exploration pour qu'il m'explique une application sur mon disque. Il lit le README, parcourt le code, et me rend une analyse.

Ma règle : si Claude n'utilise pas le bon agent, nomme-le.

Utilise l'agent Explore pour m'expliquer ce que fait l'application dans ~/Documents/code/mon-projet

Un sous-agent peut précharger des skills. Un skill peut aussi tourner dans un contexte isolé. Tu n'as pas à configurer ça le premier jour. Retiens la différence : le skill est une procédure, le sous-agent est un travailleur à part.

Les agent teams

Avec les sous-agents, chacun rend son résultat à l'agent principal. Avec les agent teams, plusieurs instances communiquent entre elles, coordonnées par un chef d'équipe, avec une liste de tâches partagée. C'est expérimental, et désactivé par défaut. La documentation des agent teams le dit : sans la variable, aucune équipe n'est créée.

Pour les activer, dans ~/.claude/settings.json :

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Sans cette ligne, pas d'équipe. Les activer change aussi la délégation ordinaire : un sous-agent que Claude nomme peut alors démarrer comme coéquipier. Si tu veux revenir aux sous-agents classiques, remets la variable à 0. Il faut en plus une session interactive : avec le flag -p, Claude ne lance pas de coéquipiers.

Dans la vidéo, une fois la fonction activée, je donne ce prompt :

Je veux que tu me crées une routine chaque matin avec une équipe d'agents qui vont
utiliser le skill last30days pour chercher des idées de contenu sur le SaaS, l'IA et
le coding, tous les matins à 7h. Ensuite, on crée du contenu pour ma chaîne YouTube et
Instagram. Organise-toi et délègue à tes agents. On peut lancer un premier test maintenant.

Claude fait son plan, puis lance trois agents : Trend Researcher, YouTube Creator et Instagram Creator. Il comprend que le chercheur doit finir en premier. Il trouve des tendances, écrit le fichier, puis les deux créateurs travaillent en parallèle. Résultat : des scripts et des carrousels, à partir de données du moment.

À la main, la recherche seule prend facilement 20 à 30 minutes. Le même schéma se transpose à un autre métier, à condition que les rôles puissent avancer sans s'attendre sur le même fichier. La doc le précise : pour une tâche séquentielle, une session seule ou des sous-agents conviennent mieux, et coûtent moins.

Pour que cette routine parte seule le lendemain matin, le complément est le scheduler de Claude Code : une tâche planifiée, locale ou dans le cloud, qui relance une session à l'heure dite.

Étape 5 : la démo et les bonnes pratiques

Une application en deux prompts

Dans la vidéo, j'assemble sous-agents, skills et agent teams sur un vrai problème. Avec plusieurs sessions ouvertes, je ne sais plus laquelle travaille. L'idée : un petit jeu en JavaScript (librairie Phaser) où chaque agent de la machine est un personnage.

Premier prompt. Un fichier Markdown décrit le projet et demande une équipe d'agents. Claude monte un team lead et des agents spécialisés. Il travaille une dizaine de minutes et livre une application web Next.js avec des personnages qui bougent, encore sur des données de simulation.

Deuxième prompt, dicté à la voix : n'utiliser que les instances Claude Code qui tournent vraiment sur la machine, afficher pour chacune la tâche en cours avec un titre et un résumé, et envoyer une notification dès qu'un agent ne fait rien.

Résultat : je vois quatre agents (team lead, backend dev, game dev, notif dev) travailler, puis disparaître une fois le travail terminé.

Je pousse ensuite : afficher toutes les instances et ouvrir le bon terminal au clic sur un personnage. Ça ne marche pas du premier coup. Après une itération de plus : les instances s'affichent, je clique, la bonne session s'ouvre.

Deux prompts pour la base. La précision du second prompt transforme une maquette en outil. C'est le geste à retenir de la démo, plus que la librairie utilisée.

La checklist

Si tu ne devais garder qu'une liste de ce tuto Claude Code, ce serait celle du schéma.

1. Choisis le modèle selon la tâche. Opus pour réfléchir, Sonnet pour exécuter vite. /model puis /usage.
2. Écris un CLAUDE.md court. Des commandes réelles, des interdits explicites, une relecture après /init.
3. Protège la fenêtre de contexte. Délègue recherche et exploration à un sous-agent. /context te montre quand elle se remplit, /compact la soulage.
4. Nomme l'agent ou le skill quand Claude ne le choisit pas seul.
5. Transforme tout process répété en skill. Tu écris la procédure une fois.
6. Branche un MCP seulement pour un service externe, et retire ceux que tu ne lances plus.
7. Réserve les agent teams au travail vraiment parallèle, après avoir activé la variable, et surveille les tokens.
8. Sois précis dans le prompt. Dans la démo, c'est le deuxième prompt qui rend l'outil utile.

Si tu compares avec un autre agent

Claude Code n'est pas le seul agent qui écrit dans un dépôt. Si tu hésites avec l'offre d'OpenAI, j'ai détaillé le positionnement, le prix annoncé et les différences d'usage dans l'article comparer Codex et Claude Code. Le geste de ce tuto (dossier, mémoire, commandes, skills) se transpose. Les fichiers et les commandes, eux, sont ceux de Claude Code.

Aller plus loin : la formation Claude Code accompagnée

Ce tuto et la vidéo te donnent la carte : installation, première session, mémoire, commandes, skills, MCP, sous-agents, et une démo. Tu peux t'arrêter là et pratiquer sur tes dossiers.

Si tu veux le même outil filmé sur des cas d'entrepreneur, avec quelqu'un qui a déjà fait le tri, c'est la formation Claude Code. Le programme reprend l'installation et les repères, le fichier CLAUDE.md, les skills, puis des cas concrets : une tâche de contenu, un audit SEO, une campagne publicitaire, des visuels, une boutique mise en ligne. L'accès à la formation est à vie. La communauté est incluse 30 jours. Le prix écrit sur la page est de 297 €, ou 2 mensualités de 147 €. L'abonnement Claude, lui, reste à part. Si la formation ne t'apporte rien sous 30 jours, la page indique un remboursement intégral.

Ce tutoriel reste gratuit. La page du programme est le parcours accompagné. Les deux ne répondent pas au même besoin : ici tu fais les étapes tout de suite, là tu suis un cours déjà découpé.

Pour la suite gratuite, la chaîne YouTube @SophieneIA publie les nouveautés. Pour regarder un déploiement dans une entreprise, le rendez-vous est sur ma page de rendez-vous.

FAQ

Par où commencer ce tuto Claude Code si je débute ?

Installe Claude Code avec la commande native de ton système, vérifie claude --version, puis lance claude dans un dossier de test. Enchaîne avec un premier prompt court, /init pour le CLAUDE.md, et seulement ensuite les skills. L'ordre des 5 étapes évite d'ajouter des briques avant de savoir ouvrir une session.

Faut-il savoir coder pour apprendre Claude Code ?

Non. Tu décris ce que tu veux en français, Claude planifie et exécute dans le dossier. Savoir lire ce que le terminal affiche aide les premiers jours, et ça s'apprend en faisant les étapes 1 et 2. La compétence qui compte est de formuler une demande précise et de relire le résultat.

Claude Code est-il inclus dans l'offre gratuite de Claude ?

Non. La documentation d'installation indique qu'il faut un compte Pro, Max, Team, Enterprise ou Console. L'offre gratuite de claude.ai ne donne pas accès à Claude Code. Ce tuto, lui, est gratuit à lire et la vidéo est gratuite à regarder. L'outil demande un abonnement ou une facturation API, dont les montants sont sur la page tarifs officielle.

Quelle est la différence entre ce tuto et la formation accompagnée ?

Ce tuto est le parcours gratuit : la vidéo de 49 minutes plus les étapes écrites pour installer, pratiquer, écrire un CLAUDE.md, et utiliser skills, MCP et sous-agents. La formation Claude Code est le cours accompagné, payant, avec des modules filmés sur des cas concrets, un accès à vie et 30 jours de communauté. Tu peux faire le tuto d'abord et décider ensuite.

Comment créer un fichier CLAUDE.md ?

Ouvre Claude Code à la racine du projet et lance /init. Claude propose un premier fichier à partir de ce qu'il voit dans le dépôt. Tu le relis, tu remplaces les commandes fausses, tu ajoutes les interdits, et tu le commits s'il est partagé. Vérifie le chargement avec /context. Le détail est dans l'article sur le fichier CLAUDE.md.

Opus ou Sonnet pour débuter avec Claude Code ?

Sonnet pour les tâches courtes, Opus quand il faut réfléchir, coder ou analyser. Tu bascules avec /model sans relancer l'installation. Sur un usage léger, commencer en Sonnet ménage les limites du plan. Passe en Opus quand la tâche le mérite, et regarde /usage pour voir l'effet.