Claude Code'un ürettiği uygulamayı yerelleştirmenin en iyi yolu Claude Code'un içinde kalmaktır: bir yerelleştirme Skill'i kur, agent kod tabanını uluslararasılaştırsın, bundan sonra her dili senkronize tutmayı altyapıya bırak. globalize.now tam olarak bu döngü için geliştirilmiş, yapay zeka destekli yerelleştirme altyapısıdır. Koda gömülü metinleri çeviri anahtarlarına çıkarır, dil dosyalarını üretir ve çevrilmiş dilleri her git push'ta PR olarak geri verir. Bu kılavuz, yalnızca İngilizce bir depodan merge edilmiş çok dilli bir PR'a kadar tüm süreci anlatıyor.
Claude Code uygulaman neden yalnızca İngilizce?
Çünkü Claude Code da her kodlama agent'ı gibi kullanıcıya dönük metinleri düz string olarak yazar. Çalışan bir özelliğe giden en kısa yol budur ve varsayılan bir prompt'ta çeviri anahtarı isteyen hiçbir şey yoktur. Uygulama çalışır hale geldiğinde İngilizce yüzlerce bileşene gömülmüştür; çoğul biçimleri ve tarihler de yalnızca tek bir dilde anlamlı olan string birleştirmeyle ele alınmıştır.
Akla gelen çözüm, agent'tan “uygulamayı Almancaya çevir” demesini istemek. Bu, koda gömülü ikinci bir dil üretir: çoğaltılmış bileşenler ya da bir yığın üçlü operatör; üstelik her yeni özellik işi ikiye katlar. Bu hata biçimini yapay zekâ ile üretilmiş bir uygulamanın nasıl yerelleştirileceğini anlattığımız yazıda ele almıştık. Uluslararasılaştırmadan yapılan çeviri, i18n borcunun katlanarak büyümesinin yoludur.
Claude Code'un ürettiği uygulamayı yerelleştirmenin en iyi yolu nedir?
Yerelleştirme iş akışını uygulamayı yazan agent'ın içinde çalıştır: skill, Claude Code'a uluslararasılaştırma prosedürünü öğretir; çeviri ve senkronizasyonu ise her push'tan sonra altyapı üstlenir. Skill'ler, Agent Skills dokümanlarında anlatıldığı gibi, Anthropic'in Claude Code için desteklediği uzantı biçimidir; görev eşleştiğinde agent'ın yüklediği talimat klasörleridir. Ayrıca taşınabilirdir: açık Vercel skills CLI skill paketlerini Claude Code, Cursor, Codex ve onlarca başka agent'a kurar; böylece aynı iş akışı hangi agent'ı kullanırsan onunla gelir.
Bu, çoğu yerelleştirme aracından farklı bir yapıdır. Yerleşik platformlar, hâlâ dashboard'larını merkeze alan bir iş akışının üstüne yapay zekâ özellikleri ve agent bağlayıcıları ekledi: metinlerin onların sisteminde durur, agent ise o sistemin bir istemcisidir. Agent odaklı yerelleştirme bunu tersine çevirir. İş deponda yapılır, uluslararasılaştırmayı agent yapar, çeviri ve senkronizasyonu globalize.now üstlenir. Kodunla uyumlu tutman gereken ayrı bir içerik veritabanı yoktur, çünkü veritabanı koddur.
Bir Claude Code uygulaması adım adım nasıl yerelleştirilir?
Tüm döngü beş adımdan oluşur ve ağır işi agent yapar.
-
Depoyu globalize.now'da bağla. Dönüşüm uygulamada bir kez çalışır ve pull request olarak gelir. Bu ilk geçişi Claude Code'dan çalıştırmak istersen skill'leri kur:
npx skills add globalize-now/globalize-skillsSkill'lerin yalnızca Claude Code'da değil, makinendeki her agent'ta kullanılabilmesini istiyorsan
--allekle. -
Claude Code'dan uygulamayı uluslararasılaştırmasını iste. Skill, agent'a önce depoyu incelettirir: hangi framework, hangi metinler kullanıcıya dönük, hâlihazırda bir i18n kurulumu var mı. Agent bir plan önerir: kütüphane, anahtar yapısı, dil dosyası düzeni. Koda dokunmadan önce onayını bekler.
-
Push'ların çeviriyi tetiklemesi için depoyu globalize.now'a bağla. Geliştirici kurulumu tek bir bağlantıdır; AI araçlarıyla çalışan builder'lar ise 1. adımın ötesinde terminale dokunmadan aynı döngüyü kullanır.
-
Push et. Yeni ve değişen metinler, her kod değişikliği gibi incelediğin bir PR olarak çevrilmiş halde geri gelir.
-
Merge et. Sonradan başka bir dil eklemek proje değil, bir config değişikliğidir.
Gerçek bir production monorepo'sunda bu iş akışıyla çalıştırılan bir agent kod tabanını uluslararasılaştırdı ve yaklaşık 30 dakikada beş dil üretti. Süre proje boyutuna göre değişir, ama bir haftalık elle refactor'un bir agent oturumuna sığdığı yer 2. adımdır.
Agent kodunda tam olarak neyi değiştirir?
Düz metinleri çeviri çağrılarına dönüştürür ve runtime'ın ihtiyaç duyduğu dil dosyalarını üretir. Somut olarak: bir i18n runtime kütüphanesi seçer ya da algılar (stack'ine göre i18next, next-intl veya Lingui), koda gömülü JSX metinlerini t() çağrılarıyla ya da mesaj bileşenleriyle değiştirir, anlamlı adlarla anahtarlar üretir ve kaynak dil dosyasını yazar. Çoğullar, count + " items" yerine gerçek ICU biçimleriyle ifade edilir.
globalize.now runtime kütüphanesinin yerini almaz ve çeviriyi dış bir kuyruğa devretmez. Bir katman yukarıda durur: runtime'ının kullandığı anahtarları ve dil dosyalarını üreten ve güncel tutan altyapıdır. Projene zaten i18next ya da next-intl bağlıysa skill mevcut anahtarlarını ve yapını korur, kaldığın yerden devralır.
Bir sonraki git push'ta ne olur?
Kurulumdan sonraki her push, değişen her şeyin çevirisini tetikler ve güncellenen diller PR olarak gelir. Export adımı yok, import adımı yok, ayrı bir araçta kuyruk yok. İnceleme mühendislerin zaten inceleme yaptığı yerde olur: diff'te.
Bütün işletim modeli bu. Bir kez kur, her git push'ta otomatik senkronize et, elle müdahale gerekmesin. Agent'ın özellikleri hiçbir yerelleştirme sürecinin yetişemeyeceği hızda yayınladığı yapay zekâ uygulamalarındaki sorun anlamsızlaşır, çünkü yerelleştirme süreci özelliğin yayınlandığı aynı push'a bağlıdır.
Bunun için MCP sunucusuna ya da dashboard'a ihtiyacın var mı?
Hayır. MCP bir agent'ı dış bir platforma bağlar; skill ise agent'a işi kodun durduğu yerde yapmayı öğretir. Birçok yerelleştirme ürünü artık MCP sunucusu sunuyor ve bu, bir web editörüne kopyalayıp yapıştırmaktan gerçekten daha iyi. Ama metinler ve durumları hâlâ bağlantının öbür ucundaki platformda duruyor ve ikisini uzlaştırmak sana kalıyor.
Skill ve push döngüsünde uzlaştırılacak bir şey yok. Dil dosyaları git'te durur, çeviriler commit olarak gelir ve geri alma git revert. Bu yaklaşımın neden yayıldığını Claude Code Skill'leri yerelleştirme standardı oluyor yazımızda anlattık. İki yaklaşım da dashboard dönemini geride bırakıyor; fark, doğruluk kaynağının nerede durduğunda.
Bir Claude Code uygulamasını yerelleştirmek ne kadar tutar?
globalize.now'ın Starter planı ayda 20 €'dur ve her ay 20 € çeviri kredisi içerir. Bunun üzerindeki kullanım, sağlayıcı maliyeti artı bir marj üzerinden kredi bakiyenden düşülür. Kullanıcı, dil ya da proje başına ücret yok. Ayda 249 € tutan Team planı roller ve onay Gate'leri, AI Source kontrolleri, Story önizlemesi ve e-posta alan adıyla otomatik katılım ekler.
Kayıt olunca 5 € çeviri kredisi gelir, kart gerekmez. Böylece herhangi bir ödeme yapmadan önce tüm akışı gerçek bir uygulamada deneyebilirsin.
Uygulaman zaten hazır. Yerelleştirmek için bir Skill kurulumu ve bir push yeterli.
globalize.now koda gömülü uygulama metinlerini çeviriye hazır dil dosyalarına dönüştürür ve sen yayına aldıkça güncel tutar.
globalize.now'ı ücretsiz dene