Разработчик перенес рабочий процесс Claude Code, созданный несколько месяцев назад, в OpenCode и обнаружил, что обработка файлов, загрузка правил, инвентаризация инструментов, метаданные навыков и межсессионная память полностью вышли из строя. Описанные им исправления теперь служат практическим чек-листом для всех, кто переходит из экосистемы Claude на open-source альтернативу.

Почему миграция была важна

Пользователи Claude Code полагаются на тесно связанный набор файлов — правила, определения навыков и логи памяти — для бесперебойной работы ИИ-ассистента для кодинга. Когда настройки автора перестали загружать правила, начали путать файлы и вызвали резкий скачок потребления токенов, его ежедневный помощник стал ненадежным. OpenCode обещает «безопасность на основе разрешений» (permission-first security), доступ к любым моделям через OpenRouter и оплату по мере использования, что делает его привлекательным. Но переход — это не просто копирование и вставка; вы должны заново объявить каждый компонент в формате, который ожидает OpenCode.

Что привело к сбоям

Claude Code использовал файл под названием CLAUDE.md, который OpenCode игнорирует, считывая вместо него AGENTS.md для получения дополнительных метаданных. Автор предположил, что эти две системы взаимозаменяемы, из-за чего несколько ключевых элементов остались невидимыми для OpenCode.

Конкретные ошибки и способы их исправления

  • Файл правил игнорируется
    OpenCode никогда не читает CLAUDE.md; он парсит только AGENTS.md. Простого переименования файла недостаточно, так как содержимое должно быть заново объявлено в новом формате.
    Исправление: Создайте новый AGENTS.md, скопируйте текст правил, запустите новую сессию OpenCode и спросите агента: «Какие у меня правила?» Если он не сможет их процитировать, значит, правила не загружены.

  • Отсутствует инвентаризация инструментов
    Команда миграции, которая должна была скопировать навыки и MCP-серверы (multi-cloud platform), не сработала, потому что OpenCode не может составить список инструментов, которые никогда не были зарегистрированы.
    Исправление: Пока инструменты Claude Code еще работают, вручную перечислите каждый навык и команду. Решите, какие из них нужно воссоздать в OpenCode, а какие можно отбросить.

  • Удаление front-matter из навыков
    При переносе файлы навыков потеряли большую часть своего front-matter, включая назначения моделей и директивы обработки инструментов. OpenCode учитывает лишь небольшое количество полей, поэтому импортированные навыки вели себя непредсказуемо.
    Исправление: Считайте каждый импортированный навык неисправным. Пересоздайте три наиболее используемых навыка с нуля, убедившись, что они содержат только поддерживаемые поля. Удалите все неиспользуемые файлы навыков.

  • Отсутствие межсессионной памяти
    Claude Code сохранял постоянную историю, на которую автор полагался для контекста. OpenCode не сохраняет память между сессиями, поэтому на следующий день после перехода ассистент «забыл» всё.
    Исправление: Добавьте явную инструкцию в AGENTS.md: «В конце каждой сессии добавляйте краткое резюме в session-log.md, описывающее выполненную работу, незавершенные задачи и принятые решения». Таким образом, лог сессий станет единственным источником истины для обеспечения непрерывности.

Ставки: что вы приобретаете и что теряете

Плюсы

  • Безопасность на основе разрешений: OpenCode запрашивает разрешение перед выполнением любого действия, что снижает риск случайных изменений кода.
  • Свобода выбора моделей: Один API-ключ открывает доступ к десяткам моделей через OpenRouter, позволяя экспериментировать без изменения конфигурационных файлов.
  • Контроль затрат: Оплата производится по мере использования, что позволяет избежать фиксированной подписки, которая может стать дорогой при резком росте потребления токенов.

Минусы

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

Практический чек-лист миграции

  1. Сначала создайте AGENTS.md – объявите каждое необходимое правило перед импортом любых других файлов.
  2. Добавьте инструкцию для лога сессий – вставьте правило «добавлять резюме» в начало AGENTS.md.
  3. Пересоздайте три основных навыка – копируйте только поддерживаемые поля; тестируйте каждый навык отдельно.
  4. Вручную переобъявите MCP – перечислите каждый сервер или облачный эндпоинт, к которым вам все еще нужен доступ.
  5. Проверьте результат – запустите новую сессию OpenCode и запросите у ассистента его правила, список навыков и статус памяти.

Итог

Миграция с Claude Code на OpenCode — это не столько перенос файлов, сколько перепроектирование деклараций, которыми управляется ассистент. Этот процесс заставляет вас свести всё к основным правилам, заново создать важные навыки и перейти на ручной лог памяти, но он также открывает двери к более дешевой и независимой от моделей ИИ-помощи. Если вы готовы променять удобство на контроль, следуйте приведенному выше чек-листу и относитесь к каждому импортированному компоненту как к началу с чистого листа.