@koreanhole/opencodex 2.95.2 → 2.95.4

package/readme/README.fr.md

@@ -0,0 +1,510 @@
+<p align="center">
+  <img src="../assets/banner.png" alt="opencodex — une passerelle locale pour Codex, Claude Code, Claude Desktop, Grok Build et plus" width="100%">
+</p>
+
+<h3 align="center">Une passerelle locale pour vos outils de programmation IA et vos modèles.</h3>
+<p align="center"><b>Utilisez les modèles de votre choix avec Codex, Claude Code, Claude Desktop et Grok Build,<br>et connectez OpenCode, Pi, Qoder, WorkBuddy, Kilo, Cline, T3 Code et d’autres outils grâce aux configurations gérées.</b><br>
+<a href="https://opencodex.me/fr/reference/client-support/">Voir tous les outils pris en charge →</a></p>
+
+<p align="center">
+  <a href="https://x.com/claudeebum"><img src="https://img.shields.io/badge/%40claudeebum-000000?logo=x&logoColor=white" alt="Suivre @claudeebum sur X"></a>
+  <a href="https://www.npmjs.com/package/@koreanhole/opencodex"><img src="https://img.shields.io/npm/v/@koreanhole/opencodex?color=cb3837&label=npm&logo=npm" alt="version npm"></a>
+  <a href="https://github.com/koreanhole/opencodex-cli/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@koreanhole/opencodex?color=blue" alt="licence"></a>
+  <img src="https://img.shields.io/node/v/@koreanhole/opencodex?logo=node.js&label=node" alt="version de Node">
+</p>
+
+```bash
+npm install -g @koreanhole/opencodex
+ocx start
+```
+
+<p align="center">
+  <a href="https://github.com/lidge-jun/opencodex/releases/latest"><img src="https://img.shields.io/badge/macOS-.dmg-24292f?logo=apple&logoColor=white" alt="Télécharger pour macOS (.dmg)"></a>
+  <a href="https://github.com/lidge-jun/opencodex/releases/latest"><img src="https://img.shields.io/badge/Windows-.msi-24292f?logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0id2hpdGUiPjxwYXRoIGQ9Ik0zIDNoOC41djguNUgzem05LjUgMEgyMXY4LjVoLTguNXpNMyAxMi41aDguNVYyMUgzem05LjUgMEgyMVYyMWgtOC41eiIvPjwvc3ZnPg==" alt="Télécharger pour Windows (.msi)"></a>
+  <a href="https://github.com/lidge-jun/opencodex/releases/latest"><img src="https://img.shields.io/badge/Linux-.AppImage-24292f?logo=linux&logoColor=white" alt="Télécharger pour Linux (.AppImage)"></a>
+  <a href="https://github.com/lidge-jun/opencodex/releases/latest"><img src="https://img.shields.io/badge/Linux-.deb-24292f?logo=debian&logoColor=white" alt="Télécharger pour Linux (.deb)"></a>
+</p>
+
+<table>
+<tr>
+<td width="50%" valign="middle">
+
+### Claude Code, exécutant n'importe quel modèle
+
+Le sélecteur est celui d'origine de Claude Code. Le moteur derrière, non.
+
+</td>
+<td width="50%">
+  <img src="../assets/claude-code-models.gif" alt="Claude Code exécutant un modèle routé par opencodex — la barre d'état affiche gpt-5.6-luna-medium comme modèle actif" width="100%">
+</td>
+</tr>
+<tr>
+<td width="50%" valign="middle">
+
+### Codex, exécutant n'importe quel modèle
+
+Choisissez un fournisseur et lancez-vous — même flux de travail, autre moteur.
+
+</td>
+<td width="50%">
+  <img src="../assets/demo.gif" alt="démonstration d'opencodex — exécution d'une tâche dans l'application Codex avec un modèle routé non-OpenAI" width="100%">
+</td>
+</tr>
+<tr>
+<td width="50%" valign="middle">
+
+### Claude Desktop, exécutant n'importe quel modèle
+
+Opus répond, puis confie la tâche à un sous-agent GPT-5.6 Sol.
+
+</td>
+<td width="50%">
+  <img src="../assets/claude-desktop-subagent.gif" alt="Claude Desktop répondant avec Claude Opus 4.8, puis déléguant un sous-agent GPT-5.6 Sol par l'intermédiaire d'opencodex" width="100%">
+</td>
+</tr>
+<tr>
+<td width="50%" valign="middle">
+
+### Grok Build, exécutant n'importe quel modèle
+
+Sol pilote la session et appelle un sous-agent Kimi K3.
+
+</td>
+<td width="50%">
+  <img src="../assets/grok-build-subagent.gif" alt="Grok Build exécutant GPT-5.6 Sol par l'intermédiaire d'opencodex et appelant un sous-agent Kimi K3" width="100%">
+</td>
+</tr>
+</table>
+
+<p align="center">
+  <a href="../README.md">English</a> · <b>Français</b> · <a href="README.ko.md">한국어</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.zh-TW.md">繁體中文</a> · <a href="README.ru.md">Русский</a> · <a href="README.ja.md">日本語</a> · <a href="README.tr.md">Türkçe</a> · 📖 <a href="https://opencodex.me/fr/"><b>Documentation complète →</b></a>
+</p>
+
+opencodex est une passerelle locale légère entre vos outils de programmation et vos fournisseurs de modèles. Elle accepte les API Responses, Chat Completions et Anthropic Messages et traduit chaque requête pour votre fournisseur, en prenant en charge le streaming, les appels d’outils, le raisonnement et les images lorsque le client, le modèle et le fournisseur le permettent. Utilisez Claude, Gemini, Grok, GLM, DeepSeek, Kimi, Qwen, Ollama et d’autres fournisseurs avec Codex, Claude Code, Claude Desktop, Grok Build et les outils de la [page des clients pris en charge](https://opencodex.me/fr/reference/client-support/). Elle peut aussi gérer un **pool de comptes ChatGPT** pour l’authentification Codex : ajoutez des comptes et actualisez leurs quotas dans le tableau de bord ; les nouvelles sessions sont dirigées vers le compte sain le moins utilisé, tandis que les conversations existantes restent liées à leur compte initial.
+
+## Démarrage rapide
+
+### Installation personnelle (CLI)
+
+```bash
+npm install -g @koreanhole/opencodex   # Node 18+ ; le runtime Bun est inclus automatiquement
+ocx start                         # proxy + tableau de bord sur localhost:10100
+```
+
+Utilisez `ocx service` pour l'exécuter en arrière-plan.
+
+Ouvrez **http://localhost:10100** et configurez tout dans le tableau de bord web — ajoutez des
+fournisseurs (plus de 40 intégrés, ou n'importe quel point de terminaison compatible OpenAI),
+choisissez les modèles, gérez les comptes. `ocx gui`
+rouvre le tableau de bord à tout moment.
+
+### Connectez votre outil
+
+Connectez l’outil que vous utilisez déjà :
+
+| Outil | Connexion |
+|---|---|
+| Codex | Activez le commutateur Codex sur la page **Connect** du tableau de bord, puis exécutez `codex` comme d’habitude. Sur une écoute locale, cela dirige le fournisseur intégré de Codex vers le proxy. Depuis le terminal, exécutez `ocx init` avant d’ajouter des fournisseurs dans le tableau de bord et acceptez son invite Codex. |
+| Claude Code | Avec le CLI `claude` installé, exécutez `ocx claude`. Il démarre le proxy si nécessaire et lance Claude Code à travers celui-ci. |
+| Claude Desktop | Exécutez `ocx claude desktop`. Lors d’une nouvelle installation, cette commande configure le profil de passerelle pour toute l’application ; une configuration first-party existante est conservée et `ocx claude desktop apply --gateway` permet de changer explicitement. Consultez le [guide Claude Code](https://opencodex.me/fr/guides/claude-code/). Quittez complètement puis rouvrez Claude Desktop après un changement. |
+| Grok Build | Sur une écoute locale avec l’intégration Grok activée, `ocx start` enregistre les modèles lorsque `~/.grok` existe ; choisissez un modèle `ocx-*` dans Grok Build. Pour une configuration distante, consultez le [guide Grok Build](https://opencodex.me/fr/guides/grok-build/). Après avoir ajouté des fournisseurs, redémarrez le proxy (ou lancez `ocx ensure` lorsque le démarrage automatique de Codex est activé) pour actualiser la liste. |
+| Outils avec intégration gérée | Utilisez la page **Connect** du tableau de bord ou `ocx integration client enable --client <id>`. |
+| Tout autre outil | Définissez l’URL de base compatible OpenAI `http://localhost:10100/v1` ou l’URL de base Anthropic `http://localhost:10100`. |
+
+La [page des clients pris en charge](https://opencodex.me/fr/reference/client-support/) indique la méthode de connexion et le protocole de chaque outil.
+
+<details>
+<summary><b>Application de bureau (bêta)</b></summary>
+
+L'application de bureau reprend le même proxy et le même tableau de bord dans une fenêtre native, avec une icône dans la barre d'état et le binaire `ocx` inclus.
+Elle se rattache à un proxy déjà en cours d'exécution ou démarre celui qui est fourni, et le tableau de bord reste
+sur le port du proxy (**http://localhost:10100** sauf si vous en avez configuré un autre). Choisissez le fichier
+correspondant à votre plateforme sur la page de la [dernière version publiée](https://github.com/lidge-jun/opencodex/releases/latest) :
+
+| Plateforme | Fichier | Remarques |
+|---|---|---|
+| macOS 13+ (Apple Silicon et Intel) | `OpenCodex-<version>-macos.dmg` | Compilation universelle, signée avec un identifiant Developer ID et notariée |
+| Windows (x64) | `OpenCodex-<version>-windows-x64.msi` | Signature du code via SignPath Foundation en cours de déploiement ([politique de signature du code](https://opencodex.me/fr/reference/code-signing/)) ; tant qu’une version n’est pas signée, SmartScreen demande une confirmation : choisissez **Informations complémentaires → Exécuter quand même** |
+| Linux (x86_64) | `OpenCodex-<version>-linux-x86_64.AppImage` ou `-linux-amd64.deb` | La barre d'état nécessite un environnement de bureau compatible AppIndicator |
+
+Chaque fichier est accompagné d'un `.sha256` sur la page de la version. Sous macOS 14+, l'application embarque
+également une extension WidgetKit qui affiche l'état du proxy, l'utilisation du jour et les quotas des
+fournisseurs ; le modèle de données des instantanés qu'elle affiche se trouve dans [`app/`](../app)
+(`MenuBarCore`). Pour compiler l'application vous-même, exécutez
+`bun install && bun run build:gui` à la racine du dépôt, puis, dans `desktop/`,
+`bun install && bun run prepare-sidecar && bun run prepare-widget && bun run build:local` sous macOS,
+ou `bun install && bun run prepare-sidecar && bun run build:local` sous Windows et Linux (l'étape du widget
+exige macOS). Le [guide de l'application de bureau](https://opencodex.me/fr/guides/desktop-app/) et le
+[guide de l'application macOS dans la barre des menus](https://opencodex.me/fr/guides/macos-menu-bar/) détaillent le premier lancement, et
+[`AGENTS_INSTALL.md`](../AGENTS_INSTALL.md#where-things-are-installed) répertorie tout ce qui est écrit sur le disque.
+
+</details>
+
+### Groupe de comptes ChatGPT
+
+opencodex peut également gérer un **groupe de comptes ChatGPT** pour l'authentification Codex. Ajoutez plusieurs
+comptes ChatGPT / Codex et actualisez leurs quotas 5 h / hebdomadaires / 30 j dans le tableau de bord.
+Avec le routage par quota, les nouvelles sessions peuvent utiliser le compte opérationnel le moins sollicité ;
+les modes round-robin et fill-first appliquent leurs propres politiques. Les fils Codex existants restent
+normalement associés au compte qui les a démarrés, afin que les longues sessions SSH, tmux ou connectées
+depuis un appareil mobile ne changent pas de compte en cours de conversation — mais la réévaluation des
+quotas, le basculement, l'exclusion d'un compte, l'expiration de l'association ou la récupération après
+une erreur 401/403 ou 429 peuvent les réassocier. Attribuez un ordre de sélection aux comptes lorsque
+l'un d'eux — généralement votre connexion Codex Desktop — ne doit être utilisé qu'une fois les autres épuisés.
+
+### Sponsors
+
+Les sponsors permettent de maintenir opencodex à chaque changement de protocole en amont. Intéressé ?
+Voir [SPONSORS.md](../SPONSORS.md).
+
+<!-- sponsors:main — one banner, model developers only; empty until a Main sponsor signs -->
+
+<!-- sponsors:standard — one row per sponsor, in order of signing -->
+<table>
+<tbody>
+<tr>
+<td width="180"><a href="https://www.orcarouter.ai/?utm_source=opencodex&utm_medium=readme"><img src="../assets/sponsors/orcarouter.png" alt="OrcaRouter" width="150"></a></td>
+<td>Merci à <a href="https://www.orcarouter.ai/?utm_source=opencodex&utm_medium=readme">OrcaRouter</a> pour son soutien à ce projet ! OrcaRouter est une passerelle d'IA compatible OpenAI pour la production : un routage adaptatif qui évalue chaque prompt et l'envoie au modèle qui atteint votre seuil, un basculement automatique, des règles de routage sous forme de code, une tarification fournisseur sans marge avec mise en cache des prompts, ainsi que des garde-fous, un pare-feu d'agents et des journaux de requêtes sur chaque appel, parmi plus de 200 modèles. Choisissez <code>OrcaRouter</code> dans le sélecteur Add provider ou exécutez <code>ocx provider add orcarouter</code> ; <code>orcarouter/auto</code> est le routeur adaptatif.</td>
+</tr>
+<tr>
+<td width="180"><a href="https://tokenlab.sh/r/OPENCODEX"><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/sponsors/tokenlab-dark.png"><img src="../assets/sponsors/tokenlab-light.png" alt="TokenLab" width="150"></picture></a></td>
+<td>Merci à <a href="https://tokenlab.sh/r/OPENCODEX">TokenLab</a> pour son soutien à ce projet ! TokenLab donne aux agents de code une seule clé API pour les principaux modèles, avec les formats OpenAI Responses et Chat Completions, Anthropic Messages et l'API native de Gemini, streaming et appel d'outils compris. Il fournit aussi un serveur MCP et des Skills pour agents afin de faciliter l'intégration. Choisissez votre mode de livraison et payez à l'usage. Choisissez <code>TokenLab</code> dans le sélecteur Add provider ou exécutez <code>ocx provider add tokenlab</code>.<br><sub>TokenLab 为编程智能体提供统一的多模型 API，一枚 API Key 即可接入主流模型，支持 OpenAI Responses、Chat Completions、Anthropic Messages 和 Gemini 原生 API 格式，以及流式输出和工具调用。同时提供 MCP 服务器和 Agent Skills，方便接入现有工作流；交付模式可选，按量付费。</sub></td>
+</tr>
+</tbody>
+</table>
+
+---
+
+<details>
+<summary>Docker Compose</summary>
+
+Le dépôt fournit une construction Compose épinglée par digest, exécutée hors root. La construction génère et
+vérifie elle-même le manifeste de compatibilité canonique à partir de l'instantané Git sélectionné. Un clone local
+nécessite Git et Docker Compose ; un contexte Git distant ne nécessite que Docker Compose. Aucun des deux chemins
+ne requiert Bun sur l'hôte ni d'étape de préparation. Initialisez une seule fois le jeton du plan de données via
+stdin et démarrez le hub :
+
+```bash
+git clone https://github.com/lidge-jun/opencodex.git
+cd opencodex
+docker compose build
+openssl rand -hex 32 | docker compose run --rm -T hub bun run docker/bootstrap-token.ts
+docker compose up -d
+curl --fail --silent http://127.0.0.1:10100/healthz
+curl --fail --silent http://127.0.0.1:10100/readyz
+```
+
+La liaison hôte par défaut est `127.0.0.1:10100`. Une exposition distante exige explicitement
+`OPENCODEX_BIND_ADDRESS=<LAN-or-Tailscale-IP> docker compose up -d` ; `0.0.0.0` active
+toutes les interfaces de l'hôte. Restreignez l'accès avec un pare-feu et une façade TLS/tailnet authentifiée.
+Le JSON généré reste non suivi. Le contexte de construction n'admet que `.git/index` et `.git/HEAD` — l'inventaire
+lu par `git ls-files`, soit environ 1 Mo au lieu du magasin d'objets complet — et ils ne sont visibles que par l'étape
+de manifeste réservée à la construction, via un montage en lecture seule ; aucun `COPY` n'inclut donc `.git`. Un manifeste
+déjà généré sur l'hôte n'est accepté qu'après validation ; sinon, la construction le génère elle-même. La construction
+rejette les manifestes obsolètes, les fichiers manquants ou non concordants, les fichiers sources en trop et les liens symboliques.
+Elle vérifie chaque SHA-256 enregistré par rapport au contexte de construction et aux fichiers d'exécution copiés, y compris
+`package.json`, `bun.lock` et le fichier spécifiquement inclus `scripts/model-metadata.source.json`.
+
+Un contexte Git distant exige que BuildKit conserve les métadonnées Git. Cet extrait de configuration Compose
+sélectionne l'instantané distant et transmet l'argument intégré requis :
+
+```yaml
+services:
+  hub:
+    pull_policy: build
+    build:
+      context: https://github.com/lidge-jun/opencodex.git#main
+      dockerfile: Dockerfile
+      target: runtime
+      args:
+        BUILDKIT_CONTEXT_KEEP_GIT_DIR: "1"
+```
+
+Le jeton et l'état mutable restent dans le volume nommé `ocx-state` ; aucun secret n'est placé dans
+l'image, le fichier Compose, l'environnement ou les arguments du shell. Consultez le
+[guide de déploiement Remote Hub](https://opencodex.me/fr/guides/remote-hub/) pour la configuration
+des fournisseurs, les contrôles d'acceptation authentifiés, la gestion distante et le rollback.
+
+</details>
+
+<details>
+<summary>Installer depuis les sources (dernière version de développement)</summary>
+
+**macOS / Linux :**
+
+```bash
+curl -fsSL https://bun.sh/install | bash
+git clone -b dev https://github.com/lidge-jun/opencodex.git
+cd opencodex && ~/.bun/bin/bun install
+~/.bun/bin/bun run build:gui
+~/.bun/bin/bun run src/cli/index.ts start
+```
+
+**Windows (PowerShell) :**
+
+```powershell
+irm bun.sh/install.ps1 | iex
+git clone -b dev https://github.com/lidge-jun/opencodex.git
+cd opencodex; bun install
+bun run build:gui
+bun run src/cli/index.ts start
+```
+
+L'installation depuis les sources exécute la dernière version de la branche `dev`. Les correctifs de
+gestion de la mémoire, les améliorations du ramasse-miettes de l'environnement
+d'exécution et les correctifs non publiés y sont disponibles avant
+leur arrivée dans le paquet npm.
+
+</details>
+
+<details>
+<summary>Pour les agents</summary>
+
+```bash
+npm install -g @koreanhole/opencodex
+ocx start     # ou `ocx service`
+ocx init      # configuration interactive : écrit ~/.opencodex/config.json et relie Codex
+```
+
+`ocx init` ne démarre jamais le proxy ; démarrez-le d'abord (ou après — les deux ordres fonctionnent, mais les commandes
+sans interface comme `ocx provider add` et `ocx combo set` communiquent avec le proxy **actif** et se terminent avec un code différent de zéro
+s'il est inaccessible). `ocx status` / `ocx doctor` / `ocx health` indiquent l'état d'exécution.
+
+> **Agents qui installent ou exécutent opencodex :** lisez
+> [`AGENTS_INSTALL.md`](../AGENTS_INSTALL.md). Une exécution interactive de `ocx start` peut demander une
+> fois s'il faut ajouter une étoile à ce dépôt — cette décision appartient à l'utilisateur, jamais à un agent. La CLI masque
+> l'invite lors des exécutions pilotées par un agent et l'API les refuse avec `403 agent_consent_required`.
+
+</details>
+
+## Plateformes prises en charge
+
+| Système d'exploitation | État | Gestionnaire de services | Application de bureau (bêta) |
+|---|---|---|---|
+| macOS (arm64 / x64) | Entièrement pris en charge | launchd | `.dmg` universel |
+| Linux (x64 / arm64) | Entièrement pris en charge | systemd (unité utilisateur) | x86_64 `.AppImage` / `.deb` |
+| Windows (x64) | Entièrement pris en charge | Planificateur de tâches (masqué) / service natif en option (`--native`, WinSW) | x64 `.msi` |
+
+L'installation de la CLI nécessite [Node](https://nodejs.org) 18+ ; l'application de bureau n'a besoin ni de Node ni de Bun. L'environnement d'exécution Bun est inclus lors de `npm install` — aucune installation
+séparée de Bun n'est nécessaire, ni WSL sous Windows. Si npm a bloqué les scripts d'installation de l'environnement inclus,
+consultez la [documentation d'installation](https://opencodex.me/fr/getting-started/installation/).
+
+## Points forts
+
+- **Utilisez n'importe quel LLM avec Codex, Claude Code, Claude Desktop et Grok Build** — plus de 40 fournisseurs prêts à
+  l'emploi, chacun conservant sa propre interface native.
+- **Réutilisez une connexion CLI locale** — `cline-cli/default` et `gemini-cli/default` délèguent à la CLI installée et connectée, tandis que Codex conserve l'approbation et l'exécution des outils.
+- **Regroupez les comptes ChatGPT** — association aux fils, basculement automatique tenant compte des quotas, période de récupération et
+  gestion de l'authentification en mode fail-closed.
+
+  > **Note sur la politique des fournisseurs :** le regroupement de comptes sert uniquement au routage et à la résilience opérationnelle ; il ne
+  > garantit aucune protection contre les limites de débit, les mesures d'application, les suspensions ou d'autres actions
+  > sur les comptes. OpenCodex n'encourage pas l'utilisation de comptes supplémentaires pour contourner les limites d'un fournisseur, ni le
+  > partage d'identifiants de compte entre personnes. Vous êtes responsable du respect des conditions actuelles de chaque
+  > fournisseur. Consultez le
+  > [guide des groupes de comptes Codex Auth](https://opencodex.me/fr/guides/web-dashboard/)
+  > et les [Conditions d'utilisation actuelles d'OpenAI](https://openai.com/policies/terms-of-use/).
+- **Combos** — un identifiant de modèle virtuel avec basculement ou round-robin pondéré entre fournisseurs. Consultez
+  le [guide des combos](https://opencodex.me/fr/guides/combos/).
+- **Des sous-agents sur n'importe quel modèle** — affichez les modèles routés dans le sélecteur de sous-agents de Codex, avec contrôle des surfaces v1/v2 et chaînes de repli. Consultez le
+  [guide des sous-agents](https://opencodex.me/fr/guides/sub-agent-surface/).
+<!-- sponsors:main-first-mention -->
+- **Connectez-vous une fois, oubliez la clé API** — OAuth pour xAI, Anthropic et Kimi ; ou transmettez
+  `codex login`, collez une clé ou utilisez des références `${ENV_VAR}`.
+- **Modules complémentaires de recherche web et de vision** — les modèles non-OpenAI bénéficient d'une véritable recherche web et de la compréhension d'images
+  grâce à un module complémentaire utilisant votre connexion ChatGPT.
+- **Voyez ce qui se passe** — le tableau de bord affiche les fournisseurs, l'état OAuth, la sélection des modèles et un
+  journal des requêtes en direct avec le nombre de jetons de cache.
+- **Arrêt propre, aucun résidu** — `ocx stop` restaure la configuration d'origine de Codex.
+- **Gestion bornée de la mémoire** — chaque cache, tampon circulaire et stockage de traduction de protocole
+  à longue durée de vie possède une limite finie, un budget en octets ou une réconciliation active. Aucun `Map` ou `Set`
+  non borné ne subsiste après le rechargement de la configuration.
+
+<details>
+<summary>Détails de la gestion de la mémoire</summary>
+
+OpenCodex suit l'état conservé par le processus dans les catégories ci-dessous. Chacune possède une limite documentée :
+
+- **14 stockages conservés** (journal des requêtes, tampons circulaires de débogage, cache d'images, cache de
+  modèles, descriptions visuelles, blobs de curseurs, continuation des réponses, etc.) sont comptabilisés en octets et
+  évincés selon le budget mémoire géré par l'application (256 Mio par défaut), sauf le stockage de
+  rejeu des contrôles natifs, épinglé et jamais évincé.
+- **4 tampons observés** (accumulateurs de traduction, segments finaux d'images/OAuth/Grok) sont
+  surveillés pour détecter la pression des octets en cours de traitement, sans éviction.
+- **31 enregistrements de stockages d'état** gèrent les balayages d'expiration (intervalle de 60 s) et la
+  réconciliation des générations de configuration afin de supprimer les clés obsolètes des fournisseurs et des comptes.
+- **Les mémos de chemins et d'empreintes** (métadonnées de l'espace de travail, identités renforcées, sels
+  d'installation, capacités indiquées par le mode) utilisent des limites LRU selon l'ordre d'insertion (8 à 128 entrées).
+- **Les marqueurs de suppression des générations du cache de modèles** sont supprimés après réconciliation ; une incrémentation globale
+  de la génération empêche les découvertes obsolètes en cours de repeupler les fournisseurs
+  supprimés.
+- **La déduplication des identifiants d'événements du Lab** s'exécute sous un verrou de registre sur disque, sans
+  index en mémoire vive au niveau du processus.
+
+Exécutez `GET /api/system/memory` (avec le jeton d'administration) pour consulter en direct les octets
+conservés, les compteurs d'éviction et les échantillons du watchdog.
+
+</details>
+
+## Routage des modèles
+
+Ciblez n'importe quel fournisseur et modèle configuré avec la syntaxe `provider/model` :
+
+```bash
+codex -m "anthropic/claude-opus-5" "Explique cette stack trace"
+codex -m "google/gemini-3-pro" "Écris des tests unitaires pour auth.ts"
+codex -m "ollama/llama3" "Refactorise cette fonction"
+```
+
+Omettez le préfixe `provider/` pour utiliser le fournisseur par défaut ou établir automatiquement la
+correspondance selon le motif du nom du modèle. Les identifiants de modèles du fournisseur contenant `/`
+sont présentés avec leurs barres obliques internes remplacées par `-` ; la forme brute comportant toutes
+les barres obliques continue également de fonctionner. Détails : [documentation sur le routage des modèles](https://opencodex.me/fr/guides/model-routing/).
+
+### Routage JEV Auto (optionnel)
+
+TypeSafe JEV peut choisir le premier modèle et l'effort de raisonnement d'un Combo activé explicitement,
+sans rien changer au sélecteur de modèles ni aux routes directes. Ajoutez l'identifiant avec
+`ocx login jev`, depuis **Providers → TypeSafe JEV → Add API key**, ou via `TYPESAFE_API_KEY`/`JEV_API_KEY`.
+Ouvrez ensuite **Models → Combos → Create JEV Auto**, choisissez les modèles cibles autorisés et cochez
+les efforts exacts que JEV peut sélectionner pour chaque cible. Sans réglage d'effort, une cible autorise
+tous les efforts que le modèle annonce actuellement.
+
+JEV n'est consulté que pour `jev-auto`, et une seule fois par appel logique au modèle. Un identifiant
+manquant, une erreur réseau ou une décision invalide retombent sur la première cible éligible ;
+l'annulation par l'appelant annule toujours la requête. Les tests automatisés utilisent un point de
+terminaison TypeSafe simulé et ne valident pas un compte JEV réel.
+
+Un Combo JEV peut aussi interroger un modèle de décision auto-hébergé, comme `tev1` d'Ollama, sans
+clé : ajoutez un fournisseur `jev-decision` dont la `baseUrl` est le point de terminaison complet
+`/v1/systemone`, puis indiquez-le dans le `decisionProvider` du Combo. Les identifiants TypeSafe n'y
+sont jamais envoyés. Détails : [modèle de décision auto-hébergé](https://opencodex.me/fr/guides/combos/).
+
+## Fournisseurs et adaptateurs
+
+<!-- sponsors:main-first-mention -->
+OpenAI (connexion ChatGPT ou clé API), Anthropic, Google Gemini, xAI, Kimi, Azure OpenAI, Ollama
+(local + Cloud), Cursor (expérimental) et tous les points de terminaison compatibles OpenAI — ainsi que DeepSeek,
+Groq, OpenRouter, OpenGateway, Together, Fireworks, Cerebras, Mistral, Hugging Face, NVIDIA NIM, MiniMax,
+Qwen Cloud, Qoder Global et CN (PAT officiel + CLI), SiliconFlow, et d'autres. Liste complète : `ocx init` ou la
+[documentation des fournisseurs](https://opencodex.me/fr/guides/providers/).
+
+## CLI
+
+```bash
+ocx init                       # configuration interactive (écrit la configuration, relie Codex, propose le shim)
+ocx start [--port 10100] [--socks5 [host:port] | --socks5-off]  # SOCKS5 par défaut : socks5://127.0.0.1:10808
+ocx stop                       # arrête le proxy et restaure Codex natif
+ocx service [install|repair|restart|start|stop|status|uninstall|remove]  # service en arrière-plan
+ocx codex-shim install         # démarre le proxy à la demande dès que `codex` se lance
+ocx health [--json]            # vérifie immédiatement que le proxy répond
+ocx ready [--json] [--wait [--timeout <seconds>]]  # vérifie l'état après synchronisation
+ocx status                     # le proxy est-il actif ?
+ocx gui                        # ouvre le tableau de bord web
+ocx provider <...>             # gère les fournisseurs (list/add/edit/test/remove)
+ocx account <...>              # gère les comptes ChatGPT et les groupes de clés API
+ocx combo <...>                # gère les combos de basculement / round-robin
+ocx v2 <...>                   # contrôle les surfaces multi-agents v1/v2
+ocx update [--tag preview]     # met à jour opencodex
+```
+
+Si le port préféré est occupé, le démarrage s'arrête et indique le processus qui l'occupe au lieu de passer à un autre port,
+afin de ne jamais laisser un second proxy fonctionner aux côtés du premier. Libérez le port ou indiquez-en un autre avec
+`--port`. Référence complète : [documentation de la CLI](https://opencodex.me/fr/reference/cli/).
+
+### État de fonctionnement et disponibilité
+
+`GET /healthz` indique immédiatement l'état de fonctionnement du proxy. Le point de terminaison non authentifié `GET /readyz` indique
+la disponibilité après synchronisation avec l'identité JSON assainie `{service, version, uptime, pid, port, status}`.
+Il renvoie `200` lorsque `status` vaut `ready` ; les états `pending` et l'état terminal `failed` renvoient `503` avec
+`Retry-After: 1`.
+
+`ocx ready [--json] [--wait [--timeout <seconds>]]` effectue une seule sonde par défaut. `--wait` interroge
+pendant 45 secondes au maximum par défaut, mais s'arrête immédiatement s'il observe l'état terminal `failed` ;
+`--timeout <seconds>` définit une limite de 1 à 300 secondes, nécessite `--wait` et n'accepte que les entiers positifs. La sortie `--json` de la CLI est
+`{ready, status, pid, port}`, où `status` vaut `ready`, `pending`, `failed` ou `unreachable`.
+
+| Sortie | Résultat |
+| --- | --- |
+| `0` | Prêt |
+| `1` | Non prêt : en attente, échec, expiration du délai ou inaccessible |
+| `64` | Arguments non valides |
+
+Un proxy plus ancien dépourvu de `/readyz` échoue de façon fail-closed en `unreachable` avec le code de sortie 1, tandis que `ocx health`
+reste compatible.
+
+### Démarrage automatique : service ou shim
+
+Utilisez le **service** (`ocx service`) pour un proxy toujours actif qui redémarre après un plantage. Utilisez le
+**shim** (`ocx codex-shim install`) pour un démarrage léger à la demande sans démon en arrière-plan.
+Supprimez-les avec `ocx service uninstall` / `ocx codex-shim uninstall`.
+
+### Désinstallation
+
+```bash
+ocx uninstall                  # arrête, supprime le service/shim, restaure Codex natif et nettoie l'état
+npm uninstall -g @koreanhole/opencodex
+```
+
+## Accès distant
+
+Par défaut, opencodex se lie à `127.0.0.1` et ne nécessite aucune authentification supplémentaire. Une liaison au-delà
+de l'adresse de bouclage (`"hostname": "0.0.0.0"`) **nécessite** un jeton bearer — le proxy refuse de démarrer
+sans `OPENCODEX_API_AUTH_TOKEN`, et chaque requête cliente doit le fournir dans
+`x-opencodex-api-key`. Détails : [référence de configuration](https://opencodex.me/fr/reference/configuration/).
+
+## Documentation
+
+La documentation publique — installation, fournisseurs, routage, combos, sous-agents, modules complémentaires, intégrations et
+les références de la CLI, de la configuration et de l'API de gestion — est générée depuis [`docs-site/`](../docs-site) et
+publiée sur **[opencodex.me](https://opencodex.me/fr/)**.
+
+Les notes de référence des mainteneurs se trouvent dans [`structure/`](../structure), la configuration pour
+les contributeurs dans [`CONTRIBUTING.md`](../CONTRIBUTING.md), et le signalement de problèmes de sécurité dans [`SECURITY.md`](../SECURITY.md).
+Signalez les vulnérabilités non divulguées en privé grâce au
+[signalement privé de vulnérabilités de GitHub](https://github.com/lidge-jun/opencodex/security/advisories/new),
+et non dans une issue publique.
+Ce formulaire est le seul canal technique : il n'existe pas d'adresse e-mail de sécurité. Les
+échanges ultérieurs restent dans le signalement privé ; une issue publique peut servir à la
+coordination, jamais aux détails de la vulnérabilité. Accuser réception d'un signalement n'est pas
+le trier, et aucun délai de première réponse n'est promis.
+
+## Développement
+
+Le développement depuis les sources nécessite la CLI `bun` dans votre `PATH`. Le paquet npm publié inclut
+son propre environnement d'exécution Bun pour les commandes `ocx` installées ; les scripts du paquet peuvent
+également résoudre Bun via cette dépendance incluse.
+
+```bash
+git clone https://github.com/lidge-jun/opencodex.git
+cd opencodex
+bun install
+bun run typecheck
+bun run test
+```
+
+Consultez le guide **[Contribuer](../CONTRIBUTING.md)**.
+
+Les contributions de contributeurs intégrées par un report ou une réimplémentation d'un mainteneur,
+lorsque le commit ne nomme pas l'auteur d'origine, sont consignées dans
+**[CREDITS.md](../CREDITS.md)**.
+
+## Politique de signature du code (Code signing policy)
+
+Les binaires Windows passent à la signature Authenticode ([#7207](https://github.com/lidge-jun/opencodex/issues/7207)). Le [guide de signature du code Windows](https://opencodex.me/fr/reference/code-signing/) décrit le déploiement, la vérification d’une signature et la politique complète.
+
+Free code signing provided by [SignPath.io](https://about.signpath.io/), certificate by [SignPath Foundation](https://signpath.org/).
+
+- Committers and reviewers: [lidge-jun](https://github.com/lidge-jun)
+- Approvers: [lidge-jun](https://github.com/lidge-jun)
+- Privacy: This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it.
+
+## Avis de non-responsabilité
+
+opencodex est un projet indépendant maintenu par la communauté et **n'est affilié ni à OpenAI, ni à Anthropic, ni à aucun autre fournisseur, et n'est approuvé par aucun d'eux**.
+
+Certains fournisseurs — notamment Anthropic (Claude) — peuvent suspendre ou restreindre les comptes qui acheminent le trafic API par des proxys tiers. **Utilisation à vos propres risques (UAYOR).** Avant de connecter un fournisseur, consultez ses conditions d'utilisation pour vérifier que l'accès par proxy est autorisé. Les mainteneurs d'opencodex ne sont pas responsables des mesures prises sur les comptes par les fournisseurs en amont.
+
+## Licence
+
+MIT