Claude Code avec le contrôle de version local pour Mac

Vous codez avec l’assistance de l’IA. Elle apporte des modifications à vos fichiers. Parfois, les modifications fonctionnent parfaitement. Parfois, elles ne fonctionnent pas. Le contrôle de version est comme un bouton d’annulation pour l’ensemble de votre projet. Chaque fois que vous enregistrez un instantané (appelé un « commit »), vous créez un point de restauration auquel vous pouvez toujours revenir. Mieux encore, vous pouvez faire tout cela entièrement sur votre ordinateur et Claude Code le fait pour vous.

Concepts Clés

Terminal - Interface en ligne de commande intégrée à Mac pour exécuter des commandes
Git - Suit chaque modification de vos fichiers sur votre ordinateur, créant des points de restauration auxquels vous pouvez revenir à tout moment
Commit - Un instantané de votre projet à un moment précis avec une description de ce qui a changé
Claude Code - Assistant de codage IA qui écrit du code, corrige les bugs et gère les opérations Git par de simples demandes

Ce Dont Vous Aurez Besoin

Avoir terminé Installer Claude Code sur Mac
20-30 minutes

Étape 1 : Ouvrir Terminal

Choisissez l’une de ces méthodes :

Spotlight : Appuyez sur Command (⌘) + Espace, tapez Terminal, appuyez sur Entrée
Finder : Ouvrez Applications > Utilitaires > Terminal

Vous verrez une invite de commande se terminant par $ ou %.

Étape 2 : Installer Git

Mac a souvent Git préinstallé. Vérifions :

Tapez cette commande et appuyez sur Entrée :
```
git --version
```

Si vous voyez un numéro de version (comme git version 2.39.0), Git est déjà installé—passez à l’Étape 3.

Si vous voyez « command not found » ou une fenêtre contextuelle vous demandant d’installer les outils de développement :

Cliquez sur Installer dans la fenêtre contextuelle, ou exécutez :
```
xcode-select --install
```
Attendez la fin de l’installation (1-5 minutes)
Vérifiez que Git est installé :
```
git --version
```

Vous devriez voir quelque chose comme git version 2.39.0.

Étape 3 : Configurer Git avec Votre Identité

Git a besoin de savoir qui vous êtes pour les messages de commit.

Définissez votre nom et votre e-mail (peuvent être fictifs) :

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

L’utilisation de votre nom et de votre e-mail vous aide à identifier qui a effectué les modifications lorsque plusieurs personnes travaillent sur ce projet.

Étape 4 : Accéder à Votre Dossier Documents

Accédez à votre dossier Documents :
```
cd ~/Documents
```
Vérifiez que vous êtes au bon endroit :
```
pwd
```

Vous devriez voir /Users/VOTRE_NOM_UTILISATEUR/Documents.

Étape 5 : Créer le Dossier du Projet

Créez un dossier appelé test_claude :
```
mkdir test_claude
```
Accédez-y :
```
cd test_claude
```

C’est là que votre projet va résider.

Étape 6 : Démarrer Claude Code

Démarrez Claude Code :
```
claude
```

Connectez-vous avec votre abonnement Claude en suivant le tutoriel d’installation. Après vous être connecté, vous verrez un message de bienvenue et l’invite Claude Code.

Étape 7 : Demander à Claude d’Initialiser Git

Tapez cette demande :
```
Commence à suivre les modifications
```

Claude initialise un dépôt Git dans votre dossier (prend 2-5 secondes). Vous avez maintenant le contrôle de version !

Si Claude demande la permission, il affiche un petit menu avec Yes et No. Utilisez les touches fléchées pour choisir Yes et appuyez sur Entrée. Vous verrez peut-être cela plusieurs fois dans ce tutoriel.

Étape 8 : Créer l’Application de Minuterie

Dans Claude Code, copiez et collez toute cette demande (coller garde toutes les lignes ensemble ; appuyer sur Entrée l’enverrait trop tôt) :

Crée une application de minuterie simple dans un seul fichier appelé timer.html.
Elle doit avoir :
- Un champ de saisie pour définir les minutes
- Des boutons Démarrer et Arrêter
- Un affichage montrant le temps restant au format MM:SS

Claude crée timer.html (prend 10-30 secondes) avec le code CSS et JavaScript.

Étape 9 : Tester la Minuterie

Ouvrez Finder
Accédez à Documents > test_claude
Double-cliquez sur timer.html pour l’ouvrir dans votre navigateur
Essayez la minuterie :
- Tapez 1 dans le champ de saisie
- Cliquez sur Démarrer
- Regardez le compte à rebours

Si quelque chose ne fonctionne pas : Dans Claude Code, décrivez l’erreur : « Je vois cette erreur : [décrivez ce qui s’est passé]. Peux-tu la corriger ? »

Étape 10 : Demander à Claude de Faire un Commit

Dans Claude Code, tapez :
```
Enregistre ces modifications.
```

Claude va :

Vérifier quels fichiers ont changé
Rédiger un message de commit descriptif
Créer le commit (prend 5-10 secondes)

Vous avez créé votre premier point de sauvegarde ! Vous pouvez toujours revenir à cette version fonctionnelle.

Étape 11 : Ajouter des Boutons Prédéfinis

Dans Claude Code, tapez :

Ajoute deux boutons en haut. Si je clique dessus, cela démarre automatiquement des minuteries de 1 et 5 minutes.

Actualisez votre onglet de navigateur (ou appuyez sur Command (⌘) + R)
Testez : Cliquez sur le bouton 5 min
Si cela fonctionne, faites un commit des modifications :
```
Enregistre ces modifications.
```

Nous avons créé un 2e point de sauvegarde. Cette version a les deux boutons qui fonctionnent.

Étape 12 : Ajouter un Autre Bouton

Dans Claude Code, tapez :
```
Ajoute un bouton de 15 minutes.
```
Actualisez votre onglet de navigateur (appuyez sur Command (⌘) + R)
Testez : Cliquez sur le bouton 15 min

Pour ce tutoriel : Faites comme si le bouton 15 minutes ne fonctionnait pas correctement. Ne faites pas encore de commit—nous allons pratiquer l’abandon des mauvaises modifications.

Étape 13 : Abandonner les Modifications

Parfois, le code de l’IA ne fonctionne pas et vous devez recommencer à partir de votre dernier point de sauvegarde.

Dans Claude Code, tapez :
```
Abandonne ces modifications.
```
Claude vous demandera généralement de confirmer d’abord. S’il affiche un menu, choisissez Yes (touches fléchées ou le numéro à côté) et appuyez sur Entrée. S’il le demande dans un message, tapez oui, abandonne les modifications de timer.html et appuyez sur Entrée
Actualisez votre navigateur—le bouton 15 minutes disparaît

Claude rejette les nouvelles modifications que nous n’aimons pas. La minuterie fonctionne à nouveau avec seulement les boutons 1 et 5 minutes !

Étape 14 : Ajouter une Notification Sonore

Dans Claude Code, tapez :

Ajoute une notification sonore quand le temps est écoulé.

Actualisez le navigateur et testez une fois que Claude a terminé (réglez la minuterie sur 1 minute)
Si cela fonctionne, faites un commit des modifications :
```
Enregistre ces modifications.
```

Étape 15 : Ajouter un Bouton Snooze

Dans Claude Code, tapez :

Le son doit continuer jusqu'à ce que je clique sur un bouton pour l'arrêter (snooze).

Actualisez le navigateur et testez une fois que Claude a terminé (réglez la minuterie sur 1 minute)
Si cela fonctionne, faites un commit des modifications :
```
Enregistre ces modifications.
```

Étape 16 : Voir Votre Historique de Commits

Dans Claude Code, tapez :

Montre-moi mon historique de modifications

Claude affiche vos commits dans un format lisible. Vous verrez :

Votre commit de l’application de minuterie initiale
Le commit des boutons prédéfinis (1 min et 5 min)
Le commit de la notification sonore
Le commit du bouton snooze

Remarquez que la tentative du bouton 15 minutes n’y est pas—vous l’avez abandonnée !

Étape 17 : Examiner le Code

Dans le navigateur qui affiche l’application, faites un clic droit et sélectionnez Afficher le code source de la page (ou appuyez sur Option (⌥) + Command (⌘) + U)
Vous utilisez Safari ? Cliquez d’abord sur Safari > Réglages > Avancées et cochez Afficher les fonctionnalités pour les développeurs web. Ensuite, faites un clic droit sur la page et choisissez Afficher le code source de la page
Vous voyez le code source de l’application.

Dans Claude Code, demandez

Explique ce code. Juste les grandes lignes.

Le Flux de Travail Complet

Demandez à Claude d’apporter des modifications
Testez
Si cela fonctionne → Demandez à Claude de faire un commit
Si cela échoue → Demandez à Claude de le corriger.
Impossible à corriger → Abandonnez les modifications et réessayez
Répétez

Vous pouvez toujours revenir à n’importe quel commit. Abandonnez sans crainte—ne committez que le code fonctionnel !

Prochaines Étapes

Essayez d’ajouter plus de fonctionnalités à votre minuterie :

Bouton 15 minutes : « Ajoute un bouton prédéfini de 15 minutes qui fonctionne » (refaites ce que nous avons abandonné !)
Bouton Pause : « Ajoute un bouton Pause/Reprendre qui bascule l’état de la minuterie »
Meilleur style : « Améliore le design visuel avec une palette de couleurs moderne et des polices plus grandes »
Barre de progression : « Ajoute une barre de progression visuelle montrant le temps restant »

N’oubliez pas : Testez après chaque fonctionnalité, committez après chaque succès, abandonnez les échecs.

Dépannage

Erreur « not a git repository » : Assurez-vous d’être dans le dossier test_claude (cd ~/Documents/test_claude)
Impossible de trouver timer.html dans Finder : Le fichier se trouve à /Users/VOTRE_NOM_UTILISATEUR/Documents/test_claude/timer.html
Les commandes Git ne fonctionnent pas : Assurez-vous d’avoir terminé l’Étape 2 et installé Git
La minuterie ne fonctionne pas : Ouvrez la console du navigateur (clic droit sur la page, sélectionnez Inspecter, puis cliquez sur l’onglet Console ; dans Safari, activez d’abord les fonctionnalités pour les développeurs comme indiqué à l’Étape 17, puis choisissez Inspecter l’élément), copiez tous les messages d’erreur en rouge, collez-les dans Claude

Ce Que Vous Pouvez Demander à Claude

« Quels fichiers ai-je modifiés ? » - Voir les modifications non committées
« Montre-moi les différences » - Voir exactement quel code a changé
« Explique ce que fait le code de la minuterie » - Comprendre l’implémentation
« Crée une branche appelée essai » - Essayer des modifications risquées en toute sécurité
« Annule tout depuis mon dernier commit » - Rejeter les modifications que vous n’avez pas encore enregistrées

Claude gère toutes les opérations Git en langage naturel—aucune commande à mémoriser !

Aperçu du Flux de Travail

Configuration : Installez Git une fois, configurez l’identité une fois
Développement : Claude écrit le code, vous testez dans le navigateur
Contrôle de Version : Claude gère toutes les opérations Git via de simples demandes
Sécurité : Abandonnez les mauvaises modifications à tout moment, revenez à n’importe quel commit précédent
Local : Votre historique Git reste sur votre ordinateur — aucun compte GitHub nécessaire (Claude Code lui-même a toujours besoin d’Internet et de votre compte Claude)

Créé par Steven Ge le 8 décembre 2025.