docs/ — официальный каталог основной документации CodexManager.
Цели:
- хранить руководства по эксплуатации, заметки по релизам и правила сопровождения прямо в репозитории;
- помогать новым участникам быстро находить нужные документы без устной передачи контекста.
CodexManager — локальный desktop + service-process менеджер пула аккаунтов и gateway-ретрансляции для сценариев Codex.
- Единое управление аккаунтами, usage и platform key.
- Локальный OpenAI-compatible gateway для Codex CLI, Gemini CLI, Claude Code и сторонних инструментов.
- Поддержка маршрутизации аккаунтов, override профилей моделей и relay через aggregate API.
- Управление пулом аккаунтов: группы, теги, сортировка, заметки, распознавание и фильтрация банов.
- Пакетный импорт/экспорт: мультифайловый импорт, рекурсивный импорт папок в desktop, экспорт по каждому аккаунту.
- Отображение usage: окна 5 часов + 7 дней, single-window аккаунты и официальные дополнительные buckets (Code Review / Spark).
- Авторизация аккаунта: OAuth через браузер и Device Code для
chatgpt.com; для браузерного OAuth также доступен ручной разбор callback URL. - Platform key: создание, отключение, удаление, привязка модели, reasoning tier и service tier; администратор может привязать key к пользовательской группе аккаунтов, пересечь её с фильтром плана и выполнять ротацию только внутри разрешённого пула.
- Aggregate API: создание/редактирование/проверка сторонних relay-upstream с поставщиками и приоритетами.
- Plugin center: built-in, private и custom source режимы с задачами/логами и Rhai-интеграцией.
- Skills и плагины: в
/skills/установка Skills отделена от установки плагинов Codex. Отдельные Skills можно устанавливать из встроенных и пользовательских GitHub-репозиториев, результатов поиска skills.sh, ZIP-файлов и существующих каталогов; нативный Marketplace Codex по-прежнему устанавливает плагины целиком, а.systemSkills доступны только для чтения. - Desktop-запуск проектов: можно сохранить локальные папки проектов и открыть Codex или выбор
resumeдля текущего проекта в новом терминале с локальным профилем CodexManager; Web и Docker не получают доступ к папкам устройства. - Локальный service + gateway: настройки bind/listen, upstream proxy, общий таймаут запроса, stream idle timeout, SSE keepalive и единая совместимая точка входа. SSE keepalive включён по умолчанию; для отключения задайте
CODEXMANAGER_SSE_KEEPALIVE_ENABLED=0(илиfalse). - Генерация изображений: по умолчанию автоматически добавляется официальный Codex tool
image_generationдля/v1/responses, явно переданные tools проксируются без изменений, также поддерживаются совместимые endpoints/v1/images/generationsи/v1/images/edits; модель image tool по умолчанию —gpt-image-2.
- Запустите desktop-приложение и нажмите Start Service.
- Откройте Account Management и выберите браузерную авторизацию или Device Code для
chatgpt.com. - Если браузерный callback не распарсился автоматически, вставьте callback URL для ручного разбора.
- Обновите usage и проверьте статус аккаунта.
- Корневой
README.mdи локализованныеdocs/*/README.md: обзор проекта и быстрый старт. - Корневой
Журнал-изменений.md: история версий и невыпущенные изменения. report/*: эксплуатация, устранение неполадок, совместимость и FAQ.release/*: сборка, упаковка, публикация и описание артефактов.
- Актуальные заметки о релизах и невыпущенных изменениях смотрите в Журнал-изменений.md.
- Если не уверены, какой документ открыть первым, используйте таблицу ниже.
Спасибо следующим спонсорам за поддержку CodexManager.
|
Спасибо AI夏末 AIXiamo за поддержку проекта! Рекомендуется пользователям в Китае без международной банковской карты, которым нужно пополнить ChatGPT, Claude, Codex или другие AI-сервисы. Поддерживаются Alipay / WeChat Pay, официальное пополнение и надёжная помощь после покупки. Посмотрите услуги на официальном сайте. |
|
Xing Si Yan Gateway предоставляет стабильный relay и сопутствующие сервисы для сценариев вызова Claude Code, Codex и похожих моделей. Подходит разработчикам и командам, которым нужны высокодоступные API, удобное подключение и непрерывная поддержка поставки. Актуальные предложения доступны на официальном сайте. |
Другие участники поддержки: Wonderdch, suxinwl, Hermit, Suifeng023, HK-hub
- Репозиторий: AIDotNet/OpenCowork
- Рекомендуемая связка: используйте OpenCowork для локальных файловых операций, multi-agent выполнения, интеграции с рабочими мессенджерами и desktop-автоматизации, а CodexManager оставьте для управления Codex-аккаунтами, учета usage, platform key и локального gateway entry point.
- Лучше всего подходит: командам, которые хотят разделить "рабочее пространство выполнения / офисную интеграцию" и "управление пулом аккаунтов / вход в gateway".
- Коротко: OpenCowork больше про выполнение в рабочей среде, а CodexManager — про управление и gateway.
| Что вам нужно сделать | Какой документ открыть |
|---|---|
| Первый запуск, развёртывание, Docker, первый запуск на macOS | Руководство по запуску и развёртыванию |
Настройка Codex CLI / ccswitch auth.json и config.toml |
Руководство по запуску и развёртыванию |
| Переменные среды, база данных, порты, прокси и адрес прослушивания | Переменные среды и конфигурация запуска |
| Маршрутизация аккаунтов, ошибки импорта и challenge-проверки | FAQ и правила маршрутизации аккаунтов |
| Почему фоновые задачи пропускают или отключают аккаунты | Пропуск аккаунтов фоновыми задачами |
| Минимальная интеграция маркетплейса плагинов | Минимальная интеграция центра плагинов |
| Внутренние команды и точки интеграции | Сводка внутренних интерфейсов системы |
| Локальная сборка, упаковка и релизные скрипты | Сборка, выпуск и скрипты |
Заметки о релизах, планы отката, описание артефактов и инструкции по упаковке.
Операционные инструкции, заметки по устранению неполадок, отчёты о совместимости и FAQ.
| Документ | Назначение |
|---|---|
| Руководство по запуску и развёртыванию | Первый запуск десктопа, Service-версия, Docker и первый запуск на macOS |
| Переменные среды и конфигурация запуска | Параметры запуска, значения по умолчанию и переменные среды |
| FAQ и правила маршрутизации аккаунтов | Частые проблемы с маршрутизацией аккаунтов и журналами |
| Сравнение параметров шлюза и Codex | Отличия текущих исходящих параметров от официального Codex |
| Пропуск аккаунтов фоновыми задачами | Почему фоновые задачи пропускают, охлаждают или отключают аккаунты |
| Минимальное руководство по устранению неполадок | Быстрые проверки для типовых проблем запуска и релея |
| Минимальная интеграция центра плагинов | Минимальный набор полей и интерфейсов для маркетплейса плагинов |
| Различия заголовков и параметров шлюза с Codex | Отличия заголовков и параметров между шлюзом и Codex |
| Интеграция центра плагинов и интерфейсы | Режимы маркетплейса, RPC/Tauri-команды, поля манифеста и интерфейсы Rhai |
| Сводка внутренних интерфейсов системы | Внутренние команды, RPC-методы и встроенные функции плагинов |
| Документ | Назначение |
|---|---|
| Сборка, выпуск и скрипты | Локальная сборка, параметры скриптов и GitHub workflow |
| Выпуск и артефакты | Имена артефактов, правила публикации и результаты релиза |
| Матрица ответственности скриптов и релиза | Какой скрипт или workflow отвечает за какую задачу |
- остаётся полезной для будущих участников,
- влияет на разработку, тестирование, выпуск или диагностику,
- или служит долгосрочным источником истины для проекта.
- временный черновик,
- личные рабочие заметки,
- одноразовый промежуточный файл,
- или локальная запись эксперимента.
docs/**/*.tmp.mddocs/**/*.local.md
Не используйте эти суффиксы для официальной документации.
Долгоживущие документы: topic.md
Разовые отчёты: yyyyMMddHHmmssfff_topic.md
- Добавляйте важные материалы в
docs/, а не раздувайте README. - Историю версий ведите в
Журнал-изменений.md. - Архитектурные заметки храните в
Архитектура.md. - Правила совместной работы храните в
Руководство-для-участников.md. - Подробности по невыпущенным изменениям фиксируйте в
Журнал-изменений.md, а README оставляйте для навигации.
- WeChat: чтобы попасть в группу, добавьте
ProsperGaoи сразу укажите цель обращения - Telegram-группа: CodexManager TG group