Bir geliştirici, aylar öncesinden kalan bir Claude Code iş akışını OpenCode'a taşıdı ve dosya işleme, kural yükleme, araç envanteri, yetenek meta verileri ve oturumlar arası belleğin tamamen bozulduğunu fark etti. Belgelediği düzeltmeler, şimdi Claude ekosisteminden açık kaynaklı alternatife geçen herkes için pratik bir kontrol listesi görevi görüyor.

Neden geçiş önemliydi

Claude Code kullanıcıları, yapay zeka destekli bir kodlama asistanını sorunsuz çalıştırmak için kurallar, yetenek tanımları ve bellek günlükleri gibi sıkı bir şekilde paketlenmiş bir dosya setine güvenirler. Yazarın kurulumu kuralları yüklemeyi durdurduğunda, dosyaları karıştırdığında ve token kullanımında ani artışlar gördüğünde, günlük kodlama yardımcısı güvenilmez hale geldi. OpenCode; "önce izin" (permission-first) güvenliği, OpenRouter aracılığıyla modelden bağımsız erişim ve kullandıkça öde fiyatlandırması vaat ederek cazip hale geliyor. Ancak geçiş basit bir kopyala-yapıştır işlemi değildir; her bileşeni OpenCode'un beklediği formatta yeniden tanımlamanız gerekir.

Bozulmaya ne yol açtı

Claude Code, OpenCode'un görmezden geldiği ve bunun yerine ek meta veriler için AGENTS.md dosyasını okuduğu CLAUDE.md adlı bir dosya kullanıyordu. Yazar, iki sistemin birbirinin yerine geçebileceğini varsayarak birkaç temel parçayı OpenCode için görünmez bıraktı.

Somut hatalar ve nasıl düzeltilirler

  • Kurallar dosyası görmezden geliniyor
    OpenCode asla CLAUDE.md dosyasını okumaz; yalnızca AGENTS.md dosyasını ayrıştırır. Dosyayı yeniden adlandırmak yeterli değildir çünkü içeriğin yeni formatta yeniden beyan edilmesi gerekir.
    Düzeltme: Yeni bir AGENTS.md oluşturun, kural metnini kopyalayın, yeni bir OpenCode oturumu başlatın ve ajana “Kurallarım nelerdir?” diye sorun. Eğer kuralları alıntılayamıyorsa, kurallar yüklenmemiş demektir.

  • Araç envanteri eksik
    Yetenekleri ve MCP (multi-cloud platform) sunucularını kopyalaması gereken taşıma komutu başarısız oldu çünkü OpenCode, hiç kaydedilmemiş araçların envanterini çıkaramaz.
    Düzeltme: Claude Code araçları hala çalışırken, her yeteneği ve komutu manuel olarak listeleyin. Hangilerini OpenCode'da yeniden inşa edeceğinize ve hangilerini bırakacağınıza karar verin.

  • Yeteneklerden front-matter siliniyor
    Taşınan yetenek dosyaları, model atamaları ve araç işleme direktifleri dahil olmak üzere front-matter bilgilerinin çoğunu kaybetti. OpenCode yalnızca birkaç alanı dikkate alır, bu nedenle içe aktarılan yetenekler öngörülemez şekilde davrandı.
    Düzeltme: İçe aktarılan her yeteneği bozuk kabul edin. En çok kullanılan üç yeteneği, yalnızca desteklenen alanları içerecek şekilde sıfırdan yeniden oluşturun. Kullanılmayan tüm yetenek dosyalarını silin.

  • Oturumlar arası bellek yok
    Claude Code, yazarın bağlam için güvendiği kalıcı bir geçmiş tutuyordu. OpenCode oturumlar arasında bellek tutmaz, bu nedenle asistan geçişten bir gün sonra her şeyi “unuttu”.
    Düzeltme: AGENTS.md dosyasına açık bir talimat ekleyin: “Her oturumun sonunda, session-log.md dosyasına ne yapıldığını, nelerin beklediğini ve alınan kararları kapsayan kısa bir özet ekle.” Böylece oturum günlüğü, süreklilik için tek doğruluk kaynağı haline gelir.

Riskler: ne kazanırsınız ve ne kaybedersiniz

Kazançlar

  • Önce izin güvenliği: OpenCode, herhangi bir eylemi gerçekleştirmeden önce izin ister, bu da yanlışlıkla yapılan kod değişikliklerini azaltır.
  • Model özgürlüğü: Tek bir API anahtarı, OpenRouter aracılığıyla düzinelerce modelin kilidini açarak yapılandırma dosyalarını değiştirmeden denemeler yapmanıza olanak tanır.
  • Maliyet kontrolü: Faturalandırma kullanım bazlıdır; token tüketimi arttığında pahalı hale gelebilen sabit ücretli abonelikten kaçınmanızı sağlar.

Kayıplar

  • Yerleşik uzun süreli belleğin olmaması, manuel bir günlük tutmanız gerektiği anlamına gelir.
  • Sınırlı yetenek meta verileri, özel araçlarınızın çoğunu yeniden inşa etmenizi gerektirir.

Pratik bir taşıma kontrol listesi

  1. Önce AGENTS.md oluşturun – başka herhangi bir dosyayı içe aktarmadan önce ihtiyacınız olan her kuralı tanımlayın.
  2. Bir oturum günlüğü talimatı ekleyin – “özet ekle” kuralını AGENTS.md'nin en üstüne yerleştirin.
  3. En önemli üç yeteneği yeniden inşa edin – yalnızca desteklenen alanları kopyalayın; her yeteneği tek başına test edin.
  4. MCP'leri manuel olarak yeniden tanımlayın – ulaşmanız gereken her sunucuyu veya bulut uç noktasını listeleyin.
  5. Doğrulayın – yeni bir OpenCode oturumu başlatın ve asistana kurallarını, yetenek listesini ve bellek durumunu sorun.

Sonuç

Claude Code'dan OpenCode'a geçmek, dosya taşımaktan ziyade asistanı yönlendiren bildirimleri yeniden yapılandırmakla ilgilidir. Bu süreç sizi temel kurallara indirgenmeye, temel yetenekleri yeniden inşa etmeye ve manuel bir bellek günlüğü tutmaya zorlar; ancak aynı zamanda daha ucuz ve modelden bağımsız yapay zeka yardımına kapı açar. Kolaylıktan vazgeçip kontrolü ele almaya hazırsanız, yukarıdaki kontrol listesini izleyin ve içe aktarılan her bileşeni yeni bir başlangıç olarak kabul edin.