Een ontwikkelaar verplaatste een maandenoude Claude Code-workflow naar OpenCode en ontdekte dat de bestandshantering, het laden van regels, de tool-inventaris, de skill-metadata en het geheugen over verschillende sessies heen allemaal uit elkaar vielen. De fixes die hij documenteerde, dienen nu als een praktische checklist voor iedereen die overstapt van het ecosysteem van Claude naar het open-source alternatief.

Waarom de migratie belangrijk was

Claude Code-gebruikers vertrouwen op een nauw verbonden set bestanden — regels, skill-definities en geheugenlogs — om een AI-gestuurde programmeerassistent soepel te laten draaien. Toen de setup van de auteur stopte met het laden van regels, bestanden door elkaar haalde en het tokenverbruik explodeerde, werd zijn dagelijkse programmeerhulp onbetrouwbaar. OpenCode belooft “permission-first security”, model-agnostische toegang via OpenRouter en een pay-as-you-go-prijsmodel, wat het aantrekkelijk maakt. Maar de overstap is geen simpele copy-paste; je moet elke component opnieuw declareren in het formaat dat OpenCode verwacht.

Wat leidde tot de problemen

Claude Code gebruikte een bestand genaamd CLAUDE.md, dat OpenCode negeert en in plaats daarvan AGENTS.md leest voor aanvullende metadata. De auteur ging ervan uit dat de twee systemen uitwisselbaar waren, waardoor verschillende kernonderdelen onzichtbaar bleven voor OpenCode.

De concrete fouten en hoe ze op te lossen

  • Regelbestand genegeerd
    OpenCode leest CLAUDE.md nooit; het analyseert alleen AGENTS.md. Het hernoemen van het bestand is niet voldoende, omdat de inhoud in het nieuwe formaat opnieuw moet worden gedeclareerd.
    Oplossing: Maak een gloednieuw AGENTS.md-bestand aan, kopieer de tekst van de regels, start een nieuwe OpenCode-sessie en vraag de agent: “Wat zijn mijn regels?”. Als de agent ze niet kan citeren, zijn de regels niet geladen.

  • Tooling-inventaris ontbreekt
    Het migratiecommando dat bedoeld was om skills en MCP (multi-cloud platform) servers te kopiëren, mislukte omdat OpenCode geen tools kan inventariseren die nooit zijn geregistreerd.
    Oplossing: Terwijl de Claude Code-tools nog draaien, maak je handmatig een lijst van elke skill en elk commando. Beslis welke je in OpenCode wilt herbouwen en welke je wilt laten vallen.

  • Front-matter verwijderd uit skills
    Geporteerde skill-bestanden verloren de meeste van hun front-matter, inclusief modeltoewijzingen en instructies voor tool-afhandeling. OpenCode respecteert slechts een handvol velden, waardoor de geïmporteerde skills onvoorspelbaar gedrag vertoonden.
    Oplossing: Behandel elke geïmporteerde skill als defect. Maak de drie meest gebruikte skills vanaf nul opnieuw aan en zorg ervoor dat ze alleen de ondersteunde velden bevatten. Verwijder alle ongebruikte skill-bestanden.

  • Geen geheugen over verschillende sessies heen
    Claude Code hield een persistente geschiedenis bij waar de auteur op vertrouwde voor context. OpenCode behoudt geen geheugen tussen sessies, waardoor de assistent de volgende dag na de overstap alles “vergat”.
    Oplossing: Voeg een expliciete instructie toe aan AGENTS.md: “Voeg aan het einde van elke sessie een korte samenvatting toe aan session-log.md met wat er is gedaan, wat er nog moet gebeuren en welke beslissingen zijn genomen.” Het sessie-logboek wordt zo de enige bron van waarheid voor continuïteit.

De inzet: wat je wint en wat je verliest

Winstpunten

  • Permission-first security: OpenCode vraagt toestemming voordat er een actie wordt uitgevoerd, wat onbedoelde code-wijzigingen vermindert.
  • Modelvrijheid: Eén API-sleutel ontgrendelt tientallen modellen via OpenRouter, waardoor je kunt experimenteren zonder configuratiebestanden te wijzigen.
  • Kostenbeheersing: Facturering is gebaseerd op verbruik, waardoor je een vast abonnement vermijdt dat duur kan worden wanneer het tokenverbruik piekt.

Verliezen

  • Geen ingebouwd langetermijngeheugen betekent dat je handmatig een logboek moet bijhouden.
  • Beperkte skill-metadata dwingt je om de meeste van je aangepaste tools opnieuw op te bouwen.

Een praktische migratiechecklist

  1. Maak eerst AGENTS.md aan – declareer elke regel die je nodig hebt voordat je andere bestanden importeert.
  2. Voeg een instructie voor het sessie-logboek toe – voeg de “voeg samenvatting toe”-regel bovenaan AGENTS.md in.
  3. Bouw de top drie skills opnieuw op – kopieer alleen de ondersteunde velden; test elke skill afzonderlijk.
  4. Declareer MCP's handmatig opnieuw – maak een lijst van elke server of cloud-endpoint die je nog moet bereiken.
  5. Valideer – start een nieuwe OpenCode-sessie en vraag de assistent naar de regels, de lijst met skills en de status van het geheugen.

Conclusie

Migreren van Claude Code naar OpenCode gaat minder over het verplaatsen van bestanden en meer over het opnieuw ontwerpen van de declaraties die de assistent aansturen. Het proces dwingt je om terug te gaan naar de kernregels, essentiële skills opnieuw op te bouwen en een handmatig geheugenlogboek te gebruiken, maar het opent ook de deur naar goedkopere, model-agnostische AI-assistentie. Als je bereid bent om gemak in te ruilen voor controle, volg dan de bovenstaande checklist en behandel elk geïmporteerd component als een frisse start.