Installation et premier lancement - Aide-memoire

Cet aide-mémoire regroupe toutes les commandes et raccourcis pour installer Claude Code, s'authentifier et explorer un codebase en quelques minutes. Gardez cette fiche pratique sous la main pour configurer votre environnement sans friction et lancer vos premières sessions de développement assisté par IA.

Claude Code est un agent de développement en ligne de commande créé par Anthropic qui s'intègre directement dans votre terminal pour analyser, modifier et générer du code. l'installation et le premier lancement de Claude Code nécessitent Node.js 18+, Git et un compte Anthropic actif. Cette fiche pratique d'installation et premier lancement constitue un aide-mémoire de référence rapide couvrant les commandes essentielles, de la mise en place à la navigation dans votre projet.

Claude Code fonctionne sur macOS, Linux et Windows via WSL2. Le temps d'installation moyen est de 3 à 5 minutes sur une connexion standard.

Quels sont les prérequis système pour installer Claude Code ?

Avant toute installation, vérifiez que votre machine dispose des outils nécessaires. Consultez la checklist d'installation complète pour ne rien oublier.

Prérequis	Version minimale	Commande de vérification	Résultat attendu
Node.js	18.0.0 (recommandé : 22 LTS)	`node --version`	`v22.x.x`
npm	9.0.0+	`npm --version`	`9.x.x` ou supérieur
Git	2.30+	`git --version`	`git version 2.x`
Système	macOS 12+, Ubuntu 20.04+, Windows + WSL2	`uname -a`	Darwin / Linux
RAM	4 Go minimum	`free -h` (Linux)	≥ 4 Go disponibles
Espace disque	500 Mo libres	`df -h`	≥ 500 Mo

Installez Node.js 22 LTS si vous ne l'avez pas encore :

# macOS avec Homebrew
brew install node@22

# Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# Vérification
node --version && npm --version

En pratique, 87 % des erreurs d'installation proviennent d'une version de Node.js inférieure à 18. Exécutez node --version avant de continuer.

Pour résoudre les problèmes courants, le guide de dépannage installation détaille chaque cas d'erreur.

À retenir : Node.js 18+ et Git 2.30+ sont les deux prérequis indispensables - vérifiez-les avec une seule commande avant de lancer l'installation.

Comment installer Claude Code via npm ou en natif ?

L'installation se fait en une seule commande npm. Ouvrez votre terminal et exécutez la commande suivante :

# Installation globale (recommandée)
npm install -g @anthropic-ai/claude-code

# Vérifier l'installation
claude --version

Méthode	Commande	Avantage	Inconvénient
npm global	`npm install -g @anthropic-ai/claude-code`	Accessible partout	Nécessite droits globaux
npx (sans install)	`npx @anthropic-ai/claude-code`	Aucune installation	Plus lent au démarrage
Mise à jour	`npm update -g @anthropic-ai/claude-code`	Dernière version	-
Désinstallation	`npm uninstall -g @anthropic-ai/claude-code`	Nettoyage complet	-

En cas d'erreur de permissions sur macOS ou Linux, utilisez cette approche plutôt que sudo :

# Configurer npm pour éviter sudo
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

# Puis relancer l'installation
npm install -g @anthropic-ai/claude-code

la taille du package Claude Code v2.1 est d'environ 45 Mo. Le téléchargement prend en moyenne 12 secondes sur une connexion à 30 Mbps.

Pour un guide pas à pas avec captures d'écran, consultez le tutoriel d'installation et premier lancement qui couvre chaque étape en détail.

À retenir : une seule commande npm install -g @anthropic-ai/claude-code suffit - privilégiez l'installation globale pour un accès depuis n'importe quel répertoire.

Comment s'authentifier et configurer le flux OAuth ?

Au premier lancement, Claude Code déclenche un flux d'authentification OAuth dans votre navigateur. Lancez simplement claude dans votre terminal :

# Premier lancement - ouvre le navigateur automatiquement
claude

# Si le navigateur ne s'ouvre pas, copiez l'URL affichée
# et collez-la manuellement dans votre navigateur

Voici comment le processus se déroule concrètement :

Exécutez claude dans votre terminal
Le navigateur s'ouvre sur la page de connexion Anthropic
Connectez-vous avec votre compte Anthropic (email ou Google SSO)
Autorisez l'accès pour Claude Code
Le terminal confirme l'authentification avec un message de succès
Votre token est stocké localement dans ~/.claude/

Commande auth	Description	Usage
`claude`	Authentification interactive	Premier lancement
`claude auth login`	Forcer une reconnexion	Token expiré
`claude auth logout`	Supprimer le token local	Changement de compte
`claude auth status`	Vérifier l'état de connexion	Diagnostic
`claude --api-key KEY`	Utiliser une clé API directe	CI/CD, scripts

Le token OAuth a une durée de validité de 30 jours. En pratique, vous n'aurez à vous réauthentifier qu'une fois par mois environ.

Pour les environnements CI/CD, utilisez une variable d'environnement plutôt que le flux interactif :

export ANTHROPIC_API_KEY="sk-ant-..."
claude --print "votre prompt"

Le guide des astuces pour vos premières conversations explique comment tirer le meilleur parti de votre session une fois authentifié.

À retenir : le flux OAuth est automatique au premier claude - votre token reste valide 30 jours, et la variable ANTHROPIC_API_KEY permet de contourner l'authentification interactive.

Quelles sont les commandes essentielles pour le premier lancement ?

Voici les commandes les plus fréquentes à connaître dès votre premier lancement. Ce tableau constitue votre fiche pratique d'installation et premier lancement avec les commandes essentielles.

Commande	Description	Exemple
`claude`	Lancer Claude Code en mode interactif	`claude`
`claude "prompt"`	Envoyer un prompt unique	`claude "explique ce fichier"`
`claude --print`	Mode non-interactif (sortie stdout)	`claude --print "liste les TODO"`
`claude --model`	Choisir le modèle	`claude --model claude-sonnet-4-6`
`claude --verbose`	Activer les logs détaillés	`claude --verbose`
`claude config`	Gérer la configuration	`claude config set theme dark`
`claude update`	Mettre à jour Claude Code	`claude update`
`claude mcp`	Gérer les serveurs MCP	`claude mcp list`

Naviguez d'abord dans le répertoire de votre projet, puis lancez Claude Code :

cd ~/mon-projet
claude
# Claude analyse automatiquement la structure du projet

Le temps de chargement initial d'un projet de 10 000 fichiers est d'environ 8 secondes. Les projets de moins de 1 000 fichiers se chargent en moins de 2 secondes.

La référence des commandes slash essentielles approfondit chaque commande disponible dans la session interactive. Vous pouvez aussi consulter l'aide-mémoire des commandes slash pour une vue d'ensemble rapide.

À retenir : claude seul suffit pour démarrer - ajoutez --print pour du scripting et --verbose pour diagnostiquer un problème.

Comment explorer et comprendre son codebase avec Claude Code ?

Une fois dans une session interactive, Claude Code analyse automatiquement votre codebase. Posez vos questions en langage naturel pour naviguer dans le code.

Action	Prompt exemple	Résultat
Vue d'ensemble	`"Décris l'architecture de ce projet"`	Structure, frameworks, dépendances
Trouver un fichier	`"Où est défini le composant Header ?"`	Chemin et contenu du fichier
Comprendre une fonction	`"Explique la fonction processOrder"`	Explication ligne par ligne
Chercher un bug	`"Pourquoi ce test échoue ?"`	Analyse et suggestion de fix
Analyser les dépendances	`"Liste toutes les dépendances npm"`	Package.json parsé
Résumer les changements	`"Que contient le dernier commit ?"`	Diff commenté

Concrètement, Claude Code lit les fichiers à la demande. Il n'indexe pas tout le codebase au démarrage : il explore de manière contextuelle selon vos questions.

Les commandes slash internes enrichissent l'exploration. Utilisez /init pour créer un fichier CLAUDE.md qui stocke le contexte de votre projet :

# Dans la session Claude Code interactive
> /init
# Génère un CLAUDE.md avec l'architecture détectée

Le système de mémoire CLAUDE.md vous permet de personnaliser durablement le comportement de Claude Code sur votre projet. Plus votre CLAUDE.md est précis, plus les réponses sont pertinentes.

En pratique, un fichier CLAUDE.md bien renseigné réduit de 40 % le nombre de tokens consommés par session selon les retours de la communauté en 2026.

À retenir : posez vos questions en français naturel, et utilisez /init pour créer un fichier CLAUDE.md qui mémorise le contexte de votre projet entre les sessions.

Quels raccourcis clavier maîtriser pour naviguer efficacement ?

Les raccourcis clavier accélèrent votre workflow dans la session interactive Claude Code. Mémorisez ces combinaisons pour gagner en productivité.

Raccourci	Action	Contexte
`Entrée`	Envoyer le message	Ligne simple
`Shift + Entrée`	Nouvelle ligne (sans envoyer)	Message multi-lignes
`Ctrl + C`	Annuler la génération en cours	Pendant une réponse
`Ctrl + D`	Quitter Claude Code	Fin de session
`Ctrl + L`	Effacer l'écran du terminal	Nettoyage visuel
`Tab`	Complétion automatique des chemins	Référence de fichier
`↑ / ↓`	Naviguer dans l'historique des prompts	Réutiliser un prompt
`Échap`	Annuler l'édition en cours	Mode édition
`Échap` (2x)	Retour au mode normal	Depuis un sous-menu

Vous pouvez aussi utiliser des commandes slash directement dans la session pour contrôler le comportement :

Commande slash	Action	Description
`/help`	Afficher l'aide	Liste des commandes
`/clear`	Réinitialiser le contexte	Nouvelle conversation
`/compact`	Compresser le contexte	Libérer des tokens
`/model`	Changer de modèle	Passer de Opus à Sonnet
`/cost`	Voir la consommation	Tokens et coût estimé
`/permissions`	Gérer les autorisations	Lecture/écriture fichiers

Concrètement, la commande /compact réduit le contexte de 60 à 70 %, ce qui vous permet de continuer une longue session sans perte de cohérence.

L'aide-mémoire des permissions et sécurité détaille comment configurer les autorisations de fichiers. Consultez aussi les astuces des commandes slash essentielles pour des usages avancés.

À retenir : Ctrl + C pour annuler, Ctrl + D pour quitter, /compact pour libérer du contexte - ces trois raccourcis couvrent 80 % des besoins de navigation.

Faut-il configurer des paramètres avancés dès le premier lancement ?

Certains paramètres méritent d'être ajustés dès la première session pour optimiser votre expérience. Configurez au minimum le modèle par défaut et les permissions de fichiers.

# Choisir le modèle par défaut
claude config set model claude-sonnet-4-6

# Activer le mode verbose pour le debug
claude config set verbose true

# Définir le répertoire de travail par défaut
claude config set workdir ~/projets

Paramètre	Valeur par défaut	Recommandation	Commande
Modèle	`claude-sonnet-4-6`	Sonnet pour le quotidien, Opus pour le complexe	`claude config set model`
Permissions	Demander à chaque fois	Autoriser lecture auto	`claude config set autoApprove read`
Thème	Système	Selon préférence	`claude config set theme dark`
Langue	English	Français si souhaité	Interface s'adapte au prompt

le modèle Claude Sonnet 4.6 offre un ratio performance/coût optimal pour 90 % des tâches de développement quotidiennes. Le modèle Opus 4.6 excelle sur les tâches de refactoring complexes et d'architecture.

Si vous souhaitez approfondir la configuration, la référence des commandes pour vos premières conversations couvre les options avancées disponibles en session interactive.

À retenir : configurez le modèle par défaut et les permissions de lecture dès la première session - vous gagnerez du temps sur chaque interaction suivante.

Comment aller plus loin après l'installation ?

Une fois Claude Code installé et configuré, vous pouvez exploiter tout le potentiel de l'outil. Voici les prochaines étapes recommandées pour progresser.

Créez votre fichier CLAUDE.md avec /init pour ancrer le contexte projet
Explorez les commandes slash avec /help pour découvrir les fonctionnalités avancées
Testez le mode multi-fichiers en demandant un refactoring sur 2-3 fichiers
Configurez les serveurs MCP pour connecter des outils externes (bases de données, API)
Automatisez avec le mode --print dans vos scripts de CI/CD

En pratique, les développeurs formés chez SFEIR Institute rapportent un gain de productivité de 35 % dès la première semaine d'utilisation de Claude Code dans leur workflow quotidien.

Pour maîtriser Claude Code en conditions réelles, la formation Claude Code de SFEIR Institute propose une journée intensive avec des labs pratiques couvrant l'installation, la configuration et les cas d'usage avancés. Si vous souhaitez intégrer Claude Code dans un workflow complet de développement assisté par IA, la formation Développeur Augmenté par l'IA de 2 jours couvre l'ensemble des outils et méthodologies.

Les développeurs expérimentés peuvent directement accéder à la formation Développeur Augmenté par l'IA – Avancé d'une journée pour approfondir les techniques de prompt engineering et d'orchestration multi-agents.

À retenir : l'installation n'est que le début - investissez 15 minutes dans la configuration de CLAUDE.md et des permissions pour transformer Claude Code en véritable copilote de développement.