Claude Code pour débutants : installer, se connecter et lancer une première tâche

La plupart des gens découvrent Claude Code comme n’importe quel nouvel outil : ils ouvrent un terminal, se sentent perdus et reviennent à coller du code dans une fenêtre de chat. Ça marche, mais ça fait perdre ce qui rend Claude Code différent. Il n’a pas besoin que tu colles quoi que ce soit.

Ce guide t’emmène de zéro installation jusqu’à une première tâche terminée. Tu vas l’installer, te connecter, poser des questions sur un vrai projet, faire un petit changement et apprendre les quelques commandes qui couvrent la plupart de ta première semaine.

Ce qu’est vraiment Claude Code

Claude Code est un assistant qui s’exécute dans ton terminal, dans le dossier de ton projet. Quand tu lui confies une tâche, il travaille en boucle selon trois phases : il rassemble du contexte, il agit, puis il vérifie le résultat. Il répète cette boucle jusqu’à ce que la tâche soit terminée, et tu peux l’interrompre à tout moment.

La différence avec un chat, ce sont les outils. Un chat ne peut répondre que par du texte. Claude Code peut lire tes fichiers, les modifier, chercher dans le projet, lancer des commandes comme ta suite de tests, et utiliser git. Chaque résultat nourrit la décision suivante.

Imagine que tu lui demandes de corriger les tests qui échouent. Il lancera en général les tests pour voir ce qui échoue, lira les messages d’erreur, cherchera les fichiers concernés, les lira, les modifiera, puis relancera les tests. Tu as écrit une phrase. Il a fait six étapes.

Si tu hésites encore sur le choix de Claude Code pour ce que tu fais, lis d’abord Claude Code, projets ou chat simple. Ce guide suppose que tu as déjà décidé.

Avant de commencer

Il te faut trois choses, et aucune n’est difficile à obtenir.

Claude Code ne fait pas partie de l’offre gratuite de Claude : l’un de ces comptes est donc nécessaire. Si tu n’as jamais ouvert de terminal, le guide officiel du terminal montre comment en ouvrir un et coller une commande. Ça prend environ deux minutes.

Étape 1 : installer Claude Code

Il existe plusieurs façons de l’installer. L’installateur natif est celui qui est recommandé, car il se met à jour tout seul en arrière-plan.

Choisis la ligne qui correspond à ton système, colle-la dans le terminal et appuie sur Entrée. L’installateur n’affiche aucune progression pendant le téléchargement : ne pense donc pas qu’il s’est figé.

Sous Linux, tu peux aussi installer avec apt, dnf ou apk sur Debian, Fedora, RHEL et Alpine. Sous Windows natif, Git for Windows est recommandé pour que Claude Code puisse utiliser l’outil Bash. Sans lui, Claude Code utilise PowerShell à la place. Si tu utilises WSL, tu n’as pas besoin de Git for Windows.

Vérifier que ça a marché

Quand l’installateur a terminé, ouvre une nouvelle fenêtre de terminal. C’est important : l’ancienne fenêtre ne connaît pas encore le nouveau programme. Lance ensuite la commande de version.

$ claude --version2.1.283 (Claude Code)

Si ton shell dit que claude est introuvable ou non reconnu, le dossier d’installation n’est pas encore dans ton PATH. Fermer puis rouvrir le terminal règle le problème la plupart du temps. Sinon, la page officielle de dépannage de l’installation associe chaque message d’erreur à une solution.

Étape 2 : démarrer ta première session

Va dans le dossier de ton projet et tape le nom du programme.

$ cd ~/projects/my-website$ claude

La première fois, Claude Code te demande de te connecter. Avec un abonnement Claude ou un compte Console, il ouvre ton navigateur, tu y valides la connexion, puis tu reviens dans le terminal. Tes identifiants sont enregistrés : tu n’auras pas à recommencer.

Tu peux te connecter de l’une de ces façons :

• Un compte Claude Pro, Max, Team ou Enterprise, qui est la voie recommandée.
• Un compte Claude Console. À la première connexion, un espace de travail « Claude Code » est créé automatiquement pour que tu puisses suivre ce que ça coûte.
• Amazon Bedrock, Google Cloud ou Microsoft Foundry, pour les personnes dont l’entreprise fournit l’accès de cette façon.

Si la variable d’environnement ANTHROPIC_API_KEY est définie et que tu approuves la clé quand on te le demande, Claude Code saute l’étape de connexion.

Une fois dedans, tu vois une invite avec la version, le modèle actuel et le dossier dans lequel tu travailles. Tape /help pour lister les commandes, /resume pour reprendre une ancienne conversation, ou /login plus tard si tu dois changer de compte.

Étape 3 : pose des questions avant de rien changer

Tes premiers prompts ne devraient rien modifier. Les questions sont le moyen le plus sûr de voir comment Claude Code lit ton projet, et elles t’apprennent ce qu’il sait déjà.

Claude lit les fichiers dont il a besoin et répond. Tu n’ajoutes pas de fichiers à la main : il les trouve. Enchaîne avec des questions plus ciblées, une à la fois :

> à quoi sert ce projet ?Lecture de package.json, README.md, src/ ...C’est un site marketing statique construit avec Next.js. Les pages sont dans src/app, les composants partagés dans src/components et le contenu dans le dossier content/.

Tu peux aussi interroger Claude Code sur lui-même. Des questions comme « que peut faire Claude Code ? » ou « comment créer des compétences personnalisées dans Claude Code ? » obtiennent de vraies réponses, car il connaît sa propre documentation.

Dans Claude Tutorial

Demander avant d’agir est une habitude à prendre

Faire expliquer à l’assistant ce qu’il voit avant de demander des changements, c’est la même discipline que l’appli enseigne pour tous les types de travail, pas seulement le code.

Bientôt disponible

Télécharger dans l’App Store

DISPONIBLE SURGoogle Play

Étape 4 : fais ton premier changement

Demande maintenant quelque chose de petit et facile à annuler.

Claude Code trouve le bon fichier et te montre la modification qu’il veut faire. Selon tes réglages, il peut d’abord te demander ton accord. Si c’est le cas, lis ce qu’il propose et choisis Yes.

Ce prompt est volontairement minuscule. Le but de cette étape n’est pas la fonction. C’est de voir une fois le cycle complet : tu demandes, Claude trouve le fichier, montre la modification, tu approuves, et le fichier change.

Ce que Claude Code peut faire sans demander est contrôlé par le mode de permission de la session. Appuie sur Shift+Tab à tout moment pour passer d’un mode à l’autre. Les versions récentes démarrent les sessions interactives du terminal en mode auto (auto mode), où une vérification en arrière-plan bloque les actions risquées au lieu de te questionner sur chacune, tandis que les versions plus anciennes ou d’autres configurations demandent plus souvent. Regarde la ligne d’état pour savoir dans quel mode tu es. Le guide suivant, Modes de permission et mode plan de Claude Code, expliqués, présente chaque mode et quand l’utiliser.

Étape 5 : utilise git en lui parlant

Si ton projet utilise git, tu peux le piloter par la conversation. Tout ceci fonctionne tel quel.

Même quand tu lui fais confiance, lis le message de commit et le diff avant d’accepter. Tu es le relecteur de tout ce que produit Claude Code.

Étape 6 : corriger un bug ou ajouter une fonctionnalité

Les vraies tâches se passent mieux avec de vrais détails. Compare ces deux façons de demander la même correction.

Les meilleures versions nomment le symptôme, l’endroit et à quoi ressemble le résultat attendu. Claude Code sait trouver les fichiers tout seul, donc tu n’as pas à les lister, mais il ne peut pas deviner de quel problème tu parles.

Pour les tâches plus grosses, découpe le travail en étapes dans une liste numérotée.

Et quand tu ne connais pas encore le code, laisse Claude explorer d’abord : demande-lui d’analyser le schéma de la base de données, ou le fonctionnement du paiement, avant de lui demander de modifier l’un ou l’autre. Quelques minutes de lecture évitent souvent une mauvaise modification.

Les commandes que tu utiliseras chaque jour

Certaines commandes se lancent dans ton shell, avant le démarrage de Claude Code, et d’autres dans une session.

Quelques touches font gagner beaucoup de temps. Tape / pour voir toutes les commandes et compétences dont tu disposes. Appuie sur Tab pour compléter une commande, sur ↑ pour rappeler tes prompts précédents et sur Shift+Tab pour changer de mode de permission. Appuie sur Esc pour arrêter Claude immédiatement s’il part dans la mauvaise direction.

Quand le premier jour tourne mal

Voici les problèmes les plus fréquents, et ce que chacun signifie.

Quand rien de tout cela ne correspond, demande à Claude Code lui-même. Tape quelque chose comme « comment corriger cette erreur ? » avec le message collé. La commande /doctor lance aussi un bilan de configuration qui diagnostique les problèmes d’installation et de réglage.

Tu n’es pas obligé d’utiliser le terminal

Le terminal est le foyer d’origine de Claude Code, et tout ce qui précède s’y applique. Le même assistant existe aussi en appli de bureau, dans VS Code et les éditeurs JetBrains, sur le web à l’adresse claude.ai/code, dans Slack, et dans des pipelines automatisés avec GitHub Actions et GitLab. L’interface change la façon dont tu le vois et lui parles. La boucle qui consiste à rassembler du contexte, agir et vérifier est la même partout.

Questions fréquentes

Claude Code est-il gratuit ?

Non. Il faut un abonnement Claude Pro, Max, Team ou Enterprise, un compte Claude Console avec des crédits d’API, ou un accès via un fournisseur cloud pris en charge. L’offre gratuite de Claude ne l’inclut pas.

Dois-je savoir coder pour utiliser Claude Code ?

Il te faut un projet à lui montrer, et plus tu comprends ce projet, mieux tu peux juger son travail. Tu n’as pas besoin d’écrire le code toi-même. Les débutants profitent surtout de l’habitude des questions d’abord, vue à l’étape 3 : demande à Claude d’expliquer avant de lui demander de modifier.

Est-ce sûr de le laisser modifier mes fichiers ?

Tu contrôles ce qu’il peut faire sans demander grâce au mode de permission, et les modifications de fichiers peuvent être annulées avec Esc deux fois. Traite son travail comme la pull request d’un collègue : lis le diff avant de valider. Garde ton projet dans git pour que chaque changement soit facile à relire ou à annuler.

Quelle différence entre Claude Code et Claude dans un chat ?

Un chat répond par du texte à propos de ce que tu colles. Claude Code travaille dans ton projet : il lit lui-même les fichiers, les modifie, lance des commandes et vérifie son propre travail. Utilise le chat pour réfléchir, utilise Claude Code pour faire.

Claude Code se souvient-il de mon projet d’une session à l’autre ?

Chaque session démarre avec un contexte vierge. Pour transmettre des connaissances d’une session à l’autre, tu les écris dans un fichier appelé CLAUDE.md, et Claude Code garde aussi ses propres notes sur tes préférences. Le deuxième guide suivant, CLAUDE.md expliqué, montre comment faire.

Ta checklist du premier jour

Pour aller plus loin

• Modes de permission et mode plan de Claude Code, expliqués pour décider de ce que Claude Code peut faire sans demander.
• CLAUDE.md expliqué : apprends ton projet à Claude Code une fois pour toutes pour ne plus répéter les mêmes instructions à chaque session.
• Bonnes pratiques de Claude Code : les habitudes qui donnent de meilleurs résultats pour les prompts, les vérifications et la gestion du contexte.
• Comment faire des modifications sur plusieurs fichiers avec Claude Code pour ton premier changement qui touche de nombreux fichiers.
• Connecter Claude à tes propres données et outils avec MCP pour aller au-delà de ton propre dossier.