Руководство по совместной разработке Claude Code и Codex

Зачем так сочетать?

В одну фразу: пусть дорогая модель думает, а дешевая модель делает, чтобы счет не взорвался.

Claude хорошо понимает требования, планирует архитектуру и выполняет сложные рассуждения, но цена тоже заметна: если писать на нем много кода, Token сгорают очень быстро. Codex силен в коде, работает быстро, а главное — намного дешевле.

Поэтому самая разумная связка такая:

• Claude отвечает за планирование: понимает ваши требования, разбивает задачи, принимает архитектурные решения и продумывает, как делать
• Codex отвечает за исполнение: через /codex:rescue берет конкретные задачи кодинга, пишет код, исправляет bug и запускает тесты
• Codex отвечает за ревью: через /codex:review делает code review кода Claude и выступает второй парой глаз

Логика этой связки проста: Token Claude тратятся только на «понять и продумать», а конкретный кодинг и ревью передаются более дешевому Codex. Для тех, кто каждый день интенсивно использует Claude Code, это заметно снижает общие расходы.

Это руководство предполагает, что установка и настройка Claude Code и Codex уже завершены. Если нет, сначала смотрите:

• Настройка Claude Code: Руководство быстрого старта yycode
• Настройка Codex: yycode × Codex: руководство быстрого старта

1. Установите плагин Codex

Когда обе стороны настроены, установите в Claude Code один плагин, чтобы связать их:

/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup

/codex:setup автоматически проверит, установлен ли Codex и пройдена ли аутентификация. Если появится сообщение, что вход не выполнен, запустите !codex login и завершите аутентификацию.

После установки введите /codex, и вы увидите новые slash-команды.

2. Основные команды

У этого плагина всего три типа возможностей: ревью, делегирование задач, управление задачами.

Ревью (только чтение, код не меняет)

# Проверить незакоммиченные изменения
/codex:review

# Проверить разницу текущей ветки с main
/codex:review --base main

# Запустить в фоне, не блокируя текущий диалог
/codex:review --background

# Состязательное ревью с указанным фокусом
/codex:adversarial-review --background Проверь, есть ли race condition, и поставь под сомнение выбор стратегии кэша

Делегирование (передать задачу Codex)

Это ключевая команда для схемы «Claude планирует, Codex выполняет». Вы можете брать задачи, спланированные Claude, и по одной передавать их Codex:

# Попросить Codex разобраться с bug
/codex:rescue investigate why the tests started failing

# Попросить Codex исправить bug
/codex:rescue fix the failing test with the smallest safe patch

# Попросить Codex реализовать функцию
/codex:rescue Реализуй логику валидации формы регистрации пользователя

# Выполнить в фоне, подходит для долгих задач
/codex:rescue --background Рефакторинг пула подключений к базе данных

# Указать более дешевую модель, чтобы еще сильнее сэкономить
/codex:rescue --model gpt-5.4-mini Напиши набор unit-тестов для utils.ts
/codex:rescue --model spark Быстро исправь эту lint-ошибку

# Продолжить прошлую задачу
/codex:rescue --resume Примени прошлое решение исправления

💡 Совет по экономии: --model gpt-5.4-mini или --model spark можно использовать для простых задач на более дешевых и быстрых моделях.

Управление задачами

3. Рекомендуемый workflow: Claude планирует, Codex выполняет

Повседневная разработка

Вы формулируете задачу → Claude анализирует и разбивает → /codex:rescue выполняет по частям → /codex:review проверяет → commit

1. Опишите требование естественным языком, чтобы Claude понял, что вам нужно
2. Claude планирует: разбивает задачу, определяет реализацию, выстраивает порядок — это сильная сторона Claude
3. Передайте конкретные задачи кодинга Codex через /codex:rescue: когда Claude спланировал «сделать A, B, C», передавайте их по одной Codex через rescue
4. После написания кода запустите ревью: /codex:review --background, чтобы Codex сделал независимое code review
5. Исправьте замечания и отправьте изменения

Плюс этого процесса: Token Claude тратятся только на планирование и понимание, а большой объем кодинга идет через дешевую квоту Codex.

Workflow для рискованных изменений

При миграциях базы данных, изменениях аутентификации/авторизации и инфраструктуры добавьте еще один слой состязательного ревью:

Claude планирует → /codex:rescue выполняет → /codex:review → исправления → /codex:adversarial-review → еще исправления → commit

Состязательное ревью будет активно оспаривать дизайн: например «почему выбрана эта стратегия кеша», «продуман ли rollback», «есть ли здесь race condition». Для рискованных изменений такой pressure test полезен.

Когда Claude застрял

Если Claude несколько раз пробует выполнить задачу и результат не устраивает, прямо переключитесь на Codex:

/codex:rescue Исправь эту проблему минимальным изменением

Другой ход мыслей модели часто помогает выйти из тупика.

4. Фоновый запуск (рекомендуется)

Для ревью и rescue-задач рекомендуется добавлять --background, чтобы не блокировать текущий диалог:

/codex:rescue --background Реализуй пагинацию
# Продолжайте обсуждать с Claude другие вещи...
/codex:status          # В любой момент посмотреть прогресс
/codex:result          # Получить результат после завершения

/codex:result вернет session ID; его можно использовать в codex resume <session-id>, чтобы продолжить задачу в Codex.

5. Review gate (опционально)

После включения Claude Code перед завершением задачи автоматически запускает ревью Codex; если найдена проблема, процесс прерывается и сначала исправляет ее:

/codex:setup --enable-review-gate    # Включить
/codex:setup --disable-review-gate   # Выключить

⚠️ Внимание: review gate заметно увеличивает расход Token и может вызвать длинные циклы между Claude и Codex. Рекомендуется использовать только в ключевых проектах; для повседневной разработки достаточно вручную запускать /codex:review.

6. Настройка модели Codex

Если хотите изменить модель Codex по умолчанию или усилие рассуждения, задайте это в конфигурационном файле.

Пользовательская конфигурация: ~/.codex/config.toml
Проектная конфигурация: .codex/config.toml в корне проекта

model = "gpt-5.4-mini"
model_reasoning_effort = "high"

Также можно временно задавать модель и усилие при каждом вызове через --model и --effort:

/codex:rescue --model spark --effort medium Быстро исправь lint-ошибку

7. Когда не стоит использовать Codex

В следующих случаях лучше полностью использовать Claude:

8. Практические советы

• Для простых задач используйте дешевую модель: --model spark подходит для lint-правок и boilerplate-кода, где глубокое рассуждение не требуется
• Сначала review, потом adversarial-review: не начинайте сразу с состязательного ревью; сначала обычное ревью проверит базовые проблемы
• Используйте --resume: /codex:rescue --resume продолжает предыдущую задачу Codex, не нужно начинать сначала
• Следите за расходом обеих сторон: хотя в целом дешевле, одновременно отслеживайте usage Claude и OpenAI, чтобы одна сторона неожиданно не ушла в перерасход
• Обработка конфликтов Skill: если ваш пользовательский Skill конфликтует по trigger words с плагином Codex, добавьте в конфликтующий Skill priority: low

Частые вопросы

Q: После установки плагина не вижу команду /codex?
A: Выполните /reload-plugins, чтобы перезагрузить плагины.

Q: /codex:review сообщает об ошибке аутентификации?
A: Значит, аутентификация Codex настроена неправильно. Смотрите yycode × Codex: руководство быстрого старта, настройте заново или выполните !codex login.

Q: Чем /codex:rescue отличается от прямой просьбы Claude написать код?
A: rescue передает задачу Codex для независимого выполнения и расходует квоту OpenAI, а не Claude Token. Это подходит для стандартизированных задач кодинга. Но Codex не видит контекст вашего диалога с Claude, поэтому описание задачи должно быть четким.

Q: Что делать, если результат ревью противоречит мнению Claude?
A: В этом и ценность работы двух моделей. Когда мнения расходятся, окончательное решение принимаете вы как разработчик.

Q: Сколько реально можно сэкономить?
A: Зависит от того, какую долю кодинга вы передадите Codex. Если в вашем workflow много генерации кода (например, тесты, CRUD), вынесение этих задач в rescue может существенно снизить расход Claude.