Ta première session en 10 minutes

Avant de commencer

Ton ordinateur

Claude Code tourne sur macOS 13 ou plus récent, sur Windows 10 (version 1809) ou plus récent, et sur Linux : Ubuntu 20.04, Debian 10, Alpine 3.19 ou plus récents.

Il demande 4 Go de mémoire ou plus, un processeur x64 ou ARM64 et une connexion internet. Pas de carte graphique : le modèle tourne sur les serveurs d'Anthropic. Il faut aussi vivre dans un pays pris en charge.

Ton compte

Un abonnement Claude Pro, Max, Team ou Enterprise, ou un compte Claude Console. Les offres sont sur claude.com/pricing.

Tes logiciels

• Un terminal, déjà présent sur ta machine. Sur macOS : Cmd + Espace, tape « Terminal », puis Entrée. Sur Windows : Win + X, puis « Terminal » ou « Windows PowerShell ». Sur Linux : Ctrl + Alt + T sur la plupart des distributions.
• Git, à télécharger sur git-scm.com/downloads. Sur Windows, l'installeur Git for Windows convient avec ses choix par défaut. Claude Code s'en sert pour lancer ses commandes en Bash ; sans lui, il passe par PowerShell. Vérifie avec git --version.
• Un vrai projet sur ta machine, idéalement suivi par git. Un petit projet perso est parfait pour commencer.

Toutes les commandes de cette leçon viennent de la documentation officielle (code.claude.com), relue le 19 octobre 2026.

Installer

Ouvre un terminal et lance la commande de ton système.

Sur macOS, Linux ou WSL :

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

Sur Windows, dans PowerShell :

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

Sur Windows, dans l'invite de commandes (CMD) :

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

Pas besoin d'être administrateur. Sous WSL (le Linux intégré à Windows), lance la commande Linux dans le terminal WSL, pas dans PowerShell.

Tu préfères un gestionnaire de paquets ? brew install --cask claude-code sur macOS, ou winget install Anthropic.ClaudeCode sur Windows. Ces deux voies ne se mettent pas à jour toutes seules : relance de temps en temps brew upgrade claude-code ou winget upgrade Anthropic.ClaudeCode.

Ferme le terminal, ouvre-en un nouveau, puis vérifie :

claude --version

Tu dois voir un numéro de version suivi de (Claude Code). Si le terminal répond que claude est introuvable, le dossier d'installation n'est pas encore dans ton PATH (la liste des dossiers où le terminal cherche les programmes). La page Troubleshoot installation de la documentation donne la marche à suivre.

Cette installation se met à jour toute seule, en arrière-plan. claude update force la mise à jour. En cas de doute, claude doctor affiche l'état de l'installation et de tes réglages sans ouvrir de session.

Te connecter

Lance simplement :

claude

À la première ouverture, il te demande de te connecter et ouvre ton navigateur. Tu valides avec ton compte Claude, et c'est fini : tes identifiants sont gardés, tu n'auras plus à le refaire. Pour changer de compte plus tard, tape /login dans une session.

Tape /exit pour quitter : on va maintenant le lancer au bon endroit.

Le lancer dans un vrai projet

Claude Code travaille dans le dossier où tu le lances. Place-toi à la racine de ton projet :

cd chemin/vers/ton-projet
claude --permission-mode manual

L'option --permission-mode manual ne sert que pour cette première fois. Depuis la version 2.1.283, une session démarre par défaut en mode « auto » : un second modèle relit les actions à ta place et bloque celles qui semblent risquées. C'est confortable, mais pour ta première session, je veux que tu voies passer chaque action.

En mode manuel, Claude lit librement ton projet, mais il te demande avant de modifier un fichier ou de lancer une commande qui change quelque chose. La barre d'état, en bas, affiche ⏸ manual mode on.

La première fois dans un dossier, Claude Code te demande aussi si tu fais confiance à ce dossier. C'est une protection : un projet peut contenir des réglages qui donnent des droits. Pour ton propre projet, accepte.

Tes premières questions

Commence par lui faire lire le projet. Tu peux écrire en français :

Que fait ce projet ? Explique-moi la structure des dossiers.

Quelles technologies sont utilisées, et où est le point d'entrée ?

Tu n'as rien à lui fournir : il ouvre lui-même les fichiers dont il a besoin. Pendant qu'il travaille, tu vois défiler ce qu'il fait : les fichiers lus, les recherches, les commandes. Lire ce qu'il fait, c'est déjà apprendre ton projet.

Accepter ou refuser

Demande-lui maintenant une petite modification, facile à vérifier :

Le README ne dit pas comment lancer le projet en local.
Ajoute une section courte à ce sujet, d'après ce que tu as lu.

Avant de toucher au fichier, il s'arrête et te montre la modification. Tu choisis :

• Yes : il applique la modification.
• No : il ne fait rien.
• Selon l'action, une troisième option autorise ce type d'action sans redemander. Pour une modification de fichier, cette autorisation dure jusqu'à la fin de la session. Pour une commande, elle est enregistrée pour de bon dans le fichier .claude/settings.local.json de ton dépôt.

Le geste le plus utile, c'est la touche Tab. Place-toi sur Yes ou sur No, appuie sur Tab et écris une remarque. Sur un refus, ta remarque devient la raison : Claude la lit et continue en en tenant compte. Par exemple : « non, garde le ton des autres sections ».

Échap (Esc) refuse aussi, mais sans explication, et Claude s'arrête là.

Regarder ce qui a changé

Tape /diff : tu vois les modifications en cours dans ton dépôt, celles de Claude comprises, sans quitter la session. Tu peux aussi les relire comme d'habitude, avec git ou ton éditeur.

Quitter, puis revenir

Pour quitter, tape /exit, ou appuie deux fois sur Ctrl+D. Ta conversation est enregistrée. Demain, dans le même dossier, cette commande la rouvre là où tu l'avais laissée :

claude -c

Mon premier réglage : les réponses en français

Le réglage language demande à Claude de toujours répondre dans la langue choisie. Chez moi, il est dans mon fichier de réglages personnel, ~/.claude/settings.json (le ~ désigne ton dossier personnel) :

{
  "language": "French"
}

Si le fichier existe déjà, ajoute seulement la ligne "language" entre les accolades, en séparant par une virgule. Tu peux aussi le régler depuis /config.

Ce même réglage fixe la langue de la dictée vocale intégrée. Je l'active avec /voice et je dicte une bonne partie de mes demandes au lieu de les taper.

Ce que la suite t'apporte

Tu as fait le tour de base : installer, lancer au bon endroit, demander, accepter ou refuser. C'est souvent là qu'on s'arrête, et qu'on utilise Claude Code comme un chat.

La suite de la formation t'apprend à t'en servir comme d'un collègue :

• passer du mode manuel au mode plan ou au mode auto d'une touche, selon la tâche ;
• interrompre sans tout perdre, mentionner un fichier avec @, lancer une commande avec !, coller une capture d'écran ;
• les commandes slash que j'utilise tous les jours ;
• surveiller le contexte avec /context, le libérer avec /compact ou /clear au bon moment ;
• reprendre une session le lendemain, et revenir en arrière quand une modification ne te plaît pas ;
• mener un petit projet complet, du plan au commit.

Sources : configuration requise et installation, guide du terminal, démarrage rapide, permissions et réglages, vérifiées le 19 octobre 2026.