lingo init

소스, 대상, 카탈로그 경로를 명시해 로컬라이제이션 구성을 만듭니다.

lingo init는 로컬라이제이션 설정을 .lingo/config.json에 기록합니다. 프로젝트의 소스 로캘, 대상 목록, 파일 패턴을 처음 설정할 때 사용하세요. 소스 파일, 인증 정보, 로컬라이제이션 엔진 연결은 별도로 준비해야 합니다. 초기화만으로는 이러한 리소스가 생성되거나 번역되지 않습니다.

sh
lingo init --source en --targets de,fr --files 'locales/en.json,docs/en/**/*.md' --yes

생성된 파일을 열어 의도한 소스 콘텐츠만 선택되는지 확인하세요. 그런 다음 필요에 따라 해당 파일을 만들고 로그인한 뒤, 원격 번역을 시작하기 전에 link를 실행하세요.

옵션 #

옵션기본값 또는 동작
--source <locale>기본값 사용 시 en.
--targets <list>쉼표로 구분한 로캘. --yes 사용 시 de,fr,es.
--files <list>쉼표로 구분한 패턴: locales/<source>.json에 --yes 사용. 예: locales/en.json.
--messages-path <path>리액트 카탈로그 i18n.messagesPath 설정. 기본값은 locales.
--types-path <path>선언 i18n.typesPath 설정. 기본값은 lingo.d.ts.
--force기존 로컬라이제이션 설정을 대체합니다.
--no-agents-mdAGENTS.md 및 CLAUDE.md의 Lingo.dev 블록을 건너뜁니다.
--yes, -y입력을 요청하지 않고 지정한 값이나 기본값을 사용합니다.

--yes이 없으면 지정하지 않은 항목을 입력하라는 메시지가 표시됩니다. 목록은 쉼표와 공백을 기준으로 나뉘므로, 공백이 포함된 패턴은 .lingo/config.json을 편집해 추가하세요. 중복된 대상 로캘과 소스 로캘에 정확히 일치하는 항목은 제거됩니다. 이 과정을 거친 대상 목록이 비어 있으면 허용되지 않습니다. CLI가 패턴을 받기 전에 셸이 패턴을 확장하지 않도록 따옴표로 감싸세요.

초기화 시 프로젝트의 AGENTS.md에도 Lingo.dev 블록을 추가하며, 파일이 없으면 새로 만듭니다. 기존 CLAUDE.md에도 블록을 추가하지만, 블록이 들어갈 AGENTS.md을 해당 파일에서 불러오는 경우는 제외됩니다. 이 블록은 코딩 에이전트에게 현지화 작업 전에 npx @lingo.dev/cli agent-guide을 실행하도록 안내합니다. 블록의 시작과 끝을 나타내는 표시 바깥의 텍스트는 그대로 유지되며, 나중에 다시 실행하면 두 표시 사이의 텍스트만 교체됩니다.

기존 프로젝트 다시 초기화하기 #

강제 실행하지 않으면 기존 로컬라이제이션 구성을 덮어쓰지 않고 그대로 유지하며, 초기화는 실패합니다. 강제 실행하면 패턴을 바탕으로 files[]를 다시 생성합니다. 이때 제외 항목, 명시적으로 지정한 형식, 출력 템플릿, 키 제어 같은 고급 항목 옵션은 사라집니다. 강제 실행 전에 이러한 옵션을 별도로 보관하세요. 변경 범위가 작다면 기존 구성을 편집하세요.

조직 및 로컬라이제이션 엔진 연결을 비롯한 다른 최상위 섹션은 유지됩니다. 카탈로그 경로의 기본값은 구성을 저장할 때 생략됩니다. 강제 실행으로 기본값을 복원하면 이전에 재정의한 i18n 값이 지워질 수 있습니다. 카탈로그 경로를 변경해도 번역 파일 패턴은 자동으로 바뀌지 않습니다.

첫 파일 가이드에서는 구성에 이어 초기 일괄 번역과 대상 파일 가져오기까지 안내합니다. 고급 파일 항목은 구성 레퍼런스를 참고하세요.