Как перейти с Claude Code на Codex: что нужно настроить вручную

Документация Ailoot: API, ключи и подключение.

Для чего нужен Codex Migration tool?#

В начале июня 2026 года OpenAI добавила эту функцию в Codex. В официальном журнале изменений сказано:

Иными словами, при первом запуске Codex App или через настройки уже установленного приложения можно запустить мастер, который прочитает локальные конфигурации другого агента. Сейчас поддерживаются Claude Code и Claude Cowork.

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

Вопрос о том, стоит ли переходить, зависит от ваших задач. Перед решением оцените, какие сценарии вы используете чаще, и насколько важны именно для вас соответствующие возможности инструментов.

Какие данные Migration tool переносит автоматически?#

Рассмотрим каждую группу и то, как меняется её расположение в ~/.claude.

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

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

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

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

5. История сессий. В Codex можно импортировать записи о работе с Claude Code за последние 30 дней и обращаться к ним как к справочному контексту. Это не продолжение прежней сессии с той же точки, но прошлые разговоры могут помочь восстановить контекст проекта и избежать повторного объяснения исходных условий.

Инструмент переносит файлы без оценки того, насколько они востребованы. После импорта проверьте содержимое и удалите вручную то, что давно не используете.

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

Разберём, какие действия могут понадобиться после миграции.

Токены MCP и ключи API. Здесь порядок действий предсказуем: после сканирования Codex покажет найденные в Claude серверы MCP и запросит учётные данные для каждого из них. Подготовьте менеджер паролей и внесите нужные значения. Затем сверяйте команду запуска и параметры подключения с документацией конкретного MCP-сервера.

Slash-команды /имя. В Claude Code skill может вызываться командой /skill-name; в Codex используется форма $skill-name. Проверьте несколько важных skills вручную: вызовите каждый через $skill-name и убедитесь, что он действительно загрузился. Отметка в мастере сама по себе этого не подтверждает.

Hooks без эквивалента в Codex. Если hook срабатывал на специфичное событие Claude Code, например pre-tool-use для определённого сочетания инструментов, соответствующий триггер в Codex может отсутствовать. Migration tool отметит такие сценарии, но не запустит их. Выберите подходящий вариант: адаптируйте логику под доступные события Codex, откажитесь от неё либо продолжайте использовать Claude Code для этого сценария. Переносите hooks, поведение которых можно задать однозначно; остальные требуют отдельной оценки, прежде чем создавать для них аналоги в новом инструменте.

Командные процессы с subagents. Передача сложного процесса, в котором несколько subagents выполняют последовательные задачи, может потребовать изменения его структуры. В Codex для этого используются профили и роли. Migration tool может пометить такой процесс как требующий архитектурной переработки; затем нужно сопоставить прежние сценарии с настройками профилей Codex.

Большие инструкции CLAUDE.md со специфичной структурой. Codex может принять файл на 2000–3000 строк, но такой объём правил неудобен для сопровождения. Разместите общие инструкции в ~/.codex/AGENTS.md, правила проекта — в корне репозитория, а узкие переопределения — во вложенных папках. После импорта проверьте структуру и распределите длинные инструкции по соответствующим уровням.

Пошаговая миграция: четыре действия в Codex App#

Пройдите эти шаги по порядку.

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

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

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

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

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

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

4. Шаг 4: завершите импорт и добавьте токены

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

Затем проверьте результат на проекте, с которым вы обычно работали в Claude Code:

• Выполните cat ~/.codex/AGENTS.md и проверьте, что глобальные правила на месте.
• Запустите нужный skill командой $skill-name и убедитесь, что он загрузился.
• Откройте .mcp.json в проекте и проверьте, что нужные серверы настроены.
• Начните типичный для вас диалог. Codex покажет, какие из импортированных hooks ему недоступны; эти элементы потребуют отдельного решения.

Hooks и Subagents: аналоги в Codex и необходимая переработка#

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

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

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

• Для subagent security-reviewer с отдельным prompt можно создать профиль security-review и задать ему нужные разрешения и повышенный уровень reasoning effort.
• Если subagent feature-developer выполнял роль обычного помощника по разработке, соответствующие настройки можно применить к профилю по умолчанию.
• Вложенные subagents не переносятся один к одному. Перестройте этот процесс с помощью последовательности профилей или явных skills.

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

Когда переходить на Codex полностью, а когда оставить оба инструмента#

Используйте этот список для первичной оценки.

Полный переход на Codex может быть оправдан, если:

• Основная часть вашей работы — автономные PR и параллельные задачи.
• GitHub занимает центральное место в рабочем процессе, а Codex Cloud Agent подходит для большинства задач.
• Вы редко занимаетесь длительными архитектурными обсуждениями и нечасто используете Plan Mode.
• Вам удобнее платить за один инструмент вместо двух.

Совместное использование Claude Code и Codex может быть подходящим вариантом, если:

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

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

За доступом к нейросетям через Ailoot обращайтесь к Ailoot.