Aller au contenu principal
Premiers pas

Premier projet pas à pas

Tutoriel concret : créez votre premier site web avec Claude Code en 5 minutes. Exemples de prompts, itérations et bonnes pratiques pour bien démarrer.

Ce que vous allez créer

Dans ce tutoriel, vous allez créer non pas un, mais deux projets : d'abord une page ultra-simple (5 minutes), puis un site web complet avec design moderne. Commençons par le plus accessible.

Prérequis

Avant de commencer, assurez-vous que Claude Code est installé et authentifié. Si ce n'est pas fait, suivez d'abord le guide Prérequis et installation.

Premier projet : votre page de présentation (5 min)

Ce premier projet est volontairement très simple. Pas de framework, pas de configuration, juste un fichier HTML que vous pourrez ouvrir directement dans votre navigateur.

Objectif : créer une page web qui dit "Bonjour, je m'appelle [votre prénom]" avec un fond bleu et du texte blanc.

Étape 1 : Créer un dossier et lancer Claude Code

Étape 2 : Demander votre page

Tapez cette demande, en remplaçant "Marie" par votre prénom :

> Crée une page HTML avec un seul fichier (index.html).
> La page doit dire "Bonjour, je m'appelle Marie" au centre de l'écran.
> Fond bleu (#1e40af), texte blanc, police grande et lisible.
> Pas de dépendances externes, tout dans un seul fichier.

Claude Code va créer le fichier index.html. Tapez y pour accepter.

Étape 3 : Voir le résultat dans votre navigateur

La façon la plus simple : glissez le fichier index.html depuis votre dossier directement dans votre navigateur (Chrome, Firefox, Safari). Votre page s'affiche instantanément !

Ou via le terminal :

# Sur macOS
open index.html
# Sur Linux
xdg-open index.html
# Sur Windows
start index.html

Bravo ! Vous venez de créer votre première page web.

C'est aussi simple que ça. Claude Code a écrit tout le HTML et CSS pour vous. Vous pouvez maintenant demander des modifications : "Change la couleur de fond en vert", "Ajoute une photo de profil", "Mets le texte en plus grand"...


Deuxième projet : un site web complet avec design moderne

Prêt(e) pour quelque chose de plus ambitieux ? Passons à un portfolio complet avec navigation, sections et animations.

Étape 1 : Préparer le terrain

Créez un nouveau dossier pour votre projet et lancez Claude Code à l'intérieur.

Claude Code va s'initialiser et analyser le dossier (vide pour l'instant). Vous êtes prêt à lui parler.

Étape 2 : Décrire ce que vous voulez

La qualité du résultat dépend directement de la qualité de votre demande. Voici un bon prompt pour commencer :

> Crée-moi une page web HTML/CSS moderne avec :
> - Un header avec un logo texte "Mon Portfolio" et une navigation
> - Une section hero avec un titre accrocheur, une description et un bouton CTA
> - Une section "Mes projets" avec 3 cartes de projets fictifs
> - Un footer avec des liens vers les réseaux sociaux
> - Design : fond sombre (#0f172a), accents cyan (#06b6d4), typographie moderne
> - Responsive (mobile, tablette, desktop)
> - Animations CSS subtiles au survol des cartes
> - Le tout dans un seul fichier index.html avec CSS intégré

Les clés d'un bon prompt

Remarquez la structure du prompt ci-dessus : Quoi (une page web HTML/CSS), Structure (chaque section décrite), Design (couleurs précises), Contraintes (responsive, un seul fichier), Détails (animations, typographie). Plus votre prompt est précis, plus le résultat sera proche de ce que vous imaginez.

Étape 3 : Observer Claude Code travailler

Après avoir envoyé votre prompt, Claude Code va :

  1. Analyser votre demande et formuler un plan
  2. Vous montrer ce qu'il va faire avant de le faire
  3. Demander votre accord pour créer le fichier

Tapez y (ou appuyez sur Entrée) pour accepter. Claude Code va générer le fichier complet.

Étape 4 : Voir le résultat

Ouvrez le fichier dans votre navigateur :

# Sur macOS
open index.html
# Sur Linux
xdg-open index.html
# Sur Windows (WSL)
explorer.exe index.html
# Ou simplement : glissez le fichier dans votre navigateur

Vous devriez voir une page web complète avec le design que vous avez demandé.

Étape 5 : Itérer et affiner

C'est là que Claude Code brille vraiment. Au lieu de modifier le code à la main, demandez simplement les changements que vous voulez :

> Ajoute une animation d'apparition progressive (fade-in)
> sur chaque section quand on scrolle vers le bas

Claude Code va modifier le fichier existant pour ajouter cette fonctionnalité. Vous pouvez enchaîner autant de demandes que nécessaire :

> Change la couleur d'accent de cyan à violet (#8b5cf6)
> et ajoute un dégradé subtil sur le header
> Ajoute un formulaire de contact avec les champs
> nom, email et message. Style-le pour qu'il soit cohérent
> avec le reste du design.
> Rends le site accessible : ajoute les attributs aria,
> vérifie les contrastes de couleur et assure-toi que tout
> est navigable au clavier

L'itération, c'est la clé

Ne cherchez pas à tout décrire parfaitement du premier coup. Commencez simple, puis affinez étape par étape. Claude Code garde le contexte de toute la conversation et comprend vos retours. C'est exactement comme travailler avec un collègue : vous lui montrez le résultat, vous lui dites ce que vous voulez changer, et il s'adapte.

Aller plus loin : un projet Next.js

Prêt pour quelque chose de plus ambitieux ? Demandez à Claude Code de créer un projet complet avec un framework.

Claude Code va :

  • Initialiser le projet (npx create-next-app)
  • Configurer TypeScript et Tailwind
  • Créer les composants React nécessaires
  • Structurer les fichiers correctement
  • Tout connecter pour que le projet fonctionne du premier coup

Bonnes pratiques pour vos premiers projets

Commencez petit

Votre premier projet avec Claude Code ne devrait pas être une application complète. Commencez par une page HTML, un script Python, ou une fonction utilitaire. Apprenez à communiquer avec l'outil avant de vous attaquer à des projets complexes.

Soyez précis dans vos demandes

"Fais-moi un site" donnera un résultat générique. "Fais-moi une landing page pour une app de méditation, fond bleu nuit, typographie serif, avec une section pricing à 3 tiers" donnera un résultat proche de votre vision.

Itérez rapidement

Envoyez des demandes courtes et fréquentes plutôt qu'un pavé de 50 lignes. Claude Code comprend mieux les instructions incrémentales.

Utilisez le CLAUDE.md

Dès que votre projet dépasse une seule session, créez un fichier CLAUDE.md à la racine. Documentez la stack, les conventions et les commandes utiles. Claude Code le lira automatiquement.

Vérifiez le résultat

Claude Code est puissant mais pas infaillible. Testez toujours le code généré, relisez les modifications critiques, et n'acceptez pas aveuglément chaque suggestion.

Commandes utiles à connaître

Pendant votre session Claude Code, vous pouvez utiliser ces commandes spéciales :

CommandeDescription
/helpAfficher l'aide et les commandes disponibles
/clearEffacer le contexte de la conversation
/compactCompresser la conversation pour libérer de la mémoire
/costAfficher le coût de la session en cours
/doctorDiagnostiquer les problèmes de configuration
Ctrl+CAnnuler la génération en cours
Ctrl+DQuitter Claude Code

Prochaines étapes

Bravo, vous avez créé votre premier projet avec Claude Code ! Vous maîtrisez maintenant les bases : lancer Claude Code, formuler des demandes, itérer sur le résultat.

Pour aller plus loin, explorez les fonctionnalités avancées qui transformeront votre quotidien :

  • Les MCP : Connectez Claude Code à Gmail, GitHub, Slack et des dizaines d'autres outils
  • Les Skills : Créez des workflows réutilisables pour automatiser vos tâches
  • Le Prompting avancé : Maîtrisez l'art de communiquer avec l'IA pour des résultats optimaux

Rejoignez la communauté

Partagez vos créations, posez vos questions et découvrez ce que d'autres utilisateurs construisent avec Claude Code. L'apprentissage est plus rapide quand on le fait ensemble.