Переход с Claude Code на Codex в 2026 году: переносим историю, настройки и рабочий процесс

Короткий ответ

Перейти с Claude Code на Codex можно так: экспортировать историю диалогов Claude Code в JSON командой /export, вручную перенести пользовательские слэш-команды и конфигурации MCP-серверов, а затем направить оба инструмента на один API-шлюз (например, TeamoRouter) — так у вас останутся тот же API-ключ, тот же биллинг и тот же доступ к моделям. С конфигурациями и настройками API всё просто, а вот контекст диалогов придётся переносить вручную. В этом руководстве описан весь процесс по состоянию на 2026 год.

Зачем переходить с Claude Code на Codex?

В 2026 году ландшафт ИИ-инструментов для программирования заметно изменился. Codex (агентный CLI для программирования от OpenAI) вырос в серьёзную альтернативу Claude Code со своими сильными сторонами: рефакторинг нескольких файлов, выполнение в песочнице и глубокая интеграция с GitHub. Многие разработчики, начинавшие с Claude Code, сейчас оценивают, не лучше ли Codex вписывается в их рабочий процесс, — или пользуются обоими инструментами параллельно.

Типичные причины перехода:

• Интеграция с экосистемой OpenAI: если ваша команда уже использует ChatGPT, GPT-4o или API OpenAI в других частях стека, Codex встраивается естественным образом.
• Модель выполнения в песочнице: Codex запускает код в изолированных окружениях, что снижает риск случайных изменений в файловой системе.
• Нативная работа с GitHub: в Codex на высшем уровне поддерживаются ревью PR, разбор issue и операции на уровне репозитория.
• Соображения стоимости: в зависимости от характера использования один инструмент может оказаться выгоднее другого.

Какой бы ни была причина, миграция не означает полного отказа от Claude Code. Многие разработчики запускают оба инструмента через единый API-шлюз вроде TeamoRouter и переключаются между ними в зависимости от задачи.

Предварительный шаг: сначала настройте единый шлюз

Прежде чем переходить с одного инструмента на другой, настройте единый LLM-шлюз. Это шаг с самой большой отдачей: и Claude Code, и Codex подключаются по стандартным API-протоколам (Anthropic и OpenAI-совместимому соответственно), а шлюз с поддержкой обоих — это один API-ключ, одна консоль биллинга и никакой возни с учётными данными для каждого инструмента по отдельности.

Рекомендуем: воспользуйтесь клиентом TeamoRouter, чтобы обойтись без ручной настройки. TeamoRouter нативно поддерживает и протокол Anthropic (Claude Code), и /v1/responses (Codex), поэтому у обоих инструментов общие ключ и баланс. Кроме того, вам не нужно ставить локальный прокси для маршрутизации, и конфликтов с VPN или системным прокси не возникает.

Когда шлюз настроен, миграция проходит в четыре шага: история диалогов, слэш-команды, MCP-серверы и конфигурация API и учётных данных.

Шаг 1. Экспорт и импорт истории диалогов

Экспорт из Claude Code

Claude Code хранит историю диалогов в локальной базе данных SQLite (обычно в ~/.claude/history.db). По состоянию на 2026 год можно экспортировать отдельные сессии:

# Экспорт конкретной сессии по ID
claude export --session <session-id> --format json --output session.json

# Экспорт недавних сессий (за последние 30 дней)
claude export --recent 30 --format markdown --output claude-history/

JSON-экспорт содержит полное дерево сообщений: промпты пользователя, ответы ассистента, вызовы инструментов и их результаты. Экспорт в markdown удобнее читать, но структурированные данные о вызовах инструментов в нём теряются.

Импорт в Codex

Codex не умеет нативно импортировать файлы истории Claude Code, но есть два практичных подхода:

1. Работа со ссылками на файлы: храните экспортированные сессии Claude Code в проекте как справочные файлы. Начиная новую сессию Codex, укажите ему экспортированный файл в качестве контекста:

   text复制

   codex "Read claude-history/session-123.md and continue the refactoring work described there"
   

2. Мост через CC Switch: если вы управляете обоими инструментами через CC Switch, он может вести общий индекс сессий для разных провайдеров. Настройте в CC Switch и Claude Code, и Codex — инструмент предоставит единый браузер сессий, работающий для обоих.

Для команд, где мигрирует сразу несколько разработчиков, есть поддерживаемый сообществом инструмент cc-migrate (в npm): он автоматизирует пакетный экспорт из Claude Code и переформатирует диалоги в файлы контекста, совместимые с Codex.

Шаг 2. Перенос пользовательских слэш-команд

Слэш-команды Claude Code описываются в .claude/commands/ внутри каждого проекта (или глобально в ~/.claude/commands/). Codex использует похожую схему с .codex/commands/.

Скрипт миграции

Форматы настолько похожи, что для большинства команд достаточно простого копирования с переименованием:

# Копируем команды уровня проекта
cp -r .claude/commands/ .codex/commands/

# Копируем глобальные команды
cp -r ~/.claude/commands/ ~/.codex/commands/

Однако на несколько различий стоит обратить внимание:

• Claude Code использует %ARG% для плейсхолдеров аргументов, Codex — $ARG.
• {{selection}} в Claude Code соответствует {{selectedText}} в Codex.
• У переопределения системного промпта (флаг --system-prompt в Claude Code) нет прямого аналога в Codex; используйте вместо него файл пользовательских инструкций Codex.

После копирования просмотрите каждую команду и поправьте несовместимый синтаксис.

Шаг 3. Миграция конфигураций MCP-серверов

И Claude Code, и Codex поддерживают Model Context Protocol (MCP), а формат конфигурации намеренно сделан совместимым. Копирование конфигурации MCP — самый простой шаг:

# Конфигурация MCP в Claude Code
cat ~/.claude/mcp.json

# Конфигурация MCP в Codex (тот же формат)
cp ~/.claude/mcp.json ~/.codex/mcp.json

Все MCP-серверы (файловая система, базы данных, API, веб-поиск), которые работают с Claude Code, точно так же работают и с Codex. Кроме копирования JSON-файла, ничего делать не нужно.

Шаг 4. Конфигурация API и учётных данных

Если вы выполнили предварительный шаг и настроили единый шлюз, здесь делать почти нечего: оба инструмента уже направлены на один эндпоинт TeamoRouter. Ваш единственный API-ключ подходит для обоих.

Если же вы уходите с прямого подключения к API Anthropic, вот различия в конфигурации:

С TeamoRouter оба инструмента используют один API-ключ. Единый подход избавляет от управления несколькими ключами:

# Общая конфигурация с TeamoRouter
export TEAMOROUTER_API_KEY="tr-your-key-here"

# Claude Code
export ANTHROPIC_BASE_URL="https://api.teamorouter.com/anthropic"
export ANTHROPIC_API_KEY="$TEAMOROUTER_API_KEY"

# Codex
export OPENAI_BASE_URL="https://api.teamorouter.com/openai"
export OPENAI_API_KEY="$TEAMOROUTER_API_KEY"

Подробнее о маршрутизации API и настройке шлюза — на странице API-шлюза TeamoRouter, который даёт единый доступ к Claude, GPT, Gemini, DeepSeek и другим моделям.

Claude Code и Codex после миграции: что меняется

После перехода учитывайте ключевые различия в рабочем процессе:

Сильнее всего придётся привыкать к модели выполнения в песочнице. Codex не может напрямую запускать команды в вашем терминале: он работает в изолированном окружении и записывает результаты обратно в вашу файловую систему. Это безопаснее, но для быстрых операций в shell может ощущаться медленнее.

Чек-лист миграции

• Настройте единый API-шлюз (рекомендуем TeamoRouter), чтобы у обоих инструментов были общие ключ и баланс
• Экспортируйте историю сессий Claude Code (JSON — ради структуры, Markdown — для справки)
• Скопируйте слэш-команды из .claude/commands/ в .codex/commands/
• Исправьте синтаксис плейсхолдеров аргументов (%ARG% на $ARG, {{selection}} на {{selectedText}})
• Скопируйте конфигурацию MCP-серверов (mcp.json) из Claude Code в Codex
• Задайте переменные окружения для вашего шлюза (ANTHROPIC_BASE_URL / OPENAI_BASE_URL)
• Запустите тестовую задачу в Codex и сравните качество результата с вашей последней сессией Claude Code
• Проверьте биллинг: запустите одну сессию и убедитесь, что списания корректно отображаются в консоли шлюза

Оставить оба инструмента: гибридный подход

Миграция не обязана проходить по принципу «всё или ничего». В 2026 году многие команды используют Claude Code и Codex одновременно, а шлюз вроде TeamoRouter служит единым слоем маршрутизации. Гибридный подход позволяет:

• Использовать Claude Code для сложных рассуждений и архитектурных задач (где Claude силён в рассуждениях на длинном контексте)
• Использовать Codex для ревью PR, управления issue и выполнения в песочнице (где выигрывает интеграция с GitHub)
• Делить один API-ключ и баланс между обоими инструментами
• Переключать инструменты от задачи к задаче, не перенастраивая учётные данные

Если вы сравниваете оба инструмента параллельно, загляните в наше подробное сравнение Claude Code и Codex — там бенчмарки на уровне задач и анализ стоимости.

FAQ

Можно ли перенести всю историю диалогов Claude Code в Codex?

Нативно — нет. В Codex нет прямого импорта базы истории Claude Code в формате SQLite. Лучший способ — экспортировать сессии Claude Code в файлы JSON или Markdown, а затем ссылаться на них при запуске новых сессий Codex. Инструмент от сообщества cc-migrate автоматизирует пакетный экспорт и преобразование формата.

Будут ли мои MCP-серверы из Claude Code работать с Codex?

Да. Оба инструмента используют Model Context Protocol (MCP) и один и тот же формат конфигурации. Скопируйте mcp.json из ~/.claude/ в ~/.codex/ — и всё заработает. Все типы MCP-серверов (файловая система, базы данных, API, веб-поиск) совместимы с обоими инструментами.

Нужны ли отдельные API-ключи для Claude Code и Codex?

Нет, если вы используете единый API-шлюз. TeamoRouter поддерживает и протокол Anthropic (Claude Code), и OpenAI /v1/responses (Codex) через один API-ключ, одну консоль биллинга и один баланс. Инструкции по настройке — на странице API-шлюза TeamoRouter.

Codex дешевле, чем Claude Code?

Зависит от характера использования и от вашего провайдера API. Codex обычно делает больше вызовов API (из-за агентной модели на основе циклов), но каждый вызов, как правило, короче. Claude Code отправляет более длинный контекст, но делает меньше обращений. Со шлюзом вроде TeamoRouter, который обеспечивает кэширование промптов с долей попаданий >99% и плавающие тарифы вплоть до 10-20% от официальной цены, оба инструмента обходятся заметно дешевле, чем при оплате напрямую по официальной цене.

В чём главное отличие рабочего процесса после перехода?

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

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

Да, и в 2026 году так поступают всё чаще. Многие разработчики используют единый шлюз (например, TeamoRouter) вместе с CC Switch, чтобы управлять обоими инструментами из одной консоли и переключаться от задачи к задаче: Claude Code — для глубоких рассуждений и архитектуры, Codex — для ревью PR и выполнения в песочнице. У обоих инструментов общие API-ключ и баланс.