Claude Code - Guide debutant

Claude Code est un assistant de développement IA qui fonctionne directement dans votre terminal. Ce guide d'initiation vous accompagne pas à pas, de l'installation à votre premier projet, sans prérequis technique particulier. Vous découvrirez comment configurer, utiliser et tirer parti de cet outil pour coder plus efficacement dès aujourd'hui.

Claude Code est un agent de développement en ligne de commande créé par Anthropic qui permet d'écrire, modifier et déboguer du code par le biais de conversations en langage naturel. cet outil s'est imposé comme l'un des assistants de coding agentique les plus adoptés par les développeurs.

Pour bien comprendre ce que recouvre cette approche, consultez l'article Qu'est-ce que le coding agentique ? qui pose les bases du concept.

Comment définir Claude Code et à quoi sert-il ?

Claude Code est un outil CLI (Command-Line Interface) qui s'exécute dans votre terminal. Contrairement à une extension d'éditeur, il opère directement dans votre environnement système.

Un CLI est un programme que vous pilotez en tapant des commandes textuelles. Ouvrez votre terminal, tapez une instruction, et l'outil répond. Pas de boutons, pas de menus graphiques.

En pratique, Claude Code lit votre code source, comprend la structure de votre projet et propose des modifications. Il peut créer des fichiers, exécuter des commandes et corriger des bugs en autonomie.

Le modèle Claude sous-jacent figure parmi les plus performants sur le benchmark SWE-bench Verified (le modèle actuel étant Claude Sonnet 4.6). Reportez-vous à la page officielle du modèle pour le score à jour.

Vous rencontrerez le terme « agentique » régulièrement : il signifie que l'outil prend des décisions intermédiaires pour accomplir une tâche complexe, sans que vous ayez à guider chaque étape. Pour une vue d'ensemble de l'outil et de ses capacités, rendez-vous sur la page dédiée à Claude Code.

À retenir : Claude Code est un assistant IA en terminal qui lit, écrit et exécute du code à votre place grâce à des conversations en langage naturel.

Quels sont les prérequis pour installer Claude Code ?

Avant d'installer Claude Code, vérifiez que votre machine dispose des éléments suivants. Aucune compétence avancée n'est requise.

Node.js est un environnement d'exécution JavaScript. Il permet de faire tourner des programmes JavaScript en dehors d'un navigateur. Installez la version 18 ou supérieure (Node.js 22 LTS est recommandé).

node --version
# Résultat attendu : v22.x.x ou supérieur

Un terminal est l'application où vous tapez vos commandes. Sur macOS, utilisez Terminal ou iTerm2. Sur Windows, utilisez PowerShell ou Windows Terminal. Sur Linux, tout émulateur de terminal convient.

Git est un système de contrôle de version. Il enregistre l'historique de vos modifications de code. Claude Code l'utilise pour comprendre le contexte de votre projet.

Concrètement, si node --version et git --version renvoient des résultats sans erreur, vous êtes prêt pour l'étape suivante. Retrouvez le détail complet dans le guide Installation et premier lancement.

À retenir : vous avez besoin de Node.js 18+, npm, Git et d'un terminal, trois commandes suffisent pour tout vérifier.

Comment installer Claude Code étape par étape ?

L'installation est rapide. Ouvrez votre terminal et exécutez la commande suivante :

npm install -g @anthropic-ai/claude-code

Le drapeau -g signifie « global » : l'outil sera accessible depuis n'importe quel dossier de votre machine. npm est le gestionnaire de paquets de Node.js : il télécharge et installe les programmes pour vous.

Vérifiez que l'installation a fonctionné :

claude --version
# Résultat attendu : 2.x.x

Si vous obtenez une erreur de permissions sur macOS ou Linux, n'utilisez pas sudo (déconseillé par la documentation officielle pour des raisons de sécurité). Préférez l'installateur natif, qui évite les problèmes de permissions :

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

Vous pouvez aussi corriger les permissions du préfixe global de npm afin de pouvoir installer des paquets sans sudo.

Ensuite, configurez votre clé API. Une clé API est un identifiant unique qui authentifie vos requêtes auprès des serveurs d'Anthropic. Créez un compte sur console.anthropic.com si vous n'en avez pas, puis récupérez votre clé.

export ANTHROPIC_API_KEY="sk-ant-votre-cle-ici"

En pratique, cette variable d'environnement sera lue automatiquement par Claude Code à chaque lancement. Pour la rendre permanente, ajoutez cette ligne à votre fichier ~/.bashrc ou ~/.zshrc.

Si vous souhaitez comprendre les options de sécurité liées à l'authentification, le guide Permissions et sécurité couvre l'ensemble des configurations possibles.

À retenir : une seule commande npm installe Claude Code, et une variable d'environnement configure votre clé API.

Comment lancer Claude Code pour la première fois ?

Placez-vous dans le dossier d'un projet existant ou créez un nouveau dossier :

mkdir mon-premier-projet && cd mon-premier-projet
git init

Puis lancez Claude Code :

claude

Un prompt interactif s'ouvre. Vous pouvez taper vos demandes en français ou en anglais. Claude Code analyse automatiquement les fichiers présents dans le répertoire courant.

Voici comment formuler votre première demande. Tapez directement dans le prompt :

Crée un fichier index.html avec une page d'accueil simple contenant un titre et un paragraphe

Claude Code va lire votre requête, créer le fichier et vous montrer le résultat. Il vous demandera la permission avant d'écrire sur le disque, acceptez en tapant y.

Une requête simple obtient généralement une réponse en quelques secondes. Pour les tâches complexes impliquant plusieurs fichiers, le traitement prend logiquement plus de temps.

Pour approfondir les techniques de conversation avec l'outil, le guide Vos premières conversations détaille les bonnes pratiques de formulation. Vous pouvez aussi garder sous la main l'aide-mémoire des premières conversations pour retrouver les commandes essentielles.

À retenir : lancez claude dans un dossier de projet, tapez votre demande en langage naturel, et validez les actions proposées.

Quelles sont les commandes essentielles à connaître ?

Claude Code propose des commandes slash qui pilotent son comportement. Une commande slash commence par le caractère / et s'exécute dans le prompt interactif.

Exécutez /init au début de chaque nouveau projet. Cette commande crée un fichier CLAUDE.md à la racine de votre projet. Ce fichier stocke les instructions permanentes que Claude Code relira à chaque session.

Le fichier CLAUDE.md est la mémoire persistante de l'outil. Vous y définissez les conventions de code, les frameworks utilisés et les règles spécifiques à votre projet. En pratique, la plupart des développeurs qui utilisent Claude Code quotidiennement maintiennent un fichier CLAUDE.md à jour.

Pour comprendre en détail le fonctionnement de cette mémoire, consultez l'article sur le système de mémoire CLAUDE.md. Les commandes slash essentielles sont également documentées dans un guide dédié.

À retenir : cinq commandes slash couvrent la grande majorité des besoins quotidiens : /help, /clear, /compact, /init et /cost.

Comment réaliser votre premier projet guidé pas à pas ?

Voici comment créer une API REST simple avec Claude Code. Ce projet se réalise rapidement et ne nécessite aucune expérience préalable en backend.

Étape 1 : Initialisez le projet.

mkdir api-demo && cd api-demo
git init
claude

Étape 2 : Demandez la structure du projet. Dans le prompt Claude Code, tapez :

Initialise un projet Node.js avec Express.
Crée un serveur avec une route GET /api/hello qui renvoie { "message": "Bonjour le monde" }.
Ajoute un fichier.gitignore approprié.

Claude Code va créer les fichiers package.json, server.js et .gitignore. Il exécutera npm install pour installer Express (un framework web pour Node.js). Acceptez chaque action en tapant y.

Étape 3 : Testez votre API.

node server.js
# Serveur démarré sur http://localhost:3000

Ouvrez votre navigateur à l'adresse http://localhost:3000/api/hello. Vous devriez voir la réponse JSON.

Étape 4 : Ajoutez une fonctionnalité. Revenez dans Claude Code et tapez :

Ajoute une route POST /api/todos qui accepte un titre et le stocke dans un tableau en mémoire.
Ajoute une route GET /api/todos qui renvoie la liste des todos.

En quelques instants, Claude Code modifie votre fichier server.js pour ajouter les deux routes. Le poids total du projet reste léger.

Ce type de projet illustre concrètement la puissance du coding agentique. Pour explorer d'autres cas d'usage et aller plus loin, la formation SFEIR Institute Claude Code (1 jour) vous permet de pratiquer sur des labs encadrés couvrant l'installation, la configuration et la prise en main complète de l'outil.

À retenir : en quatre étapes, vous créez rapidement une API fonctionnelle sans écrire une seule ligne de code manuellement.

Quelles erreurs de débutant faut-il éviter ?

Les débutants commettent des erreurs récurrentes. Voici les cinq plus fréquentes et comment les corriger.

Erreur 1 : Des prompts trop vagues. « Fais-moi un site web » ne donne pas de bons résultats. Précisez la technologie, la structure et le comportement attendu. Un prompt détaillé produit des résultats nettement plus pertinents qu'un prompt laconique.

Erreur 2 : Ignorer le contexte du projet. Claude Code analyse les fichiers du répertoire courant. Si vous le lancez depuis votre dossier home, il n'a aucun contexte projet. Placez-vous toujours dans le bon dossier avant de lancer claude.

Erreur 3 : Ne pas utiliser /init. Sans fichier CLAUDE.md, l'outil repart de zéro à chaque session. En pratique, cela signifie que vous répétez les mêmes instructions à chaque lancement.

Erreur 4 : Accepter sans lire. Claude Code demande des permissions avant d'écrire ou d'exécuter des commandes. Lisez chaque proposition avant de valider. Le guide de démarrage rapide sur les permissions explique comment configurer les niveaux d'autorisation.

Erreur 5 : Oublier de versionner. Committez régulièrement avec Git. Claude Code peut défaire ses modifications, mais Git reste votre filet de sécurité. Un git commit avant chaque demande complexe vous protège contre les résultats inattendus.

les développeurs qui appliquent ces cinq bonnes pratiques constatent une réduction significative du nombre de corrections manuelles après génération.

À retenir : précisez vos prompts, restez dans le bon dossier, utilisez /init, lisez les diffs et committez régulièrement.

Comment connecter Claude Code à des outils externes via MCP ?

MCP (Model Context Protocol) est un protocole ouvert qui permet à Claude Code de communiquer avec des services tiers. Concrètement, MCP connecte l'outil à vos bases de données, APIs et outils de documentation.

Claude Code intègre nativement le support de MCP. Ajoutez un serveur MCP avec la commande claude mcp add. Par exemple, pour connecter le serveur MCP distant de GitHub :

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ --header "Authorization: Bearer VOTRE_GITHUB_PAT"

Cette commande connecte Claude Code à l'API GitHub. Vous pouvez ensuite demander à l'outil de lister vos pull requests, créer des issues ou consulter des fichiers distants.

Des centaines de serveurs MCP couvrent les cas d'usage courants : bases de données, services cloud et outils de productivité. Parcourez les connecteurs vérifiés dans le répertoire Anthropic (claude.ai/directory).

Le tutoriel MCP complet détaille la configuration pas à pas pour les serveurs les plus populaires.

À retenir : MCP étend les capacités de Claude Code en le connectant à vos outils existants via un protocole standardisé.

Combien coûte l'utilisation de Claude Code ?

Claude Code fonctionne avec un système de tokens. Un token est une unité de texte (environ 4 caractères en anglais, 2-3 caractères en français). Chaque requête consomme des tokens en entrée (votre code + prompt) et en sortie (la réponse générée).

Chaque modèle facture un tarif par million de tokens en entrée et en sortie. Pour les montants exacts, consultez la tarification officielle, qui évolue régulièrement.

En pratique, la consommation d'une session de développement dépend de la taille de votre code, de la longueur des échanges et du modèle utilisé. La commande /cost affiche votre consommation en temps réel.

le modèle Claude Sonnet 4.6 offre le meilleur rapport performance/coût pour les tâches de développement courantes. Utilisez /cost régulièrement pour suivre votre budget.

Si vous souhaitez approfondir votre maîtrise de l'outil et optimiser vos coûts, la formation Développeur Augmenté par l'IA de SFEIR Institute (2 jours) couvre les stratégies avancées de prompting et de gestion de contexte. Pour les développeurs déjà familiers avec les bases, la formation Développeur Augmenté par l'IA – Avancé (1 jour) approfondit l'automatisation et les workflows complexes.

À retenir : suivez votre consommation avec /cost et choisissez le modèle adapté à chaque tâche pour maîtriser votre budget.

Quelles sont les prochaines étapes après ce guide ?

Vous maîtrisez désormais les fondamentaux de Claude Code. Voici la feuille de route pour progresser.

Niveau 2 - Maîtriser le contexte. Apprenez à structurer vos fichiers CLAUDE.md pour des projets multi-modules. La gestion du contexte joue un rôle central dans l'efficacité avec un outil agentique.

Niveau 3 - Automatiser les workflows. Claude Code s'intègre dans des pipelines CI/CD. Configurez des hooks pre-commit qui valident le code généré avant chaque commit.

Niveau 4 - Étendre avec MCP. Connectez Claude Code à vos bases de données, APIs internes et outils de monitoring pour une productivité maximale.

Voici les ressources essentielles pour continuer :

• Approfondir les bases : le guide Vos premières conversations couvre les techniques de prompting avancées
• Sécuriser votre usage : le guide Permissions et sécurité détaille les niveaux d'autorisation
• Comprendre la philosophie : l'article sur le coding agentique explique les principes sous-jacents

Claude Code reçoit des mises à jour régulières. Pour bénéficier des dernières améliorations, exécutez npm install -g @anthropic-ai/claude-code@latest (ou claude update). Évitez npm update -g, qui respecte la plage de versions d'origine et peut ne pas réellement mettre à jour l'outil. Les installations natives se mettent à jour automatiquement.

À retenir : progressez par paliers (contexte, automatisation, puis intégrations) et maintenez votre outil à jour pour profiter des évolutions continues.