@koreanhole/opencodex 2.95.1 → 2.95.3

package/readme/README.ru.md

@@ -0,0 +1,516 @@
+<p align="center">
+  <img src="../assets/banner.png" alt="opencodex — один локальный шлюз для Codex, Claude Code, Claude Desktop, Grok Build и других инструментов" width="100%">
+</p>
+
+<h3 align="center">Один локальный шлюз для ваших инструментов программирования с ИИ и моделей.</h3>
+<p align="center"><b>Используйте выбранные модели с Codex, Claude Code, Claude Desktop и Grok Build,<br>а OpenCode, Pi, Qoder, WorkBuddy, Kilo, Cline, T3 Code и другие подключайте через управляемые конфигурации.</b><br>
+<a href="https://opencodex.me/ru/reference/client-support/">Все поддерживаемые инструменты →</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="Подписывайтесь на @claudeebum в 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="версия 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="лицензия"></a>
+  <img src="https://img.shields.io/node/v/@koreanhole/opencodex?logo=node.js&label=node" alt="версия 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="Скачать для 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="Скачать для 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="Скачать для 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="Скачать для Linux (.deb)"></a>
+</p>
+
+<table>
+<tr>
+<td width="50%" valign="middle">
+
+### Claude Code на любой модели
+
+Селектор — штатный Claude Code. Мозг за ним — нет.
+
+</td>
+<td width="50%">
+  <img src="../assets/claude-code-models.gif" alt="Claude Code работает на маршрутизированной модели через opencodex — в строке состояния активна gpt-5.6-luna-medium" width="100%">
+</td>
+</tr>
+<tr>
+<td width="50%" valign="middle">
+
+### Codex на любой модели
+
+Выберите провайдера — и вперёд: тот же рабочий процесс, другой «мозг».
+
+</td>
+<td width="50%">
+  <img src="../assets/demo.gif" alt="Демонстрация opencodex — выполнение задачи в приложении Codex на маршрутизированной модели не от OpenAI" width="100%">
+</td>
+</tr>
+<tr>
+<td width="50%" valign="middle">
+
+### Claude Desktop на любой модели
+
+Opus отвечает, затем передаёт задачу подагенту GPT-5.6 Sol.
+
+</td>
+<td width="50%">
+  <img src="../assets/claude-desktop-subagent.gif" alt="Claude Desktop отвечает как Claude Opus 4.8, затем запускает подагента GPT-5.6 Sol через opencodex" width="100%">
+</td>
+</tr>
+<tr>
+<td width="50%" valign="middle">
+
+### Grok Build на любой модели
+
+Sol ведёт сессию и вызывает подагента Kimi K3.
+
+</td>
+<td width="50%">
+  <img src="../assets/grok-build-subagent.gif" alt="Grok Build запускает GPT-5.6 Sol через opencodex и вызывает подагента Kimi K3" width="100%">
+</td>
+</tr>
+</table>
+
+<p align="center">
+  <a href="../README.md">English</a> · <a href="README.fr.md">Français</a> · <a href="README.ko.md">한국어</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.zh-TW.md">繁體中文</a> · <b>Русский</b> · <a href="README.ja.md">日本語</a> · <a href="README.tr.md">Türkçe</a> · 📖 <a href="https://opencodex.me/ru/"><b>Полная документация →</b></a>
+</p>
+
+opencodex — лёгкий локальный шлюз между вашими инструментами программирования и поставщиками моделей. Он принимает запросы API Responses, Chat Completions и Anthropic Messages и переводит их в протокол провайдера, передавая потоковые ответы, вызовы инструментов, рассуждения и изображения там, где это поддерживают клиент, модель и провайдер. Используйте Claude, Gemini, Grok, GLM, DeepSeek, Kimi, Qwen, Ollama и других провайдеров с Codex, Claude Code, Claude Desktop, Grok Build и инструментами со [страницы поддержки клиентов](https://opencodex.me/ru/reference/client-support/). Он также управляет **пулом аккаунтов ChatGPT** для аутентификации Codex: добавляйте аккаунты и обновляйте их квоты в панели; новые сеансы автоматически направляются на исправный аккаунт с наименьшим использованием, а существующие треды остаются привязаны к исходному аккаунту.
+
+## Быстрый старт
+
+### Личная установка (CLI)
+
+```bash
+npm install -g @koreanhole/opencodex   # Node 18+; рантайм Bun подключается автоматически
+ocx start                         # прокси + панель управления на localhost:10100
+```
+
+Чтобы запустить его в фоне, используйте `ocx service`.
+
+Откройте **http://localhost:10100** и настройте всё в веб-панели: добавьте провайдеров
+(40+ встроенных или любой OpenAI-совместимый endpoint), выберите модели, управляйте
+аккаунтами. `ocx gui` в любой момент снова откроет панель.
+
+### Подключите свой инструмент
+
+Подключите инструмент, которым вы уже пользуетесь:
+
+| Инструмент | Как подключить |
+|---|---|
+| Codex | Включите переключатель Codex на странице **Connect** панели, затем запускайте `codex` как обычно. При локальном прослушивании встроенный провайдер Codex будет направлен на прокси. В терминале выполните `ocx init` до добавления провайдеров в панели и примите приглашение Codex. |
+| Claude Code | Установив CLI `claude`, выполните `ocx claude`. Команда при необходимости запускает прокси и запускает через него Claude Code. |
+| Claude Desktop | Выполните `ocx claude desktop`. При новой установке команда настраивает профиль шлюза для всего приложения; существующая настройка first-party сохраняется, а `ocx claude desktop apply --gateway` явно переключает режим. См. [руководство Claude Code](https://opencodex.me/ru/guides/claude-code/). После переключения полностью закройте и снова откройте Claude Desktop. |
+| Grok Build | При локальном прослушивании и включённой интеграции Grok команда `ocx start` регистрирует модели, если существует `~/.grok`; выберите модель `ocx-*` в Grok Build. Об удалённой настройке см. [руководство Grok Build](https://opencodex.me/ru/guides/grok-build/). После добавления провайдеров перезапустите прокси (или выполните `ocx ensure`, если включён автозапуск Codex), чтобы обновить список. |
+| Инструменты с управляемой интеграцией | Используйте страницу **Connect** панели или `ocx integration client enable --client <id>`. |
+| Любой другой инструмент | Укажите пользовательский базовый URL, совместимый с OpenAI: `http://localhost:10100/v1`, либо базовый URL Anthropic: `http://localhost:10100`. |
+
+На [странице поддержки клиентов](https://opencodex.me/ru/reference/client-support/) указаны способы подключения и протоколы каждого инструмента.
+
+<details>
+<summary><b>Настольное приложение (бета)</b></summary>
+
+Настольное приложение — это тот же прокси и та же панель управления в нативном окне,
+с иконкой в трее и встроенным `ocx`. Оно подключается к уже запущенному прокси либо
+запускает встроенный, а панель остаётся на порту прокси (**http://localhost:10100**,
+если вы не настроили другой). Выберите файл для своей платформы в
+[последнем релизе](https://github.com/lidge-jun/opencodex/releases/latest):
+
+| Платформа | Файл | Примечания |
+|---|---|---|
+| macOS 13+ (Apple Silicon и Intel) | `OpenCodex-<version>-macos.dmg` | Универсальная сборка, подписана Developer ID и нотариализована |
+| Windows (x64) | `OpenCodex-<version>-windows-x64.msi` | Подпись кода через SignPath Foundation внедряется ([политика подписи кода](https://opencodex.me/ru/reference/code-signing/)); пока релиз не подписан, SmartScreen спросит один раз — выберите **Подробнее → Выполнить в любом случае** |
+| Linux (x86_64) | `OpenCodex-<version>-linux-x86_64.AppImage` или `-linux-amd64.deb` | Для трея нужен рабочий стол с поддержкой AppIndicator |
+
+Рядом с каждым файлом на странице релиза есть `.sha256`. На macOS 14+ приложение также
+поставляется с расширением WidgetKit, которое показывает состояние прокси, расход за
+сегодня и квоты провайдеров; модель снимков, которую оно отображает, находится в
+[`app/`](../app) (`MenuBarCore`). Чтобы собрать приложение самостоятельно, выполните
+`bun install && bun run build:gui` в корне репозитория, затем в `desktop/` выполните
+`bun install && bun run prepare-sidecar && bun run prepare-widget && bun run build:local` на macOS
+или `bun install && bun run prepare-sidecar && bun run build:local` на Windows и Linux (шаг с виджетом
+работает только на macOS). В [руководстве по настольному приложению](https://opencodex.me/ru/guides/desktop-app/) и
+[руководстве по приложению macOS в строке меню](https://opencodex.me/ru/guides/macos-menu-bar/)
+описан первый запуск, а
+[`AGENTS_INSTALL.md`](../AGENTS_INSTALL.md#where-things-are-installed) перечисляет всё, что записывается на диск.
+
+</details>
+
+### Пул аккаунтов ChatGPT
+
+opencodex также умеет управлять **пулом аккаунтов ChatGPT** для аутентификации Codex. Добавьте
+несколько аккаунтов ChatGPT / Codex и обновляйте их квоты за 5 ч / неделю / 30 дней в панели.
+При маршрутизации по квоте новые сессии могут использовать работоспособный аккаунт с наименьшим
+использованием; round-robin и fill-first применяют свои политики. Существующие треды Codex
+обычно сохраняют привязку к аккаунту, с которого начались, поэтому длинные сессии по SSH,
+в tmux или с мобильного устройства не перескакивают между аккаунтами посреди разговора — но
+повторная оценка квот, failover, исключение аккаунта, истечение привязки или восстановление
+после 401/403 и 429 могут перепривязать их. Задайте аккаунтам порядок выбора, если один из
+них — обычно вход Codex Desktop — должен использоваться только после того, как остальные
+исчерпаны.
+
+### Спонсоры
+
+Спонсоры позволяют поддерживать opencodex при каждом изменении вышестоящих протоколов. Интересно?
+См. [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>Благодарим <a href="https://www.orcarouter.ai/?utm_source=opencodex&utm_medium=readme">OrcaRouter</a> за спонсорскую поддержку проекта! OrcaRouter — единый OpenAI-совместимый AI-шлюз для продакшена: адаптивная маршрутизация оценивает каждый промпт и отправляет его модели, которая проходит ваш порог, плюс автоматический failover, правила маршрутизации как код, цены провайдеров без наценки с кэшированием промптов, а также guardrails, файрвол агентов и журналы запросов на каждый вызов среди 200+ моделей. Выберите <code>OrcaRouter</code> в селекторе Add provider или выполните <code>ocx provider add orcarouter</code>; <code>orcarouter/auto</code> — адаптивный маршрутизатор.</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>Благодарим <a href="https://tokenlab.sh/r/OPENCODEX">TokenLab</a> за спонсорскую поддержку проекта! TokenLab даёт агентам для программирования один API-ключ для ведущих моделей с поддержкой форматов OpenAI Responses и Chat Completions, Anthropic Messages и нативного API Gemini, включая стриминг и вызов инструментов. Также доступны MCP-сервер и Skills для агентов, чтобы упростить интеграцию. Выберите режим доставки и платите по мере использования. Выберите <code>TokenLab</code> в селекторе Add provider или выполните <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>
+
+Репозиторий поставляет сборку Compose с закреплённым дайджестом и без root. Сборка сама создаёт
+и проверяет канонический манифест совместимости из выбранного снимка Git. Для локального клона
+нужны Git и Docker Compose, для удалённого Git-контекста — Docker Compose. Ни одному варианту
+не нужны Bun на хосте или подготовительный шаг. Один раз инициализируйте токен плоскости данных
+через stdin и запустите хаб:
+
+```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
+```
+
+Привязка по умолчанию — `127.0.0.1:10100`. Удалённый доступ требует явного
+`OPENCODEX_BIND_ADDRESS=<LAN-or-Tailscale-IP> docker compose up -d`; `0.0.0.0` открывает
+все интерфейсы хоста. Ограничьте доступ файрволом и аутентифицированным TLS/tailnet-фронтендом.
+Сгенерированный JSON остаётся неотслеживаемым. В контекст сборки допускаются только `.git/index`
+и `.git/HEAD` — инвентарь, который читает `git ls-files`, объёмом около 1 МБ вместо полного хранилища
+объектов. Они видны только этапу манифеста, используемому при сборке, через монтирование только для
+чтения, поэтому ни один `COPY` не включает `.git`. Манифест, ранее созданный на хосте, принимается
+только после проверки; иначе сборка создаёт его сама. Сборка отклоняет устаревшие манифесты,
+отсутствующие или несовпадающие файлы, лишние исходники
+и символические ссылки. Она сверяет каждый записанный SHA-256 с контекстом сборки и скопированными
+рантайм-файлами, включая `package.json`, `bun.lock` и явно включённый
+`scripts/model-metadata.source.json`.
+
+Для удалённого Git-контекста BuildKit должен сохранять метаданные Git. Этот фрагмент сборки Compose
+выбирает удалённый снимок и передаёт требуемый встроенный аргумент:
+
+```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"
+```
+
+Токен и изменяемое состояние живут в именованном томе `ocx-state`; ни одно учётное данное не
+попадает в образ, Compose-файл, окружение или аргументы оболочки. См.
+[руководство по развёртыванию Remote Hub](https://opencodex.me/ru/guides/remote-hub/)
+для настройки провайдеров, аутентифицированных проверок приёмки, удалённого управления и отката.
+
+</details>
+
+<details>
+<summary>Установка из исходников (последний dev)</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
+```
+
+Установка из исходников запускает последнюю ветку `dev`. Патчи владения памятью,
+улучшения GC рантайма и ещё не опубликованные исправления доступны здесь раньше,
+чем в npm-пакете.
+
+</details>
+
+<details>
+<summary>Для агентов</summary>
+
+```bash
+npm install -g @koreanhole/opencodex
+ocx start     # или `ocx service`
+ocx init      # интерактивная настройка: пишет ~/.opencodex/config.json и подключает Codex
+```
+
+`ocx init` никогда не запускает прокси; запустите его сначала (или после — оба порядка
+работают, но headless-команды вроде `ocx provider add` и `ocx combo set` обращаются к
+**живому** прокси и завершаются с ненулевым кодом, если он недоступен). `ocx status` /
+`ocx doctor` / `ocx health` показывают состояние запущенного процесса.
+
+> **Агентам, которые устанавливают или запускают opencodex:** прочитайте
+> [`AGENTS_INSTALL.md`](../AGENTS_INSTALL.md). Интерактивный `ocx start` может один раз
+> спросить, ставить ли star этому репозиторию — это решение пользователя, никогда не агента.
+> CLI подавляет подсказку в агентных запусках, а API отказывает с `403 agent_consent_required`.
+
+</details>
+
+## Поддерживаемые платформы
+
+| ОС | Статус | Менеджер служб | Настольное приложение (бета) |
+|---|---|---|---|
+| macOS (arm64 / x64) | Полная поддержка | launchd | Универсальный `.dmg` |
+| Linux (x64 / arm64) | Полная поддержка | systemd (пользовательский unit) | `.AppImage` / `.deb` для x86_64 |
+| Windows (x64) | Полная поддержка | Task Scheduler (скрыто) / опциональная нативная служба (`--native`, WinSW) | `.msi` для x64 |
+
+Для установки CLI требуется [Node](https://nodejs.org) 18+; настольному приложению не нужны ни Node, ни Bun. Рантайм Bun добавляется автоматически при `npm install` —
+отдельно устанавливать Bun не нужно, WSL на Windows тоже не нужен. Если npm заблокировал
+скрипты установки встроенного рантайма, см. [документацию по установке](https://opencodex.me/ru/getting-started/installation/).
+
+## Основные возможности
+
+- **Любая LLM в Codex, Claude Code, Claude Desktop и Grok Build** — 40+ провайдеров из
+  коробки, каждый со своим нативным UI.
+- **Повторно используйте вход локального CLI** — `cline-cli/default` и `gemini-cli/default` делегируют работу установленному CLI с выполненным входом, а Codex сохраняет одобрение и выполнение инструментов.
+- **Пул аккаунтов ChatGPT** — привязка тредов, автопереключение с учётом квот, кулдаун и
+  fail-closed обработка аутентификации.
+
+  > **Замечание о политике провайдеров:** пул аккаунтов нужен только для маршрутизации и
+  > операционной устойчивости; он не гарантирует защиты от лимитов провайдера, принудительных
+  > мер, блокировок и других действий в отношении аккаунтов. OpenCodex не одобряет использование
+  > дополнительных аккаунтов для обхода лимитов провайдера и совместное использование учётных
+  > данных между людьми. Вы отвечаете за соблюдение актуальных условий каждого провайдера. См.
+  > [руководство по пулу аккаунтов Codex Auth](https://opencodex.me/ru/guides/web-dashboard/)
+  > и [актуальные Terms of Use OpenAI](https://openai.com/policies/terms-of-use/).
+- **Combos** — один виртуальный id модели с failover или взвешенным round-robin между
+  провайдерами. См. [руководство по combos](https://opencodex.me/ru/guides/combos/).
+- **Подагенты на любой модели** — выводите маршрутизируемые модели в селектор подагентов Codex,
+  с управлением поверхностями v1/v2 и цепочками fallback. См.
+  [руководство по подагентам](https://opencodex.me/ru/guides/sub-agent-surface/).
+<!-- sponsors:main-first-mention -->
+- **Один вход — без API-ключа** — OAuth для xAI, Anthropic и Kimi; либо пробросьте
+  `codex login`, вставьте ключ или используйте ссылки `${ENV_VAR}`.
+- **Сайдкары веб-поиска и зрения** — модели не от OpenAI получают настоящий веб-поиск и
+  понимание изображений через сайдкар поверх вашего входа ChatGPT.
+- **Видно, что происходит** — панель показывает провайдеров, статус OAuth, выбор моделей и
+  живой журнал запросов с количеством токенов кэша.
+- **Чистый выход без следов** — `ocx stop` возвращает Codex к исходной конфигурации.
+- **Ограниченное владение памятью** — у каждого долгоживущего кэша, кольцевого буфера и
+  хранилища трансляции протокола есть конечный потолок, байтовый бюджет или активная
+  сверка. Ни один неограниченный `Map` или `Set` не переживает перезагрузку конфигурации.
+
+<details>
+<summary>Подробности владения памятью</summary>
+
+OpenCodex отслеживает состояние, удерживаемое процессом, в категориях ниже. У каждой есть
+документированная граница:
+
+- **14 удерживаемых хранилищ** (журнал запросов, отладочные кольца, кэш изображений, кэш
+  моделей, vision-описания, cursor-блобы, продолжение responses и т. д.) учитываются
+  в байтах и вытесняются бюджетом памяти приложения (по умолчанию 256 MiB), кроме
+  хранилища native control replay: оно закреплено и не вытесняется.
+- **4 наблюдаемых буфера** (аккумуляторы транслятора, хвосты image/OAuth/Grok)
+  мониторятся по байтовому давлению in-flight без вытеснения.
+- **31 регистрация state-store** выполняет sweeps истечения (интервал 60 с) и сверку
+  поколений конфигурации, чтобы удалять устаревшие ключи провайдеров и аккаунтов.
+- **Мемо пути и отпечатков** (метаданные рабочей области, усиленные идентификаторы,
+  соли установки, возможности mode-hint) используют LRU-потолки в порядке вставки
+  (8–128 записей).
+- **Tombstone поколений кэша моделей** удаляются после сверки; глобальный инкремент
+  поколения не даёт устаревшим in-flight discovery снова заполнить удалённых провайдеров.
+- **Дедупликация event-id в Lab** работает под блокировкой журнала с диска, без
+  процессного RAM-индекса.
+
+Выполните `GET /api/system/memory` (с admin-токеном), чтобы посмотреть живые удержанные
+байты, счётчики вытеснения и выборки watchdog.
+
+</details>
+
+## Маршрутизация моделей
+
+Обращайтесь к любому настроенному провайдеру и модели синтаксисом `provider/model`:
+
+```bash
+codex -m "anthropic/claude-opus-5" "Разберите этот stack trace"
+codex -m "google/gemini-3-pro" "Напишите unit-тесты для auth.ts"
+codex -m "ollama/llama3" "Отрефакторьте эту функцию"
+```
+
+Опустите префикс `provider/`, чтобы использовать провайдера по умолчанию или автоматически
+подобрать его по шаблону имени модели. Id моделей провайдера, содержащие `/`,
+отдаются с внутренними слэшами, заменёнными на `-`; исходная форма со всеми слэшами
+тоже продолжает работать. Подробности: [документация по маршрутизации моделей](https://opencodex.me/ru/guides/model-routing/).
+
+### Маршрутизация JEV Auto (опционально)
+
+TypeSafe JEV может выбирать первую модель и уровень рассуждения для явно включённого Combo, не меняя
+обычный выбор модели и прямые маршруты. Добавьте ключ через `ocx login jev`, в
+**Providers → TypeSafe JEV → Add API key** или через `TYPESAFE_API_KEY`/`JEV_API_KEY`. Затем откройте
+**Models → Combos → Create JEV Auto**, выберите разрешённые целевые модели и отметьте, какие уровни
+рассуждения JEV может выбрать для каждой цели. Если настройку не трогать, цель разрешает все уровни,
+которые модель сейчас объявляет.
+
+JEV вызывается только для `jev-auto` и только один раз на логический вызов модели. При отсутствии ключа,
+сетевой ошибке или некорректном решении запрос уходит на первую доступную цель (fail-open); отмена
+со стороны клиента по-прежнему отменяет запрос. Автотесты используют имитацию TypeSafe и не проверяют
+настоящий аккаунт JEV.
+
+Combo JEV может вместо этого обращаться к самостоятельно размещённой модели решений, например к
+бесключевой `tev1` в Ollama: добавьте провайдера `jev-decision`, у которого `baseUrl` — полный адрес
+`/v1/systemone`, и укажите его в `decisionProvider` Combo. Учётные данные TypeSafe туда никогда не
+отправляются. Подробнее: [самостоятельно размещённая модель решений](https://opencodex.me/ru/guides/combos/).
+
+## Провайдеры и адаптеры
+
+<!-- sponsors:main-first-mention -->
+OpenAI (вход ChatGPT или API-ключ), Anthropic, Google Gemini, xAI, Kimi, Azure OpenAI, Ollama
+(локально + Cloud), Cursor (экспериментально) и любой OpenAI-совместимый endpoint — плюс DeepSeek,
+Groq, OpenRouter, OpenGateway, Together, Fireworks, Cerebras, Mistral, Hugging Face, NVIDIA NIM, MiniMax,
+Qwen Cloud, Qoder Global и CN (официальный PAT + CLI), SiliconFlow и другие. Полный список: `ocx init` или
+[документация по провайдерам](https://opencodex.me/ru/guides/providers/).
+
+## CLI
+
+```bash
+ocx init                       # интерактивная настройка (пишет конфиг, подключает Codex, предлагает shim)
+ocx start [--port 10100] [--socks5 [host:port] | --socks5-off]  # SOCKS5 по умолчанию: socks5://127.0.0.1:10808
+ocx stop                       # остановить + восстановить нативный Codex
+ocx service [install|repair|restart|start|stop|status|uninstall|remove]  # фоновая служба
+ocx codex-shim install         # запускать прокси по требованию при старте `codex`
+ocx health [--json]            # проверить немедленную живость прокси
+ocx ready [--json] [--wait [--timeout <seconds>]]  # проверить готовность после синхронизации
+ocx status                     # работает ли прокси?
+ocx gui                        # открыть веб-панель
+ocx provider <...>             # управлять провайдерами (list/add/edit/test/remove)
+ocx account <...>              # управлять аккаунтами ChatGPT и пулами API-ключей
+ocx combo <...>                # управлять combos с failover / round-robin
+ocx v2 <...>                   # управление мультиагентными поверхностями v1/v2
+ocx update [--tag preview]     # обновить opencodex
+```
+
+Если предпочтительный порт занят, запуск останавливается и сообщает, какой процесс его занимает, вместо перехода
+на другой порт, поэтому второй прокси никогда не останется работать рядом с первым. Освободите порт или укажите
+другой с помощью `--port`. Полный справочник: [документация CLI](https://opencodex.me/ru/reference/cli/).
+
+### Здоровье и готовность
+
+`GET /healthz` сообщает о немедленной живости прокси. Неаутентифицированный endpoint `GET /readyz`
+сообщает о готовности после синхронизации с очищенной JSON-идентичностью `{service, version, uptime, pid, port, status}`.
+Он возвращает `200`, когда `status` равен `ready`; `pending` и терминальный `failed` возвращают `503` с
+`Retry-After: 1`.
+
+`ocx ready [--json] [--wait [--timeout <seconds>]]` по умолчанию выполняет один зонд. `--wait` опрашивает
+до 45 секунд по умолчанию, но сразу завершается при терминальном `failed`;
+`--timeout <seconds>` задаёт лимит 1–300 секунд, требует `--wait` и принимает только положительные целые. CLI `--json` выводит
+`{ready, status, pid, port}`, где `status` — `ready`, `pending`, `failed` или `unreachable`.
+
+| Код | Результат |
+| --- | --- |
+| `0` | Готов |
+| `1` | Не готов: pending, failed, timeout или unreachable |
+| `64` | Некорректные аргументы |
+
+Старый прокси без `/readyz` закрывается как `unreachable` с кодом 1, тогда как `ocx health`
+остаётся совместимым.
+
+### Автозапуск: служба или shim
+
+Используйте **службу** (`ocx service`) для постоянно работающего прокси, который перезапускается
+при сбое. Используйте **shim** (`ocx codex-shim install`) для лёгкого запуска по требованию без
+фонового демона. Удаляйте их командами `ocx service uninstall` / `ocx codex-shim uninstall`.
+
+### Удаление
+
+```bash
+ocx uninstall                  # остановить, удалить службу/shim, восстановить нативный Codex, очистить состояние
+npm uninstall -g @koreanhole/opencodex
+```
+
+## Удалённый доступ
+
+По умолчанию opencodex привязывается к `127.0.0.1` и не требует дополнительной аутентификации.
+Привязка за пределами loopback (`"hostname": "0.0.0.0"`) **требует** bearer-токен — прокси
+откажется запускаться без `OPENCODEX_API_AUTH_TOKEN`, и каждый клиентский запрос должен нести его
+как `x-opencodex-api-key`. Подробности: [справочник по конфигурации](https://opencodex.me/ru/reference/configuration/).
+
+## Документация
+
+Публичная документация — установка, провайдеры, маршрутизация, combos, подагенты, сайдкары,
+интеграции и справочники CLI/конфигурации/management-API — собирается из [`docs-site/`](../docs-site) и
+публикуется на **[opencodex.me](https://opencodex.me/ru/)**.
+
+Заметки мейнтейнеров, служащие источником истины, находятся в [`structure/`](../structure),
+настройка для контрибьюторов — в [`CONTRIBUTING.md`](../CONTRIBUTING.md), сообщения о проблемах
+безопасности — в [`SECURITY.md`](../SECURITY.md).
+Нераскрытые уязвимости сообщайте приватно через
+[GitHub private vulnerability reporting](https://github.com/lidge-jun/opencodex/security/advisories/new),
+а не публичный issue.
+Эта форма — единственный технический канал, отдельного адреса для безопасности нет. Дальнейшее
+обсуждение остаётся внутри приватного отчёта; в публичном issue допустима только координация, но
+не детали уязвимости. Подтверждение получения отчёта — это ещё не разбор, и срок первого ответа
+не обещан.
+
+## Разработка
+
+Разработка из исходников требует CLI `bun` в вашем `PATH`. Опубликованный npm-пакет содержит свой рантайм Bun
+для установленных команд `ocx`; скрипты пакета также могут находить Bun через эту встроенную зависимость.
+
+```bash
+git clone https://github.com/lidge-jun/opencodex.git
+cd opencodex
+bun install
+bun run typecheck
+bun run test
+```
+
+См. **[Contributing](../CONTRIBUTING.md)**.
+
+Работа контрибьюторов, которая попала через перенос или реимплементацию мейнтейнером,
+если коммит не называет исходного автора, записана в
+**[CREDITS.md](../CREDITS.md)**.
+
+## Политика подписи кода (Code signing policy)
+
+Исполняемые файлы для Windows переводятся на подпись Authenticode ([#7207](https://github.com/lidge-jun/opencodex/issues/7207)). Ход внедрения, проверка подписи и полная политика описаны в [руководстве по подписи кода Windows](https://opencodex.me/ru/reference/code-signing/).
+
+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.
+
+## Отказ от ответственности
+
+opencodex — независимый проект, поддерживаемый сообществом; он **не аффилирован с OpenAI, Anthropic или каким-либо другим провайдером и не одобрен ими**.
+
+Некоторые провайдеры — в частности Anthropic (Claude) — могут приостанавливать или ограничивать аккаунты, которые направляют API-трафик через сторонние прокси. **Используйте на свой страх и риск (UAYOR).** Прежде чем подключать провайдера, изучите его Terms of Service и убедитесь, что доступ через прокси разрешён. Мейнтейнеры opencodex не несут ответственности за какие-либо действия вышестоящих провайдеров в отношении аккаунтов.
+
+## Лицензия
+
+MIT