Tu as entendu parler de Claude Code et tu te demandes par où commencer ? Ce guide te prend par la main, depuis l'installation jusqu'aux bonnes pratiques, pour que tu sois opérationnel en quelques minutes — et que tu saches ensuite comment progresser par toi-même.
C'est quoi, Claude Code ?
Claude Code est un outil en ligne de commande (CLI, Command Line Interface) développé par Anthropic. Concrètement, c'est un assistant de développement qui vit dans ton terminal : tu lui parles en langage naturel, et il lit ton code, écrit des fichiers, lance des commandes, corrige des bugs et explique ce qu'il fait. Ce n'est pas un simple autocomplétion comme tu peux en avoir dans ton éditeur — c'est un agent capable de mener une tâche du début à la fin, étape par étape.
Il existe aussi sous forme d'extension VS Code et de plugin pour les IDE JetBrains, mais c'est la version terminal qui est la plus complète et qui reçoit les nouveautés en premier. Pour débuter, c'est elle qu'on va utiliser.
Étape 1 : l'installation
La méthode la plus courante passe par npm. Tu as besoin de Node.js version 18 ou supérieure installé sur ta machine. Ensuite, une seule commande :
npm install -g @anthropic-ai/claude-code
Un conseil important : n'utilise jamais sudo pour cette installation. Cela crée des problèmes de permissions et des risques de sécurité. Si npm te réclame des droits administrateur, c'est généralement le signe que ton environnement Node est mal configuré — mieux vaut le corriger que de forcer avec sudo.
Une fois installé, vérifie que tout fonctionne :
claude --version
À noter : Anthropic propose aussi un installateur natif (sans Node.js ni npm) qui se met à jour tout seul en arrière-plan. Avec la version npm, les mises à jour sont manuelles :
npm install -g @anthropic-ai/claude-code@latest
Étape 2 : la première connexion
Place-toi dans le dossier d'un projet, puis lance simplement :
claude
La première fois, Claude Code ouvre ton navigateur pour que tu te connectes avec ton compte Anthropic. C'est de l'authentification OAuth : pas de clé API à copier-coller, juste une connexion classique.
Petit point à connaître avant de commencer : Claude Code nécessite un abonnement (Pro, Max, Team, Enterprise ou un compte API Console). Le plan gratuit de Claude.ai ne donne pas accès à Claude Code. Si tu es sur un forfait Pro ou Max, tu es déjà prêt.
Étape 3 : tes premiers échanges
Une fois connecté, tu te retrouves dans une session interactive (un REPL). Tu écris ta demande, Claude répond et agit. Tu peux aussi lancer une demande en une seule fois, sans entrer dans la session, ce qui est pratique pour une tâche rapide :
claude "résume ce que fait ce projet"
Quand Claude modifie des fichiers, il t'affiche un récapitulatif des changements (du type +12 -1 : 12 lignes ajoutées, 1 supprimée). Prends le réflexe de lire ces modifications avant de les valider — c'est la base d'une bonne collaboration.
Les commandes slash à connaître
Dans la session, certaines commandes commencent par / et pilotent l'outil lui-même plutôt que ton code. En voici quelques-unes que tu utiliseras tout le temps :
- /init : génère un premier fichier CLAUDE.md pour ton projet. À lancer au démarrage d'un nouveau projet.
- /help : affiche l'aide et la liste des commandes.
- /clear : repart d'une conversation vierge. Très utile quand tu changes de sujet.
- /context : montre combien de « mémoire de travail » est actuellement utilisée.
- /compact : résume la conversation pour libérer de l'espace quand elle devient longue.
- /model : change le modèle utilisé selon que tu veux plus de vitesse ou plus de puissance.
CLAUDE.md : la mémoire de ton projet
Voici sans doute le concept le plus utile à comprendre tôt. Le fichier CLAUDE.md, placé à la racine de ton projet, contient les instructions que Claude doit garder en tête d'une session à l'autre : conventions de code, structure du projet, commandes pour lancer les tests, règles métier, choix techniques.
La commande /init en génère une première version automatiquement en analysant ton dépôt. Tu l'édites ensuite comme un simple fichier texte pour y ajouter ce que tu expliquerais à un nouveau collègue. Quelques conseils : garde-le concis (idéalement sous 200 lignes) et mets-y l'essentiel. Pour un projet Rails, par exemple, tu peux y préciser ta version de Rails, ta façon d'organiser les services, ou rappeler de lancer bin/rails test après chaque modification.
Bien rempli, ce fichier change tout : Claude cesse de redécouvrir ton projet à chaque session et respecte directement tes conventions.
Le mode plan : ton meilleur allié de débutant
Par défaut, Claude te demande ton accord avant les actions sensibles (modifier un fichier, lancer une commande). Le mode plan va plus loin : Claude décrit d'abord ce qu'il compte faire, puis attend ta validation avant d'écrire la moindre ligne. En mode plan, aucune écriture ne peut être auto-approuvée.
Pour un débutant, c'est précieux : avant un changement qui touche plusieurs fichiers, tu lis le plan, tu corriges la trajectoire si besoin, et tu n'exécutes que ce que tu comprends. C'est le meilleur moyen d'apprendre en gardant le contrôle, plutôt que de laisser l'outil avancer en boîte noire.
En pratique : une première session type
Imagine que tu veux ajouter une fonctionnalité à une app Rails. Un déroulé sain ressemble à ça :
- Tu te places dans le projet et tu lances claude.
- Si c'est la première fois, tu fais /init pour créer le CLAUDE.md.
- Tu décris ta tâche clairement, par exemple : ajoute une page de profil utilisateur avec son nom et son email, et écris le test associé.
- Tu passes en mode plan pour valider l'approche avant l'écriture.
- Claude code par étapes ; tu lis chaque diff et tu lances les tests.
- Une fois satisfait, tu fais un commit Git — Claude peut même te proposer le message.
Cette boucle « décrire → planifier → relire → tester → committer » est le cœur du métier avec Claude Code.
Les bonnes pratiques qui font la différence
Au-delà des commandes, c'est ta façon de travailler qui détermine la qualité du résultat. Quelques principes à adopter dès le départ :
Sois précis dans tes demandes. « Corrige le bug » donne de moins bons résultats que « la création d'utilisateur échoue avec cette erreur précise, corrige-la et explique-moi la cause ». Plus tu donnes de contexte — messages d'erreur entiers, logs, intention —, plus la réponse est juste.
Avance par petits pas. Demande une chose à la fois, teste, puis enchaîne. Une grosse demande monolithique est plus difficile à vérifier et à corriger qu'une suite de petites étapes maîtrisées.
Relis toujours avant de valider. Les diffs sont là pour ça. Tu peux même commenter une ligne qui te semble douteuse : Claude la reprend et la corrige.
Utilise Git sérieusement. Travaille sur des branches, committe après chaque étape réussie. Le contrôle de version est ton filet de sécurité : si une modification part dans le mauvais sens, tu reviens en arrière sans rien perdre.
Gère ta « mémoire de travail ». Surveille avec /context, utilise /compact quand la session s'allonge, et /clear quand tu changes complètement de sujet. Une conversation focalisée donne de meilleures réponses.
Reste aux commandes. Claude peut travailler de façon très autonome, mais les meilleurs résultats viennent d'une collaboration active : tu cadres bien la tâche au départ, tu interromps si ça dévie, tu corriges au fil de l'eau.
S'auto-former pour devenir moins débutant
Le plus beau, avec Claude Code, c'est qu'il est lui-même un formidable outil d'apprentissage. Pour progresser, prends l'habitude de lui demander d'expliquer plutôt que de seulement produire : « Pourquoi as-tu choisi cette approche ? », « Quelles sont les alternatives ? », « Explique-moi cette ligne ». Tu apprends en même temps que tu construis.
Travaille aussi sur un vrai projet personnel, même petit. Rien n'ancre mieux les concepts que de résoudre tes propres problèmes. Et n'hésite pas à faire relire ton code : la commande /review effectue une revue de ton travail et pointe les améliorations possibles — un excellent professeur gratuit.
Côté ressources officielles, garde ces liens sous la main. La documentation de Claude Code (code.claude.com/docs) est complète et bien structurée : commence par le guide de démarrage, puis explore au fil de tes besoins. Anthropic publie aussi un guide de bonnes pratiques très éclairant (anthropic.com/engineering/claude-code-best-practices) ainsi que des contenus d'apprentissage sur anthropic.com/learn. Quand un concept revient souvent dans ton travail — les serveurs MCP pour connecter des outils externes, les subagents pour déléguer des sous-tâches, les hooks pour automatiser des contrôles qualité —, va lire la page dédiée plutôt que de rester dans le flou. La progression se fait par couches : tu maîtrises les bases, puis tu ajoutes un concept à la fois.
En résumé
Démarrer avec Claude Code tient en trois gestes : installer le paquet npm avec Node 18+, se connecter avec son compte Anthropic, et lancer claude dans un projet. À partir de là, l'essentiel se joue dans les habitudes : un fichier CLAUDE.md bien tenu pour donner du contexte, le mode plan pour garder le contrôle, des demandes précises, des petits pas, des diffs relus et des commits réguliers.
C'est un outil qui récompense la rigueur : plus tu travailles proprement, plus il devient puissant. Et comme il sait expliquer ce qu'il fait, chaque session est aussi une occasion d'apprendre. Le meilleur conseil pour un débutant n'est donc pas de tout maîtriser d'emblée, mais de se lancer sur un projet réel, en restant curieux et aux commandes. C'est comme ça qu'on devient, petit à petit, beaucoup moins débutant.
