opencodex : un proxy local de fournisseur pour OpenAI Codex et Claude Code
Proxy fournisseur universel pour OpenAI Codex et Claude Code, utilisez n'importe quel LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) avec Codex CLI, App, SDK et Claude Code.
En bref
- De quoi s’agit-il ?
- Un proxy TypeScript qui traduit l'API Responses de Codex dans les protocoles des fournisseurs, avec pool de comptes, routage de modèles et désinstallation propre.
- À qui s’adresse-t-il ?
- opencodex est un proxy local sous licence MIT qui traduit l'API Responses de Codex dans plusieurs protocoles de fournisseurs, gère un pool de comptes ChatGPT avec affinité et bascule, et restaure la configuration Codex d'origine à l'arrêt. La disponibilité d'un fournisseur donné dépend de ses conditions et des portails de prévisualisation, et le README laisse explicitement cette décision à l'utilisateur.
- Puis-je l’utiliser commercialement ?
- Oui. MIT est une licence permissive : vous pouvez utiliser, modifier et vendre un logiciel qui en dépend, à condition de conserver les mentions de droit d’auteur et de licence.
- Est-il encore maintenu ?
- Oui. Le dépôt a reçu de nouveaux commits au cours des dernières 24 heures.
- En quel langage est-il écrit ?
- Principalement TypeScript, d’après les statistiques de langage de GitHub.
Ces réponses reposent sur les données GitHub du projet (dernière synchronisation le 15 septembre 2026) et sur notre analyse. Elles ne constituent pas un avis juridique.
ANALYSE OPEN SOURCE APPROFONDIE
Comment opencodex redirige Codex et Claude Code
opencodex est un proxy local écrit en TypeScript pour OpenAI Codex et Claude Code. Il se place entre le client Codex et un fournisseur de LLM, et traduit les appels à l'API Responses envoyés par Codex dans le protocole du fournisseur choisi. Selon le README, la traduction fonctionne dans les deux sens pour le streaming, les appels d'outils, les jetons de raisonnement et les images. Cinq adaptateurs de protocole couvrent Anthropic Messages, Google Gemini, Azure OpenAI, le passage direct OpenAI Responses et tous les points de terminaison Chat Completions compatibles OpenAI, soit plus de 40 fournisseurs intégrés. Pour Claude Code, la commande `ocx claude` démarre le proxy avec la découverte de modèles activée. Le README ne fournit pas de chiffres de référence ni de nombre d'utilisateurs, donc ces données ne sont pas établies ici.
Installation et les deux commandes clés
Le démarrage rapide pour les humains dans le README se résume à deux commandes : `npm install -g @bitkyc08/opencodex` et `ocx start`. Cela lance le proxy et ouvre un tableau de bord web sur `http://localhost:10100`. Pour un flux d'agent, `ocx init` écrit interactivement `~/.opencodex/config.json` et connecte Codex, mais il ne démarre pas le proxy. Les commandes sans interface comme `ocx provider add` et `ocx combo set` communiquent avec un proxy en cours d'exécution et se terminent avec un code non nul si elles ne peuvent pas l'atteindre. `ocx status`, `ocx doctor` et `ocx health` rapportent l'état d'exécution. Node 18 ou supérieur est requis. Le README indique que Bun est automatiquement inclus lors de `npm install`, donc aucune installation séparée de Bun n'est nécessaire. L'installation fonctionne nativement sur macOS, Linux et Windows, sans WSL sous Windows.
Choix du fournisseur, routage des modèles et effort de raisonnement
Les modèles sont spécifiés sous la forme `provider/modèle`. Les exemples du README incluent `codex -m "anthropic/claude-opus-5"`, `codex -m "google/gemini-3-pro"` et `codex -m "ollama/llama3"`. Si le préfixe du fournisseur est omis, opencodex route vers le fournisseur par défaut ou fait une correspondance automatique sur le nom du modèle, par exemple `claude-*` vers Anthropic et `gpt-*` vers OpenAI. Les modèles routés apparaissent dans le sélecteur de modèles de l'application Codex avec des contrôles d'effort de raisonnement. Le README explique que `ultra` a la même signification que Codex en amont : il active le raisonnement maximal et la délégation multi-agents active côté client, et la requête réelle est envoyée en `max`. `ultra` n'est annoncé que pour les fournisseurs qui optent via la configuration `reasoningEfforts`. GPT-5.6 Sol/Terra/Luna sont ajoutés comme éléments de catalogue pour les préréglages de clé API OpenAI et OpenRouter, mais la disponibilité réelle suit le portail de prévisualisation en amont ; opencodex ne prépare que les métadonnées de routage et de catalogue.
Pool de comptes ChatGPT : affinité, quotas et bascule
Pour l'authentification Codex, opencodex peut gérer un pool de comptes ChatGPT et Codex. Les fils de discussion existants conservent leur compte d'origine, donc les longues sessions SSH, tmux ou mobiles ne changent pas de compte en cours de conversation. Lorsque la bascule automatique est activée, les nouvelles sessions comparent la fenêtre de quota la plus chargée parmi les 5 heures, la semaine et 30 jours, et routent vers un compte éligible avec une utilisation moindre. Le tableau de bord actualise tous les quotas à la fois, et les journaux de requêtes étiquettent le trafic du pool avec des numéros de compte non-PII. Les échecs de jeton sont fail-closed : ils affichent une réauthentification nécessaire au lieu de revenir silencieusement à une autre information d'identification, tandis que les réponses 429 de quota placent le compte en refroidissement et permettent une bascule vers un autre compte de pool éligible. Il existe aussi un mode `openai-apikey` qui contourne entièrement le routage des comptes et utilise une clé API ou un pool de clés. Le README ne précise pas combien de comptes un pool peut contenir ni ne donne de seuils de quota concrets.
Configuration, accès distant et désinstallation
Le fichier de configuration se trouve dans `~/.opencodex/config.json`. Si le fichier est un JSON invalide, opencodex le sauvegarde sous `config.json.invalid-<timestamp>` et démarre avec les valeurs par défaut, donc le fichier original n'est pas perdu silencieusement. Par défaut, le proxy est lié à `127.0.0.1` sans authentification distincte. Si vous définissez `"hostname": "0.0.0.0"` pour l'exposer sur un LAN, opencodex exige un jeton bearer défini via `OPENCODEX_API_AUTH_TOKEN` et l'utilise pour les API d'administration et les chemins de données ; sans cette variable, il refuse de démarrer. Le README indique que la comparaison des jetons est effectuée en temps constant pour réduire les attaques temporelles. `ocx uninstall` arrête le proxy, supprime les services et shims installés, restaure la configuration, le catalogue et l'historique de Codex, et supprime `~/.opencodex`. Il existe deux options de démarrage automatique : les gestionnaires de services du système (launchd, systemd, Task Scheduler) pour un fonctionnement continu, ou un shim codex qui exécute `ocx ensure` à chaque appel de `codex`. Le README décrit également un remappage de l'historique de reprise qui préserve les anciens fils OpenAI pendant l'utilisation du proxy et les réintègre à l'arrêt.
Licence, garantie et conditions du fournisseur
Ce dépôt est sous licence MIT. L'extrait de licence autorise l'utilisation, la copie, la modification, la fusion, la publication, la distribution, la sous-licence et la vente de copies, et précise que le logiciel est fourni tel quel, sans garantie d'aucune sorte, y compris les garanties de qualité marchande, d'adéquation à un usage particulier et d'absence de contrefaçon. Le README ajoute qu'opencodex est un projet communautaire indépendant, ni affilié ni approuvé par OpenAI, Anthropic ou d'autres fournisseurs. Il avertit que certains fournisseurs, en particulier Anthropic, peuvent suspendre ou restreindre les comptes qui routent le trafic API via des proxys tiers, et que la responsabilité de vérifier les conditions d'utilisation du fournisseur incombe à l'utilisateur. Le README et la licence n'établissent aucun engagement de support, aucune garantie de disponibilité ni aucune affirmation de production, à l'exception de la comparaison en temps constant des jetons décrite pour le mode LAN.
Conclusion éditoriale
opencodex est un proxy local sous licence MIT qui traduit l'API Responses de Codex dans plusieurs protocoles de fournisseurs, gère un pool de comptes ChatGPT avec affinité et bascule, et restaure la configuration Codex d'origine à l'arrêt. La disponibilité d'un fournisseur donné dépend de ses conditions et des portails de prévisualisation, et le README laisse explicitement cette décision à l'utilisateur.
Notes de la communauté