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 :

Codex CLI 配置结构图
Figure : Structure de la configuration de Codex CLI

Exemple de configuration complète

# ~/.codex/config.toml

# 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 configurationTypeDescription
model.defaultstringModèle par défaut utilisé
model.reasoning_effortstringEffort 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 simples
  • o4-mini-high- Version à haut raisonnement de o4-mini
  • o3- Capacités de raisonnement solides
  • o3-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 configurationTypeDescriptionValeur par défaut
tui.alternate_screenstringMode d'écran alternatif : auto/always/neverauto
tui.widthnombreLargeur du terminal0 (automatique)
tui.heightnombreHauteur du terminal0 (automatique)

Explication du mode écran alternatif

  • auto- Détection automatique, désactivée automatiquement dans les multiplexeurs de terminal tels que Zellij
  • always- 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

# Désactiver le mode écran alternatif
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 configurationTypeDescription
skills.enabledbooléenIndique s'il faut activer le système de compétences
skills.directorystringRépertoire des fichiers de compétences

Répertoire personnalisé des compétences

Configurer le répertoire des compétences

[skills]
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

[mcp_servers.docs]
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 demande
  • deny- Rejet automatique
  • ask- 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 configurationTypeDescription
features.js_replbooléenActiver JavaScript REPL
features.js_repl_tools_onlybooléenRestreindre à l'outil js_repl uniquement

Configuration du REPL JavaScript

Activer JavaScript REPL

[features]
js_repl = true

Vous pouvez également spécifier le chemin de Node.js :

Spécifier le chemin de Node.js

js_repl_node_path = "/usr/local/bin/node"

Configuration des notifications

Codex peut envoyer des notifications lorsque les tâches sont terminées :

Élément de configurationTypeDescription
notify.enabledbooléenActiver 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'environnementDescriptionValeur par défaut
CODEX_SQLITE_HOMERépertoire de la base de données SQLiteIdentique à CODEX_HOME

Configurer le répertoire SQLite

export CODEX_SQLITE_HOME=/path/to/sqlite
codex

Configuration de la journalisation

Codex utilise env_logger de Rust ; vous pouvez configurer le niveau de journalisation :

Configurer la sortie des journaux

# Voir les 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 journalisationDescription
errorAfficher uniquement les erreurs
warnAfficher les avertissements et les erreurs
infoAfficher les informations générales, les avertissements et les erreurs
debugAfficher les informations de débogage
traceAfficher 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

# Définir l'effort de raisonnement par défaut pour le mode Plan
# Valeurs optionnelles : low/medium/high/none
plan_mode_reasoning_effort = "medium"

Exemples de configuration courants

Configuration de base

Configuration minimale

# Utiliser les paramètres par défaut
# Codex fournit déjà des valeurs par défaut raisonnables

Configuration haute performance

Configuration d'optimisation des performances

[model]
default = "o4-mini"

[tui]
alternate_screen = "always"

[features]
js_repl = true

Configuration développeur

Configuration développeur

[model]
default = "o4-mini"
reasoning_effort = "high"

[tui]
alternate_screen = "never"

[skills]
enabled = true
directory = "~/codex-skills"
Autres extensions