एका डेव्हलपरने महिन्यांपूर्वीचा Claude Code वर्कफ्लो OpenCode वर हलवला आणि तेव्हा त्याला समजले की फाईल हँडलिंग, नियम लोड करणे, टूल इन्व्हेंटरी, स्किल मेटाडेटा आणि क्रॉस-सेशन मेमरी या सर्व गोष्टी विस्कळीत झाल्या आहेत. त्याने जे उपाय दस्तऐवजीकृत केले आहेत, ते आता Claude च्या इकोसिस्टममधून ओपन-सोर्स पर्यायाकडे स्थलांतरित होणाऱ्या प्रत्येकासाठी एक व्यावहारिक चेकलिस्ट म्हणून काम करतात.
स्थलांतर का महत्त्वाचे होते
Claude Code वापरकर्ते AI-चालित कोडिंग असिस्टंट सुरळीत चालवण्यासाठी नियमावली (rules), स्किल व्याख्या (skill definitions) आणि मेमरी लॉग्स (memory logs) यांसारख्या फाईल्सच्या एका घट्ट बांधलेल्या संचावर अवलंबून असतात. जेव्हा लेखकाची सेटअप नियमावली लोड करणे थांबली, फाईल्समध्ये गोंधळ झाला आणि टोकन वापर वाढला, तेव्हा त्याचा दैनंदिन कोडिंग मदतनीस अविश्वसनीय झाला. OpenCode "permission-first security", OpenRouter द्वारे मॉडेल-अज्ञेयवादी (model-agnostic) प्रवेश आणि 'पे-अॅज-यू-गो' (pay-as-you-go) किंमत देण्याचे आश्वासन देते, ज्यामुळे ते आकर्षक ठरते. परंतु हे संक्रमण केवळ कॉपी-पेस्ट करण्यासारखे सोपे नाही; तुम्हाला OpenCode ला अपेक्षित असलेल्या फॉरमॅटमध्ये प्रत्येक घटक पुन्हा घोषित करावा लागेल.
बिघाड कशामुळे झाला
Claude Code मध्ये CLAUDE.md नावाची फाईल वापरली जात असे, जी OpenCode दुर्लक्षित करते आणि त्याऐवजी अतिरिक्त मेटाडेटासाठी AGENTS.md वाचते. लेखकाला वाटले की दोन्ही प्रणाली एकमेकांसाठी पर्यायी आहेत, ज्यामुळे अनेक मुख्य भाग OpenCode ला दिसत नव्हते.
प्रत्यक्ष अपयश आणि ते कसे सुधारावे
Rules file ignored (नियम फाईल दुर्लक्षित केली)
OpenCode कधीही CLAUDE.md वाचत नाही; ते फक्त AGENTS.md पार्स करते. फाईलचे नाव बदलणे पुरेसे नाही कारण मजकूर नवीन फॉरमॅटमध्ये पुन्हा घोषित करणे आवश्यक आहे.
Fix: एक नवीन AGENTS.md तयार करा, नियमांचा मजकूर कॉपी करा, एक नवीन OpenCode सेशन सुरू करा आणि एजंटला विचारा “What are my rules?” जर तो ते सांगू शकला नाही, तर याचा अर्थ नियम लोड झालेले नाहीत.Tooling inventory missing (टूलिंग इन्व्हेंटरी गहाळ)
स्किल्स आणि MCP (multi-cloud platform) सर्व्हर कॉपी करण्यासाठी दिलेली मायग्रेशन कमांड अयशस्वी ठरली कारण OpenCode अशा टूल्सची यादी करू शकत नाही जे कधीही नोंदणीकृत (registered) केले गेले नाहीत.
Fix: जोपर्यंत Claude Code टूल्स सुरू आहेत, तोपर्यंत प्रत्येक स्किल आणि कमांडची मॅन्युअली यादी करा. कोणते OpenCode मध्ये पुन्हा तयार करायचे आणि कोणते काढून टाकायचे हे ठरवा.Front-matter stripped from skills (स्किल्समधून फ्रंट-मॅटर काढून टाकले गेले)
पोर्ट केलेल्या स्किल फाईल्समधील मॉडेल असाइनमेंट्स आणि टूल हँडलिंग निर्देशे यांसह बहुतेक फ्रंट-मॅटर गमावले गेले. OpenCode फक्त काही मोजक्या फील्ड्सचा मान राखते, त्यामुळे आयात केलेल्या स्किल्स अनपेक्षितपणे वागू लागल्या.
Fix: प्रत्येक आयात केलेल्या स्किलला खराब समजून घ्या. सर्वाधिक वापरली जाणारी तीन स्किल्स शून्यापासून पुन्हा तयार करा, त्यामध्ये फक्त समर्थित (supported) फील्ड्स आहेत याची खात्री करा. कोणत्याही न वापरल्या जाणाऱ्या स्किल फाईल्स हटवा.No cross-session memory (क्रॉस-सेशन मेमरी नाही)
Claude Code ने एक कायमस्वरूपी इतिहास (persistent history) ठेवला होता ज्यावर लेखक संदर्भासाठी (context) अवलंबून होता. OpenCode सेशन्समध्ये मेमरी राखत नाही, त्यामुळे स्विच केल्याच्या दुसऱ्या दिवशी असिस्टंट सर्व काही “विसरून” गेला.
Fix: AGENTS.md मध्ये एक स्पष्ट सूचना जोडा: “At the end of every session, append a short summary to session-log.md covering what was done, what is pending, and decisions made.” त्यानंतर सेशन लॉग हा सातत्य राखण्यासाठी एकमेव विश्वसनीय स्रोत (single source of truth) बनतो.
फायदे आणि तोटे
फायदे (Wins)
- Permission-first security: OpenCode कोणतीही कृती करण्यापूर्वी परवानगी मागते, ज्यामुळे चुकून होणारे कोड बदल कमी होतात.
- Model freedom: एकच API की OpenRouter द्वारे डझनभर मॉडेल्स अनलॉक करते, ज्यामुळे तुम्हाला कॉन्फिगरेशन फाईल्स न बदलता प्रयोग करता येतात.
- Cost control: बिलिंग वापराच्या आधारावर असते, ज्यामुळे टोकन वापर वाढल्यावर महाग होणाऱ्या फ्लॅट-रेट सबस्क्रिप्शनची गरज भासत नाही.
तोटे (Losses)
- इन-बिल्ट दीर्घकालीन मेमरी नसल्यामुळे तुम्हाला मॅन्युअल लॉग ठेवावा लागेल.
- मर्यादित स्किल मेटाडेटा असल्यामुळे तुम्हाला तुमचे बहुतेक कस्टम टूल्स पुन्हा तयार करावे लागतील.
एक व्यावहारिक मायग्रेशन चेकलिस्ट
- प्रथम AGENTS.md तयार करा – इतर कोणतीही फाईल आयात करण्यापूर्वी तुम्हाला आवश्यक असलेले प्रत्येक नियम घोषित करा.
- session-log सूचना जोडा – AGENTS.md च्या शीर्षकावर “append summary” नियम समाविष्ट करा.
- टॉप तीन स्किल्स पुन्हा तयार करा – फक्त समर्थित फील्ड्स कॉपी करा; प्रत्येक स्किल स्वतंत्रपणे तपासा.
- MCPs मॅन्युअली पुन्हा घोषित करा – तुम्हाला अजूनही ज्या सर्व्हर किंवा क्लाउड एंडपॉइंट्सची गरज आहे त्यांची यादी करा.
- Validate (पडताळणी करा) – एक नवीन OpenCode सेशन सुरू करा आणि असिस्टंटला त्याचे नियम, स्किल लिस्ट आणि मेमरी स्टेटसबद्दल विचारा.
निष्कर्ष
Claude Code कडून OpenCode कडे स्थलांतरित करणे म्हणजे केवळ फाईल्स हलवणे नसून असिस्टंटला चालवणाऱ्या घोषणांची (declarations) पुनर्रचना करणे आहे. ही प्रक्रिया तुम्हाला मूळ नियमांपर्यंत मर्यादित राहण्यास, आवश्यक स्किल्स पुन्हा तयार करण्यास आणि मॅन्युअल मेमरी लॉग स्वीकारण्यास भाग पाडते, परंतु यामुळे स्वस्त आणि मॉडेल-अज्ञेयवादी AI सहाय्य मिळण्याचे दरवाजेही उघडतात. जर तुम्ही सोयीपेक्षा नियंत्रणाला प्राधान्य देण्यास तयार असाल, तर वरील चेकलिस्ट फॉलो करा आणि प्रत्येक आयात केलेल्या घटकाला एक नवीन सुरुवात समजा.