Configuration du projet — Claude Code en action

Travailler avec Claude Code est bien plus intéressant sur un projet concret. Sur un dossier vide, l’outil ne peut rien montrer de ce qui fait sa valeur : rien à lire, rien à exécuter, aucune convention à respecter, aucun historique à consulter. Cette leçon prépare le projet sur lequel vous ferez les exercices du cours, et pose les trois réglages qui comptent dès la première session : la confiance accordée au dossier, le mode de permission et le fichier CLAUDE.md.

Utiliser votre propre projet

La meilleure façon de suivre ce cours est d’utiliser votre propre base de code. Claude Code brille sur du vrai code, vos fichiers, votre architecture, vos conventions, y compris celles que personne n’a jamais écrites nulle part. C’est aussi le seul moyen d’évaluer honnêtement l’outil : une démonstration sur un projet jouet ne vous dira rien de son comportement sur un dépôt de trois ans avec ses zones obscures.

Placez-vous à la racine du projet, là où se trouvent package.json, pyproject.toml ou le dossier .git/, et lancez claude. Claude Code utilise le répertoire courant comme racine de travail : démarré deux niveaux plus bas, il devra deviner ce qui se trouve au-dessus, ou vous le demander. Vous pouvez ajouter d’autres dossiers en cours de session avec /add-dir <chemin>, et déplacer la session avec /cd <chemin> sans la redémarrer.

Le dialogue de confiance

La première fois que vous ouvrez un dossier, Claude Code vous demande si vous lui faites confiance. La question n’est pas de pure forme : un dépôt peut contenir des réglages dans .claude/, des hooks et des serveurs MCP qui s’exécuteront sur votre machine. Tant que vous n’avez pas accepté, Claude Code retient ces éléments. Sur un dépôt que vous ne connaissez pas, jetez un œil à .claude/settings.json et .mcp.json avant de répondre oui.

Le mode de permission

Le mode de permission fixe ce que Claude peut faire sans vous demander. Depuis la version 2.1.283, une session en terminal ou dans VS Code démarre en mode Auto : un classifieur examine les actions en arrière-plan et bloque celles qui sortent de votre demande, au lieu de vous interroger à chaque commande. Appuyez sur Maj+Tab pour passer d’un mode à l’autre ; la barre d’état affiche le mode courant.

Mode	Ce qui s’exécute sans demande	Pour quoi
Auto	Tout, sous contrôle du classifieur	Les tâches longues, réduire la fatigue des confirmations
Manual (`default`)	Les lectures seulement	Relire chaque action, travail sensible
Accept edits	Lectures, modifications de fichiers, `mkdir`, `mv`, `cp`…	Itérer sur du code que vous relisez
Plan	Lectures ; Claude propose un plan sans rien modifier	Explorer avant de changer

Sauf en mode bypassPermissions, réservé aux conteneurs isolés, certaines actions restent toujours soumises à confirmation, comme les suppressions de chemins critiques (rm -rf ~) et les écritures dans les fichiers qui exécutent du code au démarrage du shell (.zshenv, .npmrc…). Pour les premières sessions de ce cours, le mode Manual est pédagogique : vous voyez chaque action que Claude propose. Passez en Auto quand vous saurez à quoi ressemble une session normale.

Écran principal de Claude Code au démarrage d'une session : notice indiquant que le mode Auto est le mode de permission par défaut, invite de saisie, barre d'état « auto mode on (shift+tab to cycle) » et indicateur d'effort medium — Capture réelle de Claude Code 2.1.317 (4 novembre 2026) : une session qui démarre en mode Auto, avec la notice affichée la première fois et la barre d'état en bas.

Les quatre barres d'état de Claude Code selon le mode de permission : auto mode on, manual mode on, accept edits on, plan mode on — Capture réelle de Claude Code 2.1.317 (4 novembre 2026) : la barre d'état à chaque pression de Maj+Tab, depuis le mode Auto.

Créer un projet de démonstration

Si vous n’avez pas de projet sous la main, un bac à sable se monte en deux commandes :

mkdir demo-claude-code && cd demo-claude-code
git init && npm init -y

Vous pouvez ensuite demander à Claude de générer une petite application :

Crée une application Express.js simple avec une route GET /api/hello
qui renvoie { "message": "Bonjour le monde" }, et un test qui l'appelle.

L’exercice a un intérêt qui dépasse le résultat. Comme vous connaissez exactement l’état initial du dossier (il était vide il y a une minute), vous pouvez observer quels fichiers Claude crée, dans quel ordre, et quelles décisions il prend sans vous les demander. C’est une bonne première lecture de son comportement avant de le lâcher sur du code qui compte.

Bonnes pratiques

Quatre habitudes font une différence nette dès les premières sessions. Lancez Claude Code à la racine du projet, pour qu’il trouve la configuration et l’historique. Ayez un dépôt Git initialisé : Claude s’appuie sur Git pour comprendre la structure et l’historique, et vous y gagnez un filet de sécurité, puisqu’un git diff vous montre exactement ce qui a bougé. Gardez un terminal ouvert à côté pour relire un fichier ou relancer un test vous-même ; cette vérification parallèle vous évite d’accumuler des modifications que vous n’avez jamais regardées. Commencez petit : demandez d’abord à Claude d’explorer et de décrire le projet avant de lui demander des modifications. S’il se trompe sur votre point d’entrée ou votre framework, il se trompera sur tout le reste, et mieux vaut le découvrir avant qu’il n’ait touché un fichier.

Générer le CLAUDE.md

Une fois dans le projet, exécutez /init. Claude analyse la base de code et écrit un fichier CLAUDE.md avec les commandes de build et de test, l’organisation des dossiers et les conventions qu’il a repérées. Si un CLAUDE.md existe déjà, /init propose des améliorations au lieu de l’écraser. Pour un déroulé interactif qui propose aussi des skills et des hooks, lancez la session avec la variable CLAUDE_CODE_NEW_INIT=1. Relisez le fichier produit : c’est un brouillon fidèle à ce que Claude a compris, pas une vérité établie, et la moindre erreur vous suivra dans toutes les sessions suivantes. La leçon suivante explique quoi y mettre.

Vérifier que tout fonctionne

Testez avec une question simple :

Décris la structure de ce projet en quelques lignes

Lisez la réponse attentivement au lieu de la survoler : elle vous dit ce que Claude a compris de votre projet, donc la base sur laquelle il travaillera dans toutes les leçons suivantes. Si le résumé est juste, vous êtes prêt ; s’il est approximatif, c’est le bon moment pour corriger le CLAUDE.md, pas dans trois leçons. En cas de doute sur l’installation ou les réglages, /doctor fait un bilan en session et propose des corrections.

À vous de jouer

Ouvrez claude à la racine d’un projet versionné avec Git, acceptez le dialogue de confiance.
Appuyez plusieurs fois sur Maj+Tab et lisez la barre d’état : repérez les quatre modes, puis revenez en Manual.
Lancez /init, puis ouvrez le CLAUDE.md produit dans votre éditeur. Corrigez une affirmation fausse ou incomplète.
Demandez « Décris la structure de ce projet » et comparez avec ce que vous savez.

Sources officielles : Quickstart · Choose a permission mode · How Claude remembers your project · Configure permissions

Points clés à retenir

Lancez Claude Code à la racine d’un projet versionné ; /add-dir et /cd ajustent le périmètre en cours de session
Le dialogue de confiance protège votre machine des hooks et serveurs MCP d’un dépôt inconnu
Auto est le mode de départ depuis la 2.1.283 ; Maj+Tab fait défiler Auto, Manual, Accept edits et Plan
/init génère un CLAUDE.md à relire ; /doctor diagnostique l’installation et les réglages
Commencez par faire décrire le projet avant de demander une modification