Installer Claude Code CLI : guide de configuration en 5 minutes (2026)

Comment configurer Claude Code ? Installez le CLI avec l’installateur natif, curl -fsSL https://claude.ai/install.sh | bash, authentifiez-vous via votre navigateur, puis créez un fichier CLAUDE.md à la racine de votre projet, avec les détails de votre stack et vos conventions de code. Configurez les permissions dans .claude/settings.json et ajoutez un hook de formatage qui corrige automatiquement le style après chaque modification. L’ensemble de la configuration prend moins de cinq minutes. {.answer-block}

ServiceNow a déployé Claude Code auprès de plus de 29 000 employés¹, et Allianz a annoncé un partenariat rendant Claude accessible à l’ensemble de ses salariés début 2026². La courbe d’adoption de l’outil révèle un schéma récurrent : une fois qu’un développeur a essayé le codage agentique dans son propre terminal, il ne revient pas au copier-coller depuis une fenêtre de chat. Le parcours ci-dessous vous mène de zéro à une session Claude Code fonctionnelle en cinq minutes environ, avec une vraie configuration que vous pourrez conserver ensuite.

En bref : installez Claude Code avec l’installateur natif (curl -fsSL https://claude.ai/install.sh | bash), authentifiez-vous dans votre navigateur, créez un fichier CLAUDE.md décrivant le contexte de votre projet et configurez les permissions dans .claude/settings.json. Ajoutez un hook Prettier qui formate automatiquement les fichiers après chaque modification. L’ensemble prend moins de cinq minutes et la configuration persiste d’une session à l’autre.

Points clés

• Développeurs indépendants : CLAUDE.md et un hook de formatage couvrent 80 % de vos besoins. Commencez avec les permissions par défaut, puis pré-approuvez des outils à mesure que la confiance s’installe.
• Responsables d’équipe : versionnez .claude/settings.json dans votre dépôt afin que toute l’équipe partage les mêmes listes d’autorisation et les mêmes hooks.
• Ingénieurs sécurité : le modèle de permissions⁴ (Ask/Manual, listes d’autorisation, classifieur du mode auto, --dangerously-skip-permissions) correspond directement à des niveaux de confiance. Le mode Ask exige une approbation explicite pour chaque écriture et chaque commande ; depuis le 14 août 2026, les sessions Pro, Max et Team démarrent toutefois en mode auto : fixez "defaultMode": "manual" si votre modèle de menace impose un humain à chaque approbation.

Prérequis

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

Un compte Anthropic. Claude Code exige un compte Pro, Max, Team, Enterprise ou Console ; l’offre gratuite de Claude.ai n’y donne pas accès³. Les formules par abonnement incluent l’usage de Claude Code (Max 5x à 100 $/mois ou Max 20x à 200 $/mois, deux offres individuelles, à la mi-2026)⁶ ; vous pouvez sinon payer au token avec une clé API obtenue sur console.anthropic.com. L’authentification se fait dans le navigateur après l’installation : il n’y a donc rien à copier pour l’instant.

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 une largeur d’au moins 120 colonnes, car Claude Code affiche des diffs de fichiers et des sorties d’outils qui gagnent à disposer d’espace horizontal.

Node.js n’est pas requis pour l’installation recommandée. Il n’intervient que si vous choisissez l’alternative npm décrite plus bas, qui exige Node.js 22 ou une version supérieure depuis la v2.1.198.

Installation

Installez Claude Code avec l’installateur natif, celui que recommande Anthropic³ :

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

Sous Windows, exécutez plutôt irm https://claude.ai/install.ps1 | iex dans PowerShell. L’installateur place le binaire dans ~/.local/bin/claude, et les installations natives se mettent à jour en arrière-plan : vous restez à jour sans mise à niveau manuelle.

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

claude --version

Un numéro de version doit s’afficher sur la sortie standard. Si vous obtenez l’erreur « command not found », c’est que ~/.local/bin ne figure pas dans votre PATH. Ajoutez-le à votre profil shell puis rechargez-le :

# Zsh (macOS default)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Pour un diagnostic plus poussé de votre installation et de votre configuration, lancez claude doctor : la commande vérifie le binaire, le PATH et l’état des mises à jour automatiques, et signale les installations concurrentes, par exemple une copie npm globale oubliée à côté de la version native.

Autres méthodes d’installation. Homebrew convient si vous préférez les casks gérés : brew install --cask claude-code (mise à jour avec brew upgrade --cask claude-code, ou définissez CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 depuis la v2.1.129 pour des mises à jour en arrière-plan via le gestionnaire de paquets). Le paquet npm fonctionne toujours, mais il relève de l’héritage, déprécié depuis la v2.1.15 : npm install -g @anthropic-ai/claude-code (Node.js 22+, jamais avec sudo⁷) ; il installe d’ailleurs le même binaire natif en coulisses. Si vous avez commencé avec npm et souhaitez passer à la configuration recommandée, installez la version native puis supprimez la copie npm avec npm uninstall -g @anthropic-ai/claude-code pour éviter les conflits de versions.

Au premier lancement, Claude Code ouvre votre navigateur pour l’authentification OAuth. Vous vous connectez, vous autorisez l’accès, et Claude Code enregistre l’état d’authentification d’exécution localement dans ~/.claude.json. Vous pouvez sinon 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

Placez-vous dans un répertoire de projet, puis exécutez :

cd ~/Projects/my-app
claude

Claude Code démarre une session REPL interactive et charge au lancement votre CLAUDE.md ainsi que vos paramètres. Dès votre première requête dans un nouveau projet, Claude explore ce dont il a besoin :

1. Il analyse l’arborescence pour comprendre l’organisation du projet
2. Il lit les fichiers de configuration comme package.json, pyproject.toml ou Cargo.toml pour identifier la stack technique
3. Il applique les instructions de votre CLAUDE.md située à la racine, déjà chargée au démarrage

Essayez une requête simple pour vérifier que tout fonctionne :

> Explain the structure of this project

Claude lit vos fichiers, synthétise l’architecture et répond dans le terminal. Vous voyez 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 écriture.

Ce qu’il faut observer pendant votre première session. Prêtez attention à deux choses : les appels d’outils, affichés en temps réel avant chaque action, et les demandes de permission. Les appels d’outils révèlent la façon dont Claude parcourt votre base de code. Vous remarquerez qu’il lit des fichiers auxquels vous n’auriez pas pensé, ce qui fait souvent émerger un contexte utile. Les demandes de permission vous montrent exactement ce que Claude compte modifier avant que quoi que ce soit ne touche le disque. Si une modification proposée semble erronée, refusez-la et apportez des précisions. Claude ajuste son approche en fonction de vos retours au sein de la session⁸.

Configurer CLAUDE.md

CLAUDE.md est de loin le fichier le plus important pour utiliser Claude Code efficacement. Sans lui, Claude déduit votre stack du contenu des fichiers et formule des hypothèses plausibles. Avec lui, Claude suit vos conventions exactes dès la première requête. La différence compte, car un comportement fondé sur la déduction dérive : Claude peut employer CommonJS dans un projet ESM, choisir le mauvais lanceur de tests ou ignorer votre procédure de migration de base de données. CLAUDE.md supprime cette dérive.

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

touch CLAUDE.md

Voici un modèle de départ concret 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 ou TypeScript, la structure est comparable :

# 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 les plus utiles d’un CLAUDE.md sont celles qui empêchent les erreurs répétées. Si Claude importe sans cesse avec require() au lieu d’import, ajoutez « ESM imports only » à Code Standards. Si votre commande de test suppose d’activer d’abord un environnement virtuel, documentez cette séquence. Claude lit CLAUDE.md au début de chaque session : chaque ligne devient donc une instruction persistante dont l’effet se cumule sur des centaines d’interactions. J’explore les schémas qui rendent un fichier CLAUDE.md efficace dans Modèles AGENTS.md, ainsi que le principe plus large selon lequel le contexte est une architecture. La spécification ouverte AGENTS.md⁹ suit un schéma comparable pour d’autres outils agentiques, mais CLAUDE.md prend en charge des fonctionnalités plus riches, comme les skills et les répertoires de règles.

La hiérarchie compte. Vous pouvez placer un CLAUDE.md à trois endroits, que Claude fusionne par ordre de spécificité :

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

Le CLAUDE.md de projet est celui que vous versionnez. 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 l’autonomie laissée à l’agent. Le niveau choisi arbitre un compromis fondamental : plus d’autonomie donne des sessions plus rapides, mais moins de visibilité sur ce qui change.

Le mode Ask (nommé « Manual » dans le CLI depuis la v2.1.200) exige une approbation avant chaque écriture de fichier, chaque exécution de commande et chaque action destructrice. Vous voyez exactement ce que Claude compte faire et validez ou refusez chaque étape. Notez le changement du 14 août 2026 : les sessions Pro, Max et Team démarrent désormais en mode auto, où un classifieur de sécurité examine chaque action au lieu de vous solliciter ; appuyez sur Shift+Tab pour revenir à Manual, ou fixez-le avec "defaultMode": "manual" dans les paramètres. Je recommande toujours de débuter en Manual, car les demandes d’approbation vous apprennent le fonctionnement de Claude Code. Après quelques sessions, vous développez une intuition sur les opérations que l’on peut pré-approuver sans risque et sur celles qui méritent un examen à chaque fois.

Les listes d’autorisation vous permettent de pré-approuver des outils et des motifs précis pour que Claude cesse de demander à chaque fois. Vous les configurez dans le fichier .claude/settings.json de votre projet :

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

La configuration ci-dessus autorise Claude à lire des fichiers, à parcourir la base de code et à lancer vos commandes de test et de migration sans demander. Il demande toujours avant d’écrire des fichiers ou d’exécuter d’autres commandes bash. Remarquez le schéma : les opérations de lecture et les commandes connues pour être sûres passent en liste d’autorisation. Les écritures restent en mode Ask, car vous voulez relire ce que Claude écrit avant que cela n’atteigne le disque.

Ignorer dangereusement les permissions (--dangerously-skip-permissions) désactive les demandes de confirmation ; les commandes de suppression catastrophique restent soumises à confirmation, filet de sécurité ajouté en v2.1.126. Ce drapeau existe exclusivement pour les pipelines CI/CD et les workflows automatisés, là où aucun humain n’est présent pour approuver. Ne l’utilisez jamais en session interactive sur une base de code à laquelle vous tenez.

Le système de permissions rend Claude Code sûr sur de vrais projets. La progression est délibérée : commencez en mode Ask pour comprendre, mettez en liste d’autorisation les opérations devenues répétitives, et laissez les écritures sous contrôle afin de toujours relire les changements avant qu’ils n’aboutissent.

Votre premier hook

Les hooks sont des commandes shell exécutées à des moments précis du cycle de vie de Claude Code⁵. J’ai écrit un tutoriel complet sur les hooks qui construit cinq hooks de production depuis zéro, et mon article sur la création de skills personnalisés aborde le niveau d’automatisation suivant. Les hooks résolvent un problème fondamental des outils fondés sur des LLM : le modèle respecte 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 apportent des garanties déterministes là où le modèle n’offre que du probabiliste. Un hook de formatage lance votre formateur après chaque écriture, à chaque fois, quelle qu’ait été la décision du modèle. Voici un premier hook concret : le formatage automatique des fichiers après que Claude les a modifiés.

Créez ou modifiez le fichier .claude/settings.json de 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 place dans $FILE_PATH 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épart que je recommande :

• PreToolUse sur Bash : bloque les commandes dangereuses comme rm -rf / ou git push --force
• SessionStart : injecte la date du jour, la branche git active ou des variables d’environnement dans le contexte (la sortie standard des hooks SessionStart alimente le contexte de Claude)
• Stop : lance automatiquement votre suite de tests quand Claude termine une tâche

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

Quand les choses tournent mal

Quatre situations reviennent régulièrement pendant la première semaine d’utilisation de Claude Code. Les connaître à l’avance vous épargne du 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 votre modification. Lancez /clear pour réinitialiser le contexte, ou démarrez une nouvelle session. Claude relit CLAUDE.md au début d’une session, pas à chaque requête. Si Claude persiste à ignorer les instructions après une session neuve, vérifiez qu’un CLAUDE.md prioritaire, au niveau utilisateur dans ~/.claude/CLAUDE.md, n’entre pas en conflit avec votre fichier de projet.

Claude effectue une modification que vous n’avez pas approuvée. Si vous avez autorisé un motif trop large, une règle Bash fourre-tout au lieu d’un préfixe étroit comme Bash(python -m pytest:*), Claude peut exécuter des commandes sans demander. Resserrez vos motifs d’autorisation. L’approche la plus sûre : n’autoriser que les opérations de lecture et des commandes nommées explicitement. Si Claude a déjà introduit un changement indésirable, git diff montre exactement ce qui a changé et git checkout -- <file> le rétablit.

La fenêtre de contexte se remplit au cours d’une longue session. Claude Code compacte les messages anciens à mesure que la fenêtre de contexte se remplit (les modèles par défaut disposent de fenêtres de 1 million de tokens à la mi-2026 : la limite arrive donc bien plus tard qu’auparavant), mais le compactage peut faire disparaître des détails importants du début de la conversation. Au-delà de 30 minutes, committez régulièrement vos changements fonctionnels et démarrez une nouvelle session avec /clear. Le contexte neuf relit CLAUDE.md et repart proprement. Je committe après chaque sous-tâche terminée, ce qui me donne à la fois un point de retour arrière et une frontière de session naturelle.

Claude modifie le mauvais fichier ou apporte des changements inutiles. Quand Claude se met à « améliorer » du code que vous ne lui aviez pas demandé de toucher, la cause tient en général à l’ambiguïté de la requête. Plutôt que « 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 précision réduit les effets de bord indésirables. Si Claude a déjà fait des modifications non souhaitées, git diff montre exactement ce qui a changé et git checkout -- <file> rétablit des fichiers isolés sans perdre le reste du travail.

Étapes suivantes

Le parcours ci-dessus couvre l’essentiel : installation, première session, configuration du projet, permissions et un hook de départ. Pour une comparaison de Claude Code avec d’autres outils agentiques, voyez Claude Code vs Codex. Pour la référence complète des 5 systèmes fondamentaux (hiérarchie CLAUDE.md, modèle de permissions complet, architecture des hooks, commandes slash personnalisées et workflows multi-agents), lisez Le guide complet de Claude Code.

Le guide traite de la gestion de la fenêtre de contexte, de la délégation à des sous-agents, de l’activation automatique des skills et des 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 en est la suite naturelle. Pour retrouver rapidement chaque commande, chaque drapeau et chaque raccourci, consultez l’aide-mémoire Claude Code.

Si votre projet est une application iOS ou macOS, le guide du développement iOS avec des agents couvre les schémas Claude Code propres à Apple : l’intégration XcodeBuildMCP pour les builds et les simulateurs, les hooks pour le développement Apple qui protègent .pbxproj des modifications de l’agent, et la série Écosystème Apple consacrée aux App Intents, aux serveurs MCP, aux Foundation Models et au lien entre agent et plateforme au niveau des frameworks.

Références

FAQ

Quels sont les prérequis pour installer Claude Code ?

Il vous faut un compte Anthropic (Pro, Max, Team, Enterprise ou Console : l’offre gratuite n’inclut pas Claude Code) et n’importe quel émulateur de terminal. Claude Code tourne sous macOS 13+, Linux et Windows, en natif ou via WSL. L’installation recommandée passe par l’installateur natif, curl -fsSL https://claude.ai/install.sh | bash, qui ne demande ni Node.js, ni Docker, ni aucun autre runtime. Node.js 22+ n’est nécessaire que si vous optez pour l’alternative npm (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 placé à la racine de votre projet, qui indique à Claude Code votre stack, vos conventions de code et vos commandes courantes. Sans lui, Claude déduit votre configuration du contenu des fichiers et formule des hypothèses plausibles, mais ces hypothèses dérivent d’une session à l’autre. Avec CLAUDE.md, Claude suit vos conventions exactes dès la première requête, à chaque session. Le fichier accepte une hiérarchie à trois niveaux : utilisateur (~/.claude/CLAUDE.md), projet (./CLAUDE.md) et 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 standard de l’API Anthropic⁶. Une session type de 30 à 60 minutes coûte entre 0,50 et 3,00 $ selon la taille de la base de code et le volume généré. Autre possibilité, les formules Max⁶ d’Anthropic (Max 5x à 100 $/mois, Max 20x à 200 $/mois, deux offres individuelles, à la mi-2026) incluent l’usage de Claude Code avec des limites de débit plus élevées. Vous pouvez suivre votre consommation d’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 du terminal dans VS Code, placez-vous dans le répertoire de votre projet et lancez claude exactement comme dans un terminal autonome. Claude Code lit et modifie les fichiers sur le disque : les changements apparaissent donc immédiatement dans vos onglets d’éditeur VS Code. Aucune extension n’est requise pour ce workflow, même s’il existe aussi une extension VS Code dédiée si vous préférez un panneau intégré. Certains développeurs gardent une division de terminal réservée à Claude Code à côté de leur éditeur, ce qui se prête bien à la relecture des changements au fil de l’eau.

Peut-on utiliser Claude Code en toute sécurité 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, associé à des hooks capables de bloquer les opérations dangereuses comme les push forcés ou les commandes shell destructrices, rend Claude Code utilisable 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, puis d’autoriser progressivement les seules opérations en lesquelles vous avez confiance. Le contrôle de version constitue l’ultime filet de sécurité : committez avant toute session Claude Code significative, afin de pouvoir toujours revenir en arrière.

Quelle est l’erreur la plus fréquente chez les nouveaux utilisateurs ?

Donner trop de contexte à Claude dans la requête au lieu de le placer dans CLAUDE.md. Les nouveaux utilisateurs ont tendance à coller l’intégralité de leurs standards de code dans chaque requête, ce qui gaspille la fenêtre de contexte et produit des résultats incohérents d’une session à l’autre. Déplacez une fois pour toutes les instructions récurrentes vers CLAUDE.md et réservez les requêtes aux demandes propres à la session. Deuxième erreur la plus fréquente : autoriser Bash(*) plutôt que des commandes précises. Une autorisation Bash avec joker laisse Claude exécuter n’importe quelle commande shell sans demander, ce qui vide le système de permissions de son sens.