Claude Code : le guide du débutant en français (2026)

Claude Code, c’est quoi ?

Claude Code est l’outil de programmation d’Anthropic qui travaille directement dans votre projet : il lit vos fichiers, les modifie, lance des commandes dans le terminal et vous montre ce qu’il fait à chaque étape. Ce n’est pas un chat où l’on copie-colle du code : c’est un assistant qui agit dans votre dossier, avec votre accord. La documentation officielle le décrit comme un outil « agentique » disponible dans le terminal, dans les éditeurs de code, dans une application de bureau et dans le navigateur.

J’écris ce guide parce que la plupart des tutoriels partent du principe que vous êtes déjà développeur. Je l’utilise tous les jours depuis Rabat, pour mes projets comme pour ce site, et les points qui bloquent au début sont presque toujours les mêmes : l’abonnement, le terminal, l’installation, et la façon de formuler les demandes. On les prend un par un.

Ce que Claude Code fait, et ce qu’il ne fait pas

Ce qu’il fait bien :

• Lire un projet entier et vous l’expliquer : « à quoi sert ce dossier ? », « où est géré le paiement ? ».

• Écrire et modifier du code sur plusieurs fichiers à la fois, puis vous montrer les changements avant de les appliquer.

• Lancer des commandes : installer une dépendance, démarrer le projet, exécuter les tests, faire un commit Git.

• Corriger une erreur à partir du message affiché dans le terminal, en relisant le code concerné.

Ce qu’il ne fait pas à votre place :

• Décider de ce que vous construisez. Si votre demande est floue, le résultat le sera aussi.

• Garantir que le code est juste. Il se trompe parfois, avec beaucoup d’assurance. Vous devez tester ce qu’il produit.

• Gérer vos comptes et vos secrets. Ne lui collez jamais un mot de passe ou une clé d’API dans la conversation.

• Remplacer les bases. Sans notions de terminal et de Git, vous ne comprendrez pas la moitié de ce qu’il vous propose.

Mon conseil : voyez-le comme un collègue très rapide, qui a lu énormément de code, mais qui ne connaît ni votre projet ni vos clients. C’est vous qui gardez la main.

Prérequis : ce qu’il vous faut avant de commencer

Un ordinateur compatible

D’après la page d’installation, Claude Code tourne sur macOS 13 ou plus récent, Windows 10 (version 1809 ou plus) ou Windows 11, Ubuntu 20.04 et plus, Debian 10 et plus. Il faut au moins 4 Go de RAM et une connexion internet. Pas besoin d’un ordinateur puissant : le modèle tourne chez Anthropic, pas sur votre machine.

Un abonnement ou un compte API

C’est le point qui surprend le plus : l’offre gratuite de Claude n’inclut pas Claude Code. La documentation est claire, il faut un compte Pro, Max, Team, Enterprise, ou un compte Console (paiement à l’usage via l’API). J’ai détaillé les prix et la façon de payer depuis le Maroc dans cet article sur le prix de Claude Code au Maroc. Bonne nouvelle au passage : le Maroc fait partie des pays où Anthropic propose ses services.

Un minimum de terminal

Vous allez taper des commandes. Rien de compliqué, mais il faut savoir ouvrir un terminal, vous déplacer dans un dossier (cd), lister son contenu (ls ou dir). Si vous n’avez jamais ouvert de terminal, la documentation propose un guide du terminal pour grands débutants.

Git, fortement conseillé

Git garde l’historique de votre code. Avec un assistant qui modifie des fichiers, c’est votre filet de sécurité : si une modification casse tout, vous revenez en arrière en une commande. Sur Windows, installer Git for Windows apporte aussi Git Bash, que Claude Code utilise s’il est présent.

Installer Claude Code

L’installation tient en une ligne. Sur macOS, Linux ou WSL :

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

Sur Windows, dans PowerShell :

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

Fermez puis rouvrez votre terminal, et vérifiez :

claude --version

Si un numéro de version s’affiche, c’est bon. Si le terminal répond que claude est introuvable, c’est presque toujours une histoire de PATH. J’ai écrit un pas à pas complet pour Windows avec les erreurs courantes et leurs solutions. En cas de doute, la commande claude doctor affiche un diagnostic de l’installation sans lancer de session.

Votre première session, pas à pas

1. Ouvrez un dossier de projet

Créez un dossier vide pour vous entraîner, par exemple premier-projet, et placez-vous dedans :

mkdir premier-projet
cd premier-projet
git init

git init démarre l’historique Git du dossier. Prenez cette habitude dès le premier jour.

2. Lancez Claude Code

claude

La première fois, Claude Code ouvre votre navigateur pour vous connecter à votre compte. Une fois connecté, vous revenez dans le terminal avec une invite où vous pouvez écrire en français.

3. Faites une première demande simple

Commencez petit et précis. Par exemple :

Crée une page web simple, index.html, qui présente une boulangerie de Salé : un titre, trois produits avec leur prix en dirhams, et un bouton WhatsApp. Pas de framework, juste HTML et CSS.

Claude Code va vous proposer de créer le fichier et vous demander votre accord avant d’écrire sur le disque. Lisez ce qu’il propose. Acceptez, puis ouvrez index.html dans votre navigateur.

4. Itérez

Demandez une modification à la fois : « rends le bouton vert », « ajoute les horaires d’ouverture », « adapte la page au mobile ». À chaque étape, regardez le résultat. Quand c’est bon, demandez-lui de faire un commit Git avec un message clair, ou faites-le vous-même :

git add .
git commit -m "Page d’accueil de la boulangerie"

5. Donnez-lui une mémoire avec CLAUDE.md

Claude Code lit un fichier CLAUDE.md à la racine du projet à chaque session. C’est là que vous écrivez les règles de votre projet : la langue du site, les commandes pour le lancer, ce qu’il ne doit jamais toucher. La commande /init génère un premier CLAUDE.md en analysant votre projet, que vous corrigez ensuite. Tout est détaillé dans la page de documentation sur la mémoire.

Cinq erreurs de débutant

1. Demander une application entière d’un coup

« Fais-moi un clone de Glovo » ne marche pas. Découpez : d’abord la page d’accueil, puis la liste des restaurants, puis le panier. Une demande, un résultat vérifiable.

2. Accepter sans lire

Claude Code vous montre ce qu’il va faire. Si vous validez tout sans lire, vous perdez le contrôle de votre projet, et le jour où ça casse, vous ne savez pas pourquoi. Lisez au moins le résumé de chaque modification.

3. Travailler sans Git

Sans historique, une mauvaise modification peut vous coûter des heures. Avec Git, c’est une commande. Faites un commit à chaque étape qui fonctionne.

4. Coller des secrets dans la conversation

Clés d’API, mots de passe, accès à une base de données : jamais dans le chat. Mettez-les dans un fichier .env exclu de Git, et dites à Claude Code que ce fichier existe sans lui en donner le contenu.

5. Croire que « ça marche » parce que le code s’affiche

Le code peut sembler correct et ne pas fonctionner. Testez vous-même dans le navigateur, demandez-lui d’écrire des tests, et relancez-les après chaque changement important.

Aller plus loin

Une fois à l’aise avec ces bases, trois sujets changent vraiment la façon de travailler :

• Les serveurs MCP, qui connectent Claude Code à d’autres outils (base de données, GitHub, navigateur).

• Les subagents, des assistants spécialisés que vous définissez pour des tâches précises. J’en parle dans mon article sur les agents IA avec Claude Code.

• La mise en ligne, pour que votre projet ne reste pas sur votre ordinateur.

Si vous préférez un parcours guidé, c’est exactement ce que couvre mon cours Claude Code en autonomie : 12 leçons, du terminal jusqu’à une petite équipe d’agents, avec une option lab pour pratiquer dans le navigateur sans rien installer.

En résumé

• Claude Code agit dans votre projet : il lit, écrit et lance des commandes, avec votre accord.

• Il faut un abonnement payant (Pro ou plus) ou un compte API : l’offre gratuite ne l’inclut pas.

• Installez-le en une ligne, vérifiez avec claude --version, lancez-le avec claude.

• Avancez par petites demandes, lisez ce qu’il propose, faites un commit à chaque étape.

• Écrivez un CLAUDE.md pour lui donner les règles de votre projet.

Les commandes et les conditions citées ici viennent de la documentation officielle de Claude Code, consultée le 16 octobre 2026. Elles évoluent vite : en cas de doute, c’est la documentation qui fait foi.