Passer au contenu principal
OpenAI Codex communique avec Tokios via l’API Responses. Ajoutez Tokios comme fournisseur de modèle dans ~/.codex/config.toml, pointez-le vers https://api.tokios.com/v1, et Codex s’exécute contre votre propre modèle local — sur Ollama, LM Studio ou n’importe quel backend compatible OpenAI — depuis n’importe où, via votre tunnel privé.

Prérequis

  • Un connecteur Tokios en cours d’exécution apparié avec votre modèle local — voir Connector install
  • Un nom de déploiement de modèle enregistré — voir Register a model
  • Une clé API Tokios — voir API Keys
  • OpenAI Codex installé

Configurer Codex

Définissez votre clé Tokios dans l’environnement, puis ajoutez un fournisseur et un profil Tokios à ~/.codex/config.toml :
~/.codex/config.toml
wire_api = "responses" et disable_response_storage = true sont tous deux requis. Tokios fournit la surface Responses de manière stateless, donc Codex ne doit pas s’appuyer sur le stockage de réponses côté serveur.
Puis exécutez Codex avec le profil Tokios :
Remplacez gemma-tunnel par le nom public du modèle que vous avez enregistré dans la console.

Utiliser le SDK Python OpenAI

Pour appeler votre modèle local de manière programmatique avec le SDK OpenAI, pointez le client vers l’URL de base Tokios :
openai_tokios.py
L’URL de base du SDK OpenAI doit se terminer par /v1. Le point de terminaison Tokios est https://api.tokios.com/v1.

Dépannage

Votre clé sk-tok-… est manquante ou incorrecte. Vérifiez que OPENAI_API_KEY est définie dans l’environnement et que env_key = "OPENAI_API_KEY" dans config.toml correspond. Vérifiez la clé dans l’onglet Keys — elle n’a été affichée qu’une seule fois à la création.
Le model dans votre profil config.toml ne correspond à aucun nom de déploiement. Vérifiez l’onglet Models pour le nom exact que vous avez enregistré — il est sensible à la casse.
Le connecteur pour ce déploiement est hors ligne ou a atteint sa limite de concurrence. Vérifiez l’onglet Connectors — le connecteur doit afficher Online, et la machine qui l’exécute doit être toujours en marche.
Vérifiez que vous passez --profile tokios sur la ligne de commande. Sans cet indicateur, Codex utilise son profil par défaut, qui pointe vers l’API hébergée d’OpenAI. Vous pouvez aussi définir default_profile = "tokios" sous [general] dans config.toml pour en faire le profil par défaut.

Étapes suivantes

Clients compatibles

Consultez la configuration de l’URL de base et de la clé pour les autres clients compatibles OpenAI et Anthropic.

Clés API

Créez, délimitez et faites tourner les clés sk-tok-… pour les collègues et les agents.