Configuration Claude Code CLI 2026 : démarrage rapide en 5 minutes

Comment configurer Claude Code ? Installez le CLI globalement avec npm install -g @anthropic-ai/claude-code, authentifiez-vous via votre navigateur, puis créez un fichier CLAUDE.md à la racine de votre projet avec les détails de la stack et les conventions de code. Configurez les permissions dans .claude/settings.json et ajoutez un hook de formatage pour corriger automatiquement le style après chaque modification. L’ensemble de la configuration prend moins de cinq minutes. {.answer-block}

Plus de 29 000 développeurs chez ServiceNow utilisent désormais Claude Code au quotidien¹, et Allianz l’a déployé à l’échelle de l’entreprise début 2026². La courbe d’adoption de l’outil reflète un schéma : une fois que les développeurs ont essayé le codage agentique dans leur propre terminal, ils ne reviennent plus au copier-coller depuis des fenêtres de chat. Ce démarrage rapide fait partie de ma série AI engineering — des guides pratiques pour les développeurs qui construisent avec Claude. La démonstration suivante vous emmène de zéro à une session Claude Code fonctionnelle en environ cinq minutes, avec une véritable configuration que vous pourrez continuer à utiliser par la suite.

TL;DR : Installez Claude Code via npm install -g @anthropic-ai/claude-code, authentifiez-vous via votre navigateur, créez un fichier CLAUDE.md avec le contexte de votre projet et configurez les permissions dans .claude/settings.json. Ajoutez un hook Prettier pour formater automatiquement les fichiers après chaque modification. L’ensemble de la configuration prend moins de cinq minutes et persiste entre les sessions.

Points clés à retenir

• Développeurs solo : CLAUDE.md et un hook de formatage couvrent 80 % de ce dont vous avez besoin. Commencez avec les permissions par défaut et pré-approuvez les outils au fur et à mesure que vous établissez la confiance.
• Chefs d’équipe : Committez .claude/settings.json dans votre dépôt afin que toute l’équipe partage les mêmes listes d’autorisation et hooks.
• Ingénieurs sécurité : Le modèle de permissions à trois niveaux⁴ (Ask, Allowlisted, --dangerously-skip-permissions) correspond directement aux niveaux de confiance. Le mode Ask exige une approbation explicite pour chaque écriture et chaque commande.

Prérequis

Trois éléments sont nécessaires avant d’installer Claude Code :

Node.js 18 ou ultérieur. Claude Code est livré sous forme de package npm³. Vérifiez votre version :

node --version
# v18.0.0 or higher

Si vous devez installer ou mettre à niveau Node.js, utilisez nvm ou téléchargez directement depuis nodejs.org.

Un compte Anthropic avec accès à l’API. Créez une clé API sur console.anthropic.com dans Settings > API Keys. Claude Code facture au token sur votre solde API, ou vous pouvez utiliser l’abonnement Max (100 $/mois en individuel, 200 $/mois pour les équipes en mars 2026)⁶. Gardez la clé disponible pour l’étape d’authentification.

Un terminal. Claude Code fonctionne dans n’importe quel émulateur de terminal : Terminal.app, iTerm2, Windows Terminal, Alacritty ou le terminal intégré de VS Code. Je recommande un terminal d’au moins 120 colonnes de largeur, car Claude Code affiche des diffs de fichiers et des sorties d’outils qui bénéficient de l’espace horizontal.

Installation

Installez Claude Code globalement via npm :

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

Vérifiez que l’installation a réussi :

claude --version

Vous devriez voir un numéro de version imprimé sur stdout. Si vous obtenez une erreur « command not found », c’est que le répertoire bin global de npm n’est pas dans votre PATH. Exécutez npm config get prefix et ajoutez le sous-répertoire /bin au PATH de votre shell. Sur macOS avec Node installé via Homebrew, le préfixe est généralement /usr/local, donc ajoutez /usr/local/bin s’il n’y est pas déjà.

Problème d’installation courant : Si vous rencontrez des erreurs de permission EACCES pendant npm install -g, n’utilisez pas sudo. Configurez plutôt npm pour utiliser un répertoire accessible en écriture par l’utilisateur⁷ :

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
# Add to your shell profile (~/.zshrc or ~/.bashrc):
export PATH="$HOME/.npm-global/bin:$PATH"

Au premier lancement, Claude Code ouvre votre navigateur sur la console Anthropic pour l’authentification OAuth. Vous vous connectez, vous autorisez, et Claude Code stocke le token localement dans ~/.claude/. Autre solution : définir la variable d’environnement ANTHROPIC_API_KEY avant le lancement. Dans les deux cas, les identifiants restent sur votre machine et n’authentifient que les requêtes API.

Première session

Accédez à n’importe quel répertoire de projet et exécutez :

cd ~/Projects/my-app
claude

Claude Code démarre une session REPL interactive. Au premier lancement dans un nouveau projet, Claude effectue plusieurs actions automatiquement :

1. Analyse la structure du répertoire pour comprendre la disposition du projet
2. Lit les fichiers de configuration tels que package.json, pyproject.toml ou Cargo.toml pour identifier la stack technique
3. Cherche un fichier CLAUDE.md à la racine du projet pour obtenir des instructions spécifiques au projet

Essayez un prompt simple pour confirmer que tout fonctionne :

> Explain the structure of this project

Claude lit vos fichiers, synthétise l’architecture et répond dans le terminal. Vous verrez les appels d’outils en temps réel (chaque lecture de fichier, chaque commande exécutée) ainsi qu’une demande de permission avant toute opération d’écriture.

À surveiller lors de votre première session. Prêtez attention à deux choses : les appels d’outils (affichés en temps réel avant chaque action) et les invites de permission. Les appels d’outils révèlent la façon dont Claude navigue dans votre base de code. Vous remarquerez qu’il lit des fichiers auxquels vous n’auriez pas pensé à vérifier, ce qui fait souvent émerger un contexte utile. Les invites de permission vous montrent exactement ce que Claude a l’intention de modifier avant que quoi que ce soit ne touche le disque. Si une modification proposée semble incorrecte, refusez-la et fournissez des clarifications. Claude ajuste son approche en fonction de vos retours au sein de la session⁸.

Configurer CLAUDE.md

CLAUDE.md est le fichier le plus important pour une utilisation efficace de Claude Code. Sans lui, Claude déduit votre stack à partir du contenu des fichiers et fait des suppositions raisonnables. Avec lui, Claude suit vos conventions exactes dès le premier prompt. La différence est importante, car le comportement basé sur l’inférence dérive : Claude peut utiliser CommonJS dans un projet ESM, choisir le mauvais test runner ou ignorer votre workflow de migration de base de données. CLAUDE.md élimine cette dérive.

Créez le fichier à la racine de votre projet :

touch CLAUDE.md

Voici un modèle de départ pratique pour un projet Python :

# My App

## Project Context
FastAPI backend with HTMX frontend. PostgreSQL database.

## Stack
- Backend: Python 3.11, FastAPI, SQLAlchemy 2.0 (async)
- Frontend: HTMX + Alpine.js, Jinja2 templates
- Database: PostgreSQL 16, Alembic migrations
- Testing: pytest with pytest-asyncio

## Code Standards
- Type hints on all function signatures
- Pydantic v2 models for request/response validation
- Async database operations only (no sync SQLAlchemy)

## Commands
- `source venv/bin/activate` before any Python command
- `uvicorn app.main:app --reload` starts the dev server
- `python -m pytest -v` runs the test suite
- `alembic upgrade head` applies database migrations

Pour un projet JavaScript/TypeScript, la structure est similaire :

# My App

## Stack
- Backend: Node.js 20, Express 4, TypeScript
- Frontend: React 18, Vite
- Database: PostgreSQL 16, Prisma ORM
- Testing: Vitest for unit, Playwright for e2e

## Code Standards
- ESM imports only (no require())
- All API endpoints need input validation with Zod
- Tests required for new endpoints before merging

## Commands
- `npm run dev` starts the dev server on port 3000
- `npm test` runs the test suite
- `npx prisma migrate dev` runs database migrations

Les sections CLAUDE.md les plus précieuses sont celles qui empêchent les erreurs répétées. Si Claude continue d’importer avec require() au lieu d’import, ajoutez « ESM imports only » aux Code Standards. Si votre commande de test nécessite d’abord l’activation d’un virtualenv, documentez cette séquence. Claude lit CLAUDE.md au début de chaque session, de sorte que chaque ligne devient une instruction persistante qui se cumule sur des centaines d’interactions. J’explore les schémas qui rendent les fichiers CLAUDE.md efficaces dans AGENTS.md Patterns, ainsi que le principe plus large selon lequel le contexte est l’architecture. La spécification ouverte AGENTS.md⁹ suit un schéma similaire pour d’autres outils agentiques, mais CLAUDE.md prend en charge des fonctionnalités plus riches comme les répertoires de skills et de règles.

La hiérarchie est importante. Vous pouvez placer un CLAUDE.md à trois emplacements, et Claude les fusionne par ordre de spécificité :

1. ~/.claude/CLAUDE.md : instructions globales pour tous les projets (vos préférences de codage personnelles)
2. ./CLAUDE.md : instructions au niveau du projet (committées dans votre dépôt, partagées avec votre équipe)
3. ./src/CLAUDE.md : instructions au niveau du répertoire (limitées à un module ou sous-système d’un monorepo)

Le CLAUDE.md au niveau du projet est celui que vous committez dans le contrôle de version. Les membres de l’équipe qui utilisent Claude Code héritent automatiquement de vos conventions.

Les bases des permissions

Claude Code fonctionne selon trois niveaux de permissions⁴ qui déterminent le degré d’autonomie de l’agent. Le niveau que vous choisissez contrôle un compromis fondamental : plus d’autonomie signifie des sessions plus rapides mais moins de visibilité sur les changements.

Le mode Ask (le mode par défaut) exige une approbation avant chaque écriture de fichier, exécution de commande ou action destructive. Vous voyez exactement ce que Claude a l’intention de faire et vous approuvez ou rejetez chaque étape. Je recommande de commencer ici, car les invites d’approbation vous apprennent comment fonctionne Claude Code. Après quelques sessions, vous développez l’intuition de savoir quelles opérations sont sûres à pré-approuver et lesquelles méritent un examen à chaque fois.

Les permissions sur liste d’autorisation vous permettent de pré-approuver des outils et des schémas spécifiques afin que Claude ne demande pas à chaque fois. Vous les configurez dans le .claude/settings.json de votre projet :

{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(python -m pytest*)",
      "Bash(alembic upgrade head)"
    ]
  }
}

La configuration ci-dessus permet à Claude de lire des fichiers, de rechercher dans la base de code et d’exécuter vos commandes de test et de migration sans demander. Elle demande toujours avant d’écrire des fichiers ou d’exécuter toute autre commande bash. Remarquez le schéma : les opérations de lecture et les commandes connues comme sûres sont mises sur liste d’autorisation. Les opérations d’écriture restent en mode Ask, car vous souhaitez examiner ce que Claude écrit avant que cela n’atteigne le disque.

Dangerously skip permissions (--dangerously-skip-permissions) désactive toutes les invites de confirmation. Le flag existe exclusivement pour les pipelines CI/CD et les workflows automatisés où aucun humain n’est présent pour approuver. Ne l’utilisez jamais dans des sessions interactives sur une base de code à laquelle vous tenez.

Le système de permissions rend Claude Code sûr à utiliser sur de vrais projets. La progression est délibérée : commencez en mode Ask pour construire votre compréhension, mettez sur liste d’autorisation les opérations qui deviennent répétitives et gardez les opérations d’écriture sous contrôle afin de toujours examiner les changements avant qu’ils ne soient appliqués.

Votre premier hook

Les hooks sont des commandes shell qui s’exécutent à des points spécifiques du cycle de vie de Claude Code⁵. J’ai écrit un tutoriel complet sur les hooks qui construit cinq hooks de production à partir de zéro, et mon article sur la construction de skills personnalisés couvre le niveau supérieur d’automatisation. Les hooks résolvent un problème fondamental des outils basés sur les LLM : le modèle suit vos règles de formatage la plupart du temps, mais « la plupart du temps » signifie qu’une modification de fichier sur dix introduit une incohérence de style. Les hooks fournissent des garanties déterministes là où le modèle fournit des garanties probabilistes. Un hook de formatage exécute votre formateur après chaque écriture de fichier, à chaque fois, indépendamment de ce que le modèle a décidé de faire. Voici un premier hook pratique : le formatage automatique des fichiers après que Claude les a modifiés.

Créez ou modifiez .claude/settings.json dans votre projet :

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\" 2>/dev/null || true"
          }
        ]
      }
    ]
  }
}

Le hook PostToolUse⁵ se déclenche après chaque appel d’outil Edit ou Write. Claude Code définit $FILE_PATH sur le chemin du fichier modifié. Prettier le formate sur place, et || true garantit qu’un code de sortie non nul ne bloque pas Claude si Prettier n’est pas installé ou si le type de fichier n’est pas pris en charge⁵.

Autres hooks de démarrage pratiques que je recommande :

• PreToolUse sur Bash : Bloquer les commandes dangereuses comme rm -rf / ou git push --force
• SessionStart : Injecter la date actuelle, la branche git active ou les variables d’environnement dans le contexte (la sortie stdout des hooks SessionStart alimente le contexte de Claude)
• Stop : Exécuter automatiquement votre suite de tests lorsque Claude termine une tâche

Les hooks transforment Claude Code d’un outil conversationnel en un environnement de développement gouverné. Même un ou deux hooks bien choisis éliminent des catégories entières d’erreurs.

Quand les choses tournent mal

Trois situations reviennent à plusieurs reprises pendant la première semaine d’utilisation de Claude Code. Les connaître à l’avance fait gagner du temps de débogage.

Claude ignore les instructions de votre CLAUDE.md. Cause la plus fréquente : Claude a déjà lu le fichier et mis en cache sa compréhension avant que vous ne le modifiiez. Exécutez /clear pour réinitialiser le contexte, ou démarrez une nouvelle session. Claude relit CLAUDE.md au début de la session, pas à chaque prompt. Si Claude ignore toujours les instructions après une nouvelle session, vérifiez si un CLAUDE.md de priorité supérieure (au niveau utilisateur dans ~/.claude/CLAUDE.md) entre en conflit avec votre fichier au niveau du projet.

Claude effectue une modification que vous n’avez pas approuvée. Si vous avez mis sur liste d’autorisation un schéma trop large (par exemple, Bash(*) au lieu de Bash(python -m pytest*)), Claude peut exécuter des commandes sans demander. Réduisez vos schémas de liste d’autorisation. L’approche la plus sûre : ne mettre sur liste d’autorisation que les opérations de lecture et des commandes nommées spécifiques. Si Claude a déjà effectué une modification indésirable, git diff montre exactement ce qui a changé, et git checkout -- <file> l’annule.

La fenêtre de contexte se remplit pendant une longue session. Claude Code compresse les messages antérieurs lorsque la fenêtre de contexte de 200K se remplit, mais la compression peut supprimer des détails importants du début de la conversation. Pour les sessions de plus de 30 minutes, committez périodiquement les modifications en cours et démarrez une nouvelle session avec /clear. Le nouveau contexte relit CLAUDE.md et démarre proprement. Je committe après chaque sous-tâche terminée, ce qui me donne à la fois un point de retour en arrière et une frontière de session naturelle.

Claude modifie le mauvais fichier ou effectue des changements inutiles. Lorsque Claude commence à « améliorer » du code que vous ne lui avez pas demandé de toucher, le problème vient généralement de l’ambiguïté du prompt. Au lieu de « nettoie le module d’authentification », dites « dans app/auth/handlers.py, renomme verify_user en verify_user_credentials et mets à jour tous les appelants ». La spécificité réduit les effets secondaires indésirables. Si Claude a déjà effectué des modifications indésirables, git diff montre exactement ce qui a changé, et git checkout -- <file> annule les fichiers individuels sans perdre d’autres travaux.

Prochaines étapes

La démonstration ci-dessus couvre l’essentiel : installation, première session, configuration du projet, permissions et un hook de démarrage. Pour une comparaison de Claude Code avec d’autres outils agentiques, voir Claude Code vs Codex. Pour la référence complète couvrant les 5 systèmes principaux (hiérarchie CLAUDE.md, modèle de permissions complet, architecture des hooks, commandes slash personnalisées et workflows multi-agents), lisez The Complete Guide to Claude Code.

Le guide couvre la gestion de la fenêtre de contexte, la délégation à des sous-agents, l’activation automatique des skills et les schémas qui émergent après des mois d’utilisation quotidienne de Claude Code. Si ce démarrage rapide vous a été utile, le guide complet est l’étape naturelle suivante. Pour une référence rapide de chaque commande, flag et raccourci, voir le Claude Code Cheat Sheet.

Références

FAQ

Quels sont les prérequis pour installer Claude Code ?

Vous avez besoin de Node.js 18 ou ultérieur (Claude Code est livré sous forme de package npm), d’un compte Anthropic avec accès à l’API ou d’un abonnement Max, et de n’importe quel émulateur de terminal. Claude Code fonctionne sur macOS, Linux et Windows (via WSL ou en natif). Aucune dépendance supplémentaire, conteneur Docker ou runtime de langage n’est requis au-delà de Node.js. La commande d’installation est npm install -g @anthropic-ai/claude-code.

Qu’est-ce que CLAUDE.md et pourquoi en ai-je besoin ?

CLAUDE.md est un fichier markdown situé à la racine de votre projet qui indique à Claude Code votre stack, vos conventions de codage et vos commandes courantes. Sans lui, Claude déduit votre configuration à partir du contenu des fichiers et fait des suppositions raisonnables — mais ces suppositions dérivent d’une session à l’autre. Avec CLAUDE.md, Claude suit vos conventions exactes dès le premier prompt, à chaque session. Il prend en charge une hiérarchie à trois niveaux : niveau utilisateur (~/.claude/CLAUDE.md), niveau projet (./CLAUDE.md) et niveau répertoire (./src/CLAUDE.md), fusionnés par ordre de spécificité.

Combien coûte Claude Code ?

Claude Code prend en charge deux modèles de facturation. Le modèle API à l’usage facture au token aux tarifs API Anthropic standard⁶. Une session typique de 30 à 60 minutes coûte entre 0,50 $ et 3,00 $ selon la taille de la base de code et le volume de génération. Autre option, le plan Max d’Anthropic⁶ (100 $/mois en individuel, 200 $/mois pour les équipes en mars 2026) inclut l’utilisation de Claude Code avec des limites de débit plus élevées. Vous pouvez surveiller l’utilisation de l’API sur console.anthropic.com.

Puis-je utiliser Claude Code avec VS Code ?

Oui. Claude Code fonctionne dans n’importe quel terminal, y compris le terminal intégré de VS Code. Ouvrez le panneau terminal dans VS Code, accédez à votre répertoire de projet et exécutez claude exactement comme vous le feriez dans un terminal autonome. Claude Code lit et modifie les fichiers sur le disque, de sorte que les changements apparaissent immédiatement dans vos onglets d’éditeur VS Code. Aucune extension VS Code distincte n’est requise. Certains développeurs gardent un split de terminal dédié à Claude Code à côté de leur éditeur, ce qui fonctionne bien pour examiner les changements au fur et à mesure qu’ils se produisent.

Claude Code est-il sûr à utiliser sur des bases de code en production ?

Le mode Ask de Claude Code exige une approbation explicite avant chaque écriture de fichier et chaque exécution de commande. Rien ne change sur le disque sans votre confirmation. Le système de permissions, combiné à des hooks qui peuvent bloquer les opérations dangereuses comme les force push ou les commandes shell destructives, rend Claude Code pratique pour le travail en production. J’utilise Claude Code quotidiennement sur des projets qui servent de vrais utilisateurs. L’essentiel est de commencer en mode Ask, de comprendre ce que fait chaque appel d’outil avant de l’approuver, et de mettre progressivement sur liste d’autorisation uniquement les opérations auxquelles vous faites confiance. Le contrôle de version fournit le filet de sécurité final : committez avant de démarrer toute session Claude Code significative afin de pouvoir toujours faire machine arrière.

Quelle est l’erreur la plus courante chez les nouveaux utilisateurs ?

Donner à Claude trop de contexte dans le prompt au lieu de le placer dans CLAUDE.md. Les nouveaux utilisateurs ont tendance à coller l’intégralité de leurs standards de codage dans chaque prompt, ce qui gaspille l’espace de la fenêtre de contexte et produit des résultats incohérents d’une session à l’autre. Déplacez les instructions récurrentes vers CLAUDE.md une fois pour toutes, et utilisez les prompts pour les requêtes spécifiques à la session. La deuxième erreur la plus courante : mettre sur liste d’autorisation Bash(*) au lieu de commandes spécifiques. Une liste d’autorisation Bash avec un wildcard permet à Claude d’exécuter n’importe quelle commande shell sans demander, ce qui va à l’encontre du système de permissions.