Comment configurer Claude Code CLI : démarrage rapide en 5 minutes
Plus de 29 000 développeurs chez ServiceNow utilisent désormais Claude Code au quotidien, et Allianz l’a déployé à l’échelle de toute l’entreprise début 2026. La courbe d’adoption de l’outil reflète une tendance : une fois que les développeurs essaient le codage agentique dans leur propre terminal, ils ne reviennent plus au copier-coller depuis des fenêtres de chat. Ce guide de démarrage rapide vous fait passer de zéro à une session Claude Code fonctionnelle en environ cinq minutes, avec une configuration réelle que vous pourrez continuer à utiliser ensuite.
En résumé : 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 d’une session à l’autre.
Points clés
- Développeurs solo : CLAUDE.md et un hook de formatage couvrent 80 % de vos besoins. Commencez avec les permissions par défaut et pré-approuvez les outils au fur et à mesure que vous gagnez en confiance.
- Responsables d’équipe : Committez
.claude/settings.jsondans votre dépôt pour que toute l’équipe partage les mêmes listes d’autorisations et hooks. - Ingénieurs sécurité : Le modèle de permissions à trois niveaux (par défaut, pré-approuvé, ignorer) correspond directement à des niveaux de confiance. Le mode par défaut exige une approbation explicite pour chaque écriture et chaque commande.
Prérequis
Vous avez besoin de trois éléments avant d’installer Claude Code :
Node.js 18 ou version ultérieure. Claude Code est distribué sous forme de paquet npm. Vérifiez votre version :
node --version
# v18.0.0 or higher
Si vous devez installer ou mettre à jour 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 Paramètres > Clés API. Claude Code est facturé sur votre solde API ou votre abonnement Max. Gardez la clé à portée de main 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 affiché dans stdout. Si vous obtenez une erreur « command not found », assurez-vous que le répertoire global bin de npm est dans votre PATH. Exécutez npm config get prefix et ajoutez le sous-répertoire /bin de cette sortie à votre PATH.
Au premier lancement, Claude Code ouvre votre navigateur vers la console Anthropic pour l’authentification OAuth. Vous vous connectez, autorisez l’accès, et le jeton est stocké localement dans ~/.claude/. Vous pouvez également définir la variable d’environnement ANTHROPIC_API_KEY avant le lancement. Dans les deux cas, les identifiants restent sur votre machine et ne sont utilisés que pour authentifier les requêtes API.
Première session
Naviguez vers 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, il effectue automatiquement plusieurs actions :
- Analyse la structure des répertoires pour comprendre l’organisation du projet
- Lit les fichiers de configuration comme
package.json,pyproject.tomlouCargo.tomlpour identifier la stack technique - Recherche un fichier CLAUDE.md à la racine du projet pour les 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.
Configuration de CLAUDE.md
CLAUDE.md est le fichier le plus important pour une utilisation efficace de Claude Code. Il se trouve à la racine de votre projet et contient les instructions que Claude lit au début de chaque session. Considérez-le comme un README pour votre collaborateur IA.
Créez le fichier :
touch CLAUDE.md
Voici un modèle de départ pratique :
# My App
## Project Context
Express.js API with React frontend. PostgreSQL database.
## Stack
- Backend: Node.js 20, Express 4, TypeScript
- Frontend: React 18, Vite
- Database: PostgreSQL 16, Prisma ORM
- Testing: Vitest for unit tests, Playwright for e2e
## Code Standards
- Use async/await, never raw Promises
- 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
D’après mon expérience, les sections les plus précieuses sont celles qui préviennent les erreurs récurrentes. Si Claude utilise systématiquement CommonJS alors que votre projet utilise ESM, ajoutez-le dans CLAUDE.md. S’il existe une commande de test spécifique ou une étape de configuration de base de données, documentez-la. Claude lit CLAUDE.md à chaque session, donc tout ce que vous y inscrivez devient une instruction persistante.
Vous pouvez également placer un CLAUDE.md dans votre répertoire personnel (~/.claude/CLAUDE.md) pour des instructions globales applicables à tous vos projets, et dans des sous-répertoires pour un contexte qui ne s’applique qu’à des parties spécifiques d’un monorepo.
Les bases des permissions
Claude Code fonctionne selon trois niveaux de permissions qui déterminent le degré d’autonomie de l’agent :
Le mode par défaut demande la permission 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 par ce mode.
Les permissions pré-approuvées vous permettent d’ajouter à une liste blanche des outils et des motifs spécifiques pour que Claude ne demande pas à chaque fois. Vous les configurez dans le fichier .claude/settings.json de votre projet :
{
"permissions": {
"allow": [
"Read",
"Glob",
"Grep",
"Bash(npm test)",
"Bash(npx prisma migrate dev)"
]
}
}
Cet exemple autorise Claude à lire des fichiers, rechercher dans le code source, et exécuter vos commandes de test et de migration sans demander. Il continue de demander avant d’écrire des fichiers ou d’exécuter toute autre commande bash.
Ignorer dangereusement les permissions (--dangerously-skip-permissions) désactive toutes les invites de confirmation. Ce drapeau est destiné exclusivement aux pipelines CI/CD et aux workflows automatisés où aucun humain n’est présent pour approuver. Ne l’utilisez jamais en sessions interactives sur un code source auquel vous tenez.
Le système de permissions est la raison pour laquelle Claude Code peut être utilisé en toute sécurité sur de vrais projets. Commencez en mode par défaut, observez quelles approbations deviennent répétitives, et pré-approuvez sélectivement ces opérations spécifiques.
Votre premier hook
Les hooks sont des commandes shell qui s’exécutent à des moments spécifiques du cycle de vie de Claude Code. Ils fournissent des garanties déterministes par-dessus le comportement probabiliste du LLM. 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"
}
]
}
]
}
}
Ce hook se déclenche après chaque appel aux outils Edit ou Write. Claude Code définit $FILE_PATH comme le fichier qui a été modifié. Prettier le formate sur place, et || true garantit que le hook 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 /ougit push --force - SessionStart : Injecter la date courante, la branche Git active ou des 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.
Étapes suivantes
Ce guide de démarrage rapide couvre l’essentiel : l’installation, votre première session, la configuration du projet, les permissions et un hook de démarrage. Pour la référence complète couvrant les 5 systèmes fondamentaux (hiérarchie CLAUDE.md, le modèle complet de permissions, l’architecture des hooks, les commandes slash personnalisées et les workflows multi-agents) consultez Le guide complet de Claude Code.
Le guide couvre la gestion de la fenêtre de contexte, la délégation aux sous-agents, l’auto-activation des skills, et les patterns qui émergent après des mois d’utilisation quotidienne de Claude Code. Si ce guide de démarrage rapide vous a été utile, le guide complet est la suite logique.
FAQ
Combien coûte Claude Code ?
Claude Code propose deux modèles de facturation. Le modèle API à la consommation facture par jeton aux tarifs standard de l’API Anthropic. Une session typique de 30 à 60 minutes coûte entre 0,50 $ et 3,00 $ selon la taille du code source et le volume de génération. Alternativement, le plan Max d’Anthropic (100 $/mois individuel, 200 $/mois équipes) inclut l’utilisation de Claude Code avec des limites de débit plus élevées. Vous pouvez suivre votre consommation 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, naviguez vers le répertoire de votre projet et exécutez claude exactement comme vous le feriez dans un terminal autonome. Claude Code lit et modifie les fichiers sur le disque, donc les changements apparaissent immédiatement dans vos onglets de l’éditeur VS Code. Aucune extension VS Code séparée n’est nécessaire. Certains développeurs gardent un split terminal dédié à Claude Code à côté de leur éditeur, ce qui fonctionne bien pour examiner les modifications en temps réel.
Claude Code est-il sûr pour les codebases de production ?
Le mode de permissions par défaut de Claude Code demande 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é aux hooks capables de bloquer les opérations dangereuses comme les force pushes ou les commandes shell destructives, rend l’outil adapté au travail en production. J’utilise Claude Code quotidiennement sur des projets qui servent de vrais utilisateurs. L’essentiel est de commencer en mode par défaut, de comprendre ce que fait chaque appel d’outil avant de l’approuver, et de ne pré-approuver progressivement que les opérations auxquelles vous faites confiance. Le contrôle de version est votre dernier filet de sécurité : faites un commit avant de démarrer toute session Claude Code significative pour pouvoir toujours revenir en arrière.