Guide Claude Code CLI pour débutants : de l'installation à votre première tâche de codage IA

Ce que ce tutoriel vous apprend

Claude Code est l'agent de codage IA d'Anthropic qui s'exécute dans votre terminal. Il peut lire votre projet, modifier des fichiers, exécuter des commandes et automatiser des tâches de développement, le tout depuis une ligne de commande. À la fin de ce tutoriel, vous saurez installer Claude Code, vous connecter et accomplir votre première tâche de codage assisté par IA.

Quelle version ce guide couvre-t-il ? Ce guide couvre uniquement Claude Code CLI, la version qui s'exécute dans le terminal. Il ne couvre pas l'application de bureau ni la version web. Si vous préférez l'application de bureau graphique, consultez le guide dédié au bureau.

Temps nécessaire : 15–20 minutes

Difficulté : Débutant

Avant de commencer

Qu'est-ce qu'un terminal ? Un terminal (aussi appelé ligne de commande) est une fenêtre dans laquelle vous tapez des commandes au lieu de cliquer sur des boutons. Sous Windows, il s'appelle PowerShell ; sous macOS, il s'appelle Terminal. Ce tutoriel utilise des commandes claude, que vous tapez dans cette fenêtre puis validez avec Entrée.

Qu'est-ce que Claude Code ? Claude Code est un agent de codage d'Anthropic. Il lit vos fichiers, comprend comment les parties de votre projet sont liées, et peut modifier plusieurs fichiers, exécuter des tests et corriger des erreurs par lui-même, après avoir demandé votre permission.

Qu'est-ce qu'une clé API ? Une clé API est un code secret qui identifie votre compte lorsque vous payez à l'usage. Vous la générez une fois dans la console Claude (console.anthropic.com). Traitez-la comme un mot de passe : ne la partagez jamais.

Comment ouvrir votre terminal (pas à pas)

Si vous ne savez pas comment ouvrir un terminal, suivez les étapes de votre système ci-dessous. Vous l'utiliserez pour toutes les commandes de ce tutoriel.

Télécharger et installer

Choisissez votre version

Qu'est-ce que Homebrew ? Homebrew est un gestionnaire de paquets gratuit pour macOS. Vous tapez brew install pour installer des programmes, comme une boutique d'applications pour la ligne de commande. Ne choisissez cette option que si vous utilisez déjà Homebrew.

Qu'est-ce que WinGet ? WinGet est le gestionnaire de paquets officiel intégré à Windows 10 et 11. Ne choisissez cette option que si vous l'utilisez déjà.

Installer sur votre système

Sélectionnez votre système ci-dessous. Chaque onglet contient les étapes complètes pour ce système d'exploitation.

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

claude --version

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

claude update

winget install Anthropic.ClaudeCode

winget upgrade Anthropic.ClaudeCode

Se connecter

1. 1Ouvrez un terminal et accédez au dossier de votre projet (remplacez path/to/your/project par le chemin de votre propre dossier) :

cd path/to/your/project

1. 1Démarrez Claude Code :

claude

1. 1La première fois, il vous sera demandé de vous connecter. Une fenêtre de navigateur s'ouvre automatiquement :

• Connectez-vous avec votre compte Claude — utilisez votre abonnement Pro, Max, Team ou Enterprise. Après connexion, le navigateur renvoie automatiquement vos identifiants à Claude Code.
• Utilisez la console Claude (API) — si vous préférez le paiement à l'usage, connectez-vous avec votre compte Console.

1. 1Après la connexion, vous verrez l'invite de Claude Code, prête pour votre première tâche. Votre session est enregistrée, vous n'aurez donc pas à vous reconnecter.

Remarque : le plan gratuit de Claude.ai n'inclut pas Claude Code. Vous avez besoin d'un abonnement payant ou d'un compte Console.

Dépannage de l'installation

Solution pour « claude: command not found » — Windows :

1. 1Appuyez sur la touche Windows, tapez environment variables et cliquez sur Modifier les variables d'environnement système.
2. 2Cliquez sur le bouton Variables d'environnement....
3. 3Dans la liste inférieure (variables système), trouvez Path, sélectionnez-la et cliquez sur Modifier....
4. 4Cliquez sur Nouveau, ajoutez le dossier où Claude Code a été installé (par défaut : C:\Users\<votre nom d'utilisateur>\.local\bin) et cliquez sur OK dans toutes les fenêtres.
5. 5Fermez complètement PowerShell et rouvrez-le, puis exécutez claude --version.

Solution pour « claude: command not found » — macOS/Linux :

1. 1Ouvrez Terminal et copiez-exécutez cette commande :

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

1. 1Rechargez les paramètres :

source ~/.zshrc

1. 1Si vous utilisez Bash au lieu de Zsh, utilisez ~/.bashrc dans les deux commandes ci-dessus.
2. 2Exécutez claude --version pour confirmer.

Votre première tâche

Étape 1 : Ouvrez un projet

Accédez au dossier du projet sur lequel vous voulez que Claude Code travaille (remplacez le chemin par le vôtre) :

cd path/to/your/project

Vous devriez maintenant voir le chemin du dossier dans l'invite de votre terminal.

Étape 2 : Démarrez Claude Code

claude

Claude Code démarre et affiche son invite avec la version, le modèle actuel et le dossier dans lequel vous travaillez.

Étape 3 : Posez votre première question

Tapez cette demande et appuyez sur Entrée :

Que fait ce projet ?

Claude Code lit les fichiers du projet et explique ce qu'il trouve. Essayez-en quelques autres :

• Quelles technologies ce projet utilise-t-il ? — identifie les technologies du projet
• Où se trouve le point d'entrée principal ? — trouve le fichier principal
• Explique la structure des dossiers — explique comment les dossiers sont organisés

Étape 4 : Effectuez votre première modification de code

Tapez cette demande et appuyez sur Entrée :

Ajoute une fonction hello world au fichier principal

Claude Code trouve le bon fichier, vous montre les modifications proposées et demande votre approbation. C'est normal et sûr : c'est vous qui décidez de ce qui se passe sur votre machine.

Étape 5 : Approuvez ou rejetez les modifications

Lorsque Claude Code veut modifier des fichiers ou exécuter des commandes, il demande d'abord votre permission. Tapez y et appuyez sur Entrée pour approuver, ou n pour rejeter. Examinez chaque modification : vous gardez le contrôle.

Vous pouvez aussi appuyer sur Maj + Tab pour parcourir les modes d'autorisation :

• Mode par défaut — Claude demande avant chaque modification
• Mode acceptEdits — les modifications de fichiers sont approuvées automatiquement (les commandes demandent toujours)
• Mode plan — Claude propose seulement un plan et ne modifie rien

Étape 6 : Quittez Claude Code

Lorsque vous avez terminé, tapez /exit et appuyez sur Entrée, ou appuyez deux fois sur Ctrl + D.

Commandes utiles

Questions fréquentes

Ai-je besoin d'un plan payant ?

Oui. Claude Code nécessite un abonnement Claude payant (Pro à partir de 20 $/mois facturé mensuellement, Max à partir de 100 $/mois, Team ou Enterprise) ou un compte Claude Console avec paiement à l'usage de l'API. Le plan gratuit de Claude.ai n'inclut pas Claude Code. Consultez la page de tarification officielle pour connaître les options actuelles.

Claude Code fonctionne-t-il en dehors d'un dépôt git ?

Claude Code fonctionne mieux dans un projet Git. Si vous partez de zéro, créez d'abord un dépôt :

git init

Claude Code peut-il exécuter mon code ?

Oui, avec votre permission. Claude Code peut exécuter des commandes shell et des tests sur votre machine, et il vous montre toujours ce qu'il exécute avant de demander. Utilisez les modes d'autorisation (Maj + Tab) pour contrôler ce qu'il peut faire sans demander.

Mon code est-il envoyé à Anthropic ?

Lorsque vous utilisez Claude Code, vos invites et le contenu de vos fichiers sont traités selon les contrôles de données de votre type de compte. Consultez la documentation d'utilisation des données d'Anthropic pour plus de détails.

Qu'est-ce que MCP ?

MCP (Model Context Protocol) est un moyen standard de connecter Claude Code à des outils et sources de données externes, comme des bases de données ou des services internes. Vous pouvez ajouter des serveurs MCP plus tard avec /mcp dans une session — c'est une fonctionnalité avancée, pas nécessaire pour démarrer.

Prochaines étapes

• Ajoutez des consignes au projet : créez un fichier CLAUDE.md dans votre dépôt pour donner à Claude Code des instructions durables sur votre projet.
• Posez de meilleures questions : soyez précis sur ce que vous voulez — décrivez l'objectif et les contraintes au lieu de simplement « corrige le bug ».
• Apprenez les modes d'autorisation : utilisez Maj + Tab pour passer des modes avec demande de permission à des modes plus autonomes à mesure que vous gagnez en confiance.
• Essayez Claude Code ailleurs : Claude Code est aussi disponible en application de bureau, dans VS Code et les IDE JetBrains, et sur le web.
• Connectez des outils avec MCP : utilisez /mcp pour donner à Claude Code accès à des données et services externes.