Découvrir Codex et créer son premier projet

Introduction

Le plus difficile, dans l'apprentissage de tout nouvel outil, est souvent le premier pas. Vous avez bravé l'installation technique. Vous avez configuré Visual Studio Code. Vous avez installé Node.js et Git. L'infrastructure est prête.

Il est maintenant temps de découvrir Codex. Si vous n'avez jamais utilisé de terminal ou d'environnement de développement, il est parfaitement normal de ne pas tout comprendre immédiatement au premier coup d'œil.

L'objectif de ce chapitre n'est pas de programmer une application complexe. L'objectif est de se familiariser avec votre environnement de travail. Nous allons créer un dossier propre, ouvrir votre éditeur, lancer l'intelligence artificielle et échanger vos premiers mots avec elle.

C'est une étape fondamentale pour bâtir votre confiance. Prenez le temps de lire, d'observer ce qui se passe à l'écran, et d'exécuter chaque commande sans précipitation.

À quoi ressemble Codex au premier lancement ?

Contrairement aux logiciels classiques comme Word ou Photoshop, Codex ne possède pas de fenêtre dédiée avec des boutons colorés, des menus déroulants ou des barres d'outils.

Codex s'exécute directement dans le terminal. C'est ce que l'on appelle une interface en ligne de commande (CLI - Command Line Interface). Lorsque vous le lancerez tout à l'heure, vous verrez apparaître un bloc de texte. Ce bloc affichera le logo ou le nom de l'outil, suivi d'informations de chargement.

Selon que vous soyez sur Windows, macOS ou Linux, la couleur de la police et la forme du curseur clignotant peuvent légèrement différer. Ce qui importe, c'est l'apparition d'un indicateur (souvent une flèche > ou le mot Prompt:) qui signale que l'intelligence artificielle est prête à recevoir vos instructions.

Comprendre le dossier de travail

Avant d'écrire la moindre commande, il faut comprendre une notion absolue du développement : le dossier de projet (ou répertoire de travail).

Utilisons une analogie simple. Imaginez que votre ordinateur est un grand meuble à tiroirs. Un dossier de projet, c'est un classeur posé sur le bureau, qui ne contient que les documents d'une affaire précise. Si vous mélangez les factures de la maison avec les contrats d'un client, vous ne retrouverez plus rien.

En informatique, c'est identique. Chaque fois que vous avez une nouvelle idée (un site vitrine, un outil de calcul, un blog), vous devez créer un dossier entièrement vierge, dédié à ce projet unique.

Si vous ne le faites pas, et que vous lancez Codex dans votre dossier "Documents" ou "Téléchargements", l'intelligence artificielle va lire vos lettres de motivation, vos photos de vacances et vos factures, en pensant qu'il s'agit de code. Cela va la ralentir, l'embrouiller, et potentiellement générer des bugs catastrophiques.

Créer son premier projet

Nous allons commencer par créer ce fameux classeur. Inutile d'utiliser le terminal pour l'instant, vous pouvez le faire de la manière la plus classique qui soit.

1. Ouvrez l'explorateur de fichiers de votre ordinateur.
2. Rendez-vous dans vos Documents (ou à la racine de votre disque).
3. Créez un nouveau dossier parent appelé Mes-Projets-Codex.
4. Entrez dans ce dossier, et créez un sous-dossier appelé mon-premier-projet.

Vous avez maintenant un espace propre et sécurisé pour travailler. C'est ici que l'intelligence artificielle viendra déposer les fichiers qu'elle va créer pour vous.

Ouvrir un projet dans Visual Studio Code

Il faut maintenant indiquer à notre éditeur de code quel classeur il doit ouvrir.

1. Lancez l'application Visual Studio Code.
2. Dans le menu supérieur, cliquez sur Fichier (File) puis sur Ouvrir le dossier... (Open Folder...).
3. Naviguez jusqu'au dossier mon-premier-projet que vous venez de créer et sélectionnez-le.

Visual Studio Code va se rafraîchir. Sur la gauche de l'écran (l'Explorateur), vous devriez voir le nom de votre dossier en majuscules (MON-PREMIER-PROJET). En dessous, il n'y a rien, car le dossier est vide. C'est parfait.

L'espace central est vide. C'est ici que le code s'affichera bientôt. En haut, sélectionnez Terminal > Nouveau terminal. Un panneau va s'ouvrir en bas de l'écran.

Lancer Codex dans son projet

Regardez attentivement le texte qui s'affiche dans votre terminal. Il doit se terminer par le chemin de votre dossier (ex: C:\...\Mes-Projets-Codex\mon-premier-projet>).

Cela signifie que le terminal est "à l'intérieur" de ce dossier. Toute commande tapée ici s'exécutera uniquement dans ce contexte.

Tapez la commande suivante et appuyez sur Entrée :

codex

Un processus va s'enclencher. Quelques lignes de chargement peuvent apparaître. Puis, Codex va vous afficher une invite d'attente (généralement symbolisée par un curseur clignotant). L'assistant est réveillé. Il a lu le dossier (qui est vide), et il attend vos ordres.

Comprendre l'interface

Analysons l'interface du terminal de Codex :

• La zone de saisie (Prompt) : C'est la ligne où votre curseur clignote. C'est ici que vous tapez vos phrases en langage naturel.
• Les réponses de Codex : Lorsque vous validez, le texte va défiler. L'IA rédige sa réponse.
• L'historique : Tout ce qui se trouve au-dessus de la ligne actuelle représente votre conversation passée. Si l'écran devient trop rempli, vous pouvez utiliser la molette de la souris pour remonter et relire.
• Les messages système : Parfois, Codex affiche des informations techniques (fichiers modifiés, recherches en cours). Elles sont souvent d'une couleur différente (gris, jaune, vert).

Cette interface minimaliste est pensée pour éviter toute distraction. Vous discutez, Codex exécute.

Écrire son premier prompt

Un "prompt", c'est simplement l'instruction que vous donnez à l'IA. Essayons des requêtes très basiques pour s'habituer.

Dans la zone de saisie, tapez :

Bonjour. Peux-tu analyser ce dossier et me dire ce qu'il contient ?

Appuyez sur Entrée. Codex va réfléchir quelques secondes, puis vous répondre qu'il s'agit d'un dossier vide, ou qu'il ne trouve aucun fichier de code.

Essayez ensuite :

Explique-moi ce que tu es capable de faire pour m'aider.

Lisez la réponse. Vous constatez que Codex comprend parfaitement la conversation et le français. C'est le début d'un dialogue interactif.

Premier exercice

Nous allons maintenant lui demander de créer quelque chose de concret. L'objectif n'est pas de faire un site, mais de vérifier qu'il a bien les droits d'écriture sur votre ordinateur.

Tapez le prompt suivant :

Crée un fichier texte appelé "bienvenue.txt". À l'intérieur, écris simplement la phrase : "Mon environnement est correctement configuré."

Validez. Codex va générer le fichier. Regardez immédiatement dans la barre latérale gauche de Visual Studio Code : un nouveau fichier bienvenue.txt vient d'apparaître magiquement !

Cliquez dessus pour l'ouvrir dans l'espace central. Vous y lirez la phrase demandée. Vous venez de prouver que la chaîne complète (VS Code → Terminal → OpenAI → Création de fichier local) fonctionne parfaitement.

Les erreurs les plus fréquentes

Ce processus semble simple, mais les pièges guettent les débutants.

• Symptôme : Codex modifie des centaines de fichiers système.
  Cause : Vous avez lancé Codex à la racine de votre ordinateur (C:\) ou dans le dossier Utilisateur au lieu de votre projet.
  Solution : Stoppez Codex (Ctrl+C). Ouvrez le bon dossier dans VS Code.
• Symptôme : Le terminal affiche "codex : terme non reconnu".
  Cause : L'installation globale (Chapitre précédent) a échoué ou VS Code n'a pas été redémarré.
  Solution : Fermez VS Code. Rouvrez-le. Si cela persiste, relancez `npm install -g @openai/codex-cli`.
• Symptôme : La touche Entrée va simplement à la ligne au lieu d'envoyer la commande.
  Cause : Cela dépend de votre système d'exploitation et de l'interface de Codex.
  Solution : Appuyez sur `Ctrl + Entrée` ou `Cmd + Entrée` pour valider les prompts multi-lignes.
• Symptôme : Le terminal se ferme accidentellement.
  Cause : Vous avez cliqué sur la corbeille dans le panneau de VS Code.
  Solution : Menu Terminal > Nouveau Terminal, puis retapez `codex`. L'IA lira le projet et comprendra où elle en est.
• Symptôme : Codex répond "Je ne peux pas modifier ce fichier".
  Cause : Le fichier est protégé, ou vous n'avez pas les droits d'écriture.
  Solution : Assurez-vous d'avoir créé le dossier de projet dans vos Documents personnels, pas dans les fichiers système (Program Files).
• Symptôme : Une erreur rouge "Token Limit Reached".
  Cause : Vous avez envoyé un projet beaucoup trop lourd, et l'IA n'a pas assez de mémoire pour tout lire.
  Solution : Videz l'historique ou relancez Codex, et ciblez vos demandes sur des fichiers précis.
• Symptôme : Vous avez deux fenêtres terminal qui tournent en même temps.
  Cause : Vous avez cliqué deux fois sur Nouveau Terminal et lancé Codex deux fois.
  Solution : Cliquez sur la corbeille pour fermer les terminaux excédentaires afin d'éviter les conflits d'écriture.
• Symptôme : Codex supprime une modification que vous venez de faire à la main.
  Cause : Vous avez tapé du code vous-même pendant que Codex générait une réponse sur le même fichier.
  Solution : Attendez que Codex termine de réfléchir et de modifier avant d'éditer manuellement un fichier en cours de traitement.
• Symptôme : L'explorateur VS Code ne se met pas à jour.
  Cause : Un léger délai d'affichage.
  Solution : Cliquez sur la petite icône de rafraîchissement (la flèche en cercle) dans l'explorateur VS Code.
• Symptôme : Codex répond en anglais alors que vous parlez français.
  Cause : Il est parfois influencé par la langue par défaut de l'interface ou des mots techniques employés.
  Solution : Ajoutez "Réponds en français" à la fin de votre prompt.
• Symptôme : Vous confondez le champ de recherche de VS Code avec le terminal.
  Cause : L'interface de VS Code est très riche.
  Solution : Assurez-vous de cliquer bien en bas, dans le panneau "Terminal", là où le curseur clignote après un chemin de dossier.
• Symptôme : L'IA s'arrête de répondre au milieu d'une phrase longue.
  Cause : Connexion instable ou limite de réponse atteinte par OpenAI.
  Solution : Tapez simplement "Continue" et elle reprendra où elle s'était arrêtée.
• Symptôme : Vous ne trouvez plus le dossier `mon-premier-projet`.
  Cause : Vous l'avez créé à un endroit inattendu de l'ordinateur.
  Solution : Lors de la création, vérifiez toujours le "chemin parent" (ex: C:\Users\VotreNom\Documents\...).
• Symptôme : Codex refuse de fonctionner sans Internet.
  Cause : C'est son fonctionnement normal.
  Solution : Activez le Wi-Fi ou connectez-vous au réseau.
• Symptôme : Vous avez peur de "tout casser" en tapant un prompt aléatoire.
  Cause : Le syndrome de l'imposteur du débutant.
  Solution : Lancez-vous ! Au pire, vous effacerez le dossier `mon-premier-projet` et vous recommencerez. Rien ne peut endommager votre ordinateur.

Conseils

Bonnes habitudes à adopter dès le début

L'intelligence artificielle amplifie vos compétences, mais elle amplifie aussi votre désordre. Pour que l'expérience reste fluide au fil des semaines, adoptez ces réflexes :

• Travailler étape par étape : Ne demandez jamais dix actions d'un coup. Demandez-en une. Vérifiez. Passez à la suivante.
• Poser une seule question à la fois : Si vous demandez à la fois de modifier un design et de corriger une faute d'orthographe, Codex peut se concentrer sur l'un au détriment de l'autre.
• Demander des explications : Si Codex utilise un mot inconnu (comme "refactoring" ou "repo"), arrêtez tout et demandez-lui ce que cela signifie. Il est là pour ça.
• Tester régulièrement : Après chaque modification, ouvrez le fichier ou vérifiez le résultat visuellement. Ne générez pas du code pendant une heure sans jamais regarder si cela fonctionne en réalité.
• Conserver un projet propre : Si vous créez des dizaines de fichiers de test, supprimez-les une fois terminés. Moins il y a de fichiers dans le dossier, plus Codex sera rapide et précis dans ses analyses.

Foire aux questions

À retenir

Transition vers le chapitre suivant

Savoir parler à Codex est une chose. Savoir quoi lui dire pour obtenir un résultat professionnel en est une autre.

Dans le prochain chapitre, nous allons écrire votre première véritable application. Nous apprendrons comment rédiger un prompt précis, comment diriger l'IA, et comment corriger le tir si elle ne comprend pas immédiatement ce que nous souhaitons accomplir.