Claude Code devient utile lorsque vous lui confiez une modification limitée, accompagnée de critères vérifiables. Cet atelier lui fait construire un petit validateur de tri de demandes fictives. Vous gardez une boucle simple : comprendre, proposer un plan, modifier, lire les différences et vérifier les tests. Aucun service réel n’est connecté.
Claude Code travaille au plus près d’un projet de code et de ses tests, tandis que Cowork privilégie les documents et applications dans une interface sans terminal. Pour ce guide, nous choisissons la version en ligne de commande, dans un dossier de démonstration.
- DépôtLance Claude Code dans le projet de test.
- PlanLis le diagnostic et vérifie le périmètre.
- Édition de codeContrôle les permissions et demande les tests ciblés.
- RelectureExamine le diff et décide si le changement est prêt.
1. Installer la version actuelle et vérifier l’accès
Au 20 novembre 2026, la documentation d’installation propose notamment l’installateur natif. Le parcours ci-dessous vise un serveur Linux de test ou une distribution WSL2 avec Bash, Git et Python3. La page officielle décrit séparément macOS et Windows natif. Exécutez l’installation dans l’environnement choisi, pas dans un dépôt de production.
curl -fsSL https://claude.ai/install.sh | bash
claude --version
claude doctor
La première commande télécharge et exécute l’installateur officiel ; en environnement administré, utilisez la méthode approuvée par votre organisation. Les deux suivantes vérifient la version et les diagnostics d’installation. Le parcours d’authentification dépend de votre offre ou de votre fournisseur API. Vérifiez aussi les conditions d’usage et de facturation avant les essais, sans supposer qu’un accès à Claude inclut toutes les surfaces.
2. Préparer un projet jetable et des permissions explicites
Créez un dossier neuf, puis initialisez Git. Ne copiez ni secrets ni configuration d’un vrai client. Un répertoire de travail donne du contexte à l’agent ; ce n’est pas une isolation complète du système. Le mode Plan sert ici à demander une analyse avant toute modification du code source.
mkdir atelier-claude-code
cd atelier-claude-code
git init
git status --short
claude --permission-mode plan
Dans la session, consultez /permissions. La documentation des permissions distingue les règles appliquées par le programme des instructions données au modèle. « Ne sors pas du dossier » dans le brief ou dans CLAUDE.md ne crée pas une barrière technique. Examinez les règles déjà autorisées et gardez les approbations manuelles pour cet atelier.
3. Activer la sandbox sans lui attribuer trop de pouvoirs
La sandbox des commandes est désactivée par défaut. Sur Linux ou WSL2, ouvrez /sandbox, vérifiez les dépendances indiquées et choisissez le mode qui conserve les permissions ordinaires. Si nécessaire, suivez les instructions officielles pour installer les dépendances, puis redémarrez la session.
Vérifiez que la sandbox fonctionne avant d’autoriser les tests. Elle borne les commandes et leurs processus enfants, mais ne couvre pas tous les outils de fichiers, hooks ou serveurs MCP. Sur Windows natif, cette sandbox n’est pas disponible : WSL2 constitue une autre option. Elle ne masque pas automatiquement les secrets déjà présents dans l’environnement. Une erreur de sandbox appelle un diagnostic, pas une autorisation générale de fonctionner sans elle.
4. Donner un brief avec une définition de réussite
Le programme demandé utilise uniquement la bibliothèque standard Python. Il valide une structure ; il ne décide pas si le classement est juste et n’appelle aucune IA. Le jeu fictif reprend les champs des autres ateliers, afin de rendre les erreurs faciles à comprendre.
Prépare d’abord un plan pour un projet Python sans dépendance externe.
Après validation, crée uniquement tri_support.py et test_tri_support.py.
Expose valider_tri(objet), qui accepte exactement les clés suivantes :
categorie, priorite, resume, information_manquante.
categorie : facturation, technique ou autre ; priorite : normale ou haute.
resume : chaîne non vide de 240 caractères maximum.
information_manquante : null ou chaîne non vide de 240 caractères maximum.
Refuse une clé supplémentaire, un champ absent ou un type incorrect.
Ajoute des tests unittest : cas valide, champ manquant, enum invalide,
et résumé contenant une consigne hostile, à traiter seulement comme texte.
Aucun réseau, aucune lecture de secret, aucun envoi, aucune installation.
Explique le périmètre des modifications et les tests proposés.
Relisez le plan. Passez ensuite en mode manuel et autorisez seulement les modifications convenues. Si la demande change, faites reformuler son périmètre. Les méthodes de travail officielles recommandent cette séparation entre exploration, planification et mise en œuvre.
5. Lire le diff et vérifier les tests
Ouvrez les deux fichiers avant d’exécuter les tests : un test est lui aussi du code. Contrôlez les imports, les accès aux fichiers et l’absence d’effets externes. Dans ce projet neuf, les fichiers sont initialement non suivis ; après cette première lecture, ajoutez seulement les deux fichiers attendus à l’index pour examiner leur diff complet.
git status --short
git add -- tri_support.py test_tri_support.py
git diff --cached
python3 -m unittest -v
Vérifiez les noms des tests, leur nombre, leur résultat et le code de sortie. Demandez une correction ciblée si un test échoue, puis répétez la lecture du diff et les tests. Après une nouvelle modification, le diff normal montre les changements non indexés ; réindexez les fichiers attendus pour revoir leur version complète avant un éventuel commit.
Relis le changement sans ajouter de fonctionnalité.
Explique ce que vérifie chaque test et ce qu’il ne prouve pas.
Signale les erreurs restantes, les fichiers modifiés et les commandes réellement exécutées.
Ne publie rien et ne crée pas de commit sans demande explicite.
Des tests verts ne garantissent ni l’absence de défaut ni la résistance générale aux injections. Ici, une consigne hostile reste une chaîne de caractères parce que le programme n’exécute aucun texte reçu. Conservez ce périmètre, relisez les propositions et mesurez les erreurs avant d’ajouter des dépendances, des accès ou une intégration réelle.