Lingo.dev CLI는 단 하나의 구성 필드만으로 코드베이스를 로컬라이제이션 엔진에 연결합니다. 모든 lingo.dev run 호출은 엔진을 거쳐 처리되며, 브랜드 보이스, 용어집, 지침, 모델 구성이 자동으로 적용됩니다. 코드 변경도, 새 종속성도 필요 없습니다.
달라지는 점#
| 이전 | 이후 | |
|---|---|---|
| 번역 파이프라인 | 기본 Lingo.dev 파이프라인 | 사용자 로컬라이제이션 엔진 |
| 브랜드 보이스 | 없음 | 대상 로캘별로 적용 |
| 용어집 | 없음 | 요청마다 의미 기반으로 매칭 |
| 지침 | 없음 | 대상 로캘별로 포함 |
| 모델 선택 | Lingo.dev 기본값 | 폴백이 포함된 사용자 모델 구성 |
| 품질 AI 평가 | 없음 | 설정된 AI 평가자가 자동으로 실행 |
설정#
1
i18n.json에 engineId 추가하기(선택 사항)
특정 엔진을 대상으로 하려면 i18n.json 구성에 engineId 필드를 추가하세요. 엔진 ID는 대시보드에서 확인할 수 있으며 eng_로 시작합니다(예: eng_SxjMwMsfOIsvV1wh).
json
{
"version": "1.15",
"locale": {
"source": "en",
"targets": ["es", "fr", "de"]
},
"buckets": {
"json": {
"include": ["[locale]/messages.json"]
}
},
"engineId": "eng_SxjMwMsfOIsvV1wh"
}나머지 구성은 모두 그대로 유지됩니다. 소스 로캘, 대상, 버킷도 동일합니다. engineId를 생략하면 CLI는 조직의 기본 엔진을 사용합니다.
2
API 키 설정하기
CLI는 Lingo.dev API 키로 인증합니다. 환경 변수로 설정하세요:
bash
export LINGO_API_KEY="your-api-key"또는 ~/.lingodotdevrc에 저장해 계속 사용할 수도 있습니다:
ini
[auth.vnext]
apiKey = your-api-key대시보드의 API Keys 페이지에서 API 키를 생성하세요.
3
번역 실행하기
bash
lingo.dev runCLI는 번역 요청을 엔진으로 보내고 결과를 로캘 파일에 다시 기록합니다. 이 과정에서 브랜드 보이스, 용어집, 지침, 모델 구성이 자동으로 적용됩니다.
구성 레퍼런스#
i18n.json#
| 필드 | 설명 |
|---|---|
engineId | 선택 사항입니다. 엔진 ID(eng_...)입니다. 생략하면 조직의 기본 엔진이 사용됩니다. |
그 외 모든 i18n.json 필드(version, locale, buckets)는 표준 CLI 구성과 동일하게 동작합니다.
환경 변수#
| 변수 | 필수 | 기본값 | 설명 |
|---|---|---|---|
LINGO_API_KEY | 예 | - | Lingo.dev API 키 |
LINGO_API_URL | 아니요 | https://api.lingo.dev | 커스텀 API 기본 URL(셀프 호스팅 또는 스테이징용) |
미리 알아둘 점#
CLI가 생성하는 모든 번역은 엔진의 전체 파이프라인을 거칩니다:
- 브랜드 보이스가 로캘별 톤과 격식을 조정합니다
- 용어집 항목이 의미 기반 매칭으로 정확한 용어를 적용합니다
- 지침이 로캘별 언어 규칙을 적용합니다
- 모델 구성이 자동 폴백과 함께 적합한 LLM을 선택합니다
- AI 평가자가 각 요청 후 품질을 자동으로 평가합니다
번역은 Reports에서 트리거 유형 api로 표시되며, API와 통합에서 들어온 요청과 함께 확인할 수 있습니다.
