Claude Code가 만든 앱을 현지화하는 가장 좋은 방법은 Claude Code 안에서 끝내는 거예요. 현지화 Skill을 설치하고, 에이전트가 코드베이스를 국제화하게 하고, 그 이후에는 인프라가 모든 언어를 동기화하게 두세요. globalize.now는 바로 이 흐름을 위해 만든 AI 기반 현지화 인프라예요. 하드코딩된 문자열을 번역 키로 추출하고 로케일 파일을 생성하며, git push마다 번역된 언어를 PR로 돌려줘요. 이 가이드에서는 영어 전용 저장소에서 머지된 다국어 PR까지 전체 과정을 안내해요.


내 Claude Code 앱은 왜 영어로만 되어 있을까요?

Claude Code도 다른 코딩 에이전트처럼 사용자에게 보이는 문구를 리터럴 문자열로 쓰기 때문이에요. 동작하는 기능을 가장 빨리 만드는 방법이고, 기본 프롬프트에는 번역 키를 요구하는 내용이 없어요. 앱이 동작할 즈음에는 수백 개 컴포넌트에 영어가 하드코딩되어 있고, 복수형과 날짜는 한 언어에서만 말이 되는 문자열 이어 붙이기로 처리돼 있어요.

“앱을 독일어로 번역해 줘”라고 요청하고 싶어지지만, 그러면 하드코딩된 두 번째 언어가 생겨요. 컴포넌트가 중복되거나 삼항 연산자가 쌓이고, 이후 기능을 추가할 때마다 작업량이 두 배가 돼요. 이 실패 패턴은 AI 생성 앱을 현지화하는 방법에서 다뤘어요. 국제화 없는 번역이 i18n 부채를 키우는 방식이에요.


Claude Code가 만든 앱을 현지화하는 가장 좋은 방법은 무엇인가요?

앱을 만든 에이전트 안에서 현지화 워크플로를 실행하세요. Skill이 Claude Code에게 국제화 절차를 가르치고, 번역과 동기화는 푸시할 때마다 인프라가 처리해요. Skill은 Anthropic이 Claude Code에 공식 지원하는 확장 형식으로, 작업이 맞을 때 에이전트가 불러오는 지침 폴더예요. 자세한 내용은 Agent Skills 문서에 나와 있어요. 이식성도 있어요. 오픈 소스 Vercel의 skills CLI가 Claude Code, Cursor, Codex 등 수십 가지 에이전트에 Skill 패키지를 설치해 주기 때문에, 어떤 에이전트를 쓰든 같은 워크플로를 그대로 쓸 수 있어요.

대부분의 현지화 도구와는 구조가 달라요. 기존 플랫폼은 대시보드 중심 워크플로 위에 AI 기능과 에이전트 커넥터를 얹었어요. 문자열은 그 시스템 안에 있고, 에이전트는 그 시스템의 클라이언트예요. 에이전트 네이티브 현지화는 이 구조를 뒤집어요. 작업은 저장소에서 일어나고, 국제화는 에이전트가, 번역과 동기화는 globalize.now가 맡아요. 코드가 곧 데이터베이스라서, 코드와 맞춰야 할 별도의 콘텐츠 데이터베이스가 없어요.


Claude Code 앱은 단계별로 어떻게 현지화하나요?

전체 흐름은 5단계이고, 가장 큰 작업은 에이전트가 해요.

  1. globalize.now에서 저장소를 연결하세요. 변환은 앱에서 한 번 실행되고 PR로 도착해요. 이 첫 작업을 Claude Code에서 실행하려면 Skill을 설치하세요.

    npx skills add globalize-now/globalize-skills
    

    Claude Code뿐 아니라 컴퓨터에 있는 모든 에이전트에서 Skill을 쓰려면 --all를 추가하세요.

  2. Claude Code에게 앱 국제화를 요청하세요. Skill은 먼저 저장소를 살펴보게 해요. 어떤 프레임워크인지, 어떤 문자열이 사용자에게 보이는지, 기존 i18n 설정이 있는지를 확인해요. 이어서 라이브러리, 키 구조, 로케일 파일 배치까지 계획을 제안하고, 코드를 건드리기 전에 승인을 기다려요.

  3. 저장소를 globalize.now에 연결하세요. 그러면 푸시가 번역을 트리거해요. 개발자 설정은 연결 한 번이면 끝나고, AI 도구로 작업하는 빌더도 1단계 이후에는 터미널을 쓰지 않고 같은 흐름을 쓸 수 있어요.

  4. 푸시하세요. 새 문자열과 바뀐 문자열이 번역되어, 다른 코드 변경과 똑같이 리뷰하는 PR로 돌아와요.

  5. 머지하세요. 나중에 언어를 추가하는 건 설정 변경이지, 별도 프로젝트가 아니에요.

실제 프로덕션 모노레포에서 이 워크플로로 에이전트를 실행한 결과, 코드베이스 국제화와 5개 언어 생성이 약 30분 만에 끝났어요. 프로젝트 규모에 따라 시간은 달라지지만, 일주일치 수동 리팩터링이 에이전트 세션 한 번으로 줄어드는 곳이 바로 2단계예요.


에이전트는 코드에서 실제로 무엇을 바꾸나요?

리터럴 문자열을 번역 호출로 바꾸고, 런타임에 필요한 로케일 파일을 생성해요. 구체적으로는 스택에 맞춰 i18n 런타임 라이브러리(i18next, next-intl, Lingui 중 하나)를 고르거나 감지하고, 하드코딩된 JSX 텍스트를 t() 호출이나 메시지 컴포넌트로 바꾸고, 알아보기 쉬운 이름으로 키를 생성한 뒤 원본 언어 로케일 파일을 작성해요. 복수형은 count + " items" 대신 제대로 된 ICU 형식으로 바뀌어요.

globalize.now는 런타임 라이브러리를 대체하지 않고, 외부 대기열로 넘겨서 번역하지도 않아요. 한 계층 위에서 동작해요. 런타임이 가져다 쓰는 키와 로케일 파일을 생성하고 관리하는 인프라예요. 이미 i18next나 next-intl이 연결되어 있다면 Skill은 기존 키와 구조를 그대로 두고 지금 상태에서 이어받아요.


다음 git push에서는 어떤 일이 일어나나요?

설정 이후 푸시할 때마다 바뀐 부분이 번역되고, 업데이트된 언어가 PR로 도착해요. 내보내기도, 가져오기도 없고, 별도 도구의 대기열도 없어요. 리뷰는 엔지니어가 원래 리뷰하던 곳, 바로 diff에서 이뤄져요.

운영 방식은 이게 전부예요. 한 번 설정하면 git push마다 자동으로 동기화되고, 수동 작업은 필요 없어요. 에이전트가 어떤 현지화 프로세스보다 빠르게 기능을 내보내는 AI 앱 특유의 문제도 사라져요. 현지화 프로세스가 기능을 배포하는 그 푸시에 붙어 있기 때문이에요.


이 작업에 MCP 서버나 대시보드가 필요한가요?

아니요. MCP는 에이전트를 외부 플랫폼에 연결하고, Skill은 코드가 있는 곳에서 일하도록 에이전트를 가르쳐요. 요즘은 MCP 서버를 제공하는 현지화 제품이 여럿 있고, 웹 에디터에 복사해 붙여 넣던 방식보다는 분명 나아졌어요. 하지만 문자열과 그 상태는 여전히 연결 반대편 플랫폼에 있어서, 양쪽을 계속 맞춰야 해요.

Skill과 푸시 루프를 쓰면 맞출 게 없어요. 로케일 파일은 git에 있고, 번역은 커밋으로 도착하고, 롤백은 git revert로 해결돼요. 이 패턴이 퍼지는 이유는 Claude Code Skill, 현지화의 표준이 되어 가다에 정리했어요. 두 방식 모두 대시보드 시대보다 낫지만, 기준이 되는 데이터가 어디에 있느냐가 달라요.


Claude Code 앱을 현지화하는 데 비용이 얼마나 드나요?

globalize.now의 Starter 요금제는 월 €20이고, 매달 번역 크레딧 €20가 포함돼요. 초과 사용분은 제공업체 원가에 마크업을 더해 크레딧 잔액에서 차감돼요. 사용자당, 언어당, 프로젝트당 요금은 없어요. 월 €249인 Team 요금제에는 역할 및 승인 Gate, AI Source 검사, Story 미리보기, 이메일 도메인 자동 가입이 추가돼요.

가입하면 카드 등록 없이 번역 크레딧 €5를 받아요. 비용을 내기 전에 실제 앱으로 전체 과정을 직접 써볼 수 있어요.

앱은 이미 완성됐어요. 현지화는 Skill 설치 한 번, 푸시 한 번이면 끝나요.

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

globalize.now 무료로 시작하기