Codex

État de l’intégration
  • Protocole recommandé : OpenAI Responses
  • Configuration vérifiée : 15 juillet 2026 (référence officielle de configuration de Codex)
  • Vérification en conditions réelles : En attente

Les fournisseurs personnalisés de Codex utilisent le protocole Responses. Choisissez un modèle GetRouter compatible avec /v1/responses.

Enregistrer la clé API

export GETROUTER_API_KEY="YOUR_API_KEY"

Ajoutez-la si nécessaire à la configuration sécurisée de votre environnement shell. N’inscrivez pas directement la clé dans config.toml.

Configurer Codex

Modifiez ~/.codex/config.toml :

model = "MODEL_ID"
model_provider = "getrouter"

[model_providers.getrouter]
name = "GetRouter"
base_url = "https://getrouter.ai/v1"
env_key = "GETROUTER_API_KEY"
wire_api = "responses"

Remplacez MODEL_ID par l’ID exact d’un modèle de la page Modèles. Conservez les paramètres Codex sans rapport avec cette intégration.

Warning

N’utilisez pas wire_api = "chat". Les fournisseurs personnalisés de la version actuelle de Codex utilisent Responses. Un modèle limité à Chat Completions ne convient pas à cette configuration.

Vérification

  1. Redémarrez Codex depuis un shell dans lequel GETROUTER_API_KEY est défini.
  2. Vérifiez que Codex affiche le modèle et le fournisseur attendus.
  3. Commencez par une question sans risque sur le dépôt.
  4. Vérifiez que la requête apparaît dans les journaux d’utilisation de GetRouter.
  5. Testez ensuite seulement les modifications, les appels d’outils, les contextes longs ou les niveaux de raisonnement plus élevés.

Erreurs fréquentes

  • Variable d’environnement absente : lancez Codex depuis un shell qui exporte GETROUTER_API_KEY.
  • 404 sur /responses : utilisez base_url = "https://getrouter.ai/v1" ; n’ajoutez pas vous-même /responses.
  • Modèle introuvable : copiez l’ID exact du modèle et vérifiez que la clé y a accès.
  • Réponse ou événement d’outil non pris en charge : le chemin modèle/fournisseur choisi ne gère peut-être pas complètement les événements d’outils Responses ; testez un autre modèle compatible avec Responses.
  • Codex utilise encore un autre fournisseur : vérifiez le profil de configuration actif et la valeur model_provider de premier niveau.

Consultez Dépannage des intégrations avant de partager des diagnostics.