Setup initial pour vibe coding : préparer VS Code avec Codex

Bienvenue dans le vibe coding.

Avant de demander à un agent d’écrire, de refactorer ou de relire du code, préparez l’environnement.

Sans cela, vous augmentez le bruit. Vous perdez l’historique. Vous mélangez les outils. Vous laissez des décisions importantes cachées dans des fenêtres de chat isolées.

Ce guide couvre le setup initial pour travailler avec VS Code, Codex et GitHub sur Windows ou macOS.

1. Comprendre l’accès à Codex

Codex est l’agent de programmation d’OpenAI. Il peut agir via l’application, la CLI, l’extension d’IDE et le web.

La manière la plus directe de commencer est d’entrer dans le client Codex avec votre compte ChatGPT. L’usage est disponible dans les plans ChatGPT éligibles, avec des limites qui varient selon le plan.

Il existe aussi un usage par API pour des flux techniques spécifiques, des automatisations et des organisations qui préfèrent provisionner les clés manuellement.

Avant de configurer, consultez la documentation actuelle :

Si vous choisissez d’utiliser une API key :

Accédez à la plateforme développeur OpenAI.
Créez un compte ou connectez-vous.
Configurez la facturation dans Settings > Billing.
Créez une clé dans API Keys.
Gardez la clé dans un endroit sûr. Elle ne doit pas être commitée dans le dépôt.

2. Installer VS Code

Visual Studio Code sera la base de travail.

Vous pouvez le télécharger depuis le site officiel ou l’installer par le terminal.

Sur Windows, avec PowerShell :

winget install -e --id Microsoft.VisualStudioCode

Sur macOS, avec Homebrew :

brew install --cask visual-studio-code

Après l’installation, ouvrez VS Code et confirmez que le terminal intégré fonctionne.

3. Réduire les conflits entre assistants

Si vous utilisez déjà GitHub Copilot ou un autre assistant, décidez quel outil dirigera la session.

Pour le vibe coding, l’idéal est d’éviter deux agents en compétition dans le même espace. L’autocomplete agressif, les raccourcis dupliqués et les suggestions constantes peuvent gêner la lecture de ce que fait l’agent principal.

Vous n’avez pas besoin de tout supprimer pour toujours. Mais pendant une session avec Codex, il vaut mieux mettre en pause ou désactiver les extensions concurrentes.

Dans VS Code :

Ouvrez Extensions.
Cherchez GitHub Copilot ou une autre extension d’IA.
Cliquez sur Disable pour le workspace ou désactivez-la temporairement.

L’objectif est simple : une session, une direction, un agent principal.

4. Installer et authentifier Codex

Choisissez le client Codex qui correspond le mieux à votre flux :

Codex CLI ;
extension Codex pour VS Code ;
application Codex ;
Codex sur le web.

Pour commencer par la CLI, installez le paquet officiel :

npm install -g @openai/codex

Puis connectez-vous :

codex

ou, quand applicable :

codex --login

Suivez le flux d’authentification affiché dans le terminal.

Si vous utilisez l’extension VS Code, installez-la depuis l’onglet des extensions, ouvrez le panneau Codex et suivez les instructions de connexion. Préférez l’authentification avec ChatGPT quand elle est disponible. Utilisez une API key seulement si c’est le flux choisi.

5. Configurer Git et GitHub

Le vibe coding sans Git devient une mémoire courte.

Avant de demander de vrais changements, configurez votre identité :

git config --global user.name "Votre Nom Complet"
git config --global user.email "votreemail@exemple.com"

Ensuite, dans le dossier du projet :

git init
git status

Si le projet n’est pas encore sur GitHub, utilisez le panneau Source Control de VS Code ou GitHub CLI pour publier le dépôt.

Avec GitHub CLI :

gh auth login
gh repo create nom-du-repository --private --source=. --remote=origin --push

Faites de petits commits. Chaque étape doit être compréhensible.

6. Créer les fichiers de direction du projet

L’agent a besoin d’un contexte persistant.

Créez au minimum :

AGENTS.md
README.md
PLANS.md
docs/

Utilisez AGENTS.md pour les règles de travail.

Utilisez README.md pour expliquer le projet.

Utilisez PLANS.md pour organiser de petites étapes.

Utilisez docs/ pour enregistrer décisions, risques et conventions.

Un premier prompt utile :

Lisez AGENTS.md, README.md et PLANS.md.
Comprenez l'objectif du projet.
N'implémentez rien pour l'instant.
Listez les risques, les questions et une première petite étape d'implémentation.

7. Comprendre la différence entre chat et agent

Beaucoup de frustration vient du fait de traiter des outils différents comme s’ils étaient identiques.

Chat	Codex intégré à l’environnement
Répond à des questions et suggère des extraits.	Lit les fichiers, comprend la structure et peut éditer le projet.
Vous copiez, collez et décidez où intégrer.	L’agent navigue dans le dépôt et propose des changements concrets.
Fonctionne bien pour expliquer et explorer.	Fonctionne bien pour implémenter, relire et valider.
Dépend beaucoup du contexte que vous collez.	Utilise le contexte local du workspace, dans les limites autorisées.

Le chat aide à penser.

L’agent aide à exécuter.

Les deux sont utiles. Mais ils ne font pas le même travail.

8. Commencer par un petit cycle

Après le setup, ne demandez pas tout le système.

Demandez une étape :

Lisez AGENTS.md et PLANS.md.
Implémentez seulement la première étape.
Avant d'éditer, dites quels fichiers vous comptez modifier.
Ensuite lancez les validations disponibles et mettez à jour la documentation nécessaire.

C’est le bon départ.

Environnement prêt. Historique protégé. Agent avec contexte. Humain encore aux commandes.

Bienvenue dans le vibe coding.