Как перейти с Claude Code на Codex: пошаговая инструкция

Если вы рассматриваете переход с Claude Code на OpenAI Codex, эта инструкция поможет быстро перенести привычный рабочий процесс на новый инструмент.

Claude Code и Codex — два ведущих ИИ-инструмента для разработки. Оба умеют анализировать проекты, писать и редактировать код, запускать команды и тесты. Поэтому переход обычно не требует серьёзной перестройки рабочего процесса.

Для среднего проекта переход может занять менее часа. Исходный код переносить не нужно: достаточно установить Codex, подключить существующий проект и адаптировать инструкции для ИИ.

Разберём весь процесс по шагам.

Шаг 1. Подготовьте существующий проект

Если вы работали с Claude Code, скорее всего, ваш проект уже содержит всё необходимое для перехода:

  • Исходный код и конфигурационные файлы.
  • Историю изменений Git.
  • Документацию проекта.
  • Файл CLAUDE.md с инструкциями для ИИ.
  • Дополнительные правила, скрипты и команды разработки.

Codex может работать с тем же каталогом проекта. Переносить исходный код в отдельный репозиторий не требуется.

Перед переходом рекомендуется сохранить текущие изменения в Git. Проверьте состояние проекта:

git status

Если есть незакоммиченные изменения, сохраните их в отдельном коммите или временно уберите через git stash. Это позволит при необходимости вернуться к исходному состоянию.

Шаг 2. Установите OpenAI Codex

Если вы привыкли работать с Claude Code через терминал, наиболее близкий вариант — Codex CLI. Для установки потребуется Node.js и npm.

Откройте терминал и выполните:

npm install -g @openai/codex

После установки запустите:

codex

При первом запуске Codex предложит авторизоваться. Вы можете войти через аккаунт ChatGPT с подходящей подпиской или использовать API-ключ OpenAI с отдельной оплатой API.

После успешной авторизации Codex готов к работе.

Шаг 3. Откройте существующий проект в Codex

Перейдите в каталог проекта:

cd /path/to/your/project

Запустите Codex:

codex

Теперь Codex работает с теми же файлами, с которыми ранее работал Claude Code. Для начала можно попросить:

Изучи структуру проекта, основные зависимости и архитектуру. Пока ничего не изменяй. Объясни, как устроен проект и какие команды используются для запуска и тестирования.

Codex изучит доступные файлы и сформирует представление о проекте.

Важный нюанс: Codex не получает автоматически историю ваших предыдущих диалогов с Claude Code. Чтобы новый инструмент лучше понимал проект, необходимо перенести инструкции и важный контекст.

Шаг 4. Перенесите инструкции из CLAUDE.md в AGENTS.md

Это один из самых важных этапов перехода.

Claude Code использует файл CLAUDE.md, в котором можно хранить инструкции для ИИ:

  • Описание проекта и его архитектуры.
  • Правила написания кода.
  • Используемые технологии.
  • Команды сборки и тестирования.
  • Соглашения по именованию.
  • Особенности работы с репозиторием.

Codex использует аналогичный механизм — файл AGENTS.md.

Самый простой способ переноса

Если в корне проекта уже есть CLAUDE.md, создайте его копию с именем AGENTS.md.

В macOS или Linux:

cp CLAUDE.md AGENTS.md

В Windows PowerShell:

Copy-Item CLAUDE.md AGENTS.md

Теперь Codex сможет использовать инструкции из AGENTS.md при работе с проектом. Однако простого копирования не всегда достаточно.

Что нужно проверить после копирования

В файле CLAUDE.md могут быть инструкции, специфичные для Claude Code. Например:

  • Ссылки на специальные команды Claude Code.
  • Упоминания конкретных моделей Claude.
  • Настройки инструментов и разрешений.
  • Ссылки на дополнительные файлы в .claude/.
  • Инструкции по использованию специальных агентов.

Такие разделы необходимо адаптировать под Codex. Попросите Codex помочь:

Изучи AGENTS.md, который был перенесён из Claude Code. Найди инструкции, специфичные для Claude Code, и предложи, как адаптировать их для Codex. Не изменяй файл без моего подтверждения.

После проверки можно применить предложенные изменения.

Совет: не удаляйте CLAUDE.md. Если решите использовать оба инструмента, полезно сохранить инструкции для каждого из них.

Шаг 5. Перенесите контекст работы и незавершённые задачи

Одна из главных сложностей при смене ИИ-инструмента — потеря контекста.

Например, вы могли несколько дней обсуждать с Claude Code архитектуру приложения, принимать решения о реализации функций или искать причину сложной ошибки. Эта информация не обязательно присутствует в исходном коде.

Codex не сможет автоматически восстановить все решения из переписки с Claude Code.

Как сохранить контекст

Перед окончательным переходом откройте Claude Code, если он ещё доступен, и попросите:

Подготовь документ HANDOFF.md для передачи проекта другому ИИ-ассистенту.

Включи:

  • Краткое описание проекта и архитектуры.
  • Текущую задачу и степень её готовности.
  • Важные технические решения и причины их принятия.
  • Какие файлы были изменены.
  • Какие проблемы ещё не решены.
  • Что необходимо сделать следующим шагом.
  • Команды для проверки результата.

Сохрани документ в корне проекта.

После этого запустите Codex и напишите:

Прочитай AGENTS.md и HANDOFF.md. Продолжи работу над текущей задачей с учётом принятых решений. Сначала предложи план дальнейших действий.

Так вы передадите новому инструменту не только код, но и логику предыдущей работы.

Если Claude Code уже недоступен, можно самостоятельно создать HANDOFF.md на основе документации, Git-коммитов, задач и сохранившихся заметок.

Шаг 6. Продолжите разработку в Codex

После переноса проекта и инструкций можно работать практически так же, как с Claude Code. Например, попросить Codex:

Реализовать новую функцию

Добавь авторизацию через Google. Сначала изучи существующую систему авторизации и предложи план реализации.

Найти ошибку

Проверь обработку платежей. Найди возможные причины дублирования транзакций. Сначала проведи анализ, ничего не изменяя.

Написать тесты

Изучи модуль обработки заказов и добавь тесты для основных сценариев и граничных случаев.

Провести рефакторинг

Проанализируй структуру этого модуля и предложи, как упростить код без изменения его поведения.

Codex может изучать файлы, предлагать изменения, выполнять разрешённые команды и проверять результаты.

Для первых задач лучше выбирать небольшие изменения, которые легко проверить. Это поможет привыкнуть к поведению нового инструмента.

Шаг 7. Проверьте настройки и интеграции

Если вы использовали Claude Code только для редактирования файлов и выполнения команд, переход обычно достаточно простой. Но при более сложной конфигурации могут потребоваться дополнительные действия.

Особое внимание уделите:

MCP-серверы

Если Claude Code был подключён к внешним инструментам через MCP, их конфигурацию необходимо отдельно настроить в Codex. Простого копирования настроек Claude Code недостаточно.

Пользовательские команды и агенты

Специфичные для Claude Code команды, хуки и определения агентов могут не работать в Codex без адаптации.

Разрешения на выполнение команд

У Codex собственные настройки подтверждения действий и изоляции среды. Не стоит автоматически переносить старые правила безопасности.

Переменные окружения и секреты

Убедитесь, что новый инструмент получает только необходимые права доступа. Не копируйте API-ключи и пароли в AGENTS.md или другие файлы с инструкциями.

Можно ли использовать Claude Code и Codex одновременно?

Да. Необязательно полностью отказываться от Claude Code. Оба инструмента могут работать с одним репозиторием, а вы можете выбирать их в зависимости от задачи.

Не рекомендуется одновременно поручать обоим инструментам изменять одни и те же файлы. Это может привести к конфликтам и потере изменений.

Если хотите использовать инструменты параллельно, удобнее работать с отдельными Git-ветками или Git worktree.

Как оплатить Codex из России?

Codex доступен в рамках подходящих подписок ChatGPT. Подробности о тарифах, условиях доступа и способах оплаты вы найдёте на странице продукта ChatGPT в PayGPT. Там же можно оформить подписку с оплатой рублями.

Подписка ChatGPT в PayGPT

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

Нет. Codex может работать с тем же локальным репозиторием, который вы использовали с Claude Code.

Автоматического переноса истории диалогов между инструментами нет. Но вы можете передать Codex важную информацию в Markdown-файлах, например HANDOFF.md.

Для надёжной работы перенесите необходимые инструкции в AGENTS.md. Это стандартный файл инструкций проекта для Codex.

Нет. Оба инструмента могут оставаться установленными на компьютере.

Да, Codex CLI поддерживает работу с API-ключом OpenAI. В этом случае используется отдельная оплата API. Доступность конкретных моделей и функций зависит от условий API.

Для многих типичных задач разработки — да. Однако инструменты отличаются моделями, поведением, настройками, интеграциями и ограничениями. Некоторые рабочие процессы придётся адаптировать.

Да. Если вы пока не готовы переходить на Codex, можно сохранить привычный Claude Code и использовать модели Claude через API с оплатой за фактически потраченные токены.

Для этого подойдёт API-шлюз PayGPT. Он позволяет подключить Claude Code без оформления обычной подписки Claude — см. инструкцию по настройке.

Вы платите только за фактическое использование моделей, а не фиксированную сумму каждый месяц. При этом действуют тарифы и технические ограничения API, а стоимость зависит от объёма работы.