Geriausias būdas lokalizuoti Claude Code sugeneruotą programėlę — likti Claude Code aplinkoje: įdiekite lokalizavimo skill’ą, leiskite agentui internacionalizuoti kodų bazę, o tada infrastruktūrai sinchronizuoti visas kalbas. globalize.now yra DI pagrįsta lokalizavimo infrastruktūra, sukurta būtent šiam ciklui. Ji išskiria kietai įrašytas eilutes į vertimo raktus, sugeneruoja lokalės failus ir po kiekvieno git push’o grąžina išverstas kalbas kaip pull request’us. Šiame vadove apžvelgiamas visas procesas — nuo tik anglų kalba veikiančios saugyklos iki sulieto daugiakalbio PR.

Kodėl jūsų Claude Code programėlė veikia tik anglų kalba?

Nes Claude Code, kaip ir kiekvienas kodavimo agentas, naudotojui skirtą tekstą rašo kaip literalines eilutes. Tai trumpiausias kelias iki veikiančios funkcijos, o numatytojoje užklausoje niekas neprašo vertimo raktų. Kai programėlė jau veikia, anglų kalba būna kietai įrašyta šimtuose komponentų, o daugiskaita ir datos tvarkomos jungiant eilutes taip, kad tai prasminga tik viena kalba.

Akivaizdus sprendimas — paprašyti agento „išversti programėlę į vokiečių kalbą“. Taip gaunama antra kietai įrašyta kalba: pasikartojantys komponentai arba ternarinių operatorių krūva, o kiekviena būsima funkcija padvigubina darbo kiekį. Šį nesėkmės scenarijų aptarėme straipsnyje kaip lokalizuoti DI sugeneruotą programėlę. Vertimas be internacionalizavimo — tai būdas kaupti i18n skolą.

Koks geriausias būdas lokalizuoti Claude Code sugeneruotą programėlę?

Lokalizavimo procesą vykdykite tame pačiame agente, kuris sukūrė programėlę: skill’as išmoko Claude Code internacionalizavimo procedūros, o infrastruktūra po kiekvieno push’o pasirūpina vertimu ir sinchronizavimu. Skill’ai yra oficialiai Anthropic palaikomas Claude Code plėtinių formatas — tai instrukcijų aplankai, kuriuos agentas įkelia, kai užduotis atitinka jų paskirtį, kaip aprašyta Agent Skills dokumentacijoje. Jie taip pat yra perkeliami: atvirasis Vercel skills CLI įdiegia skill’ų paketus į Claude Code, Cursor, Codex ir dešimtis kitų agentų, todėl ta pati darbo eiga keliauja kartu su bet kuriuo jūsų naudojamu agentu.

Tai kitoks požiūris nei daugumoje lokalizavimo įrankių. Įsitvirtinusios platformos pridėjo DI funkcijas ir agentų jungtis prie darbo eigos, kurios centre vis dar yra jų valdymo skydas: jūsų eilutės saugomos jų sistemoje, o agentas yra jos klientas. Agentams pritaikytas lokalizavimas šį modelį apverčia. Darbas vyksta jūsų saugykloje, agentas atlieka internacionalizavimą, o globalize.now pasirūpina vertimu ir sinchronizavimu. Nereikia atskiros turinio duomenų bazės, kurią reikėtų derinti su kodu, nes pats kodas yra duomenų bazė.

Kaip žingsnis po žingsnio lokalizuoti Claude Code programėlę?

Visą ciklą sudaro penki žingsniai, o sunkiausią iš jų atlieka agentas.

  1. Prijunkite saugyklą prie globalize.now. Konvertavimas vieną kartą atliekamas programėlėje ir pateikiamas kaip pull request’as. Jei pirmąjį etapą norite paleisti tiesiai iš Claude Code, įdiekite skill’us:

    npx skills add globalize-now/globalize-skills

    Pridėkite --all, jei norite, kad skill’ai būtų pasiekiami kiekvienam jūsų kompiuteryje veikiančiam agentui, ne tik Claude Code.

  2. Paprašykite Claude Code internacionalizuoti programėlę. Skill’as pirmiausia liepia agentui išanalizuoti saugyklą: kokia naudojama sistema, kurios eilutės matomos naudotojui ir ar jau yra i18n sąranka. Jis pasiūlo planą, biblioteką, raktų struktūrą ir lokalės failų išdėstymą, o prieš keisdamas kodą palaukia jūsų patvirtinimo.

  3. Prijunkite saugyklą prie globalize.now, kad push’ai paleistų vertimą. Kūrėjams skirta sąranka reikalauja vieno prijungimo, o DI įrankiais dirbantys kūrėjai gauna tą patį ciklą, nebereikėdami naudoti terminalo po pirmojo žingsnio.

  4. Atlikite push’ą. Naujos ir pakeistos eilutės grįš išverstos kaip pull request’as, kurį peržiūrėsite taip pat, kaip bet kurį kitą kodo pakeitimą.

  5. Suliekite. Vėliau pridėti kitą kalbą reiškia pakeisti konfigūraciją, o ne pradėti naują projektą.

Tikroje gamybinėje monorepo pagal šią darbo eigą paleistas agentas internacionalizavo kodų bazę ir per maždaug 30 minučių sugeneravo penkias kalbas. Jūsų trukmė priklausys nuo projekto dydžio, tačiau būtent antrajame žingsnyje savaitę rankinio pertvarkymo pakeičia viena agento sesija.

Ką agentas iš tikrųjų pakeičia jūsų kode?

Jis paverčia literalines eilutes vertimo iškvietimais ir sugeneruoja vykdymo aplinkai reikalingus lokalės failus. Konkrečiai: parenka arba aptinka i18n vykdymo biblioteką (i18next, next-intl arba Lingui, priklausomai nuo jūsų steko), pakeičia kietai įrašytą JSX tekstą į t() iškvietimus arba pranešimų komponentus, sugeneruoja prasmingai pavadintus raktus ir įrašo šaltinio kalbos lokalės failą. Daugiskaitos formos tampa tikromis ICU formomis, o ne count + " items".

globalize.now nepakeičia vykdymo bibliotekos ir neverčia perduodama užduoties į kokią nors išorinę eilę. Ji veikia vienu sluoksniu aukščiau: infrastruktūra, kuri generuoja ir prižiūri raktus bei lokalės failus, kuriuos naudoja jūsų vykdymo aplinka. Jei jau naudojate i18next arba next-intl, skill’as išsaugo esamus raktus ir struktūrą bei perima darbą nuo dabartinio taško.

Kas nutinka po kito git push’o?

Po sąrankos kiekvienas push’as paleidžia visko, kas pasikeitė, vertimą, o atnaujintos kalbos pateikiamos kaip pull request’as. Nereikia eksportuoti, importuoti ar laukti atskiro įrankio eilėje. Peržiūra vyksta ten, kur inžinieriai jau peržiūri pakeitimus — diff’e.

Toks yra visas veikimo modelis. Sąranką atliekate vieną kartą, o po kiekvieno git push’o vyksta automatinė sinchronizacija, be rankinio įsikišimo. DI sukurtų programėlių problema, kai agentas išleidžia funkcijas greičiau, nei spėja veikti bet koks lokalizavimo procesas, tampa nebesvarbi, nes lokalizavimo procesas prijungtas prie to paties push’o, su kuriuo išleidžiama funkcija.

Ar tam reikia MCP serverio arba valdymo skydo?

Ne. MCP prijungia agentą prie išorinės platformos, o skill’as išmoko agentą atlikti darbą ten, kur yra kodas. Kelios lokalizavimo platformos dabar siūlo MCP serverius — tai tikras patobulinimas, palyginti su kopijavimu į žiniatinklio redaktorių, tačiau eilutės ir jų būsena vis tiek lieka kitoje ryšio pusėje esančioje platformoje, todėl abi sistemas vis dar turite derinti.

Naudojant skill’o ir push’o ciklą nieko nereikia derinti. Lokalės failai saugomi git, vertimai ateina kaip commitai, o grąžinimas į ankstesnę būseną yra git revert. Apie tai, kodėl šis modelis plinta, rašėme straipsnyje Claude Code skill’ai tampa lokalizavimo standartu. Abu būdai yra geresni už valdymo skydų erą — skirtumas tik tas, kur yra jūsų vienintelis patikimas šaltinis.

Kiek kainuoja Claude Code programėlės lokalizavimas?

globalize.now kainuoja 20 € per mėnesį vienai darbo sričiai. Į kainą įeina 20 € vertimo kredito per mėnesį — maždaug 200 000 žodžių —, o viršijus šią ribą taikomas žetonais pagrįstas naudojimas pagal tą patį tarifą už simbolį. Vienas planas, be pakopų, mokesčių už vietas naudotojams ar kalbas. Neribotas kalbų skaičius, įskaitant RTL kalbas. Įprasta SaaS sistema, turinti apie 10 000 vertimo raktų penkiose lokalėse, patogiai telpa į įtrauktą kiekį.

Užsiregistravę gausite 5 € vertimo kredito ir nereikės kortelės — to pakanka maždaug milijonui simbolių. Galėsite paleisti visą ciklą tikroje programėlėje dar nieko nemokėdami.

Jūsų programėlė jau sukurta. Lokalizavimą skiria vos vienas skill’o įdiegimas ir vienas push’as.

globalize.now paverčia užkoduotą programos tekstą į vertimui paruoštus lokalės failus ir juos atnaujina, kai jūs diegiate naujus pakeitimus.

Išbandyti globalize.now nemokamai