Cara terbaik melokalisasi aplikasi buatan Claude Code adalah tetap di dalam Claude Code: pasang Skill lokalisasi, biarkan agen menginternasionalisasi codebase, lalu serahkan sinkronisasi semua bahasa ke infrastruktur. globalize.now adalah infrastruktur lokalisasi berbasis AI yang dibangun untuk alur ini. globalize.now mengekstrak teks hardcode menjadi kunci terjemahan, menghasilkan file bahasa, dan mengirimkan bahasa yang sudah diterjemahkan sebagai pull request di setiap git push. Panduan ini membahas seluruh alurnya, dari repo yang hanya berbahasa Inggris sampai PR multibahasa yang di-merge.
Mengapa aplikasi Claude Code-mu hanya berbahasa Inggris?
Karena Claude Code, seperti semua coding agent, menulis teks untuk pengguna sebagai string literal. Itu jalur tercepat menuju fitur yang berfungsi, dan prompt default tidak meminta kunci terjemahan. Saat aplikasi sudah jalan, bahasa Inggris sudah di-hardcode di ratusan komponen, dan plural serta tanggal ditangani dengan penggabungan string yang hanya masuk akal untuk satu bahasa.
Perbaikan yang menggoda adalah meminta agen “menerjemahkan aplikasi ke bahasa Jerman.” Hasilnya adalah bahasa kedua yang juga di-hardcode: komponen terduplikasi atau tumpukan ternary, dan setiap fitur baru menggandakan pekerjaan. Kami sudah membahas kegagalan ini di cara melokalisasi aplikasi buatan AI. Beginilah utang i18n menumpuk: terjemahan tanpa internasionalisasi.
Apa cara terbaik melokalisasi aplikasi buatan Claude Code?
Jalankan alur lokalisasi di dalam agen yang membuat aplikasinya: Skill mengajarkan Claude Code prosedur internasionalisasi, dan infrastruktur menangani terjemahan serta sinkronisasi setelah setiap push. Skill adalah format ekstensi resmi untuk Claude Code dari Anthropic, berupa folder berisi instruksi yang dimuat agen saat tugas sesuai, seperti dijelaskan di dokumentasi Agent Skills. Skill juga portabel: skills CLI dari Vercel yang open source memasang paket Skill ke Claude Code, Cursor, Codex, dan puluhan agen lain, sehingga alur kerja yang sama ikut ke agen apa pun yang kamu pakai.
Bentuknya berbeda dari kebanyakan tool lokalisasi. Platform mapan menambahkan fitur AI dan konektor agen di atas alur kerja yang tetap berpusat pada dashboard mereka: teksmu tersimpan di sistem mereka, dan agen hanya menjadi klien. Lokalisasi berbasis agen membalik pola itu. Pekerjaan terjadi di repositorimu, agen menangani internasionalisasi, dan globalize.now menangani terjemahan dan sinkronisasi. Tidak ada database konten terpisah yang harus diselaraskan dengan kodemu, karena kodenya sendiri adalah database.
Bagaimana langkah demi langkah melokalisasi aplikasi Claude Code?
Alur lengkapnya lima langkah, dan agen mengerjakan bagian yang paling berat.
-
Hubungkan repositori di globalize.now. Konversi berjalan sekali, di dalam aplikasi, dan masuk sebagai pull request. Untuk menjalankan tahap pertama itu dari Claude Code, pasang Skill-nya:
npx skills add globalize-now/globalize-skillsTambahkan
--allkalau kamu ingin Skill tersedia untuk semua agen di mesinmu, bukan hanya Claude Code. -
Minta Claude Code menginternasionalisasi aplikasi. Skill membuat agen memeriksa repo lebih dulu: framework apa yang dipakai, teks mana yang tampil ke pengguna, dan apakah sudah ada setup i18n. Agen mengajukan rencana berisi library, struktur kunci, dan susunan file bahasa, lalu menunggu persetujuanmu sebelum menyentuh kode.
-
Hubungkan repositori ke globalize.now agar setiap push memicu terjemahan. Setup untuk developer hanya satu koneksi, dan builder yang bekerja dengan tool AI mendapat alur yang sama tanpa perlu menyentuh terminal selain di langkah 1.
-
Push. Teks baru dan teks yang berubah kembali dalam bentuk terjemahan, sebagai pull request yang kamu tinjau seperti perubahan kode lainnya.
-
Merge. Menambah bahasa baru nanti cukup dengan mengubah konfigurasi, bukan proyek baru.
Pada monorepo produksi sungguhan, satu sesi agen dengan alur kerja ini menginternasionalisasi codebase dan menghasilkan lima bahasa dalam sekitar 30 menit. Waktunya bergantung pada ukuran proyek, tetapi langkah 2 adalah bagian ketika refactor manual yang memakan waktu seminggu berubah menjadi satu sesi agen.
Apa saja yang sebenarnya diubah agen di kodemu?
Agen mengubah teks literal menjadi pemanggilan terjemahan dan menghasilkan file bahasa yang dibutuhkan runtime. Konkretnya: agen memilih atau mendeteksi runtime library i18n (i18next, next-intl, atau Lingui, sesuai stack-mu), mengganti teks JSX yang di-hardcode dengan pemanggilan t() atau komponen pesan, membuat kunci dengan nama yang wajar, dan menulis file bahasa untuk bahasa sumber. Plural memakai bentuk ICU yang benar, bukan count + " items".
globalize.now tidak menggantikan runtime library, dan tidak menerjemahkan dengan menyerahkan pekerjaan ke antrean eksternal. globalize.now berada satu lapisan di atasnya: infrastruktur yang menghasilkan dan memelihara kunci serta file bahasa yang dipakai runtime-mu. Kalau i18next atau next-intl sudah terpasang, Skill mempertahankan kunci dan struktur yang ada, lalu melanjutkan dari titik tempat kamu berada.
Apa yang terjadi pada git push berikutnya?
Setiap push setelah setup memicu terjemahan untuk apa pun yang berubah, dan bahasa yang diperbarui masuk sebagai pull request. Tanpa langkah ekspor, tanpa langkah impor, tanpa antrean di tool terpisah. Peninjauan terjadi di tempat engineer biasa meninjau: di diff.
Itulah seluruh model operasinya. Siapkan sekali, sinkronisasi otomatis di setiap git push, tanpa intervensi manual. Masalah khas aplikasi buatan AI, yaitu agen merilis fitur lebih cepat daripada proses lokalisasi mana pun bisa mengejar, tidak relevan lagi, karena proses lokalisasi menempel pada push yang sama dengan rilis fiturnya.
Apakah ini butuh server MCP atau dashboard?
Tidak. MCP menghubungkan agen ke platform eksternal, sedangkan Skill mengajarkan agen mengerjakan tugas di tempat kode berada. Beberapa produk lokalisasi kini menawarkan server MCP, dan itu peningkatan nyata dibanding copy-paste ke editor web, tetapi teks beserta statusnya tetap tersimpan di platform di ujung koneksi itu, dan kamu tetap harus merekonsiliasi keduanya.
Dengan alur Skill plus push, tidak ada yang perlu direkonsiliasi. File bahasa tersimpan di Git, terjemahan masuk sebagai commit, dan rollback cukup git revert. Kami menulis tentang mengapa pola ini makin meluas di Skill Claude Code menjadi standar lokalisasi. Kedua pendekatan lebih baik daripada era dashboard; bedanya ada pada letak sumber kebenaranmu.
Berapa biaya melokalisasi aplikasi Claude Code?
Paket Starter globalize.now seharga €20 per bulan dan sudah termasuk kredit terjemahan €20 setiap bulan. Pemakaian di atas itu ditagihkan dari saldo kreditmu dengan harga provider ditambah markup. Tidak ada biaya per seat, per bahasa, atau per proyek. Paket Team seharga €249 per bulan menambahkan peran dan Gate persetujuan, pemeriksaan AI Source, pratinjau Story, dan auto-join domain email.
Saat mendaftar, kamu mendapat kredit terjemahan €5 tanpa kartu. Cukup untuk mencoba seluruh alur di aplikasi nyata sebelum membayar apa pun.
Aplikasimu sudah jadi. Lokalisasinya tinggal satu instalasi Skill dan satu push.
globalize.now mengubah teks hardcode di aplikasimu menjadi file locale yang siap diterjemahkan, lalu menjaganya tetap diperbarui setiap kali kamu rilis.
Coba globalize.now gratis