Из Claude Code в Codex без потери правил

Переезд без спешки

Переезжает проект, не переписка

Здесь Claude Code — агент Anthropic, с которым вы работаете в папке проекта. Codex CLI — агент OpenAI в терминале: читает файлы, меняет их и запускает команды. Переносим понятные вам инструкции, файлы проекта и проверенные рабочие процедуры. Это не инструкция по импорту чатов из Claude в ChatGPT.

Не путайте четыре вещи. Claude.ai — чат, Claude Code — рабочий агент; ChatGPT — продукт и аккаунт OpenAI, Codex — агент для работы с проектом. API — отдельный способ доступа и расчёта за использование, не «та же подписка через терминал». Codex поддерживает вход через ChatGPT и через API-ключ.

Если вам удобнее приложение. Актуальная ссылка OpenAI на Codex App ведёт к ChatGPT desktop app: в нём выбирают Codex и открывают папку проекта. Не считайте любой обычный чат ChatGPT с загруженным файлом заменой агенту в этой папке. Шаги про правила, скилы и MCP ниже относятся к рабочему проекту; команды терминала нужны для пути CLI.

Если вы ещё выбираете инструмент, начните со сравнения Claude Code и Codex. Здесь уже принято решение попробовать Codex: не выбираем победителя и не обещаем одинаковый результат.

Шаг 1

Сохраните точку, к которой можно вернуться

Не начинайте с удаления Claude Code и отмены подписки. Откройте терминал в своём проекте, остановите редактирование этой же папки другими агентами и посмотрите, что уже изменено:

git status --short
git diff --stat
git diff --check

Есть несохранённая работа? Сначала сохраните её привычным способом и проверьте резервную копию. Git не хранит то, что вы в него не добавили: новые файлы, игнорируемые материалы и локальные настройки требуют отдельного внимания. Не делайте слепое git add .: там могут оказаться секреты.

Для первого теста удобно создать отдельную рабочую папку из текущего коммита. Команда ниже рассчитана на чистый Git-проект; соседней папки и ветки с таким именем ещё не должно быть:

git worktree add -b try-codex ../project-codex-trial HEAD
cd ../project-codex-trial
git status --short

Это не копия всех файлов компьютера: в новую папку попадут файлы коммита. Не переносите туда рабочие .env, ключи, персональные чаты и боевую базу «чтобы всё сразу заработало». Для проекта без Git сделайте отдельную проверенную копию только разрешённых материалов.

Шаг 2

Поставьте Codex и проверьте, за что платите

Если у вас уже есть Node.js и npm, официальный способ установки CLI такой. Команда меняет установленную программу; это не часть переноса файлов проекта.

npm install -g @openai/codex
codex --version
codex --help

Нет npm или не хотите терминал? В официальной инструкции есть другие установщики; для графического пути откройте приложение из документации OpenAI, войдите и выберите Codex. Скачивайте программу у OpenAI, не из архива с чужими токенами.

Для доступа через подписку запустите вход и выберите свой ChatGPT-аккаунт. Доступ зависит от аккаунта, рабочего пространства и его правил. API-ключ — другой путь: с оплатой по использованию API, с условиями API-организации; не используйте его как незаметную «починку» лимитов подписки. Подписка Claude сюда не переносится.

codex login
codex login status

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

Первый запуск — из пробной папки и с запретом обычной записи. Read-only ограничивает изменения, но не скрывает доступные агенту файлы. На запрос расширения прав не соглашайтесь автоматически.

codex --sandbox read-only --ask-for-approval on-request

Внутри Codex используйте /status для проверки модели и границ доступа, /model — чтобы выбрать модель из доступных вашему аккаунту. Названия моделей Claude сюда не переносятся; название в статье не даёт права доступа к модели.

Шаг 3

Соберите AGENTS.md, не переименовывайте вслепую

Codex загружает AGENTS.md. В одной папке AGENTS.override.md имеет приоритет; правила от корня к текущей папке складываются, а более близкие уточняют ранние. Глобальные правила Codex находятся в его home-каталоге, обычно ~/.codex. Не смешивайте их с правилами одного проекта.

1. Проверьте, нет ли в проекте уже AGENTS.md и вложенных правил. Не перезаписывайте их новым файлом.
2. Из своего CLAUDE.md выберите факты: где лежат файлы, как проверить результат, что запрещено менять без согласия.
3. Уберите привязки к Claude: модели, названия инструментов, slash-команды и ссылки на личные каталоги. Импорты вида @file раскройте в нужные правила или дайте обычную ссылку с ясным указанием, когда читать файл; одинаковую семантику импорта не предполагайте.
4. Создайте или дополните AGENTS.md вручную. Для большой структуры оставьте в корне только общее, а локальные особенности проверьте из соответствующей папки.

# Правила проекта

## Где что лежит
- Материалы сайта: content/.
- Скрипт проверки: check.mjs.

## Как проверить результат
- После изменения материалов выполнить: node check.mjs.
- Показать изменённые файлы и результат проверки.

## Границы
- Не читать .env и файлы с секретами.
- Не менять оплату, доступ и авторизацию без согласования.
- Не публиковать и не отправлять сообщения без разрешения.
- Не добавлять зависимости и сетевые подключения без согласования.

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

Если оставляете оба агента. Сохраните CLAUDE.md. В актуальном Claude Code прямое чтение AGENTS.md зависит от версии и наличия CLAUDE.md/CLAUDE.local.md выше по дереву. Не рассчитывайте, что оба автоматически загрузят одинаковый набор. Для общего ядра Anthropic описывает импорт @AGENTS.md из CLAUDE.md; сначала согласуйте объединение правил и проверьте /context в новой сессии Claude.

Пока ничего не меняй. Прочитай AGENTS.md и перечисли:
1. Какие правила проекта ты получил и из каких файлов.
2. Какой командой проверишь результат.
3. Какие действия требуют моего согласия.
Если есть противоречия или нет нужного файла, сначала сообщи.

Сверьте ответ с самим файлом. Если агент пропустил правило, ищите неверную рабочую папку, override или слишком длинную цепочку инструкций, а не компенсируйте проблему дополнительными разрешениями.

Шаг 4

Перенесите один навык — и проверьте его отдельно

Для проектного скила актуальный путь Codex — .agents/skills/имя/SKILL.md, для личного — ~/.agents/skills/имя/SKILL.md. Не выбирайте старый путь ~/.codex/skills по привычке. Формат включает имя, описание и текст процедуры; в CLI можно явно вызвать навык через $имя или найти через /skills.

Начните с безопасного собственного навыка без скриптов и внешних сервисов. Для существующего скила переносите всю нужную структуру, а не только SKILL.md: относительные references, scripts и assets могут быть его зависимостями. Перед копированием прочитайте каждый скрипт. Массовая ссылка на весь личный каталог скрывает проблемы вместо проверки.

---
name: project-check
description: Проверка материалов учебного проекта перед сдачей; не для публикации.
---

1. Прочитай AGENTS.md и проверь область задачи.
2. Посмотри git diff --stat и git diff --check.
3. Выполни node check.mjs.
4. Сообщи изменённые файлы, результат и оставшиеся ограничения.
5. Не публикуй проект и не подключай внешние сервисы.

В своей копии проекта адаптируйте команду проверки. Затем попросите Codex: $project-check проверь текущие изменения. Убедитесь, что выбран именно этот навык и выполнены реальные проверки. Если список не обновился, перезапустите Codex. Удачное копирование файла ещё не означает, что навык работает.

Старые инструкции вроде «вызови Bash с таким allowedTools», переменные Claude и специальные поля frontmatter требуют ручной адаптации. Совпадение расширения .md не означает одинаковые разрешения или одинаковый способ вызова.

Шаг 5

Подключайте внешние инструменты заново, по одному

MCP — подключение агента к внешним инструментам. В Codex серверы задаются в ~/.codex/config.toml или проектном .codex/config.toml; проектная конфигурация действует для доверенных проектов. Не вставляйте JSON-конфиг Claude в TOML. Уточните транспорт, команду запуска, адрес и способ входа у владельца сервера.

codex mcp list

CLI-команда ниже меняет пользовательский config.toml, обычно ~/.codex/config.toml; он общий для Codex CLI, приложения и IDE, а не только для пробной папки. Git worktree не изолирует эти настройки. Если openaiDeveloperDocs уже есть в списке, не перезаписывайте и не удаляйте эту запись. Для своего теста выберите новое свободное имя и замените его во всех командах и в заголовке TOML ниже. Перед проектным вариантом также проверьте существующие таблицы в .codex/config.toml: их не перезаписывайте.

Для первого теста ниже используется только справочник OpenAI, не почта, не платежи и не база клиентов. Эти варианты альтернативны: не добавляйте один сервер дважды.

codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
codex mcp list
codex mcp get openaiDeveloperDocs

[mcp_servers.openaiDeveloperDocs]
url = "https://developers.openai.com/mcp"

В сессии откройте /mcp, проверьте доступность и попросите найти одну страницу документации. mcp list подтверждает запись конфигурации, не успешный вызов инструмента. Для собственного сервера с OAuth есть отдельный codex mcp login имя. Не копируйте старый токен: подтвердите новый вход и минимально нужные права.

Если сервер использует bearer-токен, в TOML поддерживается ссылка на переменную окружения bearer_token_env_var; секрет храните вне Git. Сам MCP может совершать действия на удалённой стороне: локальный read-only не равен запрету отправки письма через подключённый сервис. Начинайте с тестового сервера и read-only прав на его стороне.

Переезд без спешки

Субагенты и хуки не переносятся одним копированием

Субагент — отдельный помощник для части работы. В текущем Codex пользовательские агенты описываются отдельными TOML-файлами в .codex/agents/ или ~/.codex/agents/, с полями name, description, developer_instructions. Это не тот же файл, что Claude-агент в Markdown. Сначала перенесите роль и критерии результата, затем отдельно проверьте модель, доступы и наследование ограничений. Не запускайте команду агентов на боевом проекте ради теста.

Хук — автоматическая реакция на событие: например, проверка перед командой. У Codex есть собственные хуки: .codex/hooks.json либо таблицы [hooks] в config.toml; есть и пользовательский уровень. Сверяйте события, matcher, входной JSON и реакцию на ошибку. Одинаковое имя события не гарантирует одинаковое поведение. Не включайте сразу и JSON, и TOML с тем же обработчиком: определения могут объединиться и сработать дважды.

Поэтому для первой рабочей задачи оставьте старые автоматизации выключенными в новой среде. Подключайте их после базового цикла «задание → изменение → проверка», а не как условие первого запуска.

Шаг 6

Проверьте результат, а не ощущение от ответа

Выберите маленькую обратимую задачу: исправить заголовок в документе или добавить один тест. Сначала попросите план без записи. Когда убедились в границах задачи, закройте первую сессию и запустите новую в той же пробной папке с записью только в рабочую область и запросами разрешений:

codex --sandbox workspace-write --ask-for-approval on-request

Задача: исправь только заголовок в content/welcome.md.
Правила: сначала прочитай AGENTS.md; не меняй другие файлы.
Не устанавливай зависимости, не подключай сеть и MCP.
Проверка: выполни node check.mjs и покажи git diff --check.
В конце перечисли изменённые файлы, команды и их реальные результаты.
Если проверка не запускается, сообщи причину, не выдумывай PASS.
Без коммита, push, публикации и сообщений.

После ответа самостоятельно выполните проверки, посмотрите diff и откройте результат. Не принимайте пересказ как доказательство. Для учебного примера команда проверки одна; у настоящего проекта это могут быть тесты, линтер или просмотр документа.

git status --short
git diff --check
git diff -- content/welcome.md
node check.mjs

Sandbox задаёт технические границы, approval policy — когда спрашивать разрешение. on-request не означает «спрашивать перед каждой записью»: модель решает, когда запросить расширение. Читайте конкретный запрос. Не отключайте sandbox и подтверждения, чтобы «ускорить переезд».

Переезд без спешки

Два агента рядом — но не два редактора одного файла

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

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

Удаляйте только запись, которую создали для этого теста. Существовавшее до гайда подключение не трогайте. В команде ниже используйте то же свободное имя, которое выбрали в шаге 5. Если выбрали проектный TOML, удалите только добавленную вами тестовую таблицу из .codex/config.toml, сохранив остальные настройки; CLI-remove из примера относится к пользовательской записи. Не удаляйте и не заменяйте весь config.toml.

Если добавляли тестовый MCP через CLI, убрать именно эту запись можно так. После удаления проверьте список. Отмена OAuth-разрешения у самого провайдера — отдельное действие, не то же самое, что удаление конфигурации.

codex mcp remove openaiDeveloperDocs
codex mcp list

Удаление программы и отмена подписки тоже отдельные решения. Не делайте их, пока не сохранили материалы и не проверили работу в выбранном инструменте.

Переезд без спешки

Частые ошибки: что проверять первым

Переезд без спешки

Когда переезд действительно можно считать рабочим

• Исходная папка и материалы сохранены; Claude Code не удалён.
• Понятно, какой аккаунт используется и подписка это или API.
• Codex запущен в нужной папке; модель и границы доступа проверены.
• AGENTS.md прочитан и сверен, конфликтующих override нет.
• Одна небольшая задача выполнена; diff просмотрен, реальные проверки прошли.
• Каждый нужный скил вызван отдельно; его скрипты проверены.
• Каждое нужное MCP-подключение проверено реальным безопасным вызовом.
• Хуки и субагенты либо испытаны отдельно, либо явно оставлены на потом.
• Ни ключи, ни переписки, ни личная память в новый проект не скопированы.

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

Переезд без спешки

Что проверено и что проверить у себя

Проверено локально на отдельном учебном проекте: создание worktree, сохранность исходных файлов, синтаксис TOML, команды справки Codex CLI 0.166.0 и добавление/чтение/удаление тестовой MCP-записи в изолированном CODEX_HOME. Это не запуск модели: вход, ответы агента, реальный вызов MCP, скилов, хуков и субагентов в этой проверке не выполнялись. Их надо пройти на своём разрешённом проекте по шагам выше.

Источники — официальные страницы OpenAI и Anthropic, открыты 31 октября 2026. На дату проверки ссылки developers.openai.com/codex перенаправляют на актуальные разделы learn.chatgpt.com. Название Codex App в старой ссылке уже не означает отдельную старую инструкцию установки.