Codex CLI 0.171.0 : GPT-6.2 Sol par défaut, espace TUI et --remote

Codex CLI 0.171.0 définit GPT-6.2 Sol comme modèle par défaut du catalogue, active le TUI workspace à volets scindés par défaut, ajoute codex exec --remote <ADDR> ainsi que /rc, et préserve les permission profiles lors des changements de répertoire. Vérifiez les ID de modèles actifs, revenez à GPT-6.2 Astra ou configurez une API personnalisée comme BetterToken, désactivez le workspace au besoin et contrôlez les prérequis d'exécution distante.

Sommaire
Codex CLI 0.171.0 : GPT-6.2 Sol par défaut, espace TUI et --remote

La mise à niveau vers Codex CLI 0.171.0 (publiée le 20 novembre 2026) ajoute gpt-6.2-sol comme modèle par défaut du catalogue et active par défaut l’espace de travail TUI à volets scindés. Ce changement concerne toute personne lançant codex sans clé model figée dans config.toml, les équipes qui scriptent codex exec et les développeurs qui routent Codex vers un fournisseur API personnalisé. Pour conserver Astra, figez model = "gpt-6.2-astra" dans config.toml, exécutez codex features disable tui_workspace pour retrouver l’affichage terminal à panneau unique, ou configurez ci-dessous un accès API GPT-6.2 facturé à l’usage.

Voies d’accès pour exécuter GPT-6.2 Sol et Astra dans Codex CLI 0.171.0

Avant de modifier vos fichiers, choisissez comment Codex s’authentifie et facture votre consommation GPT-6.2. La voie retenue détermine quels identifiants de modèles fonctionnent et si les fonctions réservées à ChatGPT, comme Codex cloud ou le contrôle à distance /rc, restent accessibles.

VoieCompte et authentificationUnité de facturationPrise en charge et limites dans Codex 0.171.0Idéal quand
Abonnement ChatGPT (codex login)Compte ChatGPT via connexion navigateurQuota inclus dans l’abonnement (partagé entre messages locaux et discussions cloud)Prend en charge Codex cloud et le contrôle à distance /rc ; ChatGPT Pro 200 ajoute Ultrafast avec SolVous disposez déjà d’un abonnement ChatGPT éligible et souhaitez les fonctions cloud ou de contrôle à distance
API OpenAI directeCompte OpenAI Platform + clé APIPar 1M jetons (USD)Utilise gpt-6.2-sol et gpt-6.2-astra ; aucune fonction cloud, et /rc est indisponible avec une clé APIVous préférez la facturation directe OpenAI et les politiques de données de votre organisation API
Passerelle API BetterTokenCompte BetterToken + clé APISolde à l’usage selon l’unité du modèleRéférence gpt-6.2-sol et gpt-6.2-astra via OpenAI Responses (https://www.bettertoken.ai/v1) ; le solde payant ne se réinitialise pas chaque moisVous voulez un accès API multi-modèles à l’usage sans abonnement ChatGPT

Configurer Codex CLI 0.171.0 avec BetterToken

BetterToken est une plateforme d’accès API multi-modèles facturée à l’usage, et non un produit officiel OpenAI. Au 2026-11-21, BetterToken propose à la fois gpt-6.2-sol et gpt-6.2-astra sur sa page des tarifs actuels via le protocole OpenAI Responses (https://www.bettertoken.ai/v1). Consultez la présentation de l’API Codex pour un résumé de la compatibilité Codex.

Créez votre compte BetterToken puis générez votre clé API dans la console BetterToken. L’authentification par clé API stockée dans auth.json remplace la connexion ChatGPT officielle : dans ce mode, les fonctions exclusives à ChatGPT comme /rc et Ultrafast sur ChatGPT Pro 200 ne sont pas disponibles. Pour conserver votre connexion ChatGPT officielle en parallèle d’un fournisseur tiers, suivez le guide BetterToken de préservation de la connexion officielle au lieu de modifier auth.json.

Fermez complètement Codex CLI et Codex App avant d’éditer les fichiers, car les deux clients partagent config.toml et auth.json dans le même répertoire Codex ($CODEX_HOME s’il est défini, sinon ~/.codex sur macOS/Linux ou %USERPROFILE%\.codex sur Windows ; voir Codex CLI vs Codex App vs extension VS Code). Sauvegardez config.toml et auth.json depuis ce répertoire actif dans un emplacement privé, et créez config.toml s’il n’existe pas encore.

Dans config.toml, mettez à jour sur place toute clé racine existante (model_provider, model ou cli_auth_credentials_store) et n’ajoutez que les clés manquantes avant tout bloc [tables]. Si la table [model_providers.bettertoken] existe déjà, fusionnez ces champs dans la table existante au lieu de dupliquer son en-tête ; sinon, ajoutez le bloc ci-dessous en conservant vos autres paramètres intacts, comme indiqué dans le guide de configuration Codex de BetterToken :

model_provider = "bettertoken"
model = "gpt-6.2-sol"
cli_auth_credentials_store = "file"

[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

Remplacez la valeur de model par "gpt-6.2-astra" si vous préférez Astra par défaut. Supprimez env_key et experimental_bearer_token dans [model_providers.bettertoken] lorsque vous utilisez l’authentification par fichier.

Écrivez ensuite auth.json dans ce même répertoire Codex résolu. Sur macOS ou Linux avec Bash et Python 3, exécutez le script ci-dessous pour saisir votre clé sans l’afficher à l’écran ; il s’arrête sans modifier auth.json si la saisie est annulée ou vide, et crée le fichier temporaire avec des permissions réservées au propriétaire (0600) avant d’y écrire la clé. Sur Windows natif, appliquez les étapes documentées pour auth.json (auth_mode réglé sur "apikey" et OPENAI_API_KEY contenant votre clé) dans votre répertoire Codex actif ($CODEX_HOME ou %USERPROFILE%\.codex) d’après le guide de configuration Codex de BetterToken :

CODEX_DIR="${CODEX_HOME:-$HOME/.codex}"
mkdir -p "$CODEX_DIR"
if IFS= read -rs BETTERTOKEN_API_KEY && [ -n "$BETTERTOKEN_API_KEY" ]; then
  export BETTERTOKEN_API_KEY CODEX_DIR
  python3 -c 'import json, os, pathlib, tempfile
dir_path = pathlib.Path(os.environ["CODEX_DIR"])
fd, tmp_name = tempfile.mkstemp(prefix=".auth.", dir=dir_path)
try:
    os.fchmod(fd, 0o600)
    with os.fdopen(fd, "w", encoding="utf-8") as fh:
        json.dump({"auth_mode": "apikey", "OPENAI_API_KEY": os.environ["BETTERTOKEN_API_KEY"]}, fh, indent=2)
        fh.write("\n")
    os.replace(tmp_name, dir_path / "auth.json")
except Exception:
    os.unlink(tmp_name)
    raise'
  unset BETTERTOKEN_API_KEY
else
  echo "API key entry cancelled or empty; auth.json was not changed." >&2
fi

Si Node.js est installé et que vous préférez une configuration automatisée, la documentation Codex de BetterToken fournit également curl -fsSL "https://www.bettertoken.ai/install-codex-provider.sh" | bash pour macOS et Linux, ainsi qu’un script PowerShell (install-codex-provider.ps1) pour Windows. Comparez les fichiers config.toml et auth.json générés avec la configuration manuelle ci-dessus avant de relancer Codex.

Pour vérifier le branchement, ouvrez une nouvelle session codex, lancez /status afin de contrôler les lignes Model (gpt-6.2-sol) et Model provider, puis envoyez une courte invite. Une réponse normale confirme que la connexion Responses fonctionne.

Si vous préférez passer directement par OpenAI, installez ou mettez à jour vers 0.171.0 avec npm install -g @openai/codex@0.171.0 (ou partez d’une installation 0.171.0 déjà en place) et vérifiez que codex --version affiche bien 0.171.0. Exécutez ensuite codex login pour un abonnement ChatGPT, ou connectez-vous avec une clé API OpenAI selon la référence d’authentification Codex d’OpenAI. Les équipes qui arbitrent entre quotas d’abonnement et facturation API peuvent consulter la planification du quota partagé ChatGPT et Codex.

Créer un compte BetterToken

Vérifier GPT-6.2 Sol par défaut et sélectionner Astra ou un autre modèle

Dans la PR #62106, Codex CLI 0.171.0 ajoute gpt-6.2-sol et gpt-6.2-astra aux catalogues embarqué, Amazon Bedrock et Vertex, et fait de gpt-6.2-sol la sélection par défaut du catalogue (priority: 1). Cette même mise à jour porte aussi la fenêtre de contexte de gpt-6.1-sol dans le catalogue à 500,000 jetons.

Dans le catalogue embarqué de 0.171.0 (codex-rs/models-manager/models.json), gpt-6.2-sol indique une fenêtre de contexte de 500,000 jetons et gpt-6.2-astra une fenêtre de 272,000 jetons, avec default_reasoning_level réglé sur "low" pour les deux modèles. Sur la documentation API officielle d’OpenAI au 2026-11-21, GPT-6.2 Sol et GPT-6.2 Astra prennent tous deux en charge une fenêtre de contexte de 1,050,000 jetons (922,000 en entrée au maximum, 128,000 en sortie au maximum) et rejettent l’effort de raisonnement none.

L’effet de la mise à jour sur votre modèle actif dépend de votre configuration et du catalogue actif (codex-rs/models-manager/src/manager.rs) :

  • Si model est absent de config.toml, get_default_model choisit le modèle par défaut du catalogue actif (default_model_from_available). Avec le catalogue embarqué de 0.171.0, ce choix devient gpt-6.2-sol.
  • Si model est explicitement défini dans votre config.toml utilisateur (ou dans le .codex/config.toml d’un projet de confiance), Codex conserve ce modèle, sauf si le repli fournisseur est activé et remplace un modèle indisponible.

Inspectez le catalogue embarqué dans votre binaire installé :

codex debug models --bundled

Dans une session TUI interactive, lancez /status pour vérifier la ligne Model (et Model provider lorsqu’il est défini). Pour changer de modèle sans modifier config.toml, utilisez /model dans le TUI ou passez --model / -m au lancement :

codex -m gpt-6.2-astra
codex exec -m gpt-6.2-astra "Audit the auth middleware for race conditions"

Pour définir gpt-6.2-astra (ou un modèle antérieur comme gpt-6.1-sol) de façon permanente, ajoutez ou mettez à jour model = "gpt-6.2-astra" à la racine de $CODEX_HOME/config.toml (par défaut ~/.codex/config.toml), au-dessus de tous les [tables], puis redémarrez Codex.

Au 2026-11-21, les tarifs publics de l’API Standard d’OpenAI pour les jetons texte jusqu’à 272K jetons en entrée sont de $2 en entrée / $10 en sortie par 1M jetons pour GPT-6.2 Sol, et de $8 en entrée / $40 en sortie par 1M jetons pour GPT-6.2 Astra. Au-delà de 272K jetons en entrée sur l’un ou l’autre modèle, les tarifs d’entrée et de cache doublent et la sortie coûte 1.5 fois le tarif contexte court sur l’ensemble de la requête. Commencez avec Sol pour le développement courant et basculez sur Astra lorsqu’une tâche multi-fichiers exige un raisonnement plus poussé ; voyez le comparatif GPT-6 Astra vs Sol vs Luna pour affiner ce choix. Le mode Ultrafast avec Sol relève de l’abonnement ChatGPT Pro 200 (et sur l’API OpenAI, Ultrafast coûte 3 fois le tarif Standard jusqu’au 28 février 2027), pas d’une option par défaut d’une passerelle personnalisée.

Associer les noms du catalogue aux vrais ID de modèles sur les fournisseurs personnalisés

Codex affiche des libellés lisibles comme GPT-6.2-Sol et GPT-6.2-Astra dans le sélecteur, alors que chaque fournisseur attend son propre identifiant de modèle sur le réseau.

FournisseurID GPT-6.2 SolID GPT-6.2 AstraRemarques
API OpenAI (directe)gpt-6.2-solgpt-6.2-astraCorrespond aux slugs du catalogue embarqué de Codex
BetterToken (https://www.bettertoken.ai/v1)gpt-6.2-solgpt-6.2-astraVérifié sur BetterToken au 2026-11-21 sur OpenAI Responses (openai-response), ainsi que sur les types d’endpoints openai et anthropic
Amazon Bedrockopenai.gpt-6.2-solopenai.gpt-6.2-astraLa normalisation du catalogue reconnaît aussi les ID multi-régions Bedrock Runtime global.openai.gpt-6.2-astra et us.openai.gpt-6.2-astra
Google Vertex AIgpt-6.2-solgpt-6.2-astraAjouté au catalogue GCP intégré dans la PR #62106
Autre model_provider personnaliséDéfini par le fournisseurDéfini par le fournisseurFigez l’identifiant exact model = "..." dans config.toml

Lorsque model est omis dans config.toml, Codex résout la valeur par défaut depuis le catalogue actif au lieu de deviner la convention de nommage de votre passerelle. Si votre model_provider personnalisé emploie des préfixes ou des alias différents des slugs embarqués, vos requêtes peuvent échouer tant que vous ne figez pas l’ID exact model = "..." attendu par votre passerelle à la racine de config.toml (jamais à l’intérieur de [projects."<path>"], qui stocke le trust_level du projet).

TUI workspace activé par défaut : changements et désactivation

La PR #61352 fait passer la fonctionnalité tui_workspace au statut Stable avec default_enabled: true. Après mise à jour, un panneau latéral accompagne votre conversation principale dans le terminal :

  • Aperçus de documents (PR #61888, PR #61889) : ouvrir un lien de fichier dans la transcription affiche un onglet Markdown en lecture seule dans la barre latérale, avec recherche, sélection clavier/souris, copie Markdown hors ligne et navigation dans les liens via Tab / Shift+Tab puis Enter.
  • Aperçus d’images (PR #61919) : les liens PNG, JPEG, GIF et WebP s’ouvrent en aperçu image dans la barre latérale avec le format et les dimensions, ou basculent en texte si le terminal ne gère pas l’affichage graphique. Les images générées et enregistrées apparaissent après la réponse de l’assistant avec un libellé cliquable Generated image.
  • Transcriptions des sous-agents (PR #62157) : sélectionner un sous-agent dans la barre latérale ouvre un lecteur en lecture seule à côté de la conversation parente au lieu de remplacer votre discussion active.

La fermeture d’un panneau latéral dépend de l’élément actif :

  • Dans un aperçu de document, appuyez sur Esc pour fermer l’aperçu.
  • Dans un lecteur de transcription de sous-agent, appuyez sur Esc pour revenir à la liste des sous-agents sur le même agent, ou utilisez le bouton ou le raccourci de fermeture de la barre latérale pour fermer l’onglet.

Pour désactiver l’espace de travail TUI sur une seule session, lancez Codex avec --disable :

codex --disable tui_workspace

Pour désactiver tui_workspace de façon permanente dans $CODEX_HOME/config.toml, exécutez :

codex features disable tui_workspace

Vous pouvez aussi écrire le drapeau manuellement dans $CODEX_HOME/config.toml :

[features]
tui_workspace = false

Ouvrez une nouvelle session codex pour vérifier que la barre latérale reste désactivée. Couper tui_workspace désactive ensemble la barre latérale et ses onglets d’aperçu.

Exécution distante avec codex exec --remote vs /rc et /remote dans le TUI

Codex CLI 0.171.0 introduit deux fonctions distantes distinctes :

  • codex exec --remote <ADDR> exécute un tour non interactif sur un codex app-server déjà en cours d’exécution.
  • /rc (alias /remote) gère le contrôle à distance par appareil du serveur local d’arrière-plan géré directement depuis le TUI.

Syntaxe, transport et limites de codex exec --remote <ADDR>

La PR #61707 permet à codex exec de se raccorder à un app-server existant via ws://host:port, wss://host:port, unix:// (socket Unix par défaut) ou unix://PATH.

Exemple sur le même hôte ou via tunnel SSH (boucle locale) : les écoutes WebSocket en clair sur ws://127.0.0.1:PORT conviennent uniquement à localhost ou à une redirection de port SSH. Démarrez le serveur sur cet hôte :

codex app-server --listen ws://127.0.0.1:4500

Exécutez ensuite codex exec sur la même machine (ou à travers un tunnel SSH redirigeant le port 4500) :

codex exec --remote ws://127.0.0.1:4500 "Run the test suite and summarize failures"

Hôte distinct ou runner CI (wss:// authentifié) : les écoutes WebSocket hors boucle locale acceptent par défaut les connexions non authentifiées pendant le déploiement, et codex app-server écoute lui-même en ws:// (voir la documentation app-server d’OpenAI). Avant d’exposer un app-server à une autre machine ou à un runner CI, activez l’authentification WebSocket côté serveur (privilégiez --ws-token-file plutôt qu’un jeton brut sur la ligne de commande) et placez une terminaison TLS devant le service afin que les clients se connectent en wss:// :

# On the app-server host (behind a TLS reverse proxy exposing wss://remote-host:4500)
codex app-server --listen ws://127.0.0.1:4500 \
  --ws-auth capability-token \
  --ws-token-file /absolute/path/to/app-server-token

Sur le client ou le runner CI, transmettez le jeton Bearer correspondant via le nom d’une variable d’environnement avec --remote-auth-token-env. En sortie humaine, codex exec --remote écrit thread id: <UUID> sur stderr ; avec --json, il émet un événement JSONL thread.started ("type": "thread.started") contenant thread_id. Réutilisez l’UUID renvoyé lors du premier appel pour reprendre ce fil :

if IFS= read -rs CODEX_REMOTE_TOKEN && [ -n "$CODEX_REMOTE_TOKEN" ]; then
  export CODEX_REMOTE_TOKEN

  # Start a new noninteractive turn (capture thread_id from the thread.started JSONL event)
  codex exec --remote wss://remote-host:4500 \
    --remote-auth-token-env CODEX_REMOTE_TOKEN \
    --json "Run the test suite and summarize failures"

  # Resume syntax example: replace <THREAD_UUID> with the thread_id returned above
  codex exec --remote wss://remote-host:4500 \
    --remote-auth-token-env CODEX_REMOTE_TOKEN \
    resume <THREAD_UUID> "Fix the failing parser test"

  unset CODEX_REMOTE_TOKEN
else
  echo "Remote token entry cancelled or empty." >&2
fi

Vous pouvez placer --remote et --remote-auth-token-env avant ou après exec ; indiquer des endpoints différents aux deux endroits renvoie l’erreur `codex exec` received conflicting remote server endpoints. Trois limites strictes sont vérifiées dans 0.171.0 (codex-rs/exec/src/remote.rs) :

  1. Le serveur détient la configuration de l’agent : passer des surcharges de configuration comme -m/--model, -s/--sandbox, -C/--cd, -c, -i/--image, -p/--profile, --add-dir, --output-schema, --ephemeral ou --worktree échoue avec "--remote currently supports only prompt, resume by UUID, and output options; configure the agent on the server".
  2. Reprise par UUID uniquement : exec --remote resume rejette --last, --all, --image ou toute cible qui n’est pas un UUID avec "remote resume requires a thread UUID".
  3. Pas de tour concurrent : cibler un fil dont le statut est déjà actif échoue avec "remote thread already has an active turn".

/rc et /remote dans le TUI

La PR #62121 ajoute /rc (et /remote) dans le TUI pour activer ou désactiver le contrôle à distance du serveur local d’arrière-plan géré. Une fois l’option activée, le menu vérifie que remoteControlEnabled a bien été enregistré dans app-server-daemon/settings.json pour le prochain redémarrage et signale tout échec d’écriture ; sélectionner Add device affiche un code d’appairage manuel. Vous pouvez ouvrir /rc pendant l’affichage d’une session cloud, mais ses modifications s’appliquent uniquement aux sessions locales.

Vérifiez trois prérequis avant de compter sur /rc :

  • Le serveur local d’arrière-plan géré doit tourner ; sinon les actions de contrôle à distance échouent avec "Remote control requires the local background server."
  • Vous devez être connecté avec ChatGPT. L’authentification par clé API est refusée avec "Sign in with ChatGPT to manage remote control."
  • Les administrateurs d’entreprise peuvent bloquer la fonction globalement via allow_remote_control = false dans requirements.toml géré, ce qui renvoie "Remote control is disabled by managed requirements."

En dehors du TUI (par exemple via SSH), utilisez codex remote-control start, codex remote-control stop et codex remote-control pair, documentés dans la référence CLI d’OpenAI.

Conservation des permission profiles au changement de répertoire et autres correctifs 0.171.0

Oui, votre profil de permissions actif reste intact lorsque vous changez de répertoire de travail dans 0.171.0. Dans rust-v0.170.0, le problème pouvait survenir quand seul le répertoire de travail changeait et que la racine de projet autorisée en écriture pouvait être réaffectée. Dans ce cas, Codex risquait de recréer un profil de permissions à partir des règles de l’ancien bac à sable (codex-rs/core/src/session/session.rs).

En 0.171.0, la PR #61195 supprime cette branche de reconstruction héritée. Codex conserve ainsi le profil de permissions actif, sa sélection et ses racines de workspace configurées, tout en mettant à jour les racines utilisées à l’exécution vers le nouveau répertoire. Dans le test de non-régression de la PR en mode workspace-write, les fichiers ordinaires du nouveau workspace restent modifiables tandis que les écritures vers .git/config et l’ancien workspace demeurent refusées ; les profils nommés personnalisés continuent d’appliquer leurs propres racines et règles. Si vous gérez des profils réseau ou système de fichiers restreints pour l’installation de paquets, consultez les permission profiles du sandbox Codex pour vérifier vos règles de domaines et d’écriture.

Trois autres correctifs de rust-v0.171.0 réduisent les frictions au quotidien dans le CLI :

  • Conservation du texte non envoyé au changement de session (PR #61216) : brouillons, messages en file d’attente et saisies interrompues restent rattachés à leur fil d’origine lors d’un changement ou d’une reprise de session.
  • Connexion MCP entreprise sans jeton de rafraîchissement (PR #62129) : corrige l’authentification MCP pour les fournisseurs d’identité d’entreprise qui émettent des jetons ID sans refresh token.
  • Guidage en cours de tour et approbations (PR #61820, PR #61801) : orienter un tour actif conserve les modifications précédentes dans les diffs agrégés, et les événements de fin tardifs n’annulent plus les approbations d’un tour plus récent.

Prêt à optimiser votre workflow LLM ?

Connectez vos modèles via une API unique, gérez les clés et maîtrisez vos dépenses d’IA.

Commencer gratuitement