Розробник переніс робочий процес 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 — це не стільки перенесення файлів, скільки перепроектування декларацій, які керують помічником. Цей процес змушує вас звести все до основних правил, заново створити важливі навички та перейти на ручний журнал пам'яті, але водночас він відкриває двері до дешевшої та модельно-незалежної ШІ-допомоги. Якщо ви готові проміняти зручність на контроль, дотримуйтесь наведеного вище чек-листа і ставтеся до кожного імпортованого компонента як до нового старту.