Agents.md LogoAgents.md
Codage IA basé sur le terminal

OpenAI Codex CLI

Un puissant outil en ligne de commande qui apporte le codage assisté par IA directement dans votre terminal, vous aide à créer des fonctionnalités, corriger des bogues et comprendre du code inconnu sans quitter votre flux de travail.

Fonctionnalités principales

Fonctionnalités clés d’OpenAI Codex CLI

Découvrez comment Codex CLI améliore votre flux de développement grâce à de puissantes capacités d’IA

Installation sans configuration

Commencez avec une simple commande npm install. Codex CLI s’intègre facilement à votre environnement de développement sans configuration complexe.

L’outil fonctionne immédiatement : il suffit d’une clé API OpenAI pour bénéficier d’une assistance IA directement dans votre terminal.

Flux d’approbation flexibles

Choisissez parmi trois modes selon votre niveau de contrôle souhaité : du mode suggestion (vous approuvez chaque changement) au mode entièrement automatisé dans un environnement isolé.

Entrées multimodales

Prend en charge le texte, les captures d’écran ou les schémas comme entrées afin que l’IA génère ou modifie du code à partir de contenus visuels.

Natif pour le terminal

Fonctionne entièrement dans votre terminal, éliminant les changements de contexte pour un flux plus fluide.

Sécurité et contrôle

Modes d’approbation

Choisissez le niveau d’autonomie qui vous convient avec trois modes d’approbation flexibles

ModeCe que l’agent peut faireQuand l’utiliser
Suggestion
(par défaut)
Lit les fichiers. Propose des modifications et des commandes shell, mais nécessite votre approbation avant tout changement ou exécution.Exploration sans risque, revues de code, découverte d’un codebase.
Édition automatiqueLit et écrit les fichiers automatiquement. Continue de demander avant d’exécuter des commandes shell.Refactorings ou modifications répétitives tout en gardant un œil sur les effets de bord.
Automatisation complèteLit, écrit et exécute des commandes de façon autonome dans un environnement isolé et sans réseau, limité au répertoire courant.Tâches longues comme réparer une build cassée ou prototyper des fonctionnalités pendant une pause.
Prise en main

Guide de démarrage rapide

Mettez en route OpenAI Codex CLI en quelques minutes

Installation

npm install -g @openai/codex

Ensuite, définissez votre clé API OpenAI comme variable d’environnement :

export OPENAI_API_KEY="your-api-key-here"

Remarque: Cette commande définit la clé seulement pour la session du terminal en cours. Vous pouvez ajouter la ligne 'export' au fichier de configuration de votre shell (p. ex. '~/.zshrc'), mais nous recommandons de la définir pour la session.

Exécuter Codex CLI

Exécution interactive :

codex

Ou exécutez avec un prompt en entrée :

codex "explain this codebase to me"

Exécuter en mode Automatisation complète :

codex --approval-mode full-auto "create a todo-list app"
Exemples pratiques

Exemples d’utilisation

Découvrez comment Codex CLI aide pour des tâches de développement courantes

Refactoriser des composants

codex "Refactor the Dashboard component to React Hooks"

Codex réécrit le composant en classes, lance npm test et affiche le diff.

Générer des migrations SQL

codex "Generate SQL migrations for adding a users table"

Détecte votre ORM, crée les fichiers de migration et les exécute dans une base isolée.

Écrire des tests unitaires

codex "Write unit tests for utils/date.ts"

Génère des tests, les exécute et itère jusqu’à réussite.

Renommer des fichiers en masse

codex "Bulk-rename *.jpeg -> *.jpg with git mv"

Renomme les fichiers en toute sécurité et met à jour les imports/usages.

Détails techniques

Configuration requise

Assurez‑vous que votre système répond à ces exigences avant l’installation

ExigenceDétails
Système d’exploitationmacOS 12+, Ubuntu 20.04+/Debian 10+ ou Windows 11 (via WSL2)
Node.jsVersion 22 ou ultérieure (LTS recommandé)
Git (optionnel)Version 2.23+ pour l’assistant PR intégré
RAMMinimum 4 Go (8 Go recommandés)
Avantages et limites

Avantages et inconvénients

Comprendre les forces et les limites d’OpenAI Codex CLI

Avantages

  • Mise en route instantanée: Fonctionne immédiatement avec une simple clé API OpenAI, sans configuration complexe.

  • Sécurité: S’exécute dans un environnement sans réseau et isolé au répertoire, pour plus de sécurité.

  • Multimodal: Accepte des captures d’écran ou des schémas pour implémenter des fonctionnalités à partir de contenus visuels.

  • Open Source: Entièrement open source, vous pouvez inspecter et contribuer au code.

Limites

  • Prise en charge Windows: Pas de support Windows natif ; WSL2 requis pour les utilisateurs Windows.

  • Clé API requise: Nécessite une clé API OpenAI et peut entraîner des coûts d’usage.

  • Intervention utilisateur: Peut nécessiter des interventions dans des scénarios complexes.

  • Courbe d’apprentissage: L’interface en ligne de commande peut demander un temps d’adaptation pour certains développeurs.