Agentic Lab · памятка

Переход с Claude Code на Codex

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

Самое необходимое · три шага
  1. 1

    Поставить Codex и войти

    Установить, запустить codex и войти через аккаунт ChatGPT.

    npm i -g @openai/codex
  2. 2

    Поставить мигратор

    Написать в Codex:

    $skill-installer migrate-to-codex
  3. 3

    Попросить перенести настройку

    Написать в Codex, прочитать отчет и ответить «переноси».

    $migrate-to-codex перенеси мою настройку из ~/.claude в ~/.codex.
Сначала покажи отчет и ничего не записывай.

Ниже подробно: что останется прежним, в чем разница и где понадобятся руки.

Что остается с вами

Все, что вы наработали, лежит у вас на диске. Доступ к аккаунту, чтобы это забрать, не нужен.

  • Код и история в git. Они вообще не зависят от агента.
  • Настройка в ~/.claude. Инструкции, скиллы, команды, агенты, хуки и список MCP-серверов. Их переносит мигратор, исходные файлы остаются как есть.
  • Память Claude. Это обычные markdown-файлы в ~/.claude/projects/*/memory. Codex прочитает их, если попросить или сослаться на них в AGENTS.md.
  • Старые разговоры. Лежат файлами .jsonl в ~/.claude/projects. Codex может открыть нужный и достать из него решения. Claude Code по умолчанию чистит разговоры старше 30 дней, поэтому папку ~/.claude/projects стоит сразу скопировать в надежное место.
  • Ваш опыт. Умение ставить задачу, просить план и проверять тестами работает с любым агентом.

Codex входит в платные планы ChatGPT, а мигратор с Claude Code выпустила сама OpenAI. Это штатный, поддерживаемый путь.

01

Что останется прежним

Почти все, к чему вы привыкли, в Codex есть и работает по тем же принципам.

Команды

Слеш-команды почти те же

/model, /status, /compact, /review, /init, /mcp и другие называются так же. Полная таблица ниже.

Работа

Тот же агент в терминале

Читает репозиторий, правит файлы, запускает команды и спрашивает разрешения. Есть план-режим, субагенты и память.

Инструкции

CLAUDE.md можно оставить

Codex читает AGENTS.md по той же схеме: общий файл плюс файлы в папках проекта. Чтобы он читал и CLAUDE.md, хватает одной строки в конфиге: project_doc_fallback_filenames = ["CLAUDE.md"].

Скиллы

Тот же формат

Оба инструмента используют открытый стандарт Agent Skills: папка с SKILL.md, скриптами и справочниками. Папку скилла достаточно положить в ~/.agents/skills/.

MCP

Тот же протокол

Серверы те же, меняется только файл, где они записаны: config.toml вместо .mcp.json.

Хуки

Те же скрипты

События называются так же (PreToolUse, Stop, SessionStart и другие), на вход приходит тот же JSON. Скрипты часто работают без правок, меняется только файл конфигурации.

02

В чем разница

Отличий немного, и о каждом лучше знать заранее.

Права

В Codex две отдельные настройки: когда агент спрашивает разрешения (approval_policy) и что ему можно трогать (sandbox_mode). Для начала подходит режим, в котором агент свободно работает внутри проекта и спрашивает, если хочет выйти за его пределы. Он включается флагом --full-auto.

Субагенты

Codex запускает субагента, когда вы прямо об этом попросили. Сам по описанию задачи он их не вызывает.

Инструкции

В AGENTS.md стоит дописать конкретику: какой командой запускать тесты и линтер, какие папки не трогать, как оформлять коммиты. С такими строками Codex работает заметно ровнее.

Память

Память Codex общая на все проекты и включается строкой [features] memories = true. То, что касается одного проекта, удобнее держать в его AGENTS.md.

03

Как переехать

  1. 0

    Поставить Codex и войти

    Установить одной из команд, затем запустить codex и выбрать вход через аккаунт ChatGPT.

    npm i -g @openai/codex
# или
brew install --cask codex
  2. 1

    Сохранить проекты в git

    Закоммитить проекты, с которыми работаете. Файлы в ~/.claude мигратор только читает.

  3. 2

    Попросить Codex перенести настройку

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

    $skill-installer migrate-to-codex

$migrate-to-codex перенеси мою настройку из ~/.claude в ~/.codex.
Сначала покажи отчет и ничего не записывай.

    Когда отчет понятен, скажите «переноси». Для проекта то же самое, из его папки .claude в .codex.

  4. 3

    Пройтись по пометкам

    В отчете мигратор отметит места, где нужна ваша рука, со статусами Check before using и Not Added.

04

Как освоиться в первые дни

Какую модель брать

Если вы привыкли к тройке Opus, Sonnet и Haiku, здесь похожая по ролям тройка. Список зависит от тарифа, свой всегда виден в /model.

Основная · как Sonnet

GPT-6.1 Sol

Рабочая модель для кода и повседневных задач. С нее стоит начинать и на ней оставаться, пока она справляется.

Не выбирать · как Opus

GPT-6 Astra

Самая сильная, но сжигает лимит в разы быстрее Sol, и подписки хватит ненадолго. На старте не выбирайте ее: Sol справляется с большинством задач.

Быстрая · как Haiku

GPT-6 Luna

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

Остальное в списке

Прошлые поколения

GPT-6 Sol, семейство GPT-5.6 и GPT-5.5 остались для совместимости. Для новой работы они не нужны.

Какой effort ставить

Effort задает, сколько модель думает перед ответом. Меняется вместе с моделью в /model.

low, medium

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

high, xhigh

Трудный баг без очевидной причины, решение с компромиссами, задача на много шагов.

max

Дать одной задаче больше времени подумать. Для самых трудных случаев.

ultra

Codex сам делит работу на части и раздает их параллельным субагентам. Подходит, когда задача правда делится на независимые куски. У Luna этого уровня нет.

  • Большинству задач max и ultra не нужны. Так пишет сама OpenAI.
  • Если ответ промахнулся, сначала проверьте, ясно ли поставлена задача и есть ли у агента нужные файлы и доступы. Более высокий effort недостающую информацию не добавит.
  • Если упретесь в лимит, Codex сам предложит переключиться на Luna.

Привычные команды

Большинство команд называются так же, как в Claude Code.

Claude CodeCodexЧто делает
/model/modelмодель и effort
/status/statusмодель, права, остаток контекста
/clear/clear, /newначать разговор заново
/compact/compactсжать разговор, чтобы освободить контекст
/resume/resumeпродолжить прошлую сессию
план-режим/planсначала план, потом работа
/permissions/permissionsчто можно делать без спроса
/имя-скилла$имя-скиллавызвать скилл, список в /skills
@файл/mentionпоказать агенту файл или папку
/agents/agentпереключиться на поток субагента
/memory/memoriesвключить и настроить память
/init/initсоздать AGENTS.md в проекте
/review/reviewревью изменений в рабочей папке
/mcp, /hooks/mcp, /hooksMCP-серверы и хуки

Привычки на первую неделю

  • В начале сессии наберите /status: сразу видно модель, права и сколько осталось контекста.
  • Перед коммитом смотрите /diff, после большой работы просите /review.
  • В проекте без AGENTS.md наберите /init, Codex соберет заготовку сам.
  • Чтобы попробовать другой подход, не теряя текущий разговор, есть /fork. Для короткого вопроса в сторону есть /side.
05

Где понадобятся руки

Мигратор сам отметит эти места в отчете, искать их не придется.

Команды /cmd
Становятся скиллами, вызов через $cmd. Если в команде были $ARGUMENTS, вывод shell или @файлы, эти места стоит переписать словами.
Ограничения скиллов
allowed-tools переносится как текст подсказки. Модель у скилла задать нельзя, ее выбирают на сессию или на субагента.
Хуки
После переноса их нужно один раз одобрить командой /hooks. Работают хуки типа command. Пути удобнее строить от корня git.
MCP
К серверам, где нужен вход, придется войти заново. Токены лучше хранить в переменной окружения (bearer_token_env_var). Серверы на старом транспорте SSE Codex не поддерживает.
Субагенты
Переносятся в ~/.codex/agents/*.toml. Списки tools становятся текстом инструкции, фоновый режим и изоляцию настроить нельзя.
История чатов
Не переносится. Старые разговоры остаются на диске файлами в ~/.claude/projects.
Плагины
Мигратор их перечислит. Скиллы и MCP из плагина переносятся тем же путем, что и обычные.
06

Готово, когда

  • Codex пересказывает ваши правила: codex "Summarize the current instructions."
  • Мигратор закончил работу, и его проверка прошла без ошибок.
  • Пометки из отчета разобраны.
  • Хуки видны в /hooks и одобрены.
  • Одна настоящая рабочая задача сделана в Codex от начала до конца.
07

Источники