canonical_url: https://yycode.net/docs/ru/claude-code-codex-collaboration-guide
lang: ru
updated_at: 2026-07-04T13:33:48.616Z
source_html: https://yycode.net/docs/ru/claude-code-codex-collaboration-guide

# Руководство по совместной разработке 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](DragonCode快速开始指南.md)
> - Настройка Codex: [yycode × Codex: руководство быстрого старта](DragonCode-Codex快速开始指南.md)

---

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

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

```bash
/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` | Попросить Codex проверить текущие незакоммиченные изменения или сравнить ветки |
| `/codex:adversarial-review` | Состязательное ревью — не просто проверка кода, а активное оспаривание проектных решений |

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

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

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

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

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

| Команда | Назначение |
|---|---|
| `/codex:rescue` | Передать конкретную задачу Codex; Codex реально изменит код |

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

```bash
# Попросить 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` можно использовать для простых задач на более дешевых и быстрых моделях.

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

| Команда | Назначение |
|---|---|
| `/codex:status` | Посмотреть выполняющиеся и недавно завершенные задачи Codex |
| `/codex:result` | Получить результат завершенной задачи (включая session ID, чтобы продолжить в Codex) |
| `/codex:cancel` | Отменить выполняющуюся фоновую задачу |

---

## 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:

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

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

---

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

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

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

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

---

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

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

```bash
/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` в корне проекта

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

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

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

---

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

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

| Сценарий | Причина |
|---|---|
| Глубокий рефакторинг бизнес-логики | Codex не получает весь контекст, накопленный в диалоге с Claude, и сгенерированный код может не совпасть со стилем проекта |
| Задачи, требующие глубокого понимания нескольких файлов | Codex rescue запускается независимо и не разделяет историю диалога Claude |
| Очень маленький объем кода | Если нужно всего несколько строк, делегирование не нужно; быстрее попросить 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: руководство быстрого старта](DragonCode-Codex快速开始指南.md), настройте заново или выполните `!codex login`.

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

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

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