Codex CLI

Confier la configuration à mon agentCopy Anchor Link

Copiez cette tâche dans un agent déjà opérationnel sur votre ordinateur :

Lis ce guide et aide-moi à connecter Codex CLI à TokenLab :
https://tokenlab.sh/docs/fr/integrations/codex-cli
Vérifie d’abord ma version installée et la configuration active.
Préserve les comptes, les fournisseurs, les permissions et les autres réglages existants.
Sauvegarde les fichiers locaux et présente les modifications proposées.
Laisse-moi saisir localement les clés API nécessaires ; ne les demande, ne les affiche et ne les colle jamais dans le chat.
Vérifie d’abord que la configuration se charge correctement.
Explique séparément le coût de tout test utilisant une requête payante avant de l’exécuter.

AperçuCopy Anchor Link

Codex CLI se connecte à TokenLab via /v1/responses. Le modèle choisi doit inclure openai_responses dans tokenlab.accepted_request_formats ; les fonctions peuvent varier selon le modèle.

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 requiseCopy Anchor Link

Suivez le guide CLI officiel pour macOS, Linux ou Windows. Windows natif et WSL sont distincts ; voir le guide Windows. npm est une option, pas un prérequis des binaires natifs.

InstallationCopy Anchor Link

npm install -g @openai/codex@0.149.0

Vérifier l'installation :

codex --version

ConfigurationCopy Anchor Link

Étape 1 : Définir la clé APICopy Anchor Link

Définissez TOKENLAB_API_KEY avec les étapes du démarrage rapide pour macOS, Linux, WSL ou Windows PowerShell, sans placer la clé dans l’historique. Lancez Codex depuis ce terminal. Pour un usage permanent, utilisez un gestionnaire local de secrets plutôt qu’une clé en clair dans le profil du shell.

Étape 2 : Configurer tokenlab.config.tomlCopy Anchor Link

Avec Codex 0.149.0, utilisez un fichier tokenlab.config.toml séparé dans le CODEX_HOME actif (habituellement ~/.codex). Créez-le uniquement si le nom est libre, ou sauvegardez le profil TokenLab existant avant modification. codex --profile tokenlab charge ce profil explicitement sans modifier config.toml, auth.json, les comptes ni les permissions. N’utilisez pas l’ancienne table [profiles.tokenlab]. Lancez sans ce profil pour retrouver vos réglages habituels. Voir la configuration officielle des profils.

model_provider = "tokenlab"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"

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

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.

Codex utilise actuellement wire_api = "responses", pas chat/completions. Omettez requires_openai_auth ou utilisez false pour que ce fournisseur lise env_key.

Utilisation de baseCopy Anchor Link

Démarrer le mode interactif :

codex --profile tokenlab

Commande directe :

codex --profile tokenlab "Fix the bug in main.py line 42"

Spécifier le modèle :

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

Choisir un modèleCopy Anchor Link

Choisissez un modèle dont tokenlab.accepted_request_formats contient actuellement openai_responses. Comparez les modèles sur vos tâches et consultez les tarifs sur la page des modèles.

Commandes interactivesCopy Anchor Link

Vérifier la configurationCopy Anchor Link

Vérifiez uniquement si la variable d’environnement est définie, sans afficher sa valeur. Cette vérification ne valide pas la clé :

if [ -n "${TOKENLAB_API_KEY:-}" ]; then
  printf '%s\n' 'TOKENLAB_API_KEY is set'
else
  printf '%s\n' 'TOKENLAB_API_KEY is not set'
fi

Lancez Codex et exécutez /status pour vérifier le modèle actif et les permissions. Si vous utilisez un profil, lancez ce même profil. Consultez la commande officielle de statut.

Lorsque vous souhaitez envoyer une vraie requête, exécutez la commande ci-dessous. Elle utilise votre solde TokenLab. Vérifiez la réponse et l’entrée correspondante dans Requêtes. Une variable définie ou un démarrage réussi ne prouve pas à lui seul qu’une requête a abouti.

codex --profile tokenlab "Reply only with OK. Do not use tools or modify files."

Cas d'utilisation courantsCopy Anchor Link

Revue de code :

git diff | codex --profile tokenlab "Review these code changes"

Générer des messages de commit :

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

Corriger les erreurs :

codex --profile tokenlab "Fix the TypeScript errors in src/components/"

Expliquer le code :

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

DépannageCopy Anchor Link