Démarrage rapide

Ce guide part d’une installation neuve et vous conduit jusqu’à l’exécution de Codex sur un modèle autre qu’OpenAI.

1. Exécutez l’assistant de configuration

ocx init

ocx init vous accompagne dans les étapes suivantes :

Choix d’un fournisseur — sélectionnez l’un des 79 préréglages intégrés au registre, ou custom pour saisir une URL de base et un adaptateur.
Clé API — collez une clé ou référencez une variable d’environnement telle que ${ANTHROPIC_API_KEY}.
Modèle par défaut — pour les fournisseurs clés, locaux et personnalisés, acceptez le préréglage ou saisissez un identifiant de modèle.
Port proxy — la valeur par défaut est 10100.
Injecter dans Codex ? — avec une configuration de bouclage normale, opencodex ajoute une valeur racine openai_base_url à $CODEX_HOME/config.toml (~/.codex/config.toml par défaut) donc le fournisseur openai intégré de Codex cible le proxy. Les liaisons distantes ou LAN utilisent à la place une entrée de fournisseur dédiée avec un en-tête d’authentification API.
Installer le shim de démarrage automatique ? — lorsqu’il est activé, le lancement de codex exécute d’abord ocx ensure.

Le résultat est enregistré dans $OPENCODEX_HOME/config.json (par défaut ~/.opencodex/config.json).

2. Démarrez le proxy

ocx start            # utilise le port 10100 par défaut
ocx start --port 8080

Au démarrage, opencodex :

écrit son PID à ~/.opencodex/ocx.pid (et refuse de démarrer deux fois),
découvre les modèles en direct lorsque le fournisseur le permet et synchronise les entrées natives et routées dans le catalogue de modèles de Codex,
écoute sur http://localhost:<port>/v1.

Si le port demandé est occupé, ocx start sélectionne un port libre, l’enregistre dans runtime-port.json, et met à jour Codex pour utiliser l’écouteur en direct.

Vérifiez-le :

ocx status
ocx gui       # ouvre le tableau de bord sur le port actif

3. Utiliser Codex

Codex parle maintenant à opencodex de manière transparente :

codex "Refactor this function for readability"

Pour cibler un modèle routé précis, utilisez dans le sélecteur de Codex la forme provider/model, telle qu’elle y apparaît :

codex -m "anthropic/claude-opus-5" "Explain this stack trace"
codex -m "ollama-cloud/glm-5.2"      "Write a SQL migration"

Choisissez des modèles de sous-agents (facultatif)

Une nouvelle configuration propose cinq modèles natifs dans le sélecteur de sous-agents de Codex : gpt-5.5, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna et gpt-5.4-mini. Ouvrez ocx gui pour remplacer ou réorganiser jusqu’à cinq modèles natifs ou routés. Le tableau de bord peut également définir un modèle de sous-agent préféré et un effort de raisonnement. Consultez Interface des sous-agents pour choisir v1, base ou v2 et comprendre quand s’appliquent les instructions, les valeurs natives par défaut et les replis.

Se connecter au lieu de coller une clé

Certains fournisseurs prennent en charge la connexion à un compte réel (OAuth, actualisation automatique) :

ocx login xai          # ou : anthropic, kimi, kiro, google-antigravity, cursor
ocx logout xai

OpenAI lui-même ne nécessite aucune clé : le fournisseur par défaut transfère directement les informations d’identification de votre codex login existant (consultez Fournisseurs).

Arrêt et restauration

ocx stop          # arrête le proxy et restaure Codex natif
ocx restore       # restaure Codex natif sans arrêter le proxy (alias : ocx eject)
ocx restore back  # route de nouveau Codex par le proxy toujours actif

Fonctionnement — ce qui arrive à chaque requête.
Fournisseurs — toutes les manières de s’authentifier.
Configuration — la référence config.json complète.