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

2 июня 2026 OpenAI добавил в Codex функцию Import other agent setup. Она сканит папку ~/.claude, забирает skills, MCP-конфиг, инструкции и до 30 дней истории сессий, а файл CLAUDE.md превращает в AGENTS.md. По отчётам ранних пользователей переносится около 95% настроек. Не пересели hooks с триггерами, у которых нет аналога в Codex, MCP-токены и slash-команды формата /имя.

Дальше разберём это без агитации в обе стороны. Сначала - что именно забирает Migration tool и что придётся доделать руками. Потом - отдельный честный разбор, когда полный переход на Codex вообще оправдан, а когда разумнее оставить оба инструмента. Инструкцию по шагам не подрезаем: пройдёшь ровно то, что делает мастер и что остаётся на тебе.

Зачем нужен Codex Migration tool

До 2 июня 2026 переход с Claude Code на Codex был ручным проектом на день. Надо было переименовать CLAUDE.md в AGENTS.md, переписать пути для skills, заново подключить MCP-серверы, восстановить subagents по памяти. Migration tool делает это одним сканом: открываешь Codex App, жмёшь Import other agent setup, получаешь инвентаризацию своей папки ~/.claude и план переноса.

Функцию добавили в начале июня 2026. В официальном changelog формулировка короткая.

Добавили потоки Migrate to Codex для импорта поддерживаемых настроек из Claude Code и Claude Cowork, в том числе во время онбординга.

- OpenAI Codex Changelog, developers.openai.com/codex/changelog

В переводе: при первом запуске Codex App или из настроек уже работающего клиента поднимается мастер, который читает локальные конфиги другого агента. На сегодня поддерживаются Claude Code и Claude Cowork. По разборам миграции инструмент сканит файловую систему и переносит системные промпты, кастомные skills, историю чатов, настройки MCP-серверов и автоматизированные скрипты. Это и есть тот самый «supported setup» из changelog.

Зачем это OpenAI, понятно. У Codex после выхода Sites и обновлений Codex App в мае-июне 2026 появилось всё, чем раньше Claude Code выигрывал: терминал, плагины, длинные сессии, оркестрация. Миграция убирает последний барьер для команд, которые уже встроили Claude Code в свой стек: всё сохранится, можно пробовать без потерь.

А вот нужен ли переход именно тебе - вопрос отдельный, и мы его честно разберём ниже. Если интересует прямое сравнение двух инструментов перед решением, оно в гайде Codex vs Claude Code: на длинных архитектурных диалогах и в Plan Mode Claude пока впереди, на автономных задачах и параллельных PR Codex быстрее.

Что Migration tool переносит автоматически

В первом приближении сканер забирает пять групп: инструкции (CLAUDE.md → AGENTS.md), пользовательские skills, конфигурацию MCP-серверов, hooks с детерминированной логикой и до 30 дней истории сессий. По отчётам практиков автоматически конвертится около 95% настроек, оставшиеся 5% флагируются для ручной проверки и закрываются примерно за полчаса.

Разберём по группам, что именно происходит на каждом фрагменте ~/.claude.

1. Инструкции и контекст. Файлы CLAUDE.md, и глобальный из ~/.claude/, и проектные из репозиториев, переезжают в формат AGENTS.md. Глобальный осядет в ~/.codex/AGENTS.md, проектные останутся в корне репозитория и в дочерних папках. Формат AGENTS.md по сути такой же markdown-файл с правилами, отличия в основном косметические: имена секций и пара специфичных директив. Что такое AGENTS.md и зачем он нужен Codex, подробнее в гайде Codex - что это.

2. Skills. Папка ~/.claude/skills/ сканится целиком, каждый skill адаптируется под структуру Codex и кладётся в $HOME/.agents/skills. Проектные skills из .claude/skills/ в репозитории переезжают в .agents/skills. Формат SKILL.md с frontmatter переносится почти как есть. Если в skill использованы Claude-специфичные триггеры, они флагируются для проверки.

3. MCP-серверы. Конфиг .mcp.json, и глобальный, и проектный, импортируется в формат Codex. Имена серверов, команды запуска, пути сохраняются. Что не переезжает - токены и переменные окружения. По соображениям безопасности Codex запросит у тебя API-ключи и пароли заново, чтобы не светить их в процессе миграции. Это разовая задача: в Codex App открываешь раздел MCP и подставляешь токены, которые уже есть в твоём менеджере паролей.

4. Hooks. Самая сюжетная группа. Hooks с детерминированной логикой (запрет rm -rf, alert на credential-shaped пути, запись evidence) переезжают целиком. Hooks с триггерами, у которых нет аналога в Codex (например, специфичные жизненные события Claude Code), помечаются как manual review и не активируются автоматически. В Codex типов хуков меньше, так что от чего-то придётся отталкиваться заново.

5. История сессий. До 30 последних дней работы с Claude Code импортируются как референс. Это не «продолжить точно с того же места», но в Codex видны прошлые разговоры, чтобы быстро вспомнить контекст проекта и не объяснять всё заново. На этом шаге, судя по разборам, сюрпризов нет.

Что не переносится и почему

Есть пять групп, которые в Codex либо отсутствуют, либо устроены принципиально иначе. Migration tool их пометит, но не сконвертит. Это MCP-токены и переменные окружения, slash-команды формата /имя, специфичные хуки жизненного цикла Claude Code, командные workflow на subagent-ах и большие инструкции, заточенные под формат CLAUDE.md.

Разберём каждую группу с точки зрения «что делать после миграции».

MCP-токены и API-ключи. Самое предсказуемое. После сканирования Codex покажет список всех MCP-серверов, которые он нашёл в Claude. По каждому запросит ключи и токены. Удобнее всего держать под рукой менеджер паролей и пройти все серверы за один присест. После этого MCP в Codex работает идентично Claude Code.

Slash-команды /имя. В Claude Code ты привык вызывать skill через /skill-name. В Codex канонический вызов другой - $skill-name. Это самая частая ошибка миграции, и на неё стоит обратить внимание отдельно.

Slash-команды Codex вида /name принципиально отличаются от канонического вызова навыка через $skill-name. Считать первое доказательством того, что skills загружены - типичная ошибка миграции.

- Blake Crosley, blakecrosley.com

После переноса протестируй несколько ключевых skills через $skill-name в Codex. Сработали - значит, миграция реально удалась. Не доверяй галке skills migrated в мастере, проверяй вызовом.

Hooks без аналога в Codex. Если у тебя был hook на специфичные события Claude Code (например, на pre-tool-use определённой комбинации инструментов), в Codex такой триггер может отсутствовать. Migration tool пометит их и не активирует. Дальше решаешь сам: переписать под Codex-аналог, отказаться или держать в Claude Code, если оставляешь его параллельно. Здоровое правило - переносить только детерминированные хуки, а всё остальное лишний раз не плодить в новом инструменте.

Командные workflow на subagent-ах. В Codex subagent-ы устроены через профили и роли (об этом ниже). Если у тебя в Claude был сложный пайплайн с несколькими subagent-ами в цепочке, его придётся переписать под концепцию профилей Codex. Migration tool помечает такие сетапы как requires architectural rework.

Большие специфичные CLAUDE.md. Если файл вырос до 2000-3000 строк с разделами под каждый проект, Codex может его принять, но это плохой паттерн. AGENTS.md проектируется компактным и распределённым: глобальные правила в ~/.codex/AGENTS.md, проектные - в корне репозитория, узкие override - в дочерних папках. После миграции такой файл лучше сразу разнести по уровням, чтобы он перестал быть одной «гигантской инструкцией». Тот же подход, что и с грамотным CLAUDE.md, переносится на AGENTS.md один в один.

Пошагово: 4 действия в Codex App

Базовый поток миграции через встроенный мастер занимает 15-30 минут на разогретой ~/.claude. Скачиваешь свежий Codex App, открываешь Settings, выбираешь Import other agent setup, ждёшь сканирования, подтверждаешь импорт. После - проверяешь skills вызовом $skill-name, подставляешь MCP-токены, заглядываешь в неактивированные hooks.

Конкретный чек-лист, как это пройти.

Шаг 1: обнови Codex App до 26.608 или новее

Migration tool появился в версии 26.608 (релиз 9 июня 2026). На macOS открываешь Codex App, проверяешь обновления. На Windows то же самое. Если запускаешь Codex CLI, убедись, что он совместим с актуальной App. Без свежей версии в Settings просто не будет пункта Import other agent setup.

Шаг 2: запусти импорт из настроек

В Codex App открой Settings, найди пункт Import other agent setup. Если ты только что установил Codex App, мастер сам предложит миграцию во время онбординга. После старта мастер сканит файловую систему: ~/.claude/ и репозитории, в которых лежат CLAUDE.md или .claude/. Сканирование занимает от 30 секунд до нескольких минут в зависимости от количества файлов.

Шаг 3: подтверди план переноса

После сканирования Codex покажет инвентаризацию: сколько skills нашлось, сколько MCP-серверов, сколько CLAUDE.md найдено, какие hooks подлежат миграции, сколько дней истории сессий доступно. Для каждой группы можно снять галочку, если что-то не хочешь переносить. По умолчанию выбрано всё, что Codex считает безопасным импортировать.

Шаг 4: дождись завершения и подставь токены

Импорт занимает 1-5 минут. После завершения Codex откроет follow-up окно в духе «вот что я не смог перенести автоматически, проверь руками». Обычно это список MCP-серверов, которым нужны токены. Открываешь свой менеджер паролей, подставляешь ключи в форму Codex. После этого основная часть миграции закрыта.

Дальше сверка. Открой проект, который ты обычно вёл в Claude Code, и проверь по пунктам:

cat ~/.codex/AGENTS.md      # есть ли там твои глобальные правила
$skill-name                 # запусти любой skill, должен подгрузиться

• открой .mcp.json в проекте и проверь, что нужные серверы подняты;
• запусти диалог, в котором ты типично работаешь. Codex покажет, какие из импортированных hooks ему недоступны. Это и есть те самые «5%», которые нужно решить руками.

Hooks и subagents: где аналоги в Codex и что переписывать

По типам триггеров хуков в Codex меньше, чем в Claude Code, но для базовых задач безопасности их хватает. Subagent-ы заменены на профили и роли. Если у тебя был сложный пайплайн на subagent-ах, один в один его перенести не выйдет, придётся переосмыслить через профили. Это и есть тот самый «5% работы руками», который заметнее всего.

По хукам. В Claude Code на каждое событие жизненного цикла (pre-tool-use, post-tool-use, on-error, on-context-load и другие) можно повесить shell-команду. В Codex набор событий компактнее: есть проверка перед выполнением, есть запись evidence, есть блокировка опасных команд. Если у тебя был hook на pre-tool-use с фильтрацией по конкретной комбинации, в Codex придётся либо завернуть это в общую проверку перед выполнением, либо отказаться. Закладывай на переписывание примерно час, если ты хуками активно пользовался.

По subagent-ам. В Claude Code subagent - это отдельный контекст со своим системным промптом, который запускается по /команда или из основного диалога. В Codex есть похожая концепция профилей: задаёшь профиль с конкретным набором skills, разрешений и approval policy. Профили решают примерно ту же задачу - изоляцию контекста под определённый класс задач - но через настройки, а не через явный вызов агента.

Что это значит на практике:

• был subagent security-reviewer со своим промптом - в Codex заведи профиль security-review с нужными разрешениями и higher reasoning effort;
• был subagent feature-developer - это просто рабочий профиль по умолчанию, ничего особенного;
• использовал вложенные субагенты - в Codex это не сработает один в один, нужно переосмыслить через цепочку профилей или через явные скилы.

Migration tool попытается завести профили по именам твоих subagent-ов и пометит, какие триггеры не переехали. На практике это занимает 30-60 минут на каждый сложный subagent-пайплайн.

cc2codex: альтернатива через CLI с предпросмотром

Если не хочешь доверять встроенному мастеру Codex App и хочешь видеть, что именно переносится, есть open-source плагин cc2codex. Это CLI с командами scan, plan, apply: сначала видишь полную инвентаризацию, потом план переноса без записи, потом применяешь. Полезно, когда у тебя сложная ~/.claude и хочется превью.

cc2codex - бета-инструмент с GitHub, устанавливается как плагин Codex CLI. Цикл работы:

cc2codex install-plugin     # установка плагина
cc2codex scan               # инвентаризация ~/.claude
cc2codex doctor             # отчёт о готовности к миграции
cc2codex plan               # план без записи
cc2codex apply              # применить план
cc2codex start              # управляемая миграция с пошаговым превью

Что переносит хорошо:

• инструкции из CLAUDE.md;
• skills (с адаптацией под структуру Codex);
• hooks с высокой степенью уверенности;
• конфигурацию MCP-серверов.

Что требует проверки:

• токены MCP и API-ключи - ввести заново;
• Claude-специфичные события хуков;
• командные workflow на subagent-ах;
• большие или специфичные наборы инструкций.

Главная разница со встроенным мастером - в прозрачности. cc2codex plan показывает, какие файлы будут изменены, какие созданы, что переименовано. Если потом cc2codex apply где-то упадёт, ты увидишь точно, где. Встроенный мастер на этот уровень не пускает: показал галочки, нажал кнопку, дальше как пойдёт.

Когда миграция оправдана, а когда нет

Здесь без агитации. Migration tool снимает технический барьер перехода, но он не отвечает на вопрос, нужен ли тебе сам переход. Это два разных решения, и путать их - самая дорогая ошибка. Сначала честно определи свой сценарий работы, потом выбирай инструмент.

Полный переход на Codex имеет смысл, когда твой стек - это автономные PR, длинные параллельные задачи и плотная интеграция с GitHub. Связка из двух инструментов сильнее, когда у тебя смесь архитектурных и исполнительских задач. У многих, кто собирает продукты через диалог с агентом, по факту выгоднее связка, а не полный переход.

Простой decision-фильтр.

Полный переход на Codex оправдан, если:

• ты в основном делаешь автономные PR и параллельные задачи;
• у тебя глубоко встроен GitHub-флоу, и Codex Cloud Agent закрывает 80% работы;
• ты не сильно тратишь время на архитектурные обсуждения и Plan Mode;
• тебе важно платить за один инструмент, а не за два.

Связку Claude Code + Codex стоит оставить, если:

• ты регулярно используешь Plan Mode для длинных архитектурных решений;
• тебе нужна параллельная работа: Codex крутится в облаке на одной задаче, Claude Code держит контекст другой;
• ты делаешь много разовых хаков и микро-проектов, где Plan Mode избыточен;
• у тебя сложный пайплайн на subagent-ах, который не переписывается за один вечер.

Рабочий пример связки выглядит так: Claude Code держит длинный диалог по архитектуре, а Codex запускается на «починить N багов параллельно» или «прогнать ревью PR». Каждый инструмент делает то, в чём он сильнее.

Если после честного фильтра ты понял, что связка тебе ближе полного перехода, стоит заранее разобраться и в подписках: у Claude Code свои лимиты и тарифы, которые удобно держать в голове, когда работаешь на двух инструментах сразу. Про это - в разборе подписки Claude Code.

Что ты собрал и где границы

Смотри, что у тебя теперь есть после прохода по инструкции.

• Codex App свежей версии с пройденным Import other agent setup.
• Инструкции переехали: CLAUDE.md превратился в AGENTS.md, глобальный лежит в ~/.codex/AGENTS.md.
• Skills адаптированы под структуру Codex и проверены вызовом $skill-name, а не по галке в мастере.
• MCP-серверы подняты, токены и API-ключи введены заново из менеджера паролей.
• Детерминированные hooks переехали, а помеченные manual review разобраны руками: переписаны, отброшены или оставлены в Claude Code.
• Сложные subagent-пайплайны переосмыслены через профили и роли Codex.
• Принято осознанное решение по сценарию: полный переход или связка двух инструментов.

И честно про границы. Migration tool переносит настройки, но он не переносит за тебя решение о переходе и не переписывает архитектуру subagent-пайплайнов - это остаётся ручной работой. Инструмент отлично снимает рутину первого дня, а дальше всё упирается в то, какой у тебя реальный сценарий работы. Определись с ним первым, инструмент выбирай вторым.