Chapitre 2 / 12

Comment fonctionne le système

Trois outils se partagent le travail. Pas besoin de les maîtriser, juste de savoir qui fait quoi : c'est cette compréhension qui vous permettra de vous débrouiller le jour où quelque chose coince.

Schéma : Claude écrit le code et le dépose sur une branche, GitHub garde chaque version, vous fusionnez d'un clic, Vercel détecte le changement et publie le site
Le code circule dans un seul sens. Le seul geste humain, c'est la fusion.

Claude, l'artisan.

Vous lui décrivez ce que vous voulez, en français, et il écrit le code. Particularité de Claude Code sur le web : il ne travaille pas sur votre ordinateur, mais sur une machine louée à la minute dans le cloud. Il y recopie votre projet, fait ses modifications, vérifie que tout se construit, puis dépose son travail.

Vous pouvez fermer l'onglet, il continue sans vous.

GitHub, l'atelier et la mémoire.

C'est là que vit votre projet. Chaque modification y est datée et conservée : rien ne se perd, on peut toujours revenir à la version d'avant. C'est aussi la place publique où les deux autres outils se retrouvent — Claude y dépose, Vercel y vient chercher.

Un projet stocké sur GitHub s'appelle un dépôt (repository, ou repo). Vous en créerez un par projet.

Vercel, la vitrine.

Vercel surveille votre dépôt GitHub en permanence. Dès qu'une nouvelle version arrive sur la version officielle du projet, il la récupère, la transforme en site web et la publie à votre adresse. Automatiquement, en une minute, sans que vous ayez rien à faire.

C'est lui qui vous donne une adresse publique, du type projet.vercel.app.

Le vocabulaire en cinq mots

Vous allez croiser ces mots à l'écran. Aucun n'est compliqué.

Dépôt (repository) — le dossier de votre projet chez GitHub, avec tout son historique.

Branche (branch) — une version parallèle du projet, pour travailler sans toucher à l'originale. La version officielle s'appelle main.

Commit — une modification enregistrée, avec sa date et sa description. Comme un point de sauvegarde dans un jeu vidéo.

Pull Request (PR) — « demande de fusion ». Le dossier dans lequel Claude vous dit : voici ce que je propose de changer, tu valides ?

Déploiement (deployment) — l'opération par laquelle Vercel transforme votre code en site visible sur internet.

Retenez surtout ceci : Claude ne modifie jamais directement la version officielle de votre projet. Il travaille à côté et vous demande votre accord. Cette sécurité explique une étape que beaucoup de tutoriels oublient — et qui bloque tout le monde. Nous y viendrons à l'étape 4.