Claude Code : Guide complet pour débuter avec l’IA dans votre terminal

Lancez claude dans votre terminal après l’installation via npm.

  • Node.js 18 minimum requis, version 22 LTS recommandée.
  • Installez avec npm install -g @anthropic-ai/claude-code.
  • Abonnement Pro, Max, Team ou Console API nécessaire.
  • Utilisez /help pour la liste complète des commandes.
  • /cost affiche la consommation de tokens en temps réel.

Qu’est-ce que Claude Code et comment l’installer ?

Définition et fonctionnement de Claude Code

  • CLI dans terminal : l’outil s’exécute directement dans votre terminal, sans interface graphique. Vous interagissez par commandes textuelles.
  • Aucune interface graphique : tout se passe en ligne de commande. Pas de fenêtres, pas de boutons à cliquer.
  • Hors éditeur de code dédié : Claude Code fonctionne dans n’importe quel terminal, indépendamment de votre environnement de développement.

Concrètement, vous lancez Claude Code dans le dossier de votre projet, et il accède à votre code source, lit les fichiers et exécute des commandes système pour vous assister. Il comprend la structure de votre projet et peut suggérer des modifications, générer du code ou corriger des erreurs.

Procédure d’installation complète

  • Node.js 18 minimum requis : installez d’abord Node.js (la version 22 LTS est recommandée pour une stabilité optimale).
  • npm install -g @anthropic-ai/claude-code : une seule commande suffit pour installer l’outil globalement sur votre machine.
  • Connexion compte Claude requis : vous devez posséder un abonnement Pro, Max, Team ou Enterprise, ou utiliser la Console API avec des crédits prépayés.
  • Installation en moins de 2 minutes : comptez environ une minute pour télécharger et installer les dépendances, puis une minute pour configurer votre première session.

Une fois l’installation terminée, ouvrez votre terminal dans le dossier de votre projet et tapez la commande claude. L’outil vous demandera de vous connecter à votre compte anthropic pour autoriser la session. À la première connexion, un espace dédié Claude Code est automatiquement créé dans votre console Anthropic.

Commandes essentielles et premier projet pas à pas

comment utiliser claude code

Les commandes fondamentales à connaître

Une fois votre session lancée, trois commandes vous permettent de reprendre le contrôle à tout moment. /help affiche l’aide intégrée directement dans le terminal : vous y trouverez la liste complète des instructions disponibles sans quitter votre environnement. Lorsque la conversation s’allonge et que le contexte devient confus, tapez /clear pour réinitialiser la session et repartir sur une base saine.

Pour suivre votre budget en temps réel, la commande /cost affiche le coût de la session courante : chaque échange consomme des tokens, et cette transparence évite les mauvaises surprises. Enfin, /compact résume le contexte accumulé selon vos instructions : idéal avant de changer de tâche sans perdre l’essentiel de ce qui a été dit.

Créer votre première API REST en 10 minutes

Pour démarrer, placez-vous dans le dossier de votre projet et lancez claude. Claude Code explore alors l’arborescence et vous propose d’initialiser package.json et un server.js minimal. Acceptez : en moins d’une minute, la structure de base est en place.

  • Lancer claude dans le dossier du projet
  • Initialiser package.json et server.js via la commande /init
  • Ajouter .gitignore dès le départ pour exclure node_modules
  • Structurer avec le Plan Mode avant d’écrire la moindre ligne de code

Ajoutez un fichier .gitignore immédiatement un réflexe qui vous évitera de versionner des dossiers inutiles. Enfin, activez le Plan Mode : décrivez brièvement votre API (ex. : « une route GET /users qui renvoie un tableau JSON »). Claude Code propose un plan d’exécution avant de coder, ce qui réduit les allers-retours et garantit un résultat fonctionnel en une dizaine de minutes.

CLAUDE.md, MCP et personnalisation de l’environnement

Configurer votre projet avec CLAUDE.md

Le fichier CLAUDE.md est le centre de commandement de votre projet. Il permet à Claude Code de comprendre vos conventions de code, vos règles de nommage et les spécificités de votre stack technique. Pour le créer, il suffit de taper la commande /init dans le terminal Claude génère automatiquement un fichier de configuration adapté à la structure de votre dossier.

  • /init génère le fichier automatiquement : une seule commande suffit pour créer CLAUDE.md à la racine du projet. Claude analyse vos fichiers existants et propose une configuration pré-remplie
  • Définit conventions et tests du projet : précisez le framework de test utilisé (Jest, Vitest, Mocha), la version de Node.js imposée, ainsi que les règles de linting (ESLint, Prettier) que Claude doit respecter lorsqu’il génère ou modifie du code
  • Lien vers documentation API interne : ajoutez des références vers votre API back-end, votre design system ou toute spécification métier. Claude les lira automatiquement pour contextualiser ses réponses

Connecter vos outils via le protocole MCP

Le MCP (Model Context Protocol) est un protocole standardisé qui permet à Claude Code d’interagir avec des outils et services externes sans plugin complexe. Une fois configuré, votre assistant peut consulter une base de données, envoyer des requêtes à une API ou lire des fichiers sur un serveur distant, le tout depuis votre terminal.

  • Bases de données, APIs, services externes : connectez PostgreSQL, Stripe, GitHub ou tout service doté d’une interface REST ou GraphQL. Claude peut exécuter des requêtes et traiter les résultats dans vos prompts
  • Protocole standardisé d’extension : le MCP suit un format unique d’échanges (JSON-RPC) qui évite les intégrations propriétaires. Tout développeur peut créer son propre connecteur sans apprendre un SDK spécifique
  • Personnalisation sans plugin complexe : contrairement aux IDE traditionnels, aucune installation de plugin tiers n’est nécessaire. Vous déclarez vos serveurs MCP dans le fichier de configuration de Claude Code, et il les active à la session suivante

Prix, abonnements et erreurs à éviter

Type d’abonnement Mode d’accès Consommation typique par session
Claude Pro Limite mensuelle incluse 50 000 à 200 000 tokens
Claude Max Usage intensif illimité 200 000 tokens par session
Claude Team Comptes collaborateurs 50 000 à 200 000 tokens
Console API Crédits prépayés Payez à l’usage réel

Comprendre le coût de Claude Code

Pour utiliser Claude Code, un abonnement actif à Claude Pro, Max, Team ou Enterprise est indispensable. Une alternative consiste à passer par la Console API avec des crédits prépayés. Lors de votre première connexion via le terminal, un espace « Claude Code » est automatiquement créé dans votre Console pour suivre votre consommation. Une session de 30 minutes consomme entre 50 000 et 200 000 tokens, selon la complexité des tâches effectuées. Lancez régulièrement la commande /cost dans le prompt pour visualiser le coût de votre session en temps réel et éviter les surprises.

Les pièges fréquents des débutants

  • Prompts vagues inefficaces : un prompt de 30 mots produit 3 fois plus de pertinence qu’un prompt de 5 mots soyez précis dès le départ.
  • Ignorer le Plan Mode : lancer le codage sans planifier entraîne des allers-retours coûteux utilisez le Plan Mode pour décrire votre approche avant d’écrire une ligne de code.
  • Absence de .gitignore : sans ce fichier, Claude Code peut modifier par erreur des fichiers sensibles comme node_modules ou les variables d’environnement.
  • Oublier de configurer CLAUDE.md : sans ce fichier créé par /init, l’IA ignore vos conventions de projet, ce qui réduit la qualité des suggestions.

Plan Mode : réfléchir avant de coder

Le Plan Mode est une fonctionnalité clé de Claude Code qui transforme votre approche du développement. Au lieu de coder immédiatement, le système explore d’abord votre projet, analyse la structure et propose un plan d’action détaillé. Cette méthode réduit considérablement les erreurs d’interprétation et les allers-retours chronophages.

Pour activer cette approche, formulez des prompts précis : un prompt de 30 mots produit environ 3 fois plus de pertinence qu’un prompt vague de 5 mots comme « Fais-moi un site web ». Fournissez des critères de test avant l’implémentation : Claude Code vérifiera chaque étape du plan par rapport à ces exigences. Cette discipline vous fait gagner du temps et garantit un résultat aligné sur vos attentes réelles.