Seorang pembangun telah memindahkan aliran kerja Claude Code yang berusia beberapa bulan ke OpenCode dan mendapati bahawa pengendalian fail, pemuatan peraturan, inventori alatan, metadata kemahiran dan memori rentas sesi semuanya gagal. Pembaikan yang didokumentasikannya kini berfungsi sebagai senarai semak praktikal bagi sesiapa yang beralih daripada ekosistem Claude kepada alternatif sumber terbuka.

Mengapa migrasi ini penting

Pengguna Claude Code bergantung pada set fail yang terikat rapat—peraturan, definisi kemahiran dan log memori—untuk memastikan pembantu pengekodan dipacu AI berjalan lancar. Apabila tetapan penulis berhenti memuatkan peraturan, mencampuradukkan fail dan menyebabkan penggunaan token melonjak, pembantu pengekodan hariannya menjadi tidak boleh dipercayai. OpenCode menjanjikan “keselamatan mengutamakan kebenaran” (permission-first security), akses agnostik-model melalui OpenRouter dan harga bayar-mengikut-penggunaan, menjadikannya menarik. Namun, peralihan ini bukan sekadar salin-tampal yang mudah; anda mesti mengisytiharkan semula setiap komponen dalam format yang diharapkan oleh OpenCode.

Apa yang menyebabkan kegagalan

Claude Code menggunakan fail bernama CLAUDE.md, yang diabaikan oleh OpenCode dan sebaliknya membaca AGENTS.md untuk metadata tambahan. Penulis menganggap kedua-dua sistem tersebut boleh ditukar ganti, menyebabkan beberapa komponen teras tidak kelihatan kepada OpenCode.

Kegagalan nyata dan cara memperbaikinya

  • Fail peraturan diabaikan
    OpenCode tidak pernah membaca CLAUDE.md; ia hanya menganalisis AGENTS.md. Menamakan semula fail tidak mencukupi kerana kandungannya mesti diisytiharkan semula dalam format baharu.
    Cara Perbaiki: Cipta AGENTS.md yang baharu, salin teks peraturan, mulakan sesi OpenCode baharu dan tanya ejen tersebut “Apakah peraturan saya?” Jika ia tidak dapat menyebutnya, bermakna peraturan tersebut belum dimuatkan.

  • Inventori alatan hilang
    Perintah migrasi yang sepatutnya menyalin kemahiran dan pelayan MCP (multi-cloud platform) gagal kerana OpenCode tidak dapat menyenaraikan inventori alatan yang tidak pernah didaftarkan.
    Cara Perbaiki: Semasa alatan Claude Code masih berjalan, senaraikan setiap kemahiran dan arahan secara manual. Tentukan mana yang perlu dibina semula dalam OpenCode dan mana yang perlu dibuang.

  • Front-matter dibuang daripada kemahiran
    Fail kemahiran yang dipindahkan kehilangan sebahagian besar front-matter mereka, termasuk penetapan model dan arahan pengendalian alatan. OpenCode hanya menghormati segelintir medan sahaja, jadi kemahiran yang diimport berkelakuan tidak menentu.
    Cara Perbaiki: Anggap setiap kemahiran yang diimport sebagai rosak. Bina semula tiga kemahiran yang paling kerap digunakan dari awal, pastikan ia hanya mengandungi medan yang disokong. Padam mana-mana fail kemahiran yang tidak digunakan.

  • Tiada memori rentas sesi
    Claude Code menyimpan sejarah berterusan yang menjadi sandaran penulis untuk konteks. OpenCode tidak mengekalkan memori merentasi sesi, jadi pembantu tersebut “terlupa” segalanya sehari selepas pertukaran dilakukan.
    Cara Perbaiki: Tambah arahan eksplisit ke dalam AGENTS.md: “Pada akhir setiap sesi, tambahkan ringkasan pendek ke session-log.md yang merangkumi apa yang telah dilakukan, apa yang tertangguh, dan keputusan yang telah dibuat.” Log sesi tersebut kemudiannya menjadi satu-satunya sumber rujukan untuk kesinambungan.

Pertaruhan: apa yang anda peroleh dan apa yang anda korbankan

Keuntungan

  • Keselamatan mengutamakan kebenaran: OpenCode meminta kebenaran sebelum melaksanakan sebarang tindakan, mengurangkan perubahan kod yang tidak disengajakan.
  • Kebebasan model: Satu kunci API membuka akses kepada berpuluh-puluh model melalui OpenRouter, membolehkan anda bereksperimen tanpa mengubah fail konfigurasi.
  • Kawalan kos: Pengebilan adalah berasaskan penggunaan, mengelakkan langganan kadar rata yang boleh menjadi mahal apabila penggunaan token melonjak.

Kerugian

  • Tiada memori jangka panjang terbina dalam bermakna anda mesti menyelenggara log secara manual.
  • Metadata kemahiran yang terhad memaksa anda membina semula kebanyakan alatan tersuai anda.

Senarai semak migrasi praktikal

  1. Cipta AGENTS.md terlebih dahulu – isytiharkan setiap peraturan yang anda perlukan sebelum mengimport mana-mana fail lain.
  2. Tambah arahan log-sesi – masukkan peraturan “tambah ringkasan” di bahagian atas AGENTS.md.
  3. Bina semula tiga kemahiran utama – salin medan yang disokong sahaja; uji setiap kemahiran secara berasingan.
  4. Isytiharkan semula MCP secara manual – senaraikan setiap pelayan atau titik akhir awan yang masih perlu anda akses.
  5. Sahkan – mulakan sesi OpenCode baharu dan tanya pembantu tersebut tentang peraturan, senarai kemahiran dan status memorinya.

Kesimpulan

Migrasi daripada Claude Code ke OpenCode bukan sekadar tentang memindahkan fail, tetapi lebih kepada menyusun semula seni bina pengisytiharan yang memacu pembantu tersebut. Proses ini memaksa anda untuk meringkaskan kepada peraturan teras, membina semula kemahiran penting dan menggunakan log memori manual, tetapi ia juga membuka pintu kepada bantuan AI yang lebih murah dan agnostik-model. Jika anda bersedia untuk menukar kemudahan dengan kawalan, ikuti senarai semak di atas dan anggap setiap komponen yang diimport sebagai permulaan baharu.