Fondations : bien démarrer avec Claude Code
Avant de plonger dans les astuces avancées, il faut poser les bases. Ces premiers tips concernent le setup initial - des choses simples qui évitent beaucoup de frustration ensuite.
Lancer Claude Code depuis la racine du projet
Toujours lancer claude depuis le répertoire racine de votre projet. Claude Code va "zipper" le contexte de ce répertoire dans le premier token - c'est pour ça que vous voyez des tokens utilisés même avant d'avoir tapé quoi que ce soit. Si vous avez des fichiers de règles (CLAUDE.md), c'est de là qu'ils seront lus.
Exécuter /init immédiatement
La commande /init analyse votre codebase et crée un fichier CLAUDE.md initial dans le répertoire .claude/. Claude identifie l'architecture (Next.js 15, Swift UI, etc.), les patterns et les dépendances. C'est indispensable pour les nouveaux projets.
Comprendre la hiérarchie des fichiers de règles
Il existe deux niveaux de CLAUDE.md :
- Projet - dans
.claude/CLAUDE.mddu répertoire courant (règles spécifiques au projet) - Global - dans
~/.claude/CLAUDE.md(règles qui s'appliquent à tous vos projets)
La commande /memory permet de visualiser quelles règles sont actives.
Le fichier CLAUDE.md : votre arme secrète
Pour 80% des utilisateurs, un bon CLAUDE.md suffit à obtenir d'excellents résultats sans toucher aux fonctionnalités avancées. C'est le levier le plus puissant.
Garder le fichier compact
Viser environ 300 lignes. Plus le fichier est gros, plus il consomme de tokens et plus l'IA risque d'ignorer certaines instructions. Un fichier concis et précis bat un fichier exhaustif et verbeux.
Que mettre dedans
- Architecture technique - stack, framework, structure de fichiers
- Contexte domaine - Swift UI, Next.js, etc.
- Design patterns - conventions spécifiques au projet
- Boucle de build/validation - comment compiler, tester, vérifier
La boucle de validation est cruciale
C'est probablement le conseil le plus important de toute la vidéo. Avoir des commandes de build et de validation dans le CLAUDE.md permet à Claude de s'auto-corriger en boucle. Si vous vous demandez pourquoi l'IA ne produit pas du code qui fonctionne du premier coup, c'est souvent parce qu'il manque cette boucle de feedback.
# Exemple de section validation dans CLAUDE.md
## Build & Validation
1. xcodebuild -scheme MonApp -destination 'platform=iOS Simulator'
2. Verifier que le build compile sans erreur
3. Si erreur, corriger et reprendre a l'etape 1Priorité de haut en bas
Le CLAUDE.md est lu de haut en bas, avec une priorité décroissante. Placez les règles les plus importantes en premier. Utilisez des formulations fortes : "Ne JAMAIS faire X" et "TOUJOURS faire Y".
Ajouter des exemples de code
Si votre projet utilise des patterns maison (DSL, conventions internes), ajoutez des snippets concrets. L'IA est entraînée sur du code public - elle ne connait pas vos conventions spécifiques. À chaque erreur répétée, mettez à jour le CLAUDE.md pour éviter qu'elle ne se reproduise.
Faire mettre à jour les règles par Claude lui-même
Ne modifiez jamais le CLAUDE.md manuellement. Demandez à Claude : "Mets à jour les règles pour qu'on ne refasse plus cette erreur." C'est plus rapide et ça garantit la cohérence du fichier.
Compound engineering : committer le CLAUDE.md
Une fois votre CLAUDE.md mature, committez-le dans le repo pour que vos collègues en bénéficient. Attention : retirez les chemins absolus et les infos personnelles, et gardez le fichier compact - chaque coéquipier chargera ce contexte à chaque session.
Raccourcis clavier essentiels
Si vous passez des heures dans Claude Code, ces raccourcis deviennent des réflexes.
Shift+Tab : basculer entre plan et edit
Shift+Tab bascule entre le mode plan (lecture seule, pas de modifications de fichiers) et le mode édit (accepte les modifications). L'auteur utilise le plan mode presque exclusivement au début de chaque feature.
Escape : interrompre Claude
Si Claude part dans une mauvaise direction, appuyez sur Escape pour l'interrompre. N'ayez pas peur de le faire - Claude Code géré bien la reprise. Vous pouvez appuyer sur Up pour re-éditer votre dernier prompt, ou simplement donner une nouvelle instruction.
Double Escape : effacer ou revenir en arrière
- Avec du texte dans l'input - double Escape efface tout le contenu
- Input vide - double Escape permet de revenir en arrière (rewind) à un point précédent de la conversation et restaurer ce contexte
Screenshots : glisser-déposer
Prenez une capture d'écran et glissez-la directement dans le terminal Claude Code. Indispensable pour le travail UI/UX. Combinez avec un MCP Figma pour des boucles de validation visuelles.
Commandes slash essentielles
/clear - repartir de zéro
Efface le contexte actuel. Utile quand vous changez de feature et que l'ancien contexte risque de polluer le nouveau. Équivalent à ouvrir une nouvelle instance Claude.
/context - auditer votre contexte
Affiche une représentation visuelle du contexte actuel. Si Claude Code régresse en qualité ou si vos coûts explosent, regardez quels éléments consomment le plus de tokens. Les MCPs sont souvent les plus gros consommateurs.
/compact - compresser le contexte
Compacte (résume) votre conversation actuelle. Claude Code fait ça automatiquement lors des longues sessions. L'auteur l'utilise rarement, sauf pour sauvegarder un état dans son "second brain" (voir plus bas).
/models - changer de modele
Permet de basculer entre Opus, Sonnet et Haïku. L'auteur recommandé Opus des que possible - la qualité de raisonnement compense largement la latence supplémentaire.
/resume - récupérer une session perdue
Si vous fermez accidentellement une instance, /resume restaure le contexte de la session précédente. Un filet de sécurité pour ne pas perdre un contexte qu'on a mis du temps à construire.
/mcp - gérer les MCPs
Liste les MCPs installes. L'auteur est minimaliste avec les MCPs : il n'installe que ceux strictement nécessaires pour le projet en cours, car ils gonflent la fenêtre de contexte. Pour certains projets (Xcode, Next.js), ils sont incontournables.
Git comme filet de sécurité
Utilisez des skills git pour que Claude géré vos commits, summaries et test plans. Le rewind de Claude Code est un dernier recours - git reste plus fiable pour les checkpoints.
Workflows : comment travailler efficacement
Toujours commencer en plan mode
L'auteur ne démarre jamais une feature en mode édit. Il commence toujours en plan mode, itere avec Claude, argumente, challenge les propositions. La génération de code est la partie facile - construire le bon contexte est le vrai travail.
Un contexte frais bat un contexte bloque
"Context is best served fresh and condensed." Évitez les sessions où vous enchaînez "essaie ceci", "non essaie ça", "reviens en arrière". Le contexte se pollue et l'IA se perd. Mieux vaut investir du temps dans la planification initiale et exécuter proprement.
Persister le contexte : le concept de "second brain"
L'idée : sauvegarder l'état de votre travail dans un fichier local (par exemple .claude/CLAUDE.md du projet) à la fin d'une session. Au début de la session suivante, chargez ce contexte à la demande (lazy loading). Ça permet de basculer entre projets sans perdre le fil.
# Fin de session
"Sauvegarde le travail qu'on vient de faire dans mon CLAUDE.md local"
# Debut de session suivante
"Charge mon contexte depuis mon repertoire local"Tracker ses todos dans Claude Code
Plutôt que d'utiliser un outil externe (Asana, Jira), l'auteur garde ses to-dos directement dans son fichier de contexte local, en lazy loading. Ça fonctionne pour des projets personnels ; pour le travail en équipe, utilisez un MCP connecté à votre outil de gestion.
La boucle de build : pensez validation
Au-delà du simple build, pensez aux boucles de validation avancées :
- Debugging - demander à Claude d'ajouter des logs, lancer l'app, lire les logs, debugger
- Performance - brancher un MCP Perfetto, faire un run, lire les traces
- Web - utiliser Puppeteer ou
/chromepour naviguer et valider visuellement - Tests - intégration end-to-end, tests unitaires automatiques
Utiliser Opus quand c'est possible
Opus est plus lent mais la qualité de raisonnement est supérieure. Comme l'auteur travaille avec plusieurs instances en parallèle, la latence n'est pas un problème - pendant qu'une instance réfléchit, il travaille dans une autre.
Interrompre les mauvaises hypothèses
Surveillez les mots-clés dans le "thinking" de Claude : "je ne suis pas sur", "je suppose que". Si vous voyez des hypothèses incorrectes ou des erreurs en cascade, interrompez immédiatement avec Escape et corrigez le cap.
Composabilite : skills, MCPs et sub-agents
Claude Code repose sur quatre primitives composables. Comprendre comment elles s'emboitent est la clé pour devenir un power user.
Skills : des workflows récurrents
Un skill est un fichier .md qui définit un workflow réutilisable. Pour en créer un, faites le workflow manuellement une fois, puis dites à Claude : "Sauvegarde ce qu'on vient de faire dans un nouveau skill appelé X."
Derrière le rideau, c'est un fichier Markdown avec un system prompt. Claude le détecte automatiquement grâce aux répertoires de skills et aux descriptions. Depuis un changement récent d'Anthropic, skills et slash commands sont désormais interchangeables - un skill crée est aussi accessible via /nom-du-skill.
Ne jamais créer les skills manuellement
Prenez l'habitude de demander à Claude de créer et mettre à jour les skills. Par exemple : "Étends le skill fetch-hackernews pour chercher aussi sur Twitter et Apple News." Claude met à jour le fichier .md du skill.
MCPs : avec parcimonie
Astuce : pas besoin de chercher un MCP sur le web. Dites à Claude "Trouve-moi un bon MCP Figma" - et demandez-lui de l'installer aussi. Mais attention : les MCPs gonflent votre contexte. N'installez que ceux indispensables pour le projet en cours.
Sub-agents : pour le travail atomique
Les sub-agents exécutent des tâches en parallèle et protègent votre fenêtre de contexte. Mais l'auteur met en garde : beaucoup de gens les utilisent mal.
Un sub-agent ne ramène que son output, pas le chemin qu'il a pris pour y arriver. Si une tâche à besoin du contexte complet (tests qui doivent connaitre le code, debugging qui nécessite l'historique), gardez-la dans la session principale.
Les bons cas d'usage pour les sub-agents :
- Tâches atomiques et isolées
- Side effects qui n'ont pas besoin du contexte principal
- Investigations en parallèle
Les mauvais cas d'usage : "CEO agent", "product agent", "design agent" - ces rôles multi-agents dispersent le contexte au lieu de le concentrer.
Le principe : amener le travail au contexte
Plutôt que d'éparpiller le contexte entre plusieurs agents, ramenez le travail vers une fenêtre de contexte condensée et fraiche. C'est le principe directeur.
Workflows avances : développer en parallèle
Plusieurs instances Claude Code simultanées
C'est le game changer selon l'auteur. Avec iTerm2, il ouvre plusieurs panneaux (Cmd+D) et jongle entre les instances :
- Instance 1 : développe une feature en plan mode
- Instance 2 : fait une investigation d'architecture
- Instance 3 : travaille sur un autre projet
Navigation rapide entre les panneaux avec Cmd+[ et Cmd+]. Entre les onglets avec Cmd+Shift+[/]. Il compare ça à jouer à Starcraft : donner un ordre à une unité, passer à la suivante, revenir vérifier.
Notifications sonores
Activez un son de notification quand Claude termine une exécution. Ça permet de savoir quand revenir à un onglet. L'auteur a même teste du text-to-speech pour résumer le résultat, mais c'était trop intrusif.
Git worktrees pour le code en parallèle
Si vous lancez plusieurs instances sur le même projet, elles vont entrer en conflit sur les fichiers. La solution : git worktrees, qui permet de cloner plusieurs copies de travail du même repo avec des branches séparées.
/chrome : naviguer le web depuis Claude Code
/chrome ouvre un navigateur que Claude peut contrôler - prendre des screenshots, cliquer, taper du texte, naviguer. Idéal quand vous n'avez pas d'API mais que vous pouvez accéder au service via le web. Et c'est composable : un skill peut lancer Chrome, scraper des données, et revenir avec les résultats.
Hooks : automatiser les actions pré/post exécution
Comme les hooks git (pré-commit, post-commit), Claude Code permet de définir des actions avant et après chaque exécution. Cas d'usage typiques :
- Post-exécution - linting automatique, formatage du code
- Pré-exécution - bloquer les commandes destructrices (
rm -rf, suppressions de base de données)
Demandez à Claude de les configurer pour vous - ne les maintenez pas manuellement.
Le mode dangerously-skip-permissions
claude --dangerously-skip-permissions désactivé les confirmations. Pratique pour les environnements jetables, mais risque : l'auteur a du reflasher des machines Linux après des commandes trop agressives. Utilisez /permissions pour garder des gardes-fous sur les opérations destructrices.
Plugins : le meilleur des composables
Un plugin est une combinaison de skills, MCPs, sub-agents et scripts bash. Anthropic propose un écosystème de plugins téléchargeable, et la communauté partage les siens. Explorez ce qui existe avant de réinventer.
Context is king
Le message central de cette vidéo tient en une phrase : donnez à Claude le contexte dont il a besoin, et rien de plus.
- Gardez le contexte frais - commencez en plan mode, validez, puis exécutez
- Gardez le contexte condense - évitez les MCPs inutiles, compactez, utilisez /clear
- Gardez le contexte pertinent - lazy loading, second brain, skills cibles
Claude Code est un outil de context engineering avec un agent code autour. Toutes les commandes slash, les skills, les sub-agents - tout est là pour gérer cette fenêtre de contexte. Maitrisez ça, et vous exploiterez Claude Code à son plein potentiel.