Как перейти из Claude Code в Gemini CLI без потери контекста?

Как перейти из Claude Code в Gemini CLI без потери контекста?

Сохраните состояние сайта в отдельном файле проекта и попросите Gemini CLI сначала прочитать его, затем проверить по коду. Чтобы продолжить работу после Claude Code, передайте цель задачи, список правок, команды проверки и открытые вопросы. Переписки для этого недостаточно: в ней смешаны планы, попытки и решения, от которых уже отказались. Ниже — порядок передачи проекта, который поможет отделить рабочие изменения от предположений и продолжить разработку сайта без повторного разбора всей истории.

Что сохранить перед переходом в Gemini CLI?

Начните с текущей задачи бизнеса. Формулировка «доработать сайт» не объясняет, что считать результатом. Для сайта небольшой компании полезнее написать: «Исправить выбор услуги в форме заявки; после смены услуги итоговая стоимость должна обновляться без перезагрузки страницы». Укажите страницу и действие посетителя, которое сейчас работает неправильно.

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

  • Цель: какое действие посетитель должен выполнить на сайте.
  • Текущее состояние: что уже работает и где остаётся ошибка.
  • Файлы: какие части проекта менялись и зачем.
  • Проверки: что запускали и какой результат получили.
  • Границы: что нельзя менять в рамках этой задачи.

Сохраните сводку рядом с кодом, например в HANDOFF.md. Это имя для рабочего документа, а не обещание, что инструмент автоматически прочитает файл. В первом запросе к Gemini CLI прямо укажите путь и попросите подтвердить, какие сведения он нашёл.

Если проект хранится в Git, сохраните понятную точку возврата перед новыми правками. Git помогает отслеживать версии файлов. Когда такой истории нет, сделайте отдельную копию рабочей папки и убедитесь, что знаете, какую версию сайта копируете.

Что написать в файле передачи проекта?

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

Для учебного примера с формой заявки запись может выглядеть так: «Цель: обновлять итог при выборе услуги. Состояние: список услуг открывается, итог остаётся прежним. Последняя правка касается обработчика выбора. Проверка в браузере ещё не выполнена. Следующий шаг: найти, откуда итог получает значение». Это пример структуры, а не отчёт о реальном проекте.

Пути к файлам берите из проекта. Не просите помощника угадывать их по памяти разговора. Если он утверждает, что изменил форму, пусть укажет конкретный файл и кратко объяснит правку: добавил обработчик, изменил расчёт или убрал повторный вызов.

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

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

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

Как дать Gemini CLI первую задачу после перехода?

Сначала поручите проверку контекста без изменения файлов. Так вы увидите, совпадает ли сводка с проектом, прежде чем помощник начнёт правки. Подойдёт такой запрос:

«Прочитай HANDOFF.md и инструкции проекта. Пока не меняй файлы и не запускай команды, которые меняют данные или публикуют сайт. Найди в коде части, которые относятся к задаче. Кратко опиши текущее состояние, перечисли расхождения со сводкой и предложи ближайшее действие. Отдельно укажи, что пока не удалось проверить».

Если в проекте есть CLAUDE.md или AGENTS.md, попросите прочитать их явно. Не рассчитывайте, что разные инструменты одинаково найдут и применят все инструкции. Если документы противоречат друг другу, сначала уточните правило у человека, который отвечает за проект.

  1. Проверьте, что помощник нашёл нужную страницу или компонент.
  2. Сопоставьте его описание с тем, что видите на сайте.
  3. Согласуйте одну правку с понятным результатом.
  4. После правки попросите показать изменения и результаты проверок.

На этом этапе передача контекста завершена: новый помощник нашёл нужный код и обозначил пробелы. Дальше начинается отдельная задача по изменению сайта. Если нужна именно независимая оценка уже готовой работы, пригодится разбор проверки кода после Claude Code с помощью Gemini CLI.

Как убедиться, что после перехода сайт работает?

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

Для примера с формой сначала выберите услугу, затем смените её и посмотрите на итог. После этого проверьте соседний сценарий: вернитесь к исходному выбору или очистите поле. Так вы проверите и исправление, и поведение формы после следующего действия пользователя.

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

Попросите Gemini CLI разделить отчёт на выполненные проверки и проверки, которые ещё предстоит сделать человеку. Если помощник не открывал страницу в браузере, в отчёте не должно быть утверждения, что форма работает визуально. Если он только прочитал код расчёта, результат реального оформления заказа остаётся непроверенным.

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

Какие типичные ошибки мешают передать контекст?

  • Копировать весь чат без сводки. В нём остаются устаревшие решения; вынесите актуальную цель и состояние в отдельный файл.
  • Просить сразу «закончить всё». Сначала поручите найти нужный код и сверить его с описанием задачи.
  • Записывать предположение как факт. Вместо «ошибка исправлена» укажите, какую правку внесли и как её проверили.
  • Одновременно исправлять функцию и переделывать структуру проекта. Разделите задачи, чтобы было понятно, какое изменение повлияло на результат.
  • Считать отсутствие сообщений об ошибках подтверждением работы сайта. Повторите нужное действие в браузере и зафиксируйте результат.

Файл передачи тоже требует обновления. После следующей правки замените устаревшее описание состояния и запишите результат проверки. Иначе при новом переходе помощник начнёт с ошибки, которую уже устранили, или пропустит ту, что появилась позже.

Сейчас создайте в папке проекта HANDOFF.md и запишите одной фразой, какое действие посетителя сайта нужно исправить. На этот первый шаг отведите одну минуту.