એક ડેવલપરે મહિનાઓ જૂનો Claude Code વર્કફ્લો OpenCode માં સ્થાનાંતરિત કર્યો અને જોયું કે ફાઇલ હેન્ડલિંગ, રૂલ લોડિંગ, ટૂલ ઇન્વેન્ટરી, સ્કિલ મેટાડેટા અને ક્રોસ-સેશન મેમરી બધું જ બગડી ગયું. તેણે જે સુધારાઓનું દસ્તાવેજીકરણ કર્યું છે તે હવે Claude ના ઇકોસિસ્ટમમાંથી ઓપન-સોર્સ વિકલ્પમાં શિફ્ટ થતા કોઈપણ વ્યક્તિ માટે વ્યવહારુ ચેકલિસ્ટ તરીકે કામ કરે છે.
માઇગ્રેશન શા માટે મહત્વનું હતું
Claude Code વપરાશકર્તાઓ AI-સંચાલિત કોડિંગ આસિસ્ટન્ટને સરળતાથી ચલાવવા માટે નિયમો (rules), સ્કિલ વ્યાખ્યાઓ (skill definitions) અને મેમરી લોગ્સ જેવી ફાઇલોના એક સંગઠિત સેટ પર આધાર રાખે છે. જ્યારે લેખકના સેટઅપમાં નિયમો લોડ થવાનું બંધ થઈ ગયું, ફાઇલો મિક્સ થઈ ગઈ અને ટોકન વપરાશમાં વધારો થયો, ત્યારે તેમનો દૈનિક કોડિંગ હેલ્પર અવિશ્વસનીય બની ગયો. OpenCode "પરમિશન-ફર્સ્ટ સિક્યુરિટી", OpenRouter દ્વારા મોડેલ-એગ્નોસ્ટિક એક્સેસ અને પે-એઝ-યુ-ગો (pay-as-you-go) પ્રાઇસિંગનું વચન આપે છે, જે તેને આકર્ષક બનાવે છે. પરંતુ આ પરિવર્તન માત્ર કોપી-પેસ્ટ જેવું સરળ નથી; તમારે OpenCode જે ફોર્મેટ અપેક્ષા રાખે છે તેમાં દરેક ઘટકને ફરીથી જાહેર (re-declare) કરવો પડશે.
બ્રેકેજ (ભંગાણ) માટે શું જવાબદાર હતું
Claude Code CLAUDE.md નામની ફાઇલનો ઉપયોગ કરતું હતું, જેને OpenCode અવગણે છે અને તેના બદલે વધારાના મેટાડેટા માટે AGENTS.md વાંચે છે. લેખકે ધાર્યું હતું કે બંને સિસ્ટમ્સ પરસ્પર બદલી શકાય તેવી છે, જેના કારણે ઘણા મુખ્ય ભાગો OpenCode માટે અદ્રશ્ય રહી ગયા.
ચોક્કસ નિષ્ફળતાઓ અને તેને કેવી રીતે સુધારવી
રૂલ્સ ફાઇલ અવગણવામાં આવી
OpenCode ક્યારેય CLAUDE.md વાંચતું નથી; તે ફક્ત AGENTS.md ને જ પાર્સ કરે છે. ફાઇલનું નામ બદલવું પૂરતું નથી કારણ કે સામગ્રીને નવા ફોર્મેટમાં ફરીથી જાહેર કરવી આવશ્યક છે.
સુધારો: એક નવી AGENTS.md બનાવો, રૂલ ટેક્સ્ટ કોપી કરો, નવું OpenCode સેશન શરૂ કરો અને એજન્ટને પૂછો “What are my rules?”. જો તે તેને ટાંકી ન શકે, તો તેનો અર્થ છે કે રૂલ્સ લોડ થયા નથી.ટૂલિંગ ઇન્વેન્ટરી ખૂટે છે
માઇગ્રેશન કમાન્ડ જે સ્કિલ્સ અને MCP (multi-cloud platform) સર્વર્સને કોપી કરવાનું હતું તે નિષ્ફળ રહ્યો કારણ કે OpenCode એવા ટૂલ્સની ઇન્વેન્ટરી બનાવી શકતું નથી જે ક્યારેય રજિસ્ટર કરવામાં આવ્યા નથી.
સુધારો: જ્યારે Claude Code ટૂલ્સ હજુ પણ ચાલુ હોય, ત્યારે દરેક સ્કિલ અને કમાન્ડની મેન્યુઅલી યાદી બનાવો. નક્કી કરો કે કયા ટૂલ્સ OpenCode માં ફરીથી બનાવવાના છે અને કયા છોડી દેવાના છે.સ્કિલ્સમાંથી ફ્રન્ટ-મેટર નીકળી ગયું
પોર્ટ કરેલી સ્કિલ ફાઇલોએ મોટે ભાગનું ફ્રન્ટ-મેટર ગુમાવ્યું, જેમાં મોડેલ અસાઇનમેન્ટ્સ અને ટૂલ હેન્ડલિંગ ડાયરેક્ટિવ્સનો સમાવેશ થાય છે. OpenCode ફક્ત થોડા જ ફીલ્ડ્સને માન્ય રાખે છે, તેથી ઇમ્પોર્ટ કરેલી સ્કિલ્સ અણધાર્યા રીતે વર્તી હતી.
સુધારો: દરેક ઇમ્પોર્ટ કરેલી સ્કિલને બગડેલી માનો. સૌથી વધુ વપરાતી ત્રણ સ્કિલ્સને શૂન્યથી ફરીથી બનાવો, એ સુનિશ્ચિત કરીને કે તેમાં ફક્ત સપોર્ટેડ ફીલ્ડ્સ જ હોય. કોઈપણ બિનઉપયોગી સ્કિલ ફાઇલોને ડિલીટ કરો.ક્રોસ-સેશન મેમરી નથી
Claude Code એક પર્સિસ્ટન્ટ હિસ્ટ્રી રાખતું હતું જેના પર લેખક કોન્ટેક્સ્ટ માટે આધાર રાખતા હતા. OpenCode સેશન્સ વચ્ચે મેમરી જાળવી રાખતું નથી, તેથી સ્વિચ કર્યાના બીજા જ દિવસે આસિસ્ટન્ટે બધું જ “ભૂલી” ગયું.
સુધારો: 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.” ત્યારબાદ સેશન લોગ સાતત્ય માટે સિંગલ સોર્સ ઓફ ટ્રુથ બની જાય છે.
જોખમો: તમે શું મેળવો છો અને શું ગુમાવો છો
ફાયદા (Wins)
- પરમિશન-ફર્સ્ટ સિક્યુરિટી: OpenCode કોઈપણ એક્શન એક્ઝિક્યુટ કરતા પહેલા પૂછે છે, જેનાથી અકસ્માતજન્ય કોડ ફેરફારો ઘટે છે.
- મોડેલ ફ્રીડમ: એક સિંગલ API કી OpenRouter દ્વારા ડઝનબંધ મોડેલ્સ અનલોક કરે છે, જે તમને કન્ફિગરેશન ફાઇલો બદલ્યા વિના પ્રયોગ કરવા દે છે.
- ખર્ચ નિયંત્રણ: બિલિંગ વપરાશ આધારિત છે, જે ફ્લેટ-રેટ સબ્સ્ક્રિપ્શનથી બચાવે છે જે ટોકન વપરાશ વધે ત્યારે મોંઘું બની શકે છે.
નુકસાન (Losses)
- ઇન-બિલ્ટ લોંગ-ટર્મ મેમરી ન હોવાનો અર્થ છે કે તમારે મેન્યુઅલ લોગ જાળવવો પડશે.
- મર્યાદિત સ્કિલ મેટાડેટા તમને તમારા મોટાભાગના કસ્ટમ ટૂલ્સ ફરીથી બનાવવા માટે મજબૂર કરે છે.
વ્યવહારુ માઇગ્રેશન ચેકલિસ્ટ
- પહેલા AGENTS.md બનાવો – કોઈપણ અન્ય ફાઇલો ઇમ્પોર્ટ કરતા પહેલા તમારે જરૂરી દરેક રૂલ જાહેર કરો.
- સેશન-લોગ સૂચના ઉમેરો – AGENTS.md ના ટોચ પર “append summary” રૂલ એમ્બેડ કરો.
- ટોચની ત્રણ સ્કિલ્સ ફરીથી બનાવો – ફક્ત સપોર્ટેડ ફીલ્ડ્સ કોપી કરો; દરેક સ્કિલને અલગથી ટેસ્ટ કરો.
- MCPs ને મેન્યુઅલી ફરીથી જાહેર કરો – તમારે જે સર્વર અથવા ક્લાઉડ એન્ડપોઇન્ટની જરૂર છે તેની યાદી બનાવો.
- વેલિડેટ કરો – નવું OpenCode સેશન શરૂ કરો અને આસિસ્ટન્ટને તેના રૂલ્સ, સ્કિલ લિસ્ટ અને મેમરી સ્ટેટસ વિશે પૂછો.
સારાંશ (Takeaway)
Claude Code થી OpenCode માં માઇગ્રેટ કરવું એ માત્ર ફાઇલો ખસેડવા વિશે નથી, પરંતુ આસિસ્ટન્ટને ચલાવતા ડિક્લેરેશનને ફરીથી આર્કિટેક્ટ કરવા વિશે છે. આ પ્રક્રિયા તમને મુખ્ય રૂલ્સ સુધી મર્યાદિત થવા, આવશ્યક સ્કિલ્સ ફરીથી બનાવવા અને મેન્યુઅલ મેમરી લોગ અપનાવવા માટે મજબૂર કરે છે, પરંતુ તે સસ્તા, મોડેલ-એગ્નોસ્ટિક AI આસિસ્ટન્સ માટેના દ્વાર પણ ખોલે છે. જો તમે કન્વીનિયન્સ (સુવિધા) ને બદલે કંટ્રોલ (નિયંત્રણ) મેળવવા તૈયાર હોવ, તો ઉપરના ચેકલિસ્ટનું પાલન કરો અને દરેક ઇમ્પોર્ટ કરેલા ઘટકને એક નવી શરૂઆત તરીકે ગણો.