TokenLab

Outils de code

Codex CLI

Configurer OpenAI Codex CLI pour utiliser l'API TokenLab

Laisser mon agent configurer ceci

Copiez cette tâche dans un agent déjà en cours d'exécution sur votre ordinateur :

Read this guide and help me connect Codex CLI to TokenLab:
https://tokenlab.sh/docs/fr/integrations/codex-cli
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.

Aperçu

Codex CLI peut se connecter à TokenLab via /v1/responses. Le modèle sélectionné doit lister openai_responses dans tokenlab.accepted_request_formats ; les fonctionnalités peuvent varier selon le modèle.

Le compactage distant utilise POST /v1/responses/compact. Codex envoie le modèle de la session actuelle dans body.model, ce modèle doit donc également prendre en charge Responses. Ne configurez pas /v1/compact.

Prérequis système

Utilisez le guide officiel d'installation du CLI pour macOS, Linux ou Windows. Windows natif et WSL sont des environnements distincts ; suivez le guide Windows. La commande npm ci-dessous est une option d'installation, pas une obligation pour les binaires natifs.

Installation

npm install -g @openai/codex@0.163.0

Vérifiez l'installation :

codex --version

Configuration

Étape 1 : Définir la clé API

Utilisez les instructions de terminal du Démarrage rapide pour macOS, Linux, WSL ou Windows PowerShell afin de définir TOKENLAB_API_KEY sans inscrire la clé dans l'historique des commandes. Lancez Codex depuis ce terminal. Pour une utilisation persistante, utilisez votre gestionnaire de secrets local ; n'ajoutez pas de clé en texte brut à votre profil shell.

Étape 2 : Configurer tokenlab.config.toml

Utilisez un fichier tokenlab.config.toml distinct dans votre CODEX_HOME actif (généralement ~/.codex) avec Codex 0.163.0 (testé le 18/10/2026). Créez-le uniquement si le nom n'est pas utilisé, ou sauvegardez-le avant de modifier un profil TokenLab existant. Le profil ci-dessous est chargé explicitement avec codex --profile tokenlab ; il laisse les fichiers par défaut config.toml, auth.json, les comptes et les politiques d'autorisations inchangés. N'utilisez pas de table obsolète [profiles.tokenlab]. Démarrez sans le profil pour revenir à votre configuration habituelle. Consultez 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 une passerelle Responses-over-WebSocket pour les clients Codex. Il accepte uniquement les événements officiels response.create ; stream est implicite, et background ainsi que response.cancel ne sont pas disponibles sur ce transport. Il ne s'agit pas de l'API OpenAI Realtime et il n'accepte pas session.update, conversation.item.*, input_audio_buffer.*, l'audio binaire ou les enveloppes imbriquées Realtime response.create.response.

Créez le fichier de configuration choisi s'il n'existe pas. Après l'avoir modifié, démarrez une nouvelle session avec la commande correspondante ci-dessous.

La version actuelle de Codex utilise wire_api = "responses". Ne configurez pas chat/completions. Laissez requires_openai_auth non défini ou à false pour ce fournisseur personnalisé afin que env_key soit utilisé.

Les requêtes Responses ne sont pas converties en Chat Completions. Les champs optionnels et futurs dépendent du modèle sélectionné.

Utilisation de base

Démarrer le mode interactif :

codex --profile tokenlab

Commande directe :

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

Spécifier un modèle :

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

Choisir un modèle

Utilisez un modèle qui liste actuellement openai_responses dans tokenlab.accepted_request_formats. Comparez les candidats sur vos propres tâches de codage et consultez les tarifs actuels sur la page Modèles.

Commandes interactives

CommandeDescription
/helpAfficher l'aide
/exit ou Ctrl+CQuitter
/clearEffacer la conversation
/statusAfficher le modèle actif, les autorisations et l'utilisation des tokens
/model <name>Changer de modèle

Vérifier la configuration

Vérifiez 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

Démarrez Codex et exécutez /status pour vérifier le modèle actif et les autorisations. Si vous utilisez un profil, démarrez ce même profil. Consultez la commande status officielle.

Lorsque vous êtes prêt à effectuer une vraie requête, exécutez la commande ci-dessous. Elle utilise votre solde TokenLab. Vérifiez la réponse et l'enregistrement correspondant dans Requêtes ; une vérification de l'environnement 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 courants

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 du code :

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

Générer des images et des vidéos dans le même agent

Codex peut également créer des images et de courtes vidéos avec le serveur MCP TokenLab. Chaque génération est débitée du même solde TokenLab. Exécutez ceci dans le terminal où TOKENLAB_API_KEY est définie :

codex mcp add \
  --env TOKENLAB_MCP_TOOL_PROFILE=core \
  --env TOKENLAB_API_KEY="$TOKENLAB_API_KEY" \
  tokenlab -- \
  npx -y @tokenlabai/mcp-server@0.6.48

La commande ajoute le serveur à votre fichier config.toml de base. Codex charge également ce fichier sous le profil tokenlab.config.toml, de sorte que les outils fonctionnent avec ou sans --profile tokenlab. Exécutez codex mcp list et vérifiez que tokenlab est listé. Essayez ensuite :

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video renvoie un ID de tâche. L'agent appelle get_task_status jusqu'à ce que la vidéo soit prête.

Dépannage

Sur cette page