codex-collab
Kevin7Qi/codex-collabСкилл для Claude Code, позволяющий взаимодействовать с Codex через JSON-RPC: запускать задачи, проводить код-ревью, управлять потоками и возобновлять диалоги — не покидая сессии Claude.
Установка
git clone https://github.com/Kevin7Qi/codex-collab.gitREADME
codex-collab
Совместная работа с Codex из Claude Code. Запускайте задачи, проводите код-ревью, выполняйте параллельные исследования — не покидая сессии Claude.
codex-collab — это скилл Claude Code, управляющий Codex через JSON-RPC протокол его app server. Инструмент управляет потоками, стримит структурированные события, обрабатывает подтверждения вызовов инструментов и позволяет возобновлять диалоги — всё без выхода из сессии Claude.
Зачем это нужно
- Структурированное взаимодействие — общение с Codex через JSON-RPC поверх stdio. Каждое событие типизировано и поддаётся парсингу.
- Событийный прогресс — стриминг строк прогресса по мере работы Codex, так что Claude видит происходящее в реальном времени.
- Автоматизация ревью — одна команда для код-ревью PR, незакоммиченных изменений или конкретных коммитов в изолированной среде только для чтения.
- Повторное использование потоков — возобновление существующих потоков для отправки уточняющих запросов, развития предыдущих ответов или смены направления работы.
- Управление подтверждениями — настраиваемые политики подтверждения вызовов инструментов: автоподтверждение, интерактивный режим или запрет.
Установка
Требуется Bun >= 1.0 и Codex CLI (npm install -g @openai/codex) в PATH. Протестировано на Linux (Ubuntu 22.04), macOS и Windows 10.
git clone https://github.com/Kevin7Qi/codex-collab.git
cd codex-collabLinux / macOS
./install.sh
Windows
powershell -ExecutionPolicy Bypass -File install.ps1
После установки перезапустите терминал, чтобы обновлённый PATH вступил в силу, затем выполните codex-collab health для проверки.
Инсталлятор собирает самодостаточный бандл, разворачивает его в домашнем каталоге (~/.claude/skills/codex-collab/ на Linux/macOS, %USERPROFILE%\.claude\skills\codex-collab\ на Windows) и добавляет бинарный шим в PATH. После установки Claude обнаруживает скилл автоматически.
Используйте --dev для создания симлинков на исходные файлы вместо сборки бандла — это позволяет перезагружать изменения на лету:
# Linux / macOS
./install.sh --dev
# Windows (может потребоваться Developer Mode или терминал с повышенными правами для симлинков)
powershell -ExecutionPolicy Bypass -File install.ps1 -DevБыстрый старт
# Запустить задачу по запросу
codex-collab run "what does this project do?" -s read-only --content-only
# Код-ревью
codex-collab review --content-only
# Возобновить поток
codex-collab run --resume <id> "now check error handling" --content-onlyКоманды CLI
| Команда | Описание |
|---|---|
run "prompt" [opts] | Создать поток, отправить запрос, дождаться ответа, вывести результат |
review [opts] | Код-ревью (PR, незакоммиченные изменения, коммит) |
jobs [--json] [--all] | Список потоков (--limit <n> для ограничения) |
kill <id> | Прервать выполняющийся поток |
output <id> | Полный лог потока |
progress <id> | Последняя активность (хвост лога) |
models | Список доступных моделей |
health | Проверка зависимостей |
| Команда | Описание |
|---|---|
delete <id> | Архивировать поток, удалить локальные файлы |
clean | Удалить старые логи и устаревшие маппинги |
approve <id> | Подтвердить ожидающий запрос |
decline <id> | Отклонить ожидающий запрос |
| Флаг | Описание |
|---|---|
-d, --dir <path> | Рабочий каталог |
-m, --model <model> | Название модели (по умолчанию: auto — последняя доступная) |
-r, --reasoning <level> | low, medium, high, xhigh (по умолчанию: auto — максимальный для модели) |
-s, --sandbox <mode> | read-only, workspace-write, danger-full-access (по умолчанию: workspace-write; ревью всегда использует read-only) |
--mode <mode> | Режим ревью: pr, uncommitted, commit, custom |
--ref <hash> | Хэш коммита для --mode commit |
--resume <id> | Возобновить существующий поток |
--approval <policy> | Политика подтверждения: never, on-request, on-failure, untrusted (по умолчанию: never) |
--content-only | Скрыть строки прогресса; при использовании с output — вернуть только извлечённый контент |
--timeout <sec> | Таймаут хода (по умолчанию: 1200) |
--base <branch> | Базовая ветка для ревью PR (по умолчанию: main) |
Настройки по умолчанию и конфигурация
По умолчанию codex-collab автоматически выбирает последнюю модель (предпочитая варианты -codex) и максимальный уровень рассуждений, поддерживаемый этой моделью. Никакой настройки не требуется — конфигурация остаётся актуальной по мере выхода новых моделей.
Для постоянного переопределения настроек используйте codex-collab config:
# Показать текущую конфигурацию
codex-collab config
# Задать предпочтительную модель
codex-collab config model gpt-5.3-codex
# Задать уровень рассуждений по умолчанию
codex-collab config reasoning high
# Сбросить ключ (вернуться к автоопределению)
codex-collab config model --unset
# Сбросить все ключи
codex-collab config --unsetДоступные ключи: model, reasoning, sandbox, approval, timeout
Флаги CLI всегда имеют приоритет над конфигурацией, а конфигурация — над автоопределением:
Флаг CLI > файл конфигурации > автоопределение
Конфигурация хранится в ~/.codex-collab/config.json.
Участие в разработке
См. CONTRIBUTING.md для настройки окружения разработки и руководящих принципов. Проект следует кодексу поведения Contributor Covenant.
Смотрите также
Для более простых взаимодействий также можно использовать официальный Codex MCP server.