Claude Code CLI : modèle mental et premier workflow réel

Vous savez lancer la CLI, utiliser ses commandes et écrire un prompt borné. Il vous manque deux choses : le modèle mental d’une session Claude Code (comprendre ce qu’est une session, comment elle avance, qui fait quoi) et un workflow réel déroulé de bout en bout sur lab-claude. Ce guide traite les deux : il pose la boucle de travail, puis la fait pratiquer sur une tâche volontairement petite.

Ce que vous allez apprendre

Définir ce qu’est une session Claude Code CLI
Appliquer la boucle Explorer → Planifier → Exécuter → Valider
Distinguer ce que l’agent fait de ce qui reste sous votre contrôle
Connaître les 5 réflexes de pilotage à installer dès maintenant
Dérouler un premier workflow réel borné sur lab-claude
Recadrer immédiatement si Claude élargit le scope

Prérequis

Claude Code CLI installé et fonctionnel
Commandes de la CLI maîtrisées (voir prise en main CLI)
Prompt borné à rédiger (voir prompting de base)
Projet fil rouge disponible localement : ~/Projets/lab-claude
Commandes de validation vérifiées :

uv run ruff check .
uv run pytest -q

Qu’est-ce qu’une session Claude Code CLI ?

Une session est un échange continu entre vous et l’agent dans un même terminal. Elle contient :

votre objectif du moment
le contexte déjà chargé (fichiers lus, décisions prises)
l’historique des demandes et des réponses
l’état visible : fichiers modifiés, commandes exécutées

Une bonne session n’est pas un flux improvisé. C’est une conversation pilotée : vous cadrez, l’agent propose, vous validez.

La boucle de travail : Explorer → Planifier → Exécuter → Valider

La boucle la plus utile pour débuter tient en 4 temps courts :

Explorer -> Planifier -> Exécuter -> Valider

Phase	Ce que vous demandez	Ce que vous vérifiez
Explorer	Lecture, résumé, diagnostic sans modification	Claude comprend la zone concernée
Planifier	Plan court, borné, en 3 étapes	Le plan ne sort pas du périmètre
Exécuter	Une seule étape à la fois, après validation	Diff propre et aligné sur le plan
Valider	`ruff` + `pytest` + `git diff`	Aucune régression ni débordement

Cette boucle doit rester courte. Pour débuter, privilégiez des tâches petites et vérifiables. Mieux vaut quatre cycles d’une minute qu’un cycle de dix minutes mal cadré.

Ce que Claude Code peut faire (et ce qu’il ne faut pas lui laisser faire sans validation)

Dans un workflow débutant, retenez trois capacités utiles et trois garde-fous systématiques.

Capacités utiles :

lire la structure d’un dépôt et la résumer
proposer un plan d’action borné
rappeler les commandes de validation pertinentes

Garde-fous systématiques :

ne pas modifier de fichiers sans votre accord explicite
ne pas élargir le périmètre sans validation
ne pas exécuter d’actions sensibles (suppression, install, push) sans confirmation

Schéma de répartition des rôles :

Claude Code : lit, résume, propose, exécute dans un cadre donné
Vous        : cadrez, validez, décidez, contrôlez

Les 5 réflexes de pilotage à installer dès maintenant

Ces réflexes sont la traduction concrète de la boucle en gestes quotidiens :

Donner un objectif concret (pas “améliore”, mais “ajoute /version qui renvoie la version FastAPI”)
Limiter le périmètre au strict minimum (fichiers cibles explicites)
Demander un plan court (3 étapes par défaut)
Bloquer l’exécution tant que le plan n’est pas validé
Terminer par une validation explicite (ruff + pytest + git diff)

Les formulations détaillées sont couvertes dans le guide prompting de base.

Définition du périmètre sur `lab-claude`

Dans ce guide, le périmètre est explicitement limité à :

app/main.py
tests/test_health.py

Tout le reste est hors scope.

État de départ : vérifier que le projet est propre

Avant de demander quoi que ce soit à Claude, partez d’un état validé :

cd ~/Projets/lab-claude
uv run ruff check .
uv run pytest -q

Si ces commandes sont vertes, vous avez un point de référence propre.

Workflow pas à pas sur lab-claude

Ouvrez le projet
Fenêtre de terminal
```
cd ~/Projets/lab-claude
claude
```

Demandez une exploration en lecture seule

Lis app/main.py et tests/test_health.py.
Résume le comportement actuel de /health en 6 points maximum.
Ne modifie aucun fichier.

Demandez un plan court et borné

Propose un plan en 3 étapes pour une amélioration mineure de /health.
Limite le périmètre à app/main.py et tests/test_health.py uniquement.
N'exécute rien tant que je n'ai pas validé.

Lancez une exécution contrôlée

Exécute uniquement l'étape 1 du plan validé.
Ne touche à aucun autre fichier.
À la fin, résume exactement ce qui a été modifié.

Validez immédiatement
Fenêtre de terminal
```
uv run ruff check .
uv run pytest -q
```

Schéma 2 (rythme recommandé) :

petit changement -> validation -> petit changement -> validation

Ce qu’il faut observer à chaque étape

Étape exploration : Claude reste en lecture seule
Étape plan : le plan tient en 3 étapes et reste dans le périmètre
Étape exécution : une seule étape est exécutée, sans débordement
Étape validation : ruff et pytest repassent au vert

Comment recadrer rapidement une dérive de périmètre

Si Claude élargit le scope, recadrez immédiatement avec une consigne courte et ferme :

Stop. Réduis le périmètre au strict minimum.
Ne touche à aucun autre fichier.

Puis reformulez explicitement les fichiers autorisés :

Travaille uniquement sur app/main.py et tests/test_health.py.
N'exécute rien tant que je n'ai pas validé.

Prompts spécifiques au workflow

Pour les prompts d’exploration et de plan, réutilisez ceux du guide prompting de base. Les trois prompts ci-dessous sont propres à ce workflow : exécution bornée, recadrage et sortie vérifiable.

Prompt d’exécution bornée :

Exécute uniquement l'étape 1 du plan validé.
Ne touche à aucun autre fichier.
Résume exactement ce qui a été modifié.

Prompt de recadrage :

Stop. Réduis le périmètre au strict minimum.
Ne touche qu'à app/main.py et tests/test_health.py.

Prompt de sortie vérifiable :

Donne un résumé en 5 points maximum et rappelle la commande de validation à lancer.

Erreurs fréquentes

Symptôme	Cause probable	Correction
Le plan part dans trop de directions	Objectif trop large	Revenir à une amélioration mineure unique
Claude modifie d’autres fichiers	Périmètre mal rappelé	Repréciser les fichiers autorisés avant exécution
La validation échoue	Trop de changements d’un coup	Revenir à une seule étape et revérifier immédiatement
Résumé final difficile à relire	Demande de sortie absente	Exiger un résumé borné en 5 points

Checklist de fin de guide

J’ai démarré depuis un état initial propre (ruff et pytest verts)
J’ai gardé le périmètre sur app/main.py et tests/test_health.py
J’ai demandé un plan en 3 étapes avant exécution
J’ai exécuté uniquement l’étape 1 du plan validé
J’ai validé immédiatement avec uv run ruff check . et uv run pytest -q
J’ai utilisé un prompt de recadrage si le scope a débordé
J’ai obtenu un résumé final court et vérifiable

À retenir

Le premier workflow réel doit rester petit et borné
La valeur vient de la répétabilité, pas d’un gros changement
Le plan court protège la qualité d’exécution
La validation rapide évite de propager les erreurs
Le premier objectif est la maîtrise, pas la vitesse

Prochaines étapes

Configurer CLAUDE.md Poser les conventions et garde-fous de lab-claude une fois pour toutes

Mode plan, diff et validations Installer le rituel de contrôle qui sécurise chaque changement

Erreurs courantes et recadrage Reprendre le contrôle quand une session dérive malgré le rituel