Codex, Claude Code, Cursor가 프롬프트 한 번으로 번역한 앱을 배포하기 전에 일곱 가지를 확인하세요. 긴 문자열이 레이아웃에 들어가는지, 복수형이 언어별로 맞는지, 변수가 그대로 남아 있는지, 용어가 일관적인지, 원어민이 읽었을 때 어조가 자연스러운지, 모든 키가 모든 로케일에 있는지, 그리고 다음 기능이 번역되기는 하는지예요. globalize.now는 AI 기반 현지화 인프라예요. 원샷 번역 뒤에 생기는 문제는 대부분 기계적인 문제라서, 검사로 잡을 수 있어요.

첫 번역 자체는 대개 문제가 되지 않아요. 요즘 에이전트는 읽을 만한 번역을 금방 만들어요. 프롬프트 한 번에 빠져 있는 건 결과물을 검증하는 단계예요. 이 체크리스트가 바로 그 단계예요.

번역 후에도 텍스트가 레이아웃에 맞나요?

맞지 않는 경우가 많고, 가장 먼저 깨지는 건 버튼이에요. W3C의 번역 텍스트 크기 가이드에 따르면 원문 메시지가 짧을수록 번역 후 늘어나는 비율이 커져요. 두 단어짜리 버튼 라벨은 문단보다 상대적으로 훨씬 더 길어져요. 독일어 같은 언어의 복합 명사는 줄바꿈이 안 될 수 있고, 일부 문자는 라틴 문자보다 가로나 세로 공간이 더 필요하다는 점도 짚고 있어요.

JSON 파일의 문자열을 번역하는 에이전트는 화면을 볼 수 없어요. 그래서 "Save changes"가 이제 버튼을 가득 채운다는 사실을 알 수 없죠. 지원하는 로케일 중 번역문이 가장 긴 로케일로 앱을 실행해서 주요 플로우를 돌아보고, 잘린 텍스트, 줄바꿈된 버튼, 잘린 테이블 헤더를 찾아보세요. 오른쪽에서 왼쪽으로 쓰는 언어를 지원한다면 그중 하나로도 같은 점검을 하세요. 글자 방향은 오버플로 점검만으로는 잡히지 않아요. Lovable 앱을 위한 아랍어 및 RTL 가이드에서 다뤄요.

근본적인 해결책은 더 짧은 번역이 아니라 레이아웃이에요. 컨테이너가 늘어나게 하고, 텍스트에 고정 너비를 쓰지 말고, 공간에 맞추려고 줄여 쓰지 마세요. 이 부분은 코드 작업이니 에이전트에게 맡기세요.

복수형이 대상 언어에 맞나요?

일찍 확인하세요. 이 문제는 조용히 실패해요. Unicode CLDR은 복수형 범주를 zero, one, two, few, many, other 여섯 가지로 정의해요. 영어는 one과 other만 써요. 러시아어는 one, few, many, other를 쓰고, 웨일스어는 여섯 개를 모두 써요. i18next 문서에서도 아랍어가 여섯 개의 복수형 키를 모두 쓰는 것을 볼 수 있어요.

에이전트가 영어의 두 키를 러시아어나 아랍어 파일에 그대로 복사하면, 카탈로그는 파싱도 되고 렌더링도 돼요. 하지만 파일에 없는 범주가 필요한 숫자에서는 모두 잘못된 형태가 표시돼요. 에러는 나지 않아요. i18next에서는 변수 이름이 정확히 count여야 하고, 없으면 일반 키로 폴백하지 않는다고 문서에 명시돼 있어요. 에이전트가 컴포넌트에서 count === 1 ? 'item' : 'items'를 쓰면 번역을 시작하기도 전에 같은 버그가 생겨요. 문법 쪽은 ICU MessageFormat이 무엇이고 왜 AI가 만든 앱에서 자주 문제가 되는지에서 다뤄요.

확인 방법은 기계적이에요. 로케일마다 복수형 키를 그 언어가 요구하는 범주와 비교하면 돼요.

보간 변수가 그대로 남아 있나요?

항상 그렇지는 않고, 스크립트로 확인할 수 있어요. {{name}}나 {count} 같은 보간 변수는 모든 번역에 원문 그대로 들어 있어야 해요. 긴 파일을 번역하는 에이전트는 가끔 변수 이름을 바꿔 쓰거나, 변수가 없는 편이 문장이 더 자연스럽다고 보고 변수를 빼거나, 태그 안의 내용을 번역하기도 해요. 그러면 빈칸이 나오거나, 중괄호가 그대로 노출되거나, 앱이 크래시돼요.

번역된 각 문자열의 변수 집합을 원문 문자열과 비교하세요. 아래 짧은 Node 스크립트가 이를 수행하고, 영어에는 있지만 다른 로케일에는 없는 키도 알려줘요.

import fs from "node:fs";

const [src, ...targets] = process.argv.slice(2);
const read = (f) => JSON.parse(fs.readFileSync(f, "utf8"));
const vars = (s) =>
  [...String(s).matchAll(/\{\{?\s*[\w.]+\s*\}?\}/g)].map((m) => m[0]).sort().join(",");

const base = read(src);
let problems = 0;
for (const file of targets) {
  const loc = read(file);
  for (const [key, text] of Object.entries(base)) {
    if (!(key in loc)) { console.log(file, "missing", key); problems++; continue; }
    if (typeof text === "string" && vars(text) !== vars(loc[key])) {
      console.log(file, "variable mismatch", key); problems++;
    }
  }
}
process.exit(problems ? 1 : 0);

CI에서 node check-locales.mjs locales/en.json locales/de.json locales/ru.json로 실행하세요. 키가 한 단계인 파일을 가정한 스크립트라서, 카탈로그가 중첩 구조라면 루프를 맞게 수정하세요.

용어가 일관적인가요?

한 번의 응답 안에서는 일관적이지만, 여러 번에 걸치면 흔들려요. 큰 앱의 번역이 여러 파일, 세션, 배치로 나뉘면 "workspace", "project", 제품 이름이 매번 같은 방식으로 번역된다는 보장이 없어요. 버튼에는 이렇게 쓰여 있는데 도움말 페이지에는 다르게 쓰여 있는 상황이 생겨요.

용어는 한 번만 정리해 두세요. 제품명, 기능명, 번역하면 안 되는 단어를 담은 용어집을 만들고, 번역 단계에서 이를 읽게 하세요. globalize.now는 코드베이스를 변환할 때 공유 용어집을 생성해서, 번역이 시작되기 전에 용어가 데이터로 존재해요. 도구가 없다면 에이전트 지침에서 참조하는 짧은 용어집 파일이 최소한의 방법이에요. 그 지침을 어디에 두는지는 AGENTS.md 규칙 글에서 볼 수 있어요.

원어민이 읽었을 때 자연스러운가요?

스크립트로는 할 수 없는 유일한 검사예요. 원샷 번역이 기계가 만든 것처럼 읽히는 지점은 말투, 격식, 대소문자예요. 격식 수준이 어긋난 호칭, 지시처럼 들리는 명령형 버튼, 대문자로 쓰면 소리치는 것처럼 읽히는 언어의 대문자 제목 같은 경우가 그래요.

모든 문자열을 검수할 필요는 없어요. 지원하는 언어 계열마다 한 언어를 골라서, 원어민이 첫 실행 화면, 결제나 가입 플로우, 에러 메시지를 읽게 하세요. 어조 때문에 사용자를 잃는 화면이 바로 이런 화면이에요. 원어민의 수정 사항은 용어집에 기록해서 다음 번역이 그 내용에서 시작하게 하세요.

모든 키가 존재하고, 모든 문자열이 카탈로그에 들어갔나요?

서로 다른 두 가지 누락이 화면에서는 똑같아 보여요. 하나는 키가 영어에는 있지만 특정 로케일에 없는 경우로, 위 스크립트가 잡아내요. 다른 하나는 문자열이 컴포넌트에 하드코딩되어 카탈로그에 아예 들어가지 않은 경우예요. 이 경우에는 번역이 닿을 수가 없어요. 에이전트는 화면에 보이는 텍스트보다 속성, 토스트, 에러 메시지에 두 번째 유형을 더 자주 남겨요. 이 패턴과 이를 잡아내는 린트 규칙은 에이전트가 하드코딩된 문자열을 계속 추가하는 이유에서 다뤄요.

앱을 영어가 아닌 로케일로 바꾸고 직접 돌아보세요. 영어가 남아 있다면 누락된 키이거나 시스템에 한 번도 들어간 적 없는 문자열이에요. 두 경우는 해결 방법이 달라요.

다음 기능도 번역될까요?

번역이 코드 배포 과정에 포함되어 있을 때만 그래요. 프롬프트 한 번으로는 통과할 수 없는 검사예요. 그 프롬프트는 그날 오후의 앱 상태를 번역했을 뿐이에요. 에이전트가 다음에 만드는 기능은 같은 파일에 영어로 추가되고, 로케일은 기능 하나씩 뒤처져요. 이런 문제가 쌓이는 과정은 번역 파일이 동기화에서 벗어나는 이유에 나와 있어요.

원샷 방식과 파이프라인이 갈리는 지점이 여기예요. 현지화를 개발 루프 앞단으로 옮기는 접근에서 그 주장을 풀어 설명하고, 실무적으로는 변환은 한 번만 하고 이후 변경은 만들어지는 곳에서 바로 번역한다는 뜻이에요. globalize.now에서는 앱에서 저장소를 연결하면 코드베이스가 한 번 변환되고, 이후에는 푸시 작업이 새 카탈로그 단위를 번역해요. 결과는 리뷰하고 머지할 수 있는 변경으로 전달돼요. 런타임 라이브러리와 카탈로그 포맷은 계속 여러분의 것으로 남아요. 이미 번역가가 있는 팀은 그 검수 단계를 그대로 유지하되, 그 단계가 영어로만 된 코드와 릴리스 사이의 유일한 안전장치는 아니게 돼요.

직접 스크립트로 운영하고 싶다면 최소한 위 스크립트를 CI에서 돌리고, 새 문자열은 반드시 카탈로그를 거치게 하는 규칙을 두세요. AI가 생성한 앱을 현지화하는 방법에서 전체 과정을 안내하고, Claude Code 가이드에서 이 에이전트를 구체적으로 다뤄요.

어디서부터 시작하면 될까요?

오늘 현재 로케일 파일에 스크립트를 실행해 보세요. 1분이면 끝나고, 구조가 탄탄한지 알 수 있어요. 그다음 가장 긴 로케일로 앱을 열고 첫 실행 플로우를 따라가 보세요. AI로 만든 앱을 배포했고, 변환과 번역, 이후 업데이트를 손으로 관리하는 대신 맡기고 싶다면 vibe coder 페이지에서 개요를, 개발자 레퍼런스에서 에이전트 설정을 볼 수 있어요. 요금은 별도 페이지에 있어요.

globalize.now는 하드코딩된 앱 문구를 번역할 수 있는 로케일 파일로 바꾸고, 배포할 때마다 최신 상태로 유지해요.

globalize.now 무료로 시작하기