Claude Code est un agent de développement IA créé par Anthropic qui fonctionne entièrement dans votre terminal. Contrairement aux extensions IDE classiques, il opère en ligne de commande, lit votre codebase, exécute des commandes shell, édite des fichiers et gère vos commits Git — le tout piloté par le modèle Claude. Voici un guide complet pour l'installer, le configurer et en tirer le maximum au quotidien.
Installation et premiers pas
Claude Code nécessite Node.js 18+ et un compte Anthropic avec une clé API ou un abonnement Claude Pro/Max. L'installation se fait en une seule commande :
npm install -g @anthropic-ai/claude-codeUne fois installé, lancez-le dans n'importe quel répertoire de projet :
# Se placer dans votre projet
cd ~/projects/mon-app
# Lancer Claude Code
claudeAu premier lancement, Claude Code vous demandera de vous authentifier. L'outil va scanner la structure de votre projet pour comprendre le contexte : arborescence des fichiers, package.json, fichiers de configuration, et plus encore. Cette compréhension contextuelle est ce qui le distingue d'un simple chatbot.
Le fichier CLAUDE.md : votre arme secrète
Le fichier CLAUDE.md est le mécanisme de mémoire persistante de Claude Code. Placé à la racine de votre projet, il est lu automatiquement à chaque session. C'est ici que vous définissez les conventions, la stack technique, les commandes utiles et les règles spécifiques à votre projet.
# Mon Projet - Instructions Claude
## Stack Technique
- Frontend : Angular 19, PrimeNG, Tailwind CSS 4
- Backend : NestJS 11, Mongoose 8
- Tests : Vitest (frontend), Jest (backend)
## Conventions
- Langue du code : anglais
- Commits : Conventional Commits (feat:, fix:, chore:)
- Components Angular : standalone uniquement
- Chaque route doit avoir des meta tags SEO
## Commandes utiles
- `npm run start:frontend` — Serveur de dev Angular
- `npm run start:backend` — Serveur de dev NestJS
- `npm run test` — Lancer tous les tests
## Règles importantes
- Ne jamais modifier les fichiers dans /config/production/
- Toujours ajouter des tests pour les nouveaux services
- Les DTOs doivent utiliser class-validatorVous pouvez aussi créer un fichier CLAUDE.md dans votre répertoire utilisateur (~/.claude/CLAUDE.md) pour des instructions globales qui s'appliquent à tous vos projets. La hiérarchie est : instructions globales → instructions projet → instructions sous-dossier.
Les slash commands essentielles
Claude Code propose des commandes intégrées accessibles via le préfixe /. Voici les plus utiles au quotidien :
# Demander un résumé du projet et de ses dépendances
/init
# Effacer le contexte de conversation
/clear
# Voir les coûts de la session en cours
/cost
# Gérer la mémoire persistante du projet
/memory
# Lancer un commit intelligent
/commitLa commande /commit est particulièrement puissante : Claude Code exécute un git diff, analyse toutes les modifications, rédige un message de commit structuré avec un résumé pertinent, puis crée le commit après votre validation.
Workflow quotidien : exemples concrets
Refactoring d'un service existant
Supposons que vous ayez un service NestJS monolithique à découper. Vous pouvez simplement décrire l'objectif :
> Refactore le fichier src/modules/articles/articles.service.ts.
Extrais la logique de scraping dans un nouveau service ScrapingService,
et la logique de résumé IA dans un AiSummaryService.
Mets à jour les imports et le module correspondant.
Ajoute les tests unitaires pour chaque nouveau service.Claude Code va lire le fichier source, identifier les responsabilités, créer les nouveaux fichiers, mettre à jour le module NestJS, ajuster les imports et générer les fichiers de test — le tout en plusieurs étapes visibles dans votre terminal.
Debugging avec contexte complet
> J'ai cette erreur quand je lance npm run build :
ERROR in src/app/features/home/home.component.ts:42:15
Type 'Observable<Article[]>' is not assignable to type 'Signal<Article[]>'
Corrige le problème en gardant l'approche Signal.Claude Code va lire le fichier concerné, comprendre le pattern architectural, et proposer la correction appropriée — par exemple, utiliser toSignal() du package @angular/core/rxjs-interop.
Hooks : automatiser les contrôles qualité
Les hooks Claude Code permettent d'exécuter automatiquement des vérifications avant ou après certaines actions. Ils se configurent dans le fichier .claude/settings.json :
{
"hooks": {
"pre-commit": {
"command": "npm run lint && npm run typecheck",
"description": "Vérifie le linting et le typage avant chaque commit"
},
"post-edit": {
"command": "npx prettier --write $FILE",
"description": "Formate automatiquement les fichiers modifiés"
}
}
}MCP Servers : étendre les capacités
Le protocole MCP (Model Context Protocol) permet de connecter Claude Code à des outils externes. Vous pouvez configurer des serveurs MCP dans .claude/settings.json :
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp@latest"],
"description": "Documentation à jour des librairies"
},
"sequential-thinking": {
"command": "npx",
"args": ["-y", "@anthropic/sequential-thinking-mcp"],
"description": "Raisonnement structuré pour les problèmes complexes"
}
}
}Le serveur Context7 fournit à Claude Code la documentation à jour de vos dépendances, évitant les hallucinations liées à des API obsolètes.
Utilisation non interactive et intégration CI/CD
# Exécuter une tâche unique sans mode interactif
claude -p "Ajoute des JSDoc à toutes les fonctions exportées dans src/utils/"
# Avec un fichier d'entrée
cat bug-report.txt | claude -p "Analyse ce rapport de bug et propose un fix"
# En format JSON pour l'intégration dans des scripts
claude -p "Liste les TODO du projet" --output-format jsonBonnes pratiques et conseils
- Soyez précis dans vos demandes : « Refactore ce fichier » est moins efficace que « Extrais les fonctions utilitaires de ce fichier dans un module séparé avec des tests ».
- Maintenez votre CLAUDE.md à jour : c'est la mémoire de votre projet. Plus il est détaillé, plus Claude Code sera pertinent.
- Utilisez /clear régulièrement : un contexte trop long peut diluer la pertinence des réponses.
- Vérifiez toujours le code généré : Claude Code est un outil puissant, mais la revue humaine reste indispensable.
- Combinez avec Git : travaillez sur des branches dédiées quand vous laissez Claude Code faire des modifications importantes.
Claude Code représente une nouvelle approche du développement assisté par IA. En opérant directement dans le terminal, il s'intègre naturellement dans le workflow des développeurs. Le système de CLAUDE.md, les hooks et les MCP servers en font un outil hautement personnalisable qui s'adapte à n'importe quel projet.
