Lingo.dev CLI는 프로젝트 config를 통해 코드베이스를 로컬라이제이션 엔진에 연결합니다. 모든 lingo push은 엔진을 거쳐 처리되며, 브랜드 보이스, 용어집, 규칙, 모델 구성이 자동으로 적용됩니다. 코드 변경도, 새로운 의존성도 필요 없습니다.
무엇이 달라지나요#
| 이전 | 이후 | |
|---|---|---|
| 번역 파이프라인 | Lingo.dev 기본 파이프라인 | 내 로컬라이제이션 엔진 |
| 브랜드 보이스 | 없음 | 대상 로캘별 적용 |
| 용어집 | 없음 | 요청별 의미 기반 매칭 |
| 규칙 | 없음 | 대상 로캘별 포함 |
| 모델 선택 | Lingo.dev 기본값 | 폴백이 포함된 내 모델 구성 |
| 품질 검토 | 없음 | 설정한 AI 평가자가 자동으로 실행 |
설정#
1
엔진 연결
프로젝트 루트에서 lingo link을 실행하세요:
bash
lingo linkorganization과 localization engine을 선택하거나 새로 만드세요. link이 orgId와 engineId를 .lingo/config.json에 기록합니다. 실행할 때마다 같은 엔진을 사용하도록 이 파일은 꼭 커밋하세요. 엔진 ID는 대시보드에서도 확인할 수 있으며, eng_로 시작합니다(예: eng_SxjMwMsfOIsvV1wh).
2
인증
bash
lingo login브라우저가 열리면 인증이 진행되고 세션이 저장됩니다. CI 또는 비대화형 환경에서는 대신 API 키를 전달하세요:
bash
lingo login --api-key lk_...…또는 환경 변수로 설정할 수도 있습니다:
bash
export LINGO_API_KEY="lk_..."대시보드의 API Keys 페이지에서 API 키를 생성하세요.
3
Push
bash
lingo pushCLI는 소스 파일을 엔진으로 전송하고, 번역된 결과를 다시 디스크에 기록하면서 브랜드 보이스, 용어집, 규칙, 모델 구성을 자동으로 적용합니다.
구성 레퍼런스#
.lingo/config.json#
| 필드 | 설명 |
|---|---|
orgId | 엔진을 소유하는 organization입니다. lingo link으로 설정됩니다. |
engineId | 번역을 수행하는 엔진입니다(eng_...). lingo link로 설정됩니다. |
sourceLocale, targetLocales, files는 다른 프로젝트와 동일하게 작동합니다. Configuration을 참고하세요.
환경 변수#
| 변수 | 필수 여부 | 기본값 | 설명 |
|---|---|---|---|
LINGO_API_KEY | CI에서 사용 | - | Lingo.dev API 키입니다(lingo login 대신 사용). |
LINGO_API_URL | 아니요 | https://api.lingo.dev | 사용자 지정 API 기본 URL(셀프 호스팅 또는 스테이징용) |
예상할 수 있는 점#
CLI가 생성하는 모든 번역은 엔진의 전체 파이프라인을 거칩니다:
- 브랜드 보이스가 로캘별 어조와 격식을 조정합니다
- 용어집 항목이 의미 기반 매칭으로 정확한 용어를 적용합니다
- 규칙은 로캘별 언어 규칙을 적용합니다
- 모델 구성이 자동 폴백과 함께 적절한 LLM을 선택합니다
- AI 평가자가 각 요청 후 품질을 자동으로 평가합니다
번역은 API 및 연동 요청과 함께 트리거 유형 으로 apiReports에 표시됩니다.
