OPENCODEX : le proxy local qui fait tourner Codex et Claude Code sur n’importe quel modèle
⏱️ Temps de lecture estimé : 5 minutes
📌 opencodex est un proxy local qui sert Codex et Claude Code depuis un seul port et traduit leur protocole vers le fournisseur de votre choix — Claude, Gemini, Grok, DeepSeek, Ollama, tout endpoint compatible OpenAI — sans toucher au client. Vous gardez les interfaces d’origine, vous changez de modèle derrière.
Le pitch tient en une phrase : Codex ne parle que la Responses API d’OpenAI, et rien d’autre. opencodex s’intercale à la frontière du protocole, traduit la requête dans le format natif du fournisseur, puis retransmet la réponse en événements Responses — streaming, appels d’outils, résumés de raisonnement, images, dans les deux sens. Aucun patch côté client : le CLI, l’App et le SDK fonctionnent tels quels et survivent aux mises à jour. C’est le choix que je trouve le plus sain du projet, parce qu’un fork se casse à chaque release d’OpenAI, un proxy non.
Installé en deux commandes — npm install -g @bitkyc08/opencodex, puis ocx start — il écoute sur localhost:10100 et ouvre un tableau de bord qui affiche les fournisseurs, l’état OAuth, les modèles et un journal de requêtes avec le compte des tokens de cache. ocx init vous guide ensuite : 99 préréglages intégrés (82 par clé, 13 en OAuth, 3 locaux), écriture de ~/.opencodex/config.json, ajout d’un openai_base_url dans la config de Codex, et au retour un ocx stop qui restaure la configuration d’origine. Cinq adaptateurs couvrent l’essentiel : Messages Anthropic, Gemini, Azure, passthrough Responses et Chat Completions.
Le geste quotidien, c’est le préfixe. codex -m "anthropic/claude-opus-5" "Explique cette stack trace", ou codex -m "ollama/llama3" "Refactorise cette fonction". Sans préfixe, le routage retombe sur le modèle par défaut du fournisseur, puis sur des motifs de nom connus comme claude- ou llama-. Les modèles routés apparaissent dans le picker natif de Codex, avec leurs niveaux de raisonnement, et le catalogue est partagé entre le CLI, la TUI, l’App et le SDK. ocx claude fait la même chose pour Claude Code : même port, tous les modèles routés dans son /model, contexte automatique jusqu’à 1M, sous-agents, et votre session claude.ai reste active.

Le plus intéressant se passe quand un modèle routé n’a pas une capacité d’OpenAI. Deux sidecars comblent les trous. Si Codex demande sa recherche web native et que le modèle routé ne sait pas faire, opencodex retire l’outil hébergé, expose une fonction web_search(query) synthétique et lance une petite boucle agentique : la recherche part vers gpt-5.6-luna via votre session ChatGPT — ou claude-sonnet-5 en OAuth Anthropic, grok-4.6 chez xAI — et les résultats reviennent comme résultat d’outil, trois requêtes maximum par tour. Même logique côté vision : une image envoyée à un modèle uniquement texte est décrite d’abord par un sidecar, puis remplacée par son texte dans l’appel principal. Huit descriptions par tour au maximum, et les erreurs deviennent des résultats bornés au lieu de faire tomber la requête.
Reste la pièce que tout le monde regarde, le pool de comptes ChatGPT. opencodex sait en gérer plusieurs. Les fils Codex existants gardent l’affinité de leur compte de départ — une session longue en SSH ou dans tmux ne change pas de compte en pleine conversation — et les nouvelles sessions partent sur le compte le moins chargé selon les fenêtres de quota de 5 heures, hebdomadaire et 30 jours. Un 429 met un compte en cooldown, un 401 ou 403 le marque pour réauthentification, et le tableau de bord rafraîchit les quotas à la demande.
Mon avis est favorable, avec des réserves qui tiennent dans le poste. Ce que j’admire est la discipline d’ingénierie : traductions streamées fidèlement, mémoire bornée par un budget d’octets, refus de démarrer si le port est déjà pris pour ne jamais laisser deux proxys se disputer Codex, /healthz et /readyz pour l’orchestration, licence MIT, 16 400 étoiles et 1 234 forks en trois mois, un compose Docker épinglé par digest et un widget dans la barre de menus sur macOS 14+. Le revers est dans la position : opencodex se place entre vous et votre fournisseur, et le projet ne s’en cache pas — Anthropic peut suspendre un compte dont le trafic passe par un proxy tiers, l’installeur Windows n’est pas signé, et 94 issues ouvertes sur trois mois d’existence rappellent qu’il est encore en train de se faire. Maintenir des adaptateurs quand un fournisseur change son format de sortie, ce n’est pas un travail fini.
Si vous voulez faire tourner un modèle local ou un abonnement que vous payez déjà ailleurs dans Codex, c’est aujourd’hui l’option la plus complète du paysage. Si votre projet est de router votre abonnement Claude à travers, lisez d’abord les conditions du fournisseur.
- 🔌 Un port, 99 préréglages, cinq adaptateurs — Codex et Claude Code inchangés
- 🧭
codex -m "fournisseur/modèle"pour cibler n’importe quel modèle à la demande - 🔍 Recherche web et images comprises ajoutées aux modèles qui ne les ont pas nativement
- 🪪 Pool ChatGPT : les fils existants restent sur leur compte, les nouveaux prisent le moins chargé
- 🧹
ocx stoprestaure la config Codex d’origine,ocx uninstallnettoie service et état - 🧪 MIT, TypeScript, 16 400 étoiles — mais un intermédiaire de plus entre vous et le fournisseur
Sources






