Parim viis Claude Code'i loodud rakenduse lokaliseerimiseks on jääda Claude Code'i: installige lokaliseerimise skill, laske agendil koodibaas rahvusvahelistada ja laske taristul sealt edasi kõik keeled sünkroonis hoida. globalize.now on tehisintellektil põhinev lokaliseerimistaristu, mis on loodud täpselt selle töövoo jaoks. See eraldab hardcoded string'id tõlkevõtmeteks, genereerib lokaalifailid ja tagastab tõlgitud keeled iga git push'i järel pull request'idena. Selles juhendis käime läbi kogu protsessi – ingliskeelsest hoidlast kuni ühendatud mitmekeelse PR-ini.

Miks on teie Claude Code'i rakendus ainult inglise keeles?

Sest Claude Code, nagu iga koodiagent, kirjutab kasutajale kuvatava teksti sõnasõnaliste string'idena. See on töötava funktsiooni saavutamiseks lühim tee ning vaikimisi prompt ei palu tõlkevõtmeid. Selleks ajaks, kui rakendus töötab, on inglise keel sadades komponentides hardcoded ning mitmus ja kuupäevad on lahendatud string'ide liitmisega, mis toimib ainult ühes keeles.

Ahvatlev lahendus on paluda agendil „tõlkida rakendus saksa keelde“. Tulemuseks on teine hardcoded keel: dubleeritud komponendid või hulk ternary-operaatoreid, kusjuures iga järgmine funktsioon kahekordistab töömahtu. Käsitlesime seda tõrkemustrit artiklis kuidas lokaliseerida tehisintellekti loodud rakendust. Rahvusvahelistamiseta tõlkimine ongi viis, kuidas i18n-võlg kuhjub.

Milline on parim viis Claude Code'i loodud rakenduse lokaliseerimiseks?

Käivitage lokaliseerimise töövoog samas agendis, millega rakendus loodi: skill õpetab Claude Code'ile rahvusvahelistamise protseduuri ning taristu tegeleb pärast iga push'i tõlkimise ja sünkroonimisega. Skill'id on Anthropic'u toetatud laiendusvorming Claude Code'i jaoks – juhiste kaustad, mille agent laadib, kui ülesanne neile vastab, nagu on kirjeldatud Agent Skillsi dokumentatsioonis. Need on ka kaasaskantavad: Verceli avatud skills CLI installib skill'i paketid Claude Code'i, Cursori, Codexi ja kümnete teiste agentide jaoks, nii et sama töövoog liigub teiega kaasa olenemata kasutatavast agendist.

See erineb enamiku lokaliseerimistööriistade ülesehitusest. Väljakujunenud platvormid on lisanud AI-funktsioonid ja agentide ühendused töövoole, mille keskmes on endiselt nende juhtpaneel: teie string'id asuvad nende süsteemis ja agent on selle klient. Agendipõhine lokaliseerimine pöörab selle ümber. Töö toimub teie hoidlas, agent tegeleb rahvusvahelistamisega ning globalize.now tõlkimise ja sünkroonimisega. Eraldi sisuandmebaasi, mida koodiga kooskõlas hoida, pole vaja, sest andmebaasiks on kood ise.

Kuidas Claude Code'i rakendust samm-sammult lokaliseerida?

Kogu töövoog koosneb viiest sammust, millest kõige mahukama teeb agent.

  1. Ühendage hoidla globalize.now-ga. Teisendus käivitatakse rakenduses ühe korra ja tulemuseks on pull request. Kui soovite esimese läbimise käivitada hoopis Claude Code'ist, installige skill'id:

    npx skills add globalize-now/globalize-skills

    Lisage --all, kui soovite, et skill'id oleksid saadaval kõigile teie arvutis töötavatele agentidele, mitte ainult Claude Code'ile.

  2. Paluge Claude Code'il rakendus rahvusvahelistada. Skill paneb selle esmalt hoidlat uurima: millist raamistikku kasutatakse, millised string'id on kasutajale nähtavad ja kas i18n seadistus on juba olemas. See pakub välja plaani, teegi, võtmete struktuuri ja lokaalifailide paigutuse ning ootab enne koodi muutmist teie heakskiitu.

  3. Ühendage hoidla globalize.now-ga, et push'id käivitaksid tõlkimise. Arendaja seadistus nõuab üht ühendamist ning AI-tööriistades töötavad loojad saavad sama töövoo ilma terminali kasutamata, välja arvatud esimeses etapis.

  4. Tehke push. Uued ja muudetud string'id tulevad tagasi tõlgituna pull request'ina, mille vaatate üle nagu iga teise koodimuudatuse.

  5. Ühendage muudatus. Hiljem uue keele lisamine on konfiguratsioonimuudatus, mitte eraldi projekt.

Ühes päris tootmises kasutatavas monorepos rahvusvahelistas selle töövoo kaudu käivitatud agent koodibaasi ja lõi umbes 30 minutiga viis keelt. Teie ajakulu sõltub projekti suurusest, kuid just 2. samm on koht, kus nädalane käsitsi refaktoreerimine kahaneb üheks agendisessiooniks.

Mida agent teie koodis tegelikult muudab?

See teisendab sõnasõnalised string'id tõlkekutseteks ja genereerib lokaalifailid, mida runtime vajab. Täpsemalt: see valib või tuvastab teie tehnoloogiapinu põhjal i18n runtime'i teegi (i18next, next-intl või Lingui), asendab hardcoded JSX-teksti t() kutsete või sõnumikomponentidega, genereerib mõistlike nimedega võtmed ja kirjutab lähtekeele lokaalifaili. Mitmused saavad count + " items" asemel õiged ICU-vormid.

globalize.now ei asenda runtime'i teeki ega tõlgi teksti mõnda välisesse järjekorda edasi andes. See paikneb ühe kihi võrra kõrgemal: taristu, mis genereerib ja haldab võtmeid ning lokaalifaile, mida teie runtime kasutab. Kui i18next või next-intl on teil juba ühendatud, säilitab skill olemasolevad võtmed ja struktuuri ning jätkab sealt, kus pooleli jäite.

Mis juhtub järgmisel git push'il?

Pärast seadistamist käivitab iga push kõigi muutunud osade tõlkimise ning uuendatud keeled saabuvad pull request'ina. Pole ekspordietappi, impordietappi ega eraldi tööriista järjekorda. Ülevaatus toimub seal, kus insenerid niigi muudatusi üle vaatavad: diff'is.

See ongi kogu tööpõhimõte. Seadistage üks kord, sünkroonige automaatselt iga git push'i järel ja käsitsi sekkumist pole vaja. AI abil loodud rakenduste tüüpiline probleem – agent tarnib funktsioone kiiremini, kui ükski lokaliseerimisprotsess järele jõuab – muutub ebaoluliseks, sest lokaliseerimisprotsess on seotud sama push'iga, millega funktsioon välja läheb.

Kas selleks on vaja MCP-serverit või juhtpaneeli?

Ei. MCP ühendab agendi välise platvormiga, skill õpetab agendile, kuidas teha töö ära seal, kus kood asub. Mitmed lokaliseerimistooted pakuvad nüüd MCP-servereid, mis on veebiredaktorisse kopeerimisest tõesti parem lahendus, kuid string'id ja nende olek asuvad endiselt ühenduse teises otsas oleval platvormil ning teie peate need kaks süsteemi ikkagi kooskõlla viima.

Skill'i ja push'i töövoos pole midagi, mida kooskõlla viia. Lokaalifailid asuvad git'is, tõlked saabuvad commit'idena ja tagasipööramine on git revert. Kirjutasime sellest, miks see muster levib, artiklis Claude Code'i skill'idest saab lokaliseerimise standard. Mõlemad lähenemised on juhtpaneelide ajastust paremad; erinevus seisneb selles, kus asub teie tõeallikas.

Kui palju maksab Claude Code'i rakenduse lokaliseerimine?

globalize.now maksab 20 € kuus tööruumi kohta ning sisaldab kuus 20 € väärtuses tõlkekrediiti (umbes 200 000 sõna); sellest suurema mahu puhul rakendub sama tähemärgipõhine tokenitasu. Üks pakett, tasemeid pole, kasutajakoha- ega keelepõhiseid tasusid pole. Keeled on piiramatud, sealhulgas RTL-keeled. Tüüpiline SaaS, millel on umbes 10 000 tõlkevõtit viies lokaalis, mahub hõlpsasti kaasatud mahu sisse.

Registreerumisel saate 5 € tõlkekrediiti ja kaarti pole vaja lisada – sellest piisab ligikaudu miljoni tähemärgi jaoks. Saate kogu töövoo päris rakenduses enne millegi eest maksmist läbi proovida.

Teie rakendus on juba valmis. Selle lokaliseerimiseks on vaja vaid ühe skill'i installimist ja üht push'i.

globalize.now muudab rakenduse koodis olevad tekstid tõlkeks valmis lokaale failideks ja hoiab neid ajakohasena, kui sa uusi versioone välja lasid.

Proovi globalize.now tasuta