대부분의 코드베이스는 현지화를 염두에 두고 만들어지지 않았어요.
저장소를 연결하면 globalize.now가 하드코딩된 문자열을 모두 찾아 구조화된 i18n 아키텍처로 자동 변환해요. 앱에서 실행해도 되고, 코딩 에이전트로 실행해도 돼요.
React, Next.js, Vue 등 최신 프론트엔드 프레임워크를 지원해요.
Cursor나 Lovable로 개발 중인가요? AI로 만든 앱 가이드를 확인해 보세요.
적용 전
<button>Submit order</button>적용 후
<button> {t("checkout.submit_order")} </button>locales/ en.json fr.json es.json
globalize.now는 하드코딩된 UI 문자열을 어떻게 i18n 키로 바꾸나요?
React, Next.js, Vue 등 최신 프론트엔드 프레임워크를 지원해요. 앱에서 저장소를 연결하면 스캔이 알아서 이어지고, 코딩 에이전트에서 직접 실행할 수도 있어요.
저장소 스캔 중...
✓ 하드코딩된 UI 문자열 감지
✓ 번역 키 생성
✓ 로케일 파일 생성
✓ 용어집 생성
이제 앱을 현지화할 준비가 됐어요.
앱에서는 복제본으로 작업하므로 머지하기 전까지 브랜치는 그대로예요. 에이전트 방식은 내 컴퓨터에서 로컬로 실행돼요.
코딩 에이전트에서 실행하고 싶다면? 에이전트 방식 보기
MCP 연결하기
Globalize MCP를 Claude, Cursor 또는 다른 MCP 클라이언트에 연결해 에이전트에서 현지화를 실행하세요.
엔드포인트
https://api.globalize.now/mcpClaude Code
claude mcp add --transport http globalize https://api.globalize.now/mcpCursor: ~/.cursor/mcp.json에 추가
{"mcpServers":{"globalize":{"url":"https://api.globalize.now/mcp"}}}Claude(웹, 데스크톱, 모바일): Claude의 Connectors 디렉터리에서 globalize.now를 추가하세요. 다른 MCP 클라이언트는 위 URL을 커스텀 커넥터로 추가하면 돼요. 둘 다 OAuth 로그인을 쓰므로 API 키는 필요 없어요.
MCP는 프로젝트, 번역, GitHub 동기화를 관리해요. 코드를 국제화하지는 않아요. 먼저 Skill을 실행하세요(시작하기 참고).
globalize.now가 저장소에서 실제로 바꾸는 것
globalize.now가 저장소를 분석해 실제 현지화 구조를 자동으로 만들어요.
적용 전
Submit order적용 후
{t("checkout.submit_order")}{
"checkout.submit_order": "Submit order"
}앱에서 실행하든 에이전트로 실행하든, 저장소에 적용되는 변경은 똑같아요.
- 컴포넌트에서 UI 문자열 추출
- 구조화된 번역 키 생성
- 로케일 파일 생성
- UI 문자열이 번역 키를 쓰도록 코드 수정
실제 코드베이스에서 현지화가 어려워지는 이유
대부분의 애플리케이션은 국제화 없이 시작해요. 시간이 지나면 UI 텍스트가 컴포넌트 안에 그대로 박혀 버려요.
현지화가 필요해질 때쯤이면 이런 상태예요.
- UI 문자열이 수백 개 파일에 흩어져 있어요
- 같은 문구가 인터페이스 곳곳에 중복돼 있어요
- 번역 키를 설계한 적이 없어요
- 로케일 구조가 아예 없어요
이 단계에서 i18n을 추가하려면 대개 UI의 상당 부분을 다시 써야 해요.
globalize.now가 생성하는 것
코드베이스에서 UI 문자열 추출
컴포넌트, 라우트, 템플릿에서 사용자에게 보이는 텍스트를 스캔해요.
globalize.now는 구조화된 번역 키를 어떻게 생성하나요?
UI 문자열을 네임스페이스가 있는 i18n 키로 변환해요.
globalize.now는 어떤 로케일 파일을 자동으로 생성하나요?
로케일 JSON 파일과 공용 용어집을 생성해요.
작동 방식
저장소 스캔
코드베이스를 분석해 사용자에게 보이는 UI 문자열을 찾아요.
UI 텍스트 정규화
UI 문자열을 일관된 번역 키로 변환해요.
현지화 파일 생성
로케일 JSON 파일과 공용 번역 용어집을 만들어요.
UI를 다시 쓰지 않고 코드베이스에 현지화를 추가하세요.
앱에 필요한 i18n 구조를 자동으로 생성해요.
€5 상당의 번역 크레딧으로 무료로 시작하세요. 더 큰 저장소와 팀을 위한 유료 요금제도 있어요.