Claude Code pour débutants : installation, premier lancement, CLAUDE.md

Claude Code est un outil en ligne de commande d’Anthropic : tu lui parles dans un terminal, il lit ton projet, propose des modifications, exécute des commandes. Contrairement à un chatbot classique, il ne se contente pas de répondre : il explore, planifie et agit pendant que tu regardes, corriges, ou t’absentes. Voici le parcours exact, vérifié dans la documentation officielle, pour débuter sans te perdre.

Installer Claude Code

Sur Windows, ouvre PowerShell et lance :

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

C’est la méthode d’installation « native » recommandée par la documentation officielle : elle se met à jour toute seule en arrière-plan. Une alternative existe avec le gestionnaire de paquets WinGet (winget install Anthropic.ClaudeCode), mais elle ne se met pas à jour automatiquement. Sur macOS, Linux ou WSL, la commande équivalente est curl -fsSL https://claude.ai/install.sh | bash.

Une fois l’installation terminée, ouvre une nouvelle fenêtre de terminal et vérifie que tout fonctionne :

claude --version

Si le terminal ne reconnaît pas la commande claude, c’est que le dossier d’installation n’est pas encore dans ton PATH : la documentation propose une page dédiée pour corriger ça selon ton système.

Ton premier lancement

Place-toi dans le dossier d’un projet (même un petit projet personnel), puis lance simplement :

claude

Tu devras te connecter avec un compte Claude (Pro, Max, ou un compte Console) la première fois ; ensuite, tu n’auras plus à le refaire. Une fois dans la session, la documentation recommande de commencer par une question exploratoire plutôt que de foncer sur une tâche : demande par exemple « à quoi sert ce projet ? », « quelles technologies sont utilisées ici ? » ou « explique-moi la structure des dossiers ». Claude lit les fichiers nécessaires et te répond, sans que tu aies à tout lui expliquer toi-même.

Si tu bloques à un moment, trois pistes existent en dehors de la session elle-même : taper /help dans Claude Code, parcourir la documentation officielle, ou suivre le cours gratuit « Claude Code 101 » proposé sur Claude Academy. Une communauté existe aussi sur Discord si tu préfères poser ta question à d’autres utilisateurs.

Quelques commandes essentielles à connaître dès le début :

Commande	Ce qu’elle fait
claude	démarre une session interactive
claude "tâche"	démarre une session avec une première demande déjà écrite
claude -c	reprend la conversation la plus récente dans ce dossier
/clear	efface l’historique de la conversation en cours
/help	affiche les commandes disponibles
/exit	quitte Claude Code

Le fichier CLAUDE.md : la mémoire de ton projet

Chaque session démarre avec une mémoire vide. Le fichier CLAUDE.md sert justement à donner à Claude des instructions qu’il relit à chaque nouvelle session : conventions de code, commandes de test, choses à ne jamais faire. La documentation officielle le résume ainsi : c’est l’endroit où noter « ce que tu expliquerais autrement à chaque fois ».

Tu peux le placer à deux endroits selon la portée voulue :

• ./CLAUDE.md, à la racine du projet : partagé avec quiconque récupère le projet (utile si tu travailles à plusieurs ou si tu veux le garder d’un projet à l’autre via Git).
• ~/.claude/CLAUDE.md, dans ton dossier personnel : s’applique à tous tes projets, sur ta machine.

Tu n’as pas besoin de l’écrire à la main dès le départ : la commande /init, lancée depuis une session, analyse ton projet et génère un premier CLAUDE.md avec les commandes et conventions qu’elle détecte. Garde-le court (moins de 200 lignes, dit la documentation) : un fichier trop long fait que Claude finit par ignorer une partie des règles qu’il contient. Un exemple minimal :

# Style de code
- Utiliser des modules ES (import/export), pas CommonJS (require)

# Workflow
- Toujours vérifier les types après une série de modifications
- Lancer les tests un par un plutôt que la suite complète, pour la rapidité

Pour vérifier que ton CLAUDE.md a bien été pris en compte, tape /context en début de session : Claude Code affiche la liste des fichiers de mémoire réellement chargés. C’est le réflexe à avoir si tu as l’impression que Claude « oublie » une règle que tu penses pourtant avoir écrite.

Les permissions : qui décide de quoi

Claude Code ne fait pas n’importe quoi sans validation : un « mode de permission » définit ce qu’il peut exécuter sans te demander ton avis. La documentation en liste plusieurs, du plus prudent au plus autonome :

• Manuel (le mode par défaut) : Claude lit les fichiers, mais te demande ton accord avant de modifier quoi que ce soit ou d’exécuter une commande.
• Accepter les modifications : les modifications de fichiers sont appliquées directement, pratique quand tu comptes de toute façon relire le résultat avec git diff.
• Plan : Claude explore et te propose un plan détaillé, sans rien modifier tant que tu n’as pas validé.
• Auto : un modèle classificateur distinct examine chaque action à ta place et bloque ce qui semble risqué, pour réduire les interruptions sur les tâches longues.

Tu changes de mode à tout moment avec la combinaison Shift+Tab. En débutant, reste en mode manuel ou utilise le mode plan sur tout ce qui touche à plusieurs fichiers à la fois : ça te force à lire ce que Claude propose avant que ça ne devienne irréversible.

Bonnes pratiques pour débuter

• Avance petit à petit. La documentation officielle recommande de séparer clairement exploration, plan, puis exécution, plutôt que de tout demander d’un coup.
• Relis chaque diff. Ne valide pas une modification que tu ne comprends pas ; demande une explication si besoin.
• Utilise Git. Claude Code sait committer, créer des branches, écrire un message de commit descriptif : demande-le-lui en langage naturel plutôt que de sortir de la session pour taper les commandes toi-même.
• Corrige tôt. Si Claude part dans une mauvaise direction, appuie sur Esc pour l’arrêter immédiatement : le contexte est conservé, tu peux réorienter sans tout perdre.
• Ne bloque pas sur le premier essai. D’après la documentation, mieux vaut souvent effacer le contexte (/clear) et repartir avec une demande plus précise que de corriger sans fin la même approche ratée.

Si tu utilises Claude Code pour un travail noté, vérifie d’abord les règles d’usage de l’IA propres à ton établissement : la façon dont tu dois documenter cette aide varie d’une école à l’autre.

À retenir

• Sur Windows, l’installation recommandée tient en une commande PowerShell : irm https://claude.ai/install.ps1 | iex.
• Une session se lance avec claude depuis le dossier de ton projet ; commence par une question exploratoire plutôt qu’une tâche.
• Le fichier CLAUDE.md (généré avec /init, puis affiné à la main) donne à Claude une mémoire persistante de ton projet, tant qu’il reste court et précis.
• Les modes de permission (manuel, accepter les modifications, plan, auto) déterminent ce que Claude peut faire sans te demander ; Shift+Tab les fait défiler.
• Avance petit à petit, relis chaque diff, et utilise le mode plan dès que la tâche touche plusieurs fichiers.

Pour un CLAUDE.md de départ déjà structuré pour un projet étudiant, la skill claude-md-projet te fournit un modèle à adapter.