Démarrage rapide
Ce guide vous mène d’une nouvelle installation à la première requête de votre outil de programmation. Les étapes 1 et 2 sont communes ; l’étape 3 propose une branche par outil. La page des clients pris en charge présente les outils et leurs connexions.
1. Exécutez l’assistant de configuration
Section intitulée « 1. Exécutez l’assistant de configuration »ocx initocx init vous accompagne dans les étapes suivantes :
- Choix d’un fournisseur — sélectionnez l’un des 107 préréglages intégrés au registre, ou
custompour 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.tomlpar défaut) donc le fournisseuropenaiinté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
codexexécute d’abordocx ensure.
Le résultat est enregistré dans $OPENCODEX_HOME/config.json (par défaut ~/.opencodex/config.json).
2. Démarrez le proxy
Section intitulée « 2. Démarrez le proxy »ocx start # utilise le port 10100 par défautocx start --port 8080Au 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’arrête et indique ce qui l’occupe : exécutez d’abord
ocx stop si un processus opencodex y répond, ou démarrez sur un port libre avec
ocx start --port <port>. La commande ne change jamais de port d’elle-même : auparavant, ce
comportement laissait deux proxys en cours d’exécution et redirigeait Codex vers le plus récent.
Vérifiez-le :
ocx statusocx gui # ouvre le tableau de bord sur le port actif3. Connectez votre outil
Section intitulée « 3. Connectez votre outil »Choisissez la branche correspondant à votre outil. Vous pouvez en connecter plusieurs : ils partagent les mêmes fournisseurs et modèles.
Si vous avez accepté l’invite Codex à l’étape 1, Codex communique maintenant avec opencodex de manière transparente. Si vous avez refusé cette invite ou si la configuration s’est arrêtée parce qu’une configuration existait déjà, activez le commutateur Codex sur la page Connect du tableau de bord avant de lancer Codex ; Intégration Codex explique les modifications et leur restauration.
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"Claude Code
Section intitulée « Claude Code »Avec le CLI claude installé :
ocx claudeocx claude démarre le proxy s’il ne fonctionne pas et lance Claude Code avec un environnement dirigé vers opencodex. Les arguments supplémentaires sont transmis. Consultez Claude Code pour les valeurs par défaut des niveaux, les autres lanceurs et la désactivation.
Claude Desktop
Section intitulée « Claude Desktop »ocx claude desktopLors d’une nouvelle installation, cette commande configure le profil de passerelle pour toute l’application. Une installation utilisant déjà le mode first-party le conserve ; exécutez ocx claude desktop apply --gateway pour changer explicitement. Le mode first-party conserve claude.ai pour Desktop et ne route que son onglet Code ; consultez la section sur les modes Claude Desktop dans Claude Code.
Quittez complètement puis rouvrez Claude Desktop après un changement de mode.
Grok Build
Section intitulée « Grok Build »Sur une écoute locale, si ~/.grok existe, ocx start enregistre les modèles visibles dans ~/.grok/config.toml. Choisissez un modèle ocx-* dans Grok Build. Les configurations distantes et le bloc géré sont décrits dans Grok Build.
Après avoir ajouté des fournisseurs ou des modèles, lancez ocx ensure ou redémarrez le proxy pour que Grok Build les voie.
Autres outils
Section intitulée « Autres outils »Les outils avec intégration gérée (OpenCode, Pi, Qoder, WorkBuddy, Kilo, Cline, T3 Code et d’autres) se connectent depuis la page Connect du tableau de bord ou avec :
ocx integration client enable --client <id>Les fichiers de configuration et les délais de prise d’effet sont décrits dans Intégrations. Tout autre outil acceptant un point de terminaison personnalisé peut utiliser l’URL de base compatible OpenAI http://localhost:10100/v1 ou l’URL de base Anthropic http://localhost:10100.
Choisissez des modèles de sous-agents (facultatif)
Section intitulée « 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-6-astra. 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é
Section intitulée « 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, cursorocx logout xaiOpenAI 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
Section intitulée « Arrêt et restauration »ocx stop # arrête le proxy et restaure Codex natifocx 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.jsoncomplète.