01 - Installer et configurer Claude Code
Ce que tu vas apprendre
- Installer Claude Code CLI et le connecter a ton compte
- Choisir le bon modèle selon la tache
- Configurer les permissions pour éviter les mauvaises surprises
- Installer l'extension VS Code et le plugin JetBrains
Prerequisites
- 00 - Introduction
- Node.js 18+ installe
Installation
Claude Code est un package npm. Une commande et c'est regle :
bashnpm install -g @anthropic-ai/claude-code
Première chose apres l'install : lance claude dans ton terminal. La première exécution te guide pour connecter ton compte Anthropic. Tu as deux options : utiliser ton abonnement Claude Pro/Max, ou configurer une clé API directement.
Si tu choisis la clé API :
bashexport ANTHROPIC_API_KEY="sk-ant-..."
Mets ca dans ton .bashrc ou .zshrc pour ne pas avoir a le refaire a chaque session. Personnellement, j'utilise l'abonnement Max. Le forfait inclut un quota genereux et tu ne te retrouves pas avec une facture surprise apres une grosse session de refactoring.
Choisir le bon modèle
Claude Code donne acces a plusieurs modèles. Le choix depend de ce que tu fais :
Opus 4.6 : le modèle par défaut pour les taches complexes. Refactoring multi-fichiers, architecture, debug de problèmes subtils. C'est celui que j'utilise 80% du temps. Il est plus lent, mais il se trompe moins sur les taches qui demandent de la reflexion.
Sonnet : plus rapide, moins cher. Parfait pour les modifications simples, le scaffolding, la génération de tests unitaires repetitifs. Quand je sais exactement ce que je veux et que j'ai juste besoin d'un executant rapide, je bascule dessus avec /model sonnet.
Haiku : le modèle le plus leger. Je ne l'utilise presque jamais directement, mais Claude Code l'utilise en interne pour certains hooks (on verra ca dans l'article sur les hooks).
Tu peux changer de modèle en cours de session :
bash/model opus
/model sonnet
Mon conseil : reste sur Opus par défaut. La différence de coût est negligeable comparee au temps que tu perds quand un modèle moins capable fait une erreur sur un refactoring complexe.
Les modes de permission
C'est le reglage le plus important a comprendre avant de laisser Claude travailler. Trois modes existent :
Plan mode (/plan) : Claude analyse et propose, mais n'exécuté rien. Il te montre les fichiers qu'il veut modifier, les commandes qu'il veut lancer, et attend ta validation. C'est le mode découverte. Utilise-le la première semaine pour comprendre comment Claude raisonne.
Mode par défaut : Claude demande confirmation avant chaque action sensible (écriture de fichier, exécution de commande). Tu valides au cas par cas. C'est le mode que j'utilise au quotidien.
Auto-accept (--auto-accept ou /auto) : Claude exécuté tout sans demander. Utile quand tu lui fais confiance sur une tache bien définie ("ecris les tests pour tous les fichiers du dossier utils"). Dangereux si tu lui donnes une instruction vague.
Il y a aussi --dangerously-skip-permissions qui bypass toutes les protections. Le nom est explicite. Je ne l'utilise que dans des conteneurs Docker jetables pour du CI.
Les commandes de base
Quelques commandes a connaître des le premier jour :
bash/help # Liste toutes les commandes disponibles
/config # Voir et modifier la configuration
/cost # Combien tu as depense sur cette session
/compact # Compacter le contexte quand la session devient longue
/checkpoint # Creer un point de restauration git
/rewind # Revenir au dernier checkpoint si ca part en vrille
/fast # Toggle le mode rapide (meme modele, sortie acceleree)
La commande /cost est ton meilleur ami. Verifie régulièrement combien une session consomme. Ca t'évité les surprises et ca t'apprend a formuler des demandes plus efficaces.
VS Code et JetBrains
Claude Code n'est pas limite au terminal. L'extension VS Code s'installe depuis le marketplace :
- Cherche "Claude Code" dans les extensions VS Code
- Installe, redemarre
- Claude apparaît dans le panneau lateral
L'avantage de l'intégration VS Code : tu vois les modifications en temps réel dans l'éditeur. Les diffs s'affichent directement, tu peux accepter ou rejeter chaque changement individuellement. C'est plus confortable que le terminal pour les gros refactorings.
Pour JetBrains (IntelliJ, WebStorm, PyCharm), le plugin est disponible dans le marketplace JetBrains. Meme principe, meme fonctionnalités.
Mon usage perso : je lance Claude Code dans le terminal intégré de VS Code. J'ai le meilleur des deux mondes. Le contrôle du terminal avec la visibilité de l'éditeur. Quand Claude edite un fichier, je vois le diff instantanement dans l'onglet a cote.
Premier test
Ouvre un terminal dans un projet existant et lance :
bashclaude
Puis demande quelque chose de simple :
Lis le fichier package.json et dis-moi quelles sont les dependances principales de ce projet.Claude va lire le fichier, analyser les dépendances, et te faire un résumé. Si ca marche, ton setup est bon. Dans le prochain article, on configure CLAUDE.md pour que Claude comprenne vraiment ton projet, pas juste tes fichiers.
Article précédent : 00 - Introduction
Article suivant : 02 - CLAUDE.md : donner un cerveau persistant a ton IA