현지화를 위한 Claude Code Skill

npx skills add globalize-now/globalize-skills 한 줄이면 Claude Code Skill이 설치돼요. 하드코딩된 문자열을 추출하고 로케일 파일을 생성하며, Git 푸시마다 번역을 동기화해요. 대시보드도, 수동 검수도 필요 없어요.

Claude Code는 파일을 자율적으로 수정하는 에이전트형 코딩 도구예요. globalize.now는 이 워크플로에 자연스럽게 들어맞아요. 명령 하나로 에이전트가 문자열을 추출하고 로케일 파일을 생성하면, Claude Code가 변경 사항을 커밋해요. 이후 Git 푸시마다 번역이 동기화되고, 수동 작업은 없어요.

사전 준비

  • Claude Code로 작업한 프로젝트(Next.js, React, Vue 등)
  • Git 저장소
  • Node.js 18 이상
  • 설치와 인증을 마친 Claude Code

Claude Code에서 globalize.now 설정하는 방법

  1. Claude Code 프로젝트 디렉터리 열기

    Claude Code가 수정 작업을 해 온 저장소로 cd 해서 이동하세요. 경로가 Git 루트와 일치해야 해요.

  2. Skill 설치 프로그램 실행하기

    globalize.now 앱에서 저장소를 연결해 변환하거나, 프로젝트 루트에서 Globalize Skill을 설치하세요. 에이전트가 i18n 구조를 잡고 리터럴을 스캔할 수 있어요.

    npx skills add globalize-now/globalize-skills --all
  3. 하드코딩된 UI 문자열 스캔하기

    globalize.now가 트리를 순회하면서 컴포넌트에 아직 박혀 있는, 사용자에게 보이는 영어 문자열을 목록으로 뽑아줘요.

  4. 제안된 번역 키 구조 확인하기

    리팩터링을 적용하기 전에 네임스페이스, 네이밍, 복수형 처리 방식을 검토하세요.

  5. 리팩터링과 로케일 파일 적용하기

    변경을 승인하면 컴포넌트가 런타임 헬퍼를 호출하고, JSON 카탈로그가 Git에 반영돼요.

  6. Claude Code로 커밋하고 푸시하기

    Claude Code가 머지 가능한 diff를 스테이징하고 커밋한 뒤 푸시해요. 이후 푸시부터는 자동 동기화가 계속돼요.

MCP로 연결하기 (선택)

Claude Code에서 Globalize를 직접 제어하고 싶나요? 코드가 i18n에 맞게 준비되면 MCP를 연결하세요.

claude mcp add --transport http globalize https://api.globalize.now/mcp

더 알아보기: MCP 연결하기

자주 겪는 문제

Claude Code와 globalize.now가 같은 컴포넌트를 동시에 수정하려 해요

해결 방법: globalize.now를 먼저 실행해 키와 로케일 파일을 만들어 두세요. 그 이후에는 Claude Code가 하드코딩된 리터럴을 다시 넣지 않고 번역 항목을 다루게 돼요.

Claude Code가 새 문자열을 추가하면 추출을 어떻게 다시 실행하나요?

해결 방법: globalize.now는 Git 푸시마다 자동으로 실행돼요. 수정할 때마다 설치 프로그램을 다시 실행하지 않아도 새 리터럴이 감지돼요.

자주 묻는 질문

globalize.now는 Claude Code에서도 동작하나요?

네. globalize.now는 에이전트 Skill과 저장소에서 실행하는 CLI로 제공돼요. Claude Code가 같은 명령을 실행하고 결과 diff를 커밋할 수 있어요. Git 기반 통합이라서, 로케일 파일이 생기고 나면 푸시할 때마다 번역이 맞춰져요. 에디터와 버전 관리 밖에 별도 대시보드는 필요 없어요.

Claude Code가 globalize.now를 인식하도록 따로 설정해야 하나요?

npx skills add globalize-now/globalize-skills만 실행하면 세션을 진행하는 에이전트가 Skill을 쓸 수 있어요. 이 초기 설정 외에 Claude Code 전용 플러그인은 없어요. 설치한 뒤에는 다른 AI 코딩 환경에서 쓰는 것과 같은 현지화 프롬프트로 Claude Code에 요청하세요.

Claude Code와 globalize.now가 같은 Git 워크플로를 공유할 수 있나요?

하나의 저장소 히스토리를 공유하는 것이 좋아요. globalize.now가 키와 로케일 JSON을 작성하고, Claude Code는 그 파일이 이미 들어 있는 브랜치에서 기능 작업을 이어가요. 평소처럼 PR로 머지하면 리뷰어가 제품 코드와 번역 변경을 한 번에 볼 수 있어요. 이후 globalize.now가 푸시를 감시하면서 다른 로케일을 최신 상태로 유지해요.

Claude Code가 하드코딩된 텍스트가 있는 새 UI를 만들면 어떻게 되나요?

다음 Git 푸시에서 globalize.now가 새 리터럴을 diff로 찾아내 키를 제안하고 카탈로그를 자동으로 업데이트해요. 영어 JSX와 로케일 파일이 어긋나는 일을 막아줘요. PR 리뷰는 그대로 하지만, 기능 브랜치마다 번들을 수동으로 내보내거나 일회성 스크립트를 다시 돌릴 필요는 없어요.

globalize.now가 Claude Code의 코드베이스 수정을 방해하나요?

아니요. 첫 추출이 끝난 뒤에도 Claude Code는 컴포넌트에 그대로 접근할 수 있어요. 컴포넌트가 원문 문자열 대신 번역 헬퍼를 참조할 뿐이에요. globalize.now는 파일을 잠그지 않고, 에디터 워크플로를 바꾸라고 요구하지도 않아요. 커밋이 Git을 거치는 한 두 도구는 문제없이 함께 동작해요. Claude Code 프로젝트는 원래 그렇게 배포하고요.

Claude Code와 globalize.now를 함께 쓰면 어떤 저장소에 가장 도움이 되나요?

UI 텍스트가 아직 코드에 인라인으로 들어 있는, AI가 수정한 JavaScript·TypeScript 앱에 가장 효과가 커요. 에이전트가 화면을 빠르게 만들어내면, globalize.now가 그 속도를 전면 재작성 없이 구조화된 i18n으로 바꿔줘요. 이미 모든 문자열을 로케일 파일에 두었다면 추출할 게 적겠지만, 대부분의 Claude Code 프로토타입은 globalize.now가 자동화하는 첫 번째 작업이 필요해요.

Claude Code에서 globalize.now 사용해 보기

프로젝트 루트에서 시작하세요:

npx skills add globalize-now/globalize-skills --all

제품 소개와 요금은 홈페이지에서 확인하세요

다른 통합

무료로 시작하기