l10n.dev 시작하기
l10n.dev는 개발자와 현지화 팀을 위해 구축된 AI 기반 현지화 플랫폼입니다. AI 에이전트, 터미널, CI 파이프라인 또는 웹 워크스페이스에서 i18n 파일을 키, 구조, 자리 표시자 및 복수형을 유지하면서 번역합니다. 이 페이지에서는 첫 번역 과정을 안내하고 설정 완료 후 플랫폼이 수행할 수 있는 작업을 보여줍니다.
무료 계정 만들기 및 매월 10,000자 무료 제공을 통해 AI 현지화 에이전트로 콘텐츠를 번역하세요.
시작하는 데 신용카드는 필요하지 않습니다!
웹 워크스페이스 외부의 모든 항목(AI 에이전트, 명령줄 인터페이스, GitHub 액션, 플러그인 및 API)은 API 키로 인증합니다. 다음 페이지에서 키를 생성하세요.API 키 페이지에서 키를 생성하고 안전한 곳에 보관하세요. 에이전트 구성, 명령줄 인터페이스 구성 또는 CI 보안 설정에 붙여넣게 됩니다. 언제든지 키를 취소하고 재발급할 수 있습니다.
l10n.dev를 사용하는 방법은 세 가지가 있습니다. 모두 동일한 번역 엔진, 문자 잔액, 용어집 및 언어 지침을 공유하므로 현재 워크플로우에 맞는 방식을 선택하고 나중에 혼합하여 사용하세요.
AI 에이전트를 MCP 서버에 연결하면 전문적인 현지화 도구로 변합니다. 에이전트가 직접 문자열을 번역하여 컨텍스트를 소모하고 실행 간에 결과가 달라지는 대신, l10n.dev를 전용 번역 엔진으로 호출하여 완성된 파일을 돌려받습니다. 마치 팀에 현지화 전문가가 있는 것과 같습니다.
- 토큰 효율성: 번역된 콘텐츠가 에이전트의 컨텍스트 윈도우를 통과하지 않으므로 코딩 어시스턴트가 코드 작업에 집중할 수 있습니다.
- 형식 보장: 키, 순서, 자리 표시자 및 복수형이 그대로 유지되므로 번역 후 깨진 JSON을 수정할 필요가 없습니다.
- 지속적인 메모리: 용어집과 언어 지침이 당사 측에 저장되므로 에이전트의 기억력에 의존하지 않고 일관된 품질을 유지합니다.
설정은 단일 명령어로 가능합니다. 다음은 Claude Code에 대한 예시입니다(Cursor, Windsurf, Copilot, Claude Desktop 및 Codex는 가이드에서 다룹니다).
claude mcp add --env L10N_API_KEY=your-api-key-here --transport stdio l10n -- npx -y ai-l10n-mcp그런 다음 에이전트에게 "src/i18n/en을 독일어와 일본어로 번역해 줘."라고 요청하기만 하면 됩니다. 에이전트가 프로젝트 구조를 감지하고 번역하여 파일을 작성합니다.
ai-l10n npm 패키지는 터미널과 CI/CD 파이프라인에 현지화 기능을 제공합니다. 개발 중에 수동으로 파일을 번역한 다음, 동일한 명령어를 워크플로우로 옮겨 새로운 문자열이 검토자에게 도달하기 전에 현지화되도록 하세요.
- 프로젝트 구조 감지: 소스 파일을 지정하면 기존 대상 언어를 자동으로 찾습니다.
- 기본 증분 번역: translateOnlyNewStrings를 사용하면 추가되거나 변경된 문자열만 전송되고 청구됩니다.
- 파이프라인 준비 완료: 로컬, GitHub 액션, GitLab CI 또는 Jenkins에서 동일하게 작동합니다.
패키지를 설치하고 API 키를 저장한 후 첫 번째 파일을 번역하세요:
npm install ai-l10n
npx ai-l10n config --api-key YOUR_API_KEY
# Auto-detects target languages from your project structure
npx ai-l10n translate ./locales/en.json --update
# Or name them explicitly
npx ai-l10n translate ./locales/en.json --languages es,fr,de --update푸시할 때마다 번역하려면 워크플로우에 GitHub 액션을 추가하세요:
name: Auto-translate i18n files
on:
push:
branches: [main]
paths: ['locales/en/**']
permissions:
contents: write
jobs:
translate:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: l10n-dev/ai-l10n@v1
with:
api-key: ${{ secrets.L10N_API_KEY }}
config-file: 'ai-l10n.config.json'
pull-request: false
워크스페이스는 서비스 결과물을 확인하는 가장 빠른 방법입니다. API 키나 설치가 필요하지 않습니다. 또한 파일, 용어집, 지침 및 잔액을 관리하는 곳이기도 합니다.
- JSON, YAML, PO, XLIFF, ARB, Markdown 또는 일반 텍스트 등 i18n 파일을 업로드하세요.
- 원본 언어와 하나 이상의 대상 언어를 선택하세요.
- 선택적으로 용어집과 언어 지침을 첨부하고 새로운 문자열만 번역하도록 설정하세요.
- 번역을 누르고 진행 상황을 확인한 뒤 결과를 다운로드하거나 리포지토리에 바로 복사하세요.
기본적으로 AI는 주변 키와 파일 구조를 컨텍스트로 파악합니다. 다음 두 가지 기능을 통해 제품의 용어와 브랜드 음성을 고정할 수 있으며, 이는 에이전트, 명령줄 인터페이스, 워크스페이스, API 등 모든 경로에 동일하게 적용됩니다.
용어집은 제품명, 기능명 및 도메인 특화 용어가 어떻게 번역되어야 하는지 지정합니다. 용어집 생성을 활성화하면 l10n.dev가 원본 및 번역된 콘텐츠에서 자동으로 용어집을 구축하고 해당 언어 쌍의 활성화된 용어집으로 저장하므로, 향후 모든 번역이 브랜드에 맞고 일관되게 유지됩니다. 직접 용어집을 가져오거나 AI로 생성할 수도 있습니다.
언어 지침은 AI에게 작성 방식을 알려줍니다. 격식 또는 비격식, 사용할 호칭, 브랜드 이름 처리 방법, 제품별 관례 또는 브랜드 음성을 정의하는 모든 내용을 설정하세요. 한 번 작성하면 해당 언어의 모든 번역에 적용됩니다.
경험칙: 단어가 무엇이 되어야 하는지는 용어집을 사용하고, 전체 텍스트가 어떻게 들려야 하는지는 언어 지침을 사용하세요.
콘텐츠별로 원본 문자열을 추적하므로 번역을 다시 실행해도 실제로 변경된 내용만 전송됩니다. 기존에 검토된 번역은 그대로 유지되고 Git diff는 작게 유지되며, 새로운 텍스트에 대해서만 비용이 청구됩니다. 콘텐츠를 저장하지 않으며 변경 사항을 감지하기 위해 해시 처리만 하므로 원본 문자열은 비공개로 유지됩니다.
인간 번역가를 찾기 어려운 언어를 포함하여 165개 언어로 번역하세요. JSON, YAML, PO, XLIFF, ARB, Markdown, 일반 텍스트 및 OpenAPI 사양은 ICU 메시지 및 전체 CLDR 복수형을 포함하여 기본적으로 처리됩니다.
모든 결과는 원본과 비교하여 검증됩니다. 자리 표시자, 키 또는 구조가 손실되면 해당 청크가 자동으로 재시도됩니다. 큰 파일은 컨텍스트를 유지하면서 청크로 분할되며, 여러 LLM을 운영하여 각 언어와 콘텐츠 유형에 가장 적합한 모델을 사용합니다.
현지화는 개발자만의 작업이 아닙니다. Figma, Obsidian용 플러그인, VS Code 확장 프로그램, NPM 패키지, MCP 및 문서화된 REST API 등 팀이 이미 사용하는 도구에 l10n.dev를 도입하세요.
번역 데이터를 저장하지 않습니다. 워크스페이스에서 파일을 번역할 때 사용자가 완전한 제어권을 가지며 언제든지 삭제할 수 있습니다.
조직에 격리된 인프라, 자체 데이터베이스 및 스토리지, 자체 모델 배포 또는 사용자 지정 규정 준수 보장이 필요한 경우 l10n.dev를 전용 인스턴스로 실행할 수 있습니다.
모든 계정은 매달 10,000개의 무료 문자를 제공받습니다. 요금이나 신용 카드 정보가 필요 없으며, 소규모 앱을 현지화하거나 약정 전에 품질을 평가하기에 충분합니다.
무료 월간 할당량보다 더 많은 양이 필요한 경우 패키지를 구매하여 문자 잔액을 늘릴 수 있습니다. 주문과 연결된 이메일 주소를 사용하여 로그인하고 혜택을 이용하세요.
사용 가능한 패키지:
- 100K Characters
가격: $4.90
100,000개의 문자를 번역합니다.* - 1M Characters
가격: $14.90
1,000,000개의 문자를 번역합니다.* - 5M Characters
가격: $39.90
5,000,000개의 문자를 번역합니다.*
*각 패키지는 90일 동안 유효하며, 만료 전에 다시 구매하면 사용하지 않은 잔액이 이월됩니다.
계획 중인 작업 방식에 맞는 다음 단계를 선택하거나, 파일을 직접 번역하여 결과를 확인해 보세요.
왜 l10n.dev를 선택해야 할까요?
l10n.dev는 AI의 강력한 기능과 사용자 친화적인 도구를 결합하여 현지화 프로세스를 간소화합니다. 개발자이든 현지화 팀의 일원이든, 당사의 플랫폼은 귀하의 필요에 맞춘 정확하고 효율적이며 합리적인 번역을 보장합니다.