Codex Configuration de la CLI
Codex CLI peut être personnalisé via des fichiers de configuration. Cette section décrit la structure des fichiers de configuration, les différentes options de configuration et comment les ajuster selon vos besoins.
Emplacement du fichier de configuration
Le fichier de configuration de Codex se trouve dans le répertoire personnel de l'utilisateur, sous~/.codex/config.toml:
~/.codex/config.toml
Si le fichier n'existe pas, vous devez le créer manuellement. Codex créera un fichier de configuration par défaut lors du premier démarrage.
Après avoir modifié la configuration, vous devez redémarrer Codex pour que cela prenne effet.
Structure du fichier de configuration
Un fichier de configuration complet peut inclure les sections suivantes :
Exemple de configuration complète
# Paramètres de base
[model]
default = "o4-mini" # Modèle par défaut à utiliser
# Paramètres TUI
[tui]
alternate_screen = "auto" # Mode écran alternatif : auto/always/never
# Configuration des compétences
[skills]
enabled = true
# Interrupteurs de fonctionnalités
[features]
js_repl = false # Indique s'il faut activer le REPL JavaScript
# Configuration du serveur MCP
[mcp_servers]
# Paramètres de notification
[notify]
enabled = false
Configuration du modèle
Codex prend en charge plusieurs modèles ; vous pouvez choisir en fonction des exigences de la tâche :
| Élément de configuration | Type | Description |
|---|---|---|
model.default | string | Modèle par défaut utilisé |
model.reasoning_effort | string | Effort de raisonnement : low/medium/high |
Modèles disponibles
Les modèles disponibles dans Codex CLI incluent :
o4-mini- Rapide et efficace, adapté aux tâches simpleso4-mini-high- Version à haut raisonnement de o4-minio3- Capacités de raisonnement solideso3-pro- Version professionnelle de o3
Les différents modèles ont des vitesses et des prix différents ; choisir le bon modèle peut optimiser l'expérience utilisateur et le coût.
Configuration de l'interface TUI
Paramètres pertinents pour l'interface utilisateur du terminal :
| Élément de configuration | Type | Description | Valeur par défaut |
|---|---|---|---|
tui.alternate_screen | string | Mode d'écran alternatif : auto/always/never | auto |
tui.width | nombre | Largeur du terminal | 0 (automatique) |
tui.height | nombre | Hauteur du terminal | 0 (automatique) |
Explication du mode écran alternatif
auto- Détection automatique, désactivée automatiquement dans les multiplexeurs de terminal tels que Zellijalways- Toujours utiliser l'écran alternatif (expérience par défaut)never- Ne jamais utiliser l'écran alternatif (préserver l'historique de défilement)
Surcharge à l'exécution
Vous pouvez surcharger ces paramètres à l'exécution via des arguments de ligne de commande :
Configuration de surcharge en ligne de commande
codex --no-alt-screen
Configuration des compétences
Les compétences sont le mécanisme d'extension de Codex qui vous permet de personnaliser les flux de travail :
| Élément de configuration | Type | Description |
|---|---|---|
skills.enabled | booléen | Indique s'il faut activer le système de compétences |
skills.directory | string | Répertoire des fichiers de compétences |
Répertoire personnalisé des compétences
Configurer le répertoire des compétences
enabled = true
directory = "~/my-codex-skills"
Configuration du serveur MCP
Les serveurs MCP (Model Context Protocol) permettent à Codex de s'intégrer à des outils et services externes :
Configurer le serveur MCP
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]
# Configuration des autorisations d'outils
[mcp_servers.docs.tools.search]
approval_mode = "approve"
Autorisations des outils MCP
Vous pouvez définir les autorisations individuellement pour les outils de chaque serveur MCP :
approve- Approbation automatique, aucune demandedeny- Rejet automatiqueask- Demander avant chaque exécution (par défaut)
Soyez prudent lors de la configuration des serveurs MCP ; n'activez que les outils auxquels vous faites confiance.
Interrupteurs de fonctionnalités
Activez ou désactivez des fonctionnalités Codex spécifiques :
| Élément de configuration | Type | Description |
|---|---|---|
features.js_repl | booléen | Activer JavaScript REPL |
features.js_repl_tools_only | booléen | Restreindre à l'outil js_repl uniquement |
Configuration du REPL JavaScript
Activer JavaScript REPL
js_repl = true
Vous pouvez également spécifier le chemin de Node.js :
Spécifier le chemin de Node.js
Configuration des notifications
Codex peut envoyer des notifications lorsque les tâches sont terminées :
| Élément de configuration | Type | Description |
|---|---|---|
notify.enabled | booléen | Activer les notifications |
Configurer les hooks de notification
Vous pouvez configurer des scripts de notification personnalisés via des variables d'environnement :
CODEX_NOTIFY_HOOK=/path/to/your/notify-script.sh
Base de données d'état SQLite
Codex utilise SQLite pour stocker l'état interne :
| Variable d'environnement | Description | Valeur par défaut |
|---|---|---|
CODEX_SQLITE_HOME | Répertoire de la base de données SQLite | Identique à CODEX_HOME |
Configurer le répertoire SQLite
codex
Configuration de la journalisation
Codex utilise env_logger de Rust ; vous pouvez configurer le niveau de journalisation :
Configurer la sortie des journaux
tail -f ~/.codex/log/codex-tui.log
# Définir le niveau de journalisation
RUST_LOG=codex_core=info,codex_tui=info,codex_rmcp_client=info codex
| Niveau de journalisation | Description |
|---|---|
error | Afficher uniquement les erreurs |
warn | Afficher les avertissements et les erreurs |
info | Afficher les informations générales, les avertissements et les erreurs |
debug | Afficher les informations de débogage |
trace | Afficher les informations de trace détaillées |
Par défaut, le niveau de journalisation en mode TUI est info, et le niveau par défaut en mode non interactif (exec) est error.
Configuration du mode Plan
Configurer le comportement de Codex en mode Plan :
Configurer le mode Plan
# Valeurs optionnelles : low/medium/high/none
plan_mode_reasoning_effort = "medium"
Exemples de configuration courants
Configuration de base
Configuration minimale
# Codex fournit déjà des valeurs par défaut raisonnables
Configuration haute performance
Configuration d'optimisation des performances
default = "o4-mini"
[tui]
alternate_screen = "always"
[features]
js_repl = true
Configuration développeur
Configuration développeur
default = "o4-mini"
reasoning_effort = "high"
[tui]
alternate_screen = "never"
[skills]
enabled = true
directory = "~/codex-skills"