Codex CLI

Aperçu

Type: Outil de programmationChemin principal: OpenAI Responses (chemin optionnel avancé)Niveau de prise en charge: Pris en charge avec limitations selon le modèle/chemin

OpenAI Codex est un outil en ligne de commande open-source (CLI) qui sert d’agent de codage léger, capable de lire, modifier et exécuter du code dans le terminal. Il est construit sur des modèles GPT et optimisé pour la génération de code. Pour TokenLab, Codex CLI peut utiliser /v1/responses, mais vous devez le considérer comme un chemin de compatibilité avancé. Certaines fonctionnalités spécifiques à Responses ne sont pas garanties sur tous les modèles et chemins routés. La compaction distante de Codex CLI est prise en charge sur POST /v1/responses/compact. Codex envoie le model de la session courante dans body.model pour /compact et l’auto-compactage, donc le modèle utilisé pour compacter doit être disponible sur le chemin Responses. Ne configurez pas /v1/compact.

Configuration requise

OS: macOS, Linux (prise en charge officielle), Windows via WSL
Node.js: Version 18+
npm: Version 10.x.x ou supérieure

Installation

npm install -g @openai/codex

Vérifier l’installation :

codex --version

Configuration

Étape 1 : Définir la clé API

Temporaire (session en cours) :

export OPENAI_API_KEY="sk-your-tokenlab-key"

Configuration permanente : Ajouter à ~/.bashrc, ~/.zshrc ou ~/.bash_profile :

export OPENAI_API_KEY="sk-your-tokenlab-key"

Puis rechargez :

source ~/.zshrc  # or source ~/.bashrc

Étape 2 : Configurer config.toml

Éditez ~/.codex/config.toml :

model_provider = "tokenlab"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "xhigh"
model_context_window = 258000
model_auto_compact_token_limit = 232200
sandbox_mode = "danger-full-access"
approval_policy = "never"

personality = "friendly"
service_tier = "fast"

[model_providers.tokenlab]
env_key = "OPENAI_API_KEY"
name = "TokenLab"
base_url = "https://api.tokenlab.sh/v1"
wire_api = "responses"
supports_websockets = true
websocket_connect_timeout_ms = 15000

[features]
fast_mode = true

Ce mode WebSocket est un pont Responses-over-WebSocket pour les clients Codex. Il n’accepte que les événements officiels response.create ; stream est implicite, et background ainsi que response.cancel ne sont pas disponibles sur ce transport. Ce n’est pas l’API OpenAI Realtime et il n’accepte pas session.update, conversation.item.*, input_audio_buffer.*, l’audio binaire ni les enveloppes Realtime imbriquées response.create.response.

Si le fichier de configuration n’existe pas, exécutez codex une fois pour le générer, puis modifiez le fichier. Redémarrez complètement Codex après avoir modifié config.toml afin que les nouveaux paramètres du fournisseur soient rechargés.

Codex déprécie la prise en charge de chat/completions pour les fournisseurs personnalisés. Conservez wire_api = "responses" pour TokenLab à moins que vous n’utilisiez intentionnellement un ancien chemin de compatibilité.

TokenLab transmet au mieux les champs Responses inconnus sans rétrograder silencieusement la requête vers Chat Completions. L’upstream sélectionné décide si le champ ou la combinaison est pris en charge.

Utilisation de base

Démarrer le mode interactif :

codex

Commande directe :

codex "Fix the bug in main.py line 42"

Spécifier le modèle :

codex -m gpt-5.6-sol "Build a REST API server"

Modèles recommandés

Modèle	Idéal pour
`gpt-5.6-sol`	Choix par défaut optimal pour le codage et le raisonnement
`gpt-5-mini`	Solution de repli plus rapide et moins coûteuse pour les flux de travail de codage
`claude-sonnet-4-6`	Revue de code, documentation
`deepseek-r1`	Conception d’algorithmes, raisonnement

Commandes interactives

Commande	Description
`/help`	Afficher l’aide
`/exit` or `Ctrl+C`	Quitter
`/clear`	Effacer la conversation
`/config`	Voir la configuration
`/model <name>`	Changer de modèle
`/tokens`	Voir l’utilisation des tokens

Vérifier la configuration

# Check environment variable
echo $OPENAI_API_KEY

# Test API connection
codex "Hello, Codex!"

# View configuration
cat ~/.codex/config.toml

Cas d’utilisation courants

Revue de code :

git diff | codex "Review these code changes"

Générer des messages de commit :

git diff --staged | codex "Generate a commit message for these changes"

Corriger les erreurs :

codex "Fix the TypeScript errors in src/components/"

Expliquer le code :

cat main.py | codex "Explain what this code does"

Dépannage

Erreur de connexion

Vérifiez que base_url dans config.toml est exactement https://api.tokenlab.sh/v1
Vérifiez la connectivité réseau
Assurez-vous qu’aucun proxy n’interfère

Échec d'authentification

Vérifiez que env_key = "OPENAI_API_KEY" est présent dans ~/.codex/config.toml
Vérifiez que la variable d’environnement OPENAI_API_KEY est définie
Vérifiez que la clé commence par sk-
Assurez-vous que la clé est active dans le tableau de bord TokenLab

Modèle introuvable

Vérifiez que le nom du modèle correspond exactement
Vérifiez la disponibilité du modèle sur tokenlab.sh/en/models

Champ natif Responses rejeté

Certains champs ne sont disponibles que sur /v1/responses lorsque TokenLab peut garantir ce comportement pour le modèle et le chemin sélectionnés
Si vous voyez unsupported_request_field, supprimez ce champ ou passez à un flux de travail qui n’en dépend pas

/compact ou l'auto-compactage échoue

Codex CLI appelle POST /v1/responses/compact, pas /v1/compact
La requête de compaction utilise le model de la session courante, ce modèle doit donc être disponible sur le chemin Responses
Conservez wire_api = "responses" et base_url = "https://api.tokenlab.sh/v1"

Matrice de compatibilité

Outils de code

SDK natifs

Frameworks et plateformes

Apps de chat

Aperçu

Configuration requise

Installation

Configuration

Étape 1 : Définir la clé API

Étape 2 : Configurer config.toml

Utilisation de base

Modèles recommandés

Commandes interactives

Vérifier la configuration

Cas d’utilisation courants

Dépannage

​Aperçu

​Configuration requise

​Installation

​Configuration

​Étape 1 : Définir la clé API

​Étape 2 : Configurer config.toml

​Utilisation de base

​Modèles recommandés

​Commandes interactives

​Vérifier la configuration

​Cas d’utilisation courants

​Dépannage

Aperçu

Configuration requise

Installation

Configuration

Étape 1 : Définir la clé API

Étape 2 : Configurer config.toml

Utilisation de base

Modèles recommandés

Commandes interactives

Vérifier la configuration

Cas d’utilisation courants

Dépannage