Débuter avec Claude Code : le guide du premier projet

Claude Code : ce que c’est et ce qu’il faut pour démarrer

Claude Code est un agent de codage développé par Anthropic : il lit les fichiers d’un dossier de projet, les modifie et exécute des commandes à ta demande, au lieu de seulement suggérer du code. Il tourne dans le terminal, VS Code, JetBrains, l’app Desktop, sur le web et sur mobile, avec le même moteur source : Anthropic, documentation Claude Code, 2026.

Ce guide s’adresse à quelqu’un qui n’a jamais lancé Claude Code et veut créer un site ou une petite application. Prérequis :

• un abonnement Claude ou un compte Anthropic Console (la plupart des surfaces l’exigent, vérifie les conditions sur la page officielle des tarifs le jour où tu t’abonnes) ;
• un dossier de projet, même vide ;
• Git installé sur ta machine ;
• un terminal, ou VS Code, JetBrains ou l’app Desktop si tu préfères une interface.

Les surfaces évoluent vite. Voici celles que la documentation listait à la rédaction de cet article :

Source : Platforms and integrations, Anthropic, 2026. Pour un premier projet, le terminal ou VS Code suffisent.

1. Installe Claude Code

Lance l’installeur natif, puis vérifie la version. Les commandes ci-dessous viennent de guides tiers : confirme-les sur la documentation officielle avant de les exécuter.

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Vérification
claude --version

2. Fais un premier échange sans rien modifier

Place-toi dans le dossier du projet, puis lance claude. Au premier démarrage, connecte ton compte.

cd mon-projet
claude

Pour ce premier échange, demande une lecture, pas une modification : « Explique-moi la structure de ce dossier et ce que tu comprends du projet. Ne modifie rien. » Sur un dossier vide, demande plutôt : « Pose-moi les questions nécessaires pour cadrer un site vitrine de trois pages. »

3. Initialise Git avant toute modification

Git garde l’historique de ton projet. Sans lui, tu ne peux pas annuler proprement une modification de l’agent. Dans un second terminal :

git init
git add -A
git commit -m "Point de départ"
git switch -c premiere-page

La dernière commande crée une branche de travail. Chez Peechy, la règle est de toujours travailler sur une branche, jamais directement sur la branche principale : si le résultat déçoit, on jette la branche et la version stable reste intacte.

4. Crée le fichier CLAUDE.md

CLAUDE.md est un fichier de règles lu au début de chaque conversation : commandes du projet, style de code, règles de travail. La commande /init en génère une première version à partir de la structure du projet, et /context vérifie qu’il est bien chargé source : Anthropic, bonnes pratiques Claude Code, 2026.

Garde-le court. Un fichier trop long pousse Claude à ignorer une partie des règles. Pour chaque ligne, demande-toi : si je la retire, l’agent fera-t-il des erreurs ? Sinon, supprime-la. La Claude Academy propose aussi de commencer sans fichier, de noter où tu corriges l’agent sans cesse, puis de lancer /init source : Claude Academy, 2026.

Voici les trois règles écrites dans le fichier de règles de Peechy, reformulées pour un premier projet :

- Travaille toujours sur une branche, jamais sur main.
- Demande confirmation avant toute suppression.
- « Terminé » veut dire : le build passe et le comportement a été observé, pas seulement « code écrit ».

Les procédures occasionnelles relèvent plutôt des skills : voir comment ajouter des Skills à Claude Code.

5. Comprends les modes de permission

Un mode de permission fixe ce que l’agent peut faire sans te demander. Claude Code propose six modes source : Anthropic, modes de permission, 2026 :

Dans le terminal, Shift+Tab fait défiler les modes et la barre d’état affiche le mode actif. Pour un premier projet, reste en default, puis passe en acceptEdits quand tu sais ce que tu fais. N’utilise pas bypassPermissions sur ta machine.

6. Cadre en mode plan, avance par petites étapes

Le mode plan est un mode en lecture seule : Claude explore le projet et propose un plan sans rien éditer. Active-le avec Shift+Tab ou lance directement claude --permission-mode plan.

Demande par exemple : « Propose un plan pour créer la page d’accueil, avec les fichiers touchés. » Relis le plan, corrige-le, puis valide. Ensuite, découpe : une page, puis un formulaire, puis le menu. À chaque étape, demande de lancer le build et de te dire ce qu’il faut observer dans le navigateur. Cette découpe est notre pratique, pas une prescription officielle. Pour le parcours complet d’un site jusqu’au déploiement, voir le site vitrine avec Claude Code jusqu’à Vercel.

7. Adopte trois habitudes avant la mise en ligne

1. Lis ce qui change avant d’accepter. Un diff désigne la liste des lignes ajoutées et retirées dans chaque fichier. Si tu ne comprends pas une suppression, demande à Claude de l’expliquer.
2. Teste toi-même. Ouvre le site, clique, remplis le formulaire, essaie sur mobile. Un build qui passe ne prouve pas que la page fait ce que tu veux.
3. Fais une revue de sécurité avant toute mise en ligne. Clés d’API dans le code, formulaires non protégés, dépendances douteuses : les risques sont détaillés dans vibe coding : les risques de sécurité.

Pièges courants

• Travailler sur la branche principale. Crée une branche avant la première modification.
• Un CLAUDE.md fleuve. Élague-le régulièrement, les règles utiles se noient sinon.
• Valider sans lire. En acceptEdits, les modifications passent sans demande : relis les diffs après coup.
• Prendre « code écrit » pour « terminé ». Exige le build et un test visuel.
• Mettre des secrets dans le dépôt. Les mots de passe et clés d’API n’ont rien à faire dans les fichiers versionnés.

Pour la suite, lis les erreurs à éviter avec Claude Code ou Codex ou le comparatif des deux outils.