Seorang pengembang memindahkan alur kerja Claude Code yang sudah berjalan berbulan-bulan ke OpenCode dan menemukan bahwa penanganan file, pemuatan aturan, inventaris alat, metadata keahlian, dan memori lintas sesi semuanya berantakan. Perbaikan yang ia dokumentasikan kini berfungsi sebagai daftar periksa praktis bagi siapa pun yang berpindah dari ekosistem Claude ke alternatif sumber terbuka (open-source).

Mengapa migrasi ini penting

Pengguna Claude Code bergantung pada sekumpulan file yang terikat erat—aturan, definisi keahlian, dan log memori—untuk menjaga asisten pengodean berbasis AI tetap berjalan lancar. Ketika pengaturan penulis berhenti memuat aturan, mencampuradukkan file, dan menyebabkan penggunaan token melonjak, pembantu pengodean hariannya menjadi tidak dapat diandalkan. OpenCode menjanjikan “keamanan berbasis izin” (permission-first security), akses agnostik model melalui OpenRouter, dan harga bayar sesuai pemakaian (pay-as-you-go), menjadikannya menarik. Namun, transisinya bukan sekadar salin-tempel; Anda harus mendeklarasikan ulang setiap komponen dalam format yang diharapkan OpenCode.

Apa yang menyebabkan kerusakan

Claude Code menggunakan file bernama CLAUDE.md, yang diabaikan oleh OpenCode, dan sebaliknya OpenCode membaca AGENTS.md untuk metadata tambahan. Penulis berasumsi kedua sistem tersebut dapat saling menggantikan, sehingga membuat beberapa bagian inti tidak terlihat oleh OpenCode.

Kegagalan nyata dan cara memperbaikinya

  • File aturan diabaikan
    OpenCode tidak pernah membaca CLAUDE.md; ia hanya memproses AGENTS.md. Mengubah nama file saja tidak cukup karena kontennya harus dideklarasikan ulang dalam format baru.
    Perbaikan: Buat AGENTS.md baru, salin teks aturan, mulai sesi OpenCode baru, dan tanya agen “Apa aturan saya?” Jika ia tidak dapat mengutipnya, berarti aturan belum dimuat.

  • Inventaris alat hilang
    Perintah migrasi yang seharusnya menyalin keahlian dan server MCP (multi-cloud platform) gagal karena OpenCode tidak dapat menginventarisasi alat yang belum terdaftar.
    Perbaikan: Selagi alat Claude Code masih berjalan, daftar setiap keahlian dan perintah secara manual. Putuskan mana yang akan dibangun ulang di OpenCode dan mana yang akan dibuang.

  • Front-matter terhapus dari keahlian
    File keahlian yang dipindahkan kehilangan sebagian besar front-matter mereka, termasuk penetapan model dan arahan penanganan alat. OpenCode hanya menghormati segelintir bidang, sehingga keahlian yang diimpor berperilaku tidak terduga.
    Perbaikan: Anggap setiap keahlian yang diimpor sebagai rusak. Buat ulang tiga keahlian yang paling sering digunakan dari awal, pastikan hanya berisi bidang yang didukung. Hapus file keahlian yang tidak digunakan.

  • Tidak ada memori lintas sesi
    Claude Code menyimpan riwayat persisten yang diandalkan penulis untuk konteks. OpenCode tidak mempertahankan memori di berbagai sesi, sehingga asisten “melupakan” segalanya sehari setelah peralihan.
    Perbaikan: Tambahkan instruksi eksplisit ke AGENTS.md: “Di akhir setiap sesi, tambahkan ringkasan singkat ke session-log.md yang mencakup apa yang telah dilakukan, apa yang tertunda, dan keputusan yang dibuat.” Log sesi tersebut kemudian menjadi satu-satunya sumber kebenaran (single source of truth) untuk kontinuitas.

Risikonya: apa yang Anda dapatkan dan apa yang Anda hilangkan

Keuntungan

  • Keamanan berbasis izin: OpenCode meminta izin sebelum mengeksekusi tindakan apa pun, mengurangi perubahan kode yang tidak disengaja.
  • Kebebasan model: Satu kunci API membuka puluhan model melalui OpenRouter, memungkinkan Anda bereksperimen tanpa mengubah file konfigurasi.
  • Kontrol biaya: Penagihan berbasis penggunaan, menghindari langganan tarif tetap yang bisa menjadi mahal saat konsumsi token melonjak.

Kerugian

  • Tidak adanya memori jangka panjang bawaan berarti Anda harus mengelola log secara manual.
  • Metadata keahlian yang terbatas memaksa Anda untuk membangun ulang sebagian besar alat kustom Anda.

Daftar periksa migrasi praktis

  1. Buat AGENTS.md terlebih dahulu – deklarasikan setiap aturan yang Anda butuhkan sebelum mengimpor file lainnya.
  2. Tambahkan instruksi log sesi – sematkan aturan “tambahkan ringkasan” di bagian atas AGENTS.md.
  3. Bangun ulang tiga keahlian utama – salin hanya bidang yang didukung; uji setiap keahlian secara terpisah.
  4. Deklarasikan ulang MCP secara manual – daftar setiap server atau titik akhir cloud yang masih perlu Anda jangkau.
  5. Validasi – mulai sesi OpenCode baru dan tanyakan kepada asisten mengenai aturan, daftar keahlian, dan status memorinya.

Kesimpulan

Migrasi dari Claude Code ke OpenCode bukan sekadar memindahkan file, melainkan membangun kembali arsitektur deklarasi yang menggerakkan asisten tersebut. Proses ini memaksa Anda untuk menyederhanakan diri ke aturan inti, membangun kembali keahlian penting, dan mengadopsi log memori manual, tetapi hal ini juga membuka pintu menuju bantuan AI yang lebih murah dan agnostik model. Jika Anda siap menukar kenyamanan dengan kendali, ikuti daftar periksa di atas dan perlakukan setiap komponen yang diimpor sebagai awal yang baru.