@intlayer/docs 5.5.12 → 5.7.0

package/docs/ko/intlayer_cli.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-06-29
+updatedAt: 2025-07-11
 title: CLI
 description: Intlayer CLI를 사용하여 다국어 웹사이트를 관리하는 방법을 알아보세요. 이 온라인 문서의 단계를 따라 몇 분 만에 프로젝트를 설정할 수 있습니다.
 keywords:
@@ -36,11 +36,11 @@ yarn add intlayer-cli -g
 pnpm add intlayer-cli -g
 ```
 
-> `intlayer` 패키지가 이미 설치되어 있다면, CLI도 자동으로 설치됩니다. 이 단계는 건너뛸 수 있습니다.
+> `intlayer` 패키지가 이미 설치되어 있다면, CLI도 자동으로 설치됩니다. 이 단계는 건너뛰어도 됩니다.
 
 ## intlayer-cli 패키지
 
-`intlayer-cli` 패키지는 [intlayer 선언](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/get_started.md)을 사전(dictionary)으로 변환하는 역할을 합니다.
+`intlayer-cli` 패키지는 여러분의 [intlayer 선언](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/get_started.md)을 사전(dictionaries)으로 변환하는 역할을 합니다.
 
 이 패키지는 `src/**/*.content.{ts|js|mjs|cjs|json}`와 같은 모든 intlayer 파일을 변환합니다. [Intlayer 선언 파일을 선언하는 방법을 확인하세요](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
 
@@ -48,7 +48,7 @@ intlayer 사전을 해석하려면 [react-intlayer](https://www.npmjs.com/packag
 
 ## 구성 파일 지원
 
-Intlayer는 여러 가지 구성 파일 형식을 지원합니다:
+Intlayer는 여러 구성 파일 형식을 지원합니다:
 
 - `intlayer.config.ts`
 - `intlayer.config.js`
@@ -57,54 +57,13 @@ Intlayer는 여러 가지 구성 파일 형식을 지원합니다:
 - `intlayer.config.mjs`
 - `.intlayerrc`
 
-사용 가능한 로케일이나 기타 매개변수를 구성하는 방법은 [구성 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)를 참조하세요.
+사용 가능한 로케일 또는 기타 매개변수를 구성하는 방법은 [구성 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)를 참조하세요.
 
-## CLI SDK
-
-CLI SDK는 Intlayer CLI를 자신의 코드에서 사용할 수 있게 해주는 라이브러리입니다.
-
-```bash packageManager="npm"
-npm install @intlayer/cli -D
-```
-
-```bash packageManager="yarn"
-yarn add @intlayer/cli -D
-```
-
-```bash packageManager="pnpm"
-pnpm add @intlayer/cli -D
-```
-
-사용 예시:
-
-```ts
-import {
-  push,
-  pull,
-  fill,
-  build,
-  docTranslate,
-  docReview,
-} from "@intlayer/cli";
-
-push();
-pull();
-// ...
-fill();
-// ...
-build();
-// ...
-docTranslate();
-// ...
-docReview();
-// ...
-```
-
-## intlayer 명령어 실행하기
+## intlayer 명령 실행
 
-### 사전 빌드하기
+### 사전 빌드
 
-사전을 빌드하려면 다음 명령어를 실행하세요:
+사전을 빌드하려면 다음 명령어를 실행할 수 있습니다:
 
 ```bash
 npx intlayer build
@@ -116,7 +75,7 @@ npx intlayer build
 npx intlayer build --watch
 ```
 
-이 명령어는 기본적으로 `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx}` 경로에서 선언된 콘텐츠 파일을 찾아 `.intlayer` 디렉토리에 사전을 빌드합니다.
+이 명령은 기본적으로 `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx}` 경로에서 선언 콘텐츠 파일을 찾고, `.intlayer` 디렉토리에 사전을 빌드합니다.
 
 ##### 별칭:
 
@@ -124,13 +83,14 @@ npx intlayer build --watch
 - `npx intlayer dictionary build`
 - `npx intlayer dic build`
 
-### 사전 푸시하기
+### 사전 푸시
 
 ```bash
+bash
 npx intlayer dictionary push
 ```
 
-[intlayer editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)가 설치되어 있다면, 사전을 에디터로 푸시할 수도 있습니다. 이 명령어는 사전을 [에디터](https://intlayer.org/dashboard)에서 사용할 수 있도록 해줍니다. 이를 통해 팀과 사전을 공유하고 애플리케이션 코드를 수정하지 않고도 콘텐츠를 편집할 수 있습니다.
+[intlayer 에디터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)가 설치되어 있다면, 사전을 에디터로 푸시할 수도 있습니다. 이 명령은 사전을 [에디터](https://intlayer.org/dashboard)에서 사용할 수 있도록 합니다. 이를 통해 팀과 사전을 공유하고 애플리케이션 코드를 수정하지 않고도 콘텐츠를 편집할 수 있습니다.
 
 ##### 별칭:
 
@@ -140,22 +100,56 @@ npx intlayer dictionary push
 
 ##### 인수:
 
-- `-d`, `--dictionaries`: 가져올 사전의 ID들입니다. 지정하지 않으면 모든 사전이 푸시됩니다.
+**사전 옵션:**
+
+- **`-d`, `--dictionaries`**: 가져올 사전의 ID들입니다. 지정하지 않으면 모든 사전이 푸시됩니다.
+
   > 예시: `npx intlayer dictionary push -d my-dictionary-id my-other-dictionary-id`
-- `-r`, `--deleteLocaleDictionary`: 사전이 푸시된 후 로케일 디렉터리를 삭제할지 묻는 질문을 건너뛰고 삭제합니다. 기본적으로 사전이 로컬에 정의되어 있으면 원격 사전 내용을 덮어씁니다.
+
+**구성 옵션:**
+
+- **`--base-dir`**: 프로젝트의 기본 디렉토리를 지정합니다. intlayer 설정을 가져오기 위해, 이 명령은 기본 디렉토리에서 `intlayer.config.{ts,js,json,cjs,mjs}` 파일을 찾습니다.
+
+  > 예시: `npx intlayer dictionary push --env-file .env.production.local`
+
+**환경 변수 옵션:**
+
+- **`--env`**: 환경을 지정합니다 (예: `development`, `production`). intlayer 설정 파일에서 환경 변수를 사용하는 경우에 유용합니다.
+- **`--env-file`**: 변수들을 불러올 사용자 지정 환경 파일을 제공합니다. intlayer 설정 파일에서 환경 변수를 사용하는 경우에 유용합니다.
+
+  > 예시: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > 예시: `npx intlayer dictionary push --env production`
+
+**출력 옵션:**
+
+- **`-r`, `--delete-locale-dictionary`**: 사전이 푸시된 후 로케일 디렉토리를 삭제할지 묻는 질문을 건너뛰고, 해당 디렉토리를 삭제합니다. 기본적으로 사전이 로컬에 정의되어 있으면 원격 사전 내용을 덮어씁니다.
+
   > 예시: `npx intlayer dictionary push -r`
-- `-k`, `--keepLocaleDictionary`: 사전이 푸시된 후 로케일 디렉터리를 삭제할지 묻는 질문을 건너뛰고 유지합니다. 기본적으로 사전이 로컬에 정의되어 있으면 원격 사전 내용을 덮어씁니다.
+
+  > 예시: `npx intlayer dictionary push --delete-locale-dictionary`
+
+- **`-k`, `--keep-locale-dictionary`**: 사전이 푸시된 후 로케일 디렉토리를 삭제할지 묻는 질문을 건너뛰고, 해당 디렉토리를 유지합니다. 기본적으로 사전이 로컬에 정의되어 있으면 원격 사전 내용을 덮어씁니다.
+
   > 예시: `npx intlayer dictionary push -k`
-- `--env`: 환경을 지정합니다 (예: `development`, `production`).
-- `--env-file`: 변수 로드를 위한 사용자 지정 환경 파일을 제공합니다.
-- `--base-dir`: 프로젝트의 기본 디렉터리를 지정합니다.
-- `--verbose`: 디버깅을 위해 자세한 로깅을 활성화합니다.
-- `--git-diff`: 기본 브랜치(기본값 `origin/main`)에서 현재 브랜치(기본값: `HEAD`)로 변경된 사전만 실행합니다.
-- `--git-diff-base`: git diff의 기준 참조를 지정합니다(기본값 `origin/main`).
-- `--git-diff-current`: git diff의 현재 참조를 지정합니다(기본값 `HEAD`).
-- `--uncommitted`: 커밋되지 않은 변경 사항을 포함합니다.
-- `--unpushed`: 푸시되지 않은 변경 사항을 포함합니다.
-- `--untracked`: 추적되지 않은 파일을 포함합니다.
+
+  > 예시: `npx intlayer dictionary push --keep-locale-dictionary`
+
+**로그 옵션:**
+
+- **`--verbose`**: 디버깅을 위한 상세 로그 활성화.
+
+**Git 옵션:**
+
+- **`--git-diff`**: 기본 브랜치(기본값 `origin/main`)에서 현재 브랜치(기본값: `HEAD`)로 변경된 사전만 실행합니다.
+- **`--git-diff-base`**: git diff의 기준 참조를 지정합니다 (기본값 `origin/main`).
+- **`--git-diff-current`**: git diff의 현재 참조를 지정합니다 (기본값 `HEAD`).
+- **`--uncommitted`**: 커밋되지 않은 변경 사항 포함.
+- **`--unpushed`**: 푸시되지 않은 변경 사항 포함.
+- **`--untracked`**: 추적되지 않은 파일 포함.
+
+> 예시: `npx intlayer dictionary push --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+> 예시: `npx intlayer dictionary push --uncommitted --unpushed --untracked`
 
 ### 원격 사전 가져오기
 
@@ -163,7 +157,7 @@ npx intlayer dictionary push
 npx intlayer pull
 ```
 
-[intlayer editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)이 설치되어 있으면, 에디터에서 사전을 가져올 수도 있습니다. 이렇게 하면 애플리케이션의 필요에 따라 사전의 내용을 덮어쓸 수 있습니다.
+[intlayer editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)가 설치되어 있으면, 에디터에서 사전을 가져올 수도 있습니다. 이렇게 하면 애플리케이션의 필요에 따라 사전 내용을 덮어쓸 수 있습니다.
 
 ##### 별칭:
 
@@ -173,13 +167,35 @@ npx intlayer pull
 
 ##### 인수:
 
-- `-d, --dictionaries`: 가져올 사전의 ID들입니다. 지정하지 않으면 모든 사전이 가져와집니다.
+**사전 옵션:**
+
+- **`-d, --dictionaries`**: 가져올 사전의 ID들입니다. 지정하지 않으면 모든 사전을 가져옵니다.
+
   > 예시: `npx intlayer dictionary pull -d my-dictionary-id my-other-dictionary-id`
-- `--newDictionariesPath` : 새 사전이 저장될 디렉토리 경로입니다. 지정하지 않으면 새 사전은 프로젝트의 `./intlayer-dictionaries` 디렉토리에 저장됩니다. 사전 내용에 `filePath` 필드가 지정되어 있으면, 사전은 이 인수를 무시하고 지정된 `filePath` 디렉토리에 저장됩니다.
-- `--env`: 환경을 지정합니다 (예: `development`, `production`).
-- `--env-file`: 변수를 로드할 사용자 정의 환경 파일을 제공합니다.
-- `--base-dir`: 프로젝트의 기본 디렉토리를 지정합니다.
-- `--verbose`: 디버깅을 위한 상세 로그 출력을 활성화합니다.
+
+**구성 옵션:**
+
+- **`--base-dir`**: 프로젝트의 기본 디렉터리를 지정합니다. intlayer 구성을 가져오기 위해, 명령어는 기본 디렉터리에서 `intlayer.config.{ts,js,json,cjs,mjs}` 파일을 찾습니다.
+
+  > 예시: `npx intlayer dictionary push --env-file .env.production.local`
+
+**환경 변수 옵션:**
+
+- **`--env`**: 환경을 지정합니다 (예: `development`, `production`).
+- **`--env-file`**: 변수들을 로드할 사용자 정의 환경 파일을 제공합니다.
+- **`--base-dir`**: 프로젝트의 기본 디렉터리를 지정합니다. intlayer 구성을 가져오기 위해, 명령어는 기본 디렉터리에서 `intlayer.config.{ts,js,json,cjs,mjs}` 파일을 찾습니다.
+
+  > 예시: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > 예시: `npx intlayer dictionary push --env production`
+
+**출력 옵션:**
+
+- **`--new-dictionaries-path`** : 새 사전이 저장될 디렉토리 경로입니다. 지정하지 않으면 새 사전은 프로젝트의 `./intlayer-dictionaries` 디렉토리에 저장됩니다. 사전 내용에 `filePath` 필드가 지정된 경우, 사전은 이 인수를 무시하고 지정된 `filePath` 디렉토리에 저장됩니다.
+
+**로그 옵션:**
+
+- **`--verbose`**: 디버깅을 위한 상세 로그를 활성화합니다.
 
 ##### 예시:
 
@@ -190,11 +206,10 @@ npx intlayer dictionary pull --newDictionariesPath ./my-dictionaries-dir/
 ### 사전 채우기 / 감사 / 번역
 
 ```bash
-bash
 npx intlayer fill
 ```
 
-이 명령어는 누락된 번역, 구조적 불일치 또는 타입 불일치와 같은 잠재적인 문제에 대해 콘텐츠 선언 파일을 분석합니다. 문제가 발견되면, **intlayer fill**은 사전을 일관되고 완전하게 유지하기 위해 업데이트를 제안하거나 적용합니다.
+이 명령은 누락된 번역, 구조적 불일치 또는 타입 불일치와 같은 잠재적인 문제에 대해 콘텐츠 선언 파일을 분석합니다. 문제가 발견되면, **intlayer fill**은 사전을 일관되고 완전하게 유지하기 위해 업데이트를 제안하거나 적용합니다.
 
 ##### 별칭:
 
@@ -204,78 +219,74 @@ npx intlayer fill
 
 ##### 인수:
 
-- `-f, --file [files...]`
-  감사할 특정 콘텐츠 선언 파일 목록입니다. 지정하지 않으면 발견된 모든 `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` 파일이 감사 대상이 됩니다.
+**파일 목록 옵션:**
+
+- **`-f, --file [files...]`**: 감사할 특정 콘텐츠 선언 파일 목록입니다. 지정하지 않으면 구성 파일 설정에 따라 발견된 모든 `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` 파일이 감사됩니다.
+
+  > 예시: `npx intlayer dictionary fill -f src/home/app.content.ts`
 
-- `--exclude [excludedGlobs...]`
-  감사에서 제외할 glob 패턴입니다 (예: `--exclude "src/test/**"`).
+- **`-k, --keys [keys...]`**: 키를 기준으로 사전을 필터링합니다. 지정하지 않으면 모든 사전이 감사됩니다.
 
-- `--source-locale [sourceLocale]`
-  번역할 원본 로케일입니다. 지정하지 않으면 구성에서 기본 로케일이 사용됩니다.
+  > 예시: `npx intlayer dictionary fill -k key1 key2`
 
-- `--output-locales [outputLocales...]`
-  번역할 대상 로케일입니다. 지정하지 않으면 원본 로케일을 제외한 구성의 모든 로케일이 사용됩니다.
+- **`--excluded-keys [excludedKeys...]`**: 키를 기준으로 사전을 제외합니다. 지정하지 않으면 모든 사전이 감사됩니다.
 
-- `--mode [mode]`
-  번역 모드: 'complete', 'review', 또는 'missing-only' 중 하나입니다. 기본값은 'missing-only'입니다.
+  > 예시: `npx intlayer dictionary fill --excluded-keys key1 key2`
 
-- `--git-diff`
-  기본 브랜치(기본값 `origin/main`)에서 현재 브랜치(기본값 `HEAD`)로의 변경 사항이 포함된 사전을 필터링합니다.
+- **`--path-filter [pathFilters...]`**: 파일 경로에 대한 glob 패턴을 기준으로 사전을 필터링합니다.
 
-- `--git-diff-base`
-  git diff의 기준 참조를 지정합니다 (기본값 `origin/main`).
+  > 예시: `npx intlayer dictionary fill --path-filter "src/home/**"`
 
-- `--git-diff-current`
-  git diff의 현재 참조를 지정합니다 (기본값 `HEAD`).
+**출력 옵션:**
 
-- `--uncommitted`
-  커밋되지 않은 변경 사항이 포함된 사전을 필터링합니다.
+- **`--source-locale [sourceLocale]`**: 번역할 소스 로케일입니다. 지정하지 않으면 구성 파일의 기본 로케일이 사용됩니다.
 
-- `--unpushed`
-- `--unpushed`
-  푸시되지 않은 변경 사항이 포함된 사전을 필터링합니다.
+- **`--output-locales [outputLocales...]`**: 번역할 대상 로케일입니다. 지정하지 않으면 구성에 있는 모든 로케일이 소스 로케일을 제외하고 사용됩니다.
 
-- `--untracked`
-  추적되지 않은 파일이 포함된 사전을 필터링합니다.
+- **`--mode [mode]`**: 번역 모드: 'complete', 'review', 또는 'missing-only' 중 하나입니다. 기본값은 'missing-only'입니다.
 
-- `--keys [keys...]`
-  지정된 키를 기준으로 사전을 필터링합니다.
+**Git 옵션:**
 
-- `--excluded-keys [excludedKeys...]`
-  지정된 키를 기준으로 사전을 제외합니다.
+- **`--git-diff`**: 기본 브랜치(기본값 `origin/main`)에서 현재 브랜치(기본값 `HEAD`)로 변경된 사전만 실행합니다.
+- **`--git-diff-base`**: git diff의 기준 참조를 지정합니다 (기본값 `origin/main`).
+- **`--git-diff-current`**: git diff의 현재 참조를 지정합니다 (기본값 `HEAD`).
+- **`--uncommitted`**: 커밋되지 않은 변경 사항을 포함합니다.
+- **`--unpushed`**: 푸시되지 않은 변경 사항을 포함합니다.
+- **`--untracked`**: 추적되지 않은 파일을 포함합니다.
 
-- `--path-filter [pathFilters...]`
-  파일 경로에 대한 glob 패턴을 기준으로 사전을 필터링합니다.
+  > 예시: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
 
-- `--model [model]`
-  번역에 사용할 AI 모델 (예: `gpt-3.5-turbo`).
+  > 예시: `npx intlayer doc translate --uncommitted --unpushed --untracked`
 
-- `--provider [provider]`
-  번역에 사용할 AI 제공자.
+**AI 옵션:**
 
-- `--temperature [temperature]`
-  AI 모델의 온도 설정.
+- **`--model [model]`**: 번역에 사용할 AI 모델 (예: `gpt-3.5-turbo`).
+- **`--provider [provider]`**: 번역에 사용할 AI 제공자.
+- **`--temperature [temperature]`**: AI 모델의 온도 설정.
+- **`--api-key [apiKey]`**: AI 서비스용 API 키 직접 제공.
+- **`--custom-prompt [prompt]`**: 번역 지침을 위한 맞춤 프롬프트 제공.
+- **`--application-context [applicationContext]`**: AI 번역에 추가적인 문맥 제공.
 
-- `--api-key [apiKey]`
-  AI 서비스에 사용할 API 키를 제공합니다.
+  > 예시: `npx intlayer fill --model gpt-3.5-turbo --provider openai --temperature 0.5 --api-key sk-1234567890 --application-context "My application is a cat store"`
 
-- `--custom-prompt [prompt]`
-  번역 지침을 위한 사용자 지정 프롬프트를 제공합니다.
+**환경 변수 옵션:**
 
-- `--application-context [applicationContext]`
-  AI 번역을 위한 추가 컨텍스트를 제공합니다.
+- **`--env`**: 환경을 지정합니다 (예: `development`, `production`).
+- **`--env-file [envFile]`**: 변수들을 로드할 커스텀 환경 파일을 제공합니다.
+
+  > 예시: `npx intlayer fill --env-file .env.production.local`
+
+  > 예시: `npx intlayer fill --env production`
 
-- `--env`
-  환경을 지정합니다 (예: `development`, `production`).
+**설정 옵션:**
 
-- `--env-file [envFile]`
-  변수를 로드할 사용자 지정 환경 파일을 제공합니다.
+- **`--base-dir`**: 프로젝트의 기본 디렉토리를 지정합니다.
+
+  > 예시: `npx intlayer fill --base-dir ./src`
 
-- `--base-dir`
-  프로젝트의 기본 디렉토리를 지정합니다.
+**로그 옵션:**
 
-- `--verbose`
-  디버깅을 위한 자세한 로깅을 활성화합니다.
+- **`--verbose`**: 디버깅을 위한 상세 로그를 활성화합니다.
 
 ##### 예시:
 
@@ -283,36 +294,35 @@ npx intlayer fill
 npx intlayer fill --file src/home/*.content.ts --source-locale en --output-locales fr es --model gpt-3.5-turbo
 ```
 
-이 명령은 `src/home/` 디렉토리 내 모든 콘텐츠 선언 파일에 대해 영어에서 프랑스어 및 스페인어로 GPT-3.5 Turbo 모델을 사용하여 콘텐츠를 번역합니다.
+이 명령어는 `src/home/` 디렉토리에 있는 모든 콘텐츠 선언 파일을 대상으로 GPT-3.5 Turbo 모델을 사용하여 영어에서 프랑스어와 스페인어로 콘텐츠를 번역합니다.
 
 ### 구성 관리
 
 #### 구성 가져오기
 
-`configuration get` 명령어는 Intlayer의 현재 설정, 특히 로케일 설정을 가져옵니다. 이는 설정을 확인하는 데 유용합니다.
+`configuration get` 명령어는 Intlayer의 현재 구성을, 특히 로케일 설정을 가져옵니다. 이는 설정을 확인하는 데 유용합니다.
 
 ```bash
 npx intlayer configuration get
 ```
 
-##### 별칭(Aliases):
+##### 별칭:
 
 - `npx intlayer config get`
 - `npx intlayer conf get`
 
-##### 인수(Arguments):
+##### 인수:
 
 - **`--env`**: 환경을 지정합니다 (예: `development`, `production`).
 - **`--env-file`**: 변수 로드를 위한 사용자 지정 환경 파일을 제공합니다.
 - **`--base-dir`**: 프로젝트의 기본 디렉토리를 지정합니다.
-- **`--verbose`**: 디버깅을 위한 상세 로깅을 활성화합니다.
+- **`--verbose`**: 디버깅을 위한 상세 로그 출력을 활성화합니다.
 
-#### 구성 푸시(Push Configuration)
+#### 구성 푸시
 
-`configuration push` 명령어는 설정을 Intlayer CMS 및 에디터에 업로드합니다. 이 단계는 Intlayer 비주얼 에디터에서 원격 사전을 사용하기 위해 필요합니다.
+`configuration push` 명령은 구성 설정을 Intlayer CMS 및 에디터에 업로드합니다. 이 단계는 Intlayer 비주얼 에디터에서 원격 사전을 사용할 수 있도록 하는 데 필요합니다.
 
 ```bash
-bash
 npx intlayer configuration push
 ```
 
@@ -326,13 +336,13 @@ npx intlayer configuration push
 - **`--env`**: 환경을 지정합니다 (예: `development`, `production`).
 - **`--env-file`**: 변수 로드를 위한 사용자 지정 환경 파일을 제공합니다.
 - **`--base-dir`**: 프로젝트의 기본 디렉토리를 지정합니다.
-- **`--verbose`**: 디버깅을 위한 자세한 로깅을 활성화합니다.
+- **`--verbose`**: 디버깅을 위한 상세 로그 출력을 활성화합니다.
 
 구성을 푸시하면 프로젝트가 Intlayer CMS와 완전히 통합되어 팀 간 원활한 사전 관리가 가능합니다.
 
 ### 문서 관리
 
-`doc` 명령어는 여러 로케일에 걸친 문서 파일을 관리하고 번역하는 도구를 제공합니다.
+`doc` 명령어는 여러 로케일에 걸쳐 문서 파일을 관리하고 번역하는 도구를 제공합니다.
 
 #### 문서 번역
 
@@ -344,69 +354,130 @@ npx intlayer doc translate
 
 ##### 인수:
 
-- **`--doc-pattern [docPattern...]`**: 번역할 문서 파일을 매칭하는 glob 패턴입니다.
+**파일 목록 옵션:**
+
+- **`--doc-pattern [docPattern...]`**: 번역할 문서 파일과 일치하는 글로브 패턴입니다.
+
   > 예시: `npx intlayer doc translate --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
-- **`--excluded-glob-pattern [excludedGlobPattern...]`**: 번역에서 제외할 glob 패턴입니다.
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: 번역에서 제외할 파일을 지정하는 Glob 패턴입니다.
+
   > 예시: `npx intlayer doc translate --excluded-glob-pattern "docs/internal/**"`
-- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: 동시에 번역할 파일 수입니다.
-  > 예시: `npx intlayer doc translate --nb-simultaneous-file-processed 5`
-- **`--locales [locales...]`**: 문서 번역 대상 로케일입니다.
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: 지정한 시간 이전에 수정된 파일은 건너뜁니다.
+
+  - "2025-12-05"와 같은 절대 시간 (문자열 또는 Date 객체)일 수 있습니다.
+  - `1 * 60 * 60 * 1000` (1시간)과 같은 상대 시간(ms)일 수 있습니다.
+  - 이 옵션은 `fs.stat` 메서드를 사용하여 파일의 수정 시간을 확인합니다. 따라서 Git이나 다른 도구가 파일을 수정한 경우 영향을 받을 수 있습니다.
+
+  > 예시: `npx intlayer doc translate --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: 지정한 시간 이내에 수정된 파일은 건너뜁니다.
+
+  - 절대 시간으로 "2025-12-05" (문자열 또는 Date 객체) 형태일 수 있습니다.
+  - 상대 시간으로 ms 단위 `1 * 60 * 60 * 1000` (1시간) 형태일 수 있습니다.
+  - 이 옵션은 `fs.stat` 메서드를 사용하여 파일의 수정 시간을 확인합니다. 따라서 Git이나 파일을 수정하는 다른 도구에 의해 영향을 받을 수 있습니다.
+
+  > 예시: `npx intlayer doc translate --skip-if-modified-after "2025-12-05"`
+
+**출력 옵션:**
+
+- **`--locales [locales...]`**: 문서를 번역할 대상 로케일들입니다.
+
   > 예시: `npx intlayer doc translate --locales fr es de`
+
 - **`--base-locale [baseLocale]`**: 번역할 원본 로케일입니다.
+
   > 예시: `npx intlayer doc translate --base-locale en`
-- **`--model [model]`**: 번역에 사용할 AI 모델입니다 (예: `gpt-3.5-turbo`).
-- **`--provider [provider]`**: 번역에 사용할 AI 제공자입니다.
-- **`--temperature [temperature]`**: AI 모델의 온도 설정입니다.
+
+**파일 처리 옵션:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: 번역을 위해 동시에 처리할 파일 수입니다.
+
+  > 예시: `npx intlayer doc translate --nb-simultaneous-file-processed 5`
+
+**AI 옵션:**
+
+- **`--model [model]`**: 번역에 사용할 AI 모델 (예: `gpt-3.5-turbo`).
+- **`--provider [provider]`**: 번역에 사용할 AI 제공자.
+- **`--temperature [temperature]`**: AI 모델의 온도 설정.
 - **`--api-key [apiKey]`**: AI 서비스에 사용할 API 키를 제공합니다.
-- **`--custom-prompt [prompt]`**: 번역 지침을 위한 사용자 지정 프롬프트를 제공합니다.
 - **`--application-context [applicationContext]`**: AI 번역에 추가적인 컨텍스트를 제공합니다.
+- **`--custom-prompt [prompt]`**: 번역에 사용되는 기본 프롬프트를 사용자 정의합니다. (참고: 대부분의 사용 사례에서는 번역 동작을 더 잘 제어할 수 있는 `--custom-instructions` 옵션을 대신 사용하는 것이 권장됩니다.)
+
+  > 예시: `npx intlayer doc translate --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "My application is a cat store"`
+
+**환경 변수 옵션:**
+
 - **`--env`**: 환경을 지정합니다 (예: `development`, `production`).
-- **`--env-file [envFile]`**: 변수 로드를 위한 사용자 정의 환경 파일을 제공합니다.
-- **`--base-dir`**: 프로젝트의 기본 디렉토리를 지정합니다.
-- **`--verbose`**: 디버깅을 위한 상세 로그 출력을 활성화합니다.
-- **`--custom-instructions [customInstructions]`**: 프롬프트에 추가되는 사용자 정의 지침입니다. 포맷팅, URL 번역 등 특정 규칙을 적용하는 데 유용합니다.
+- **`--env-file [envFile]`**: 변수를 로드할 사용자 정의 환경 파일을 제공합니다.
+- **`--base-dir`**: 프로젝트의 기본 디렉터리를 지정합니다.
 
-##### 예시:
+  > 예시: `npx intlayer doc translate --base-dir ./docs --env-file .env.production.local`
 
-```bash
-npx intlayer doc translate
-  --doc-pattern "docs/en/**/*.md"
-  --base-locale en --locales fr es
-  --model chatgpt-4o-latest
-  --custom-instructions "$(cat ./instructions.md)"
-```
+**로그 옵션:**
+
+- **`--verbose`**: 디버깅을 위해 상세 로그를 활성화합니다.
+
+  > 예시: `npx intlayer doc translate --verbose`
+
+**사용자 지정 지침 옵션:**
+
+- **`--custom-instructions [customInstructions]`**: 프롬프트에 추가되는 사용자 지정 지침입니다. 포맷팅, URL 번역 등 특정 규칙을 적용하는 데 유용합니다.
+
+  - "2025-12-05"와 같은 절대 시간(문자열 또는 Date 객체)일 수 있습니다.
+  - 밀리초 단위의 상대 시간 `1 * 60 * 60 * 1000` (1시간)일 수 있습니다.
+  - 이 옵션은 `fs.stat` 메서드를 사용하여 파일의 수정 시간을 확인합니다. 따라서 Git이나 파일을 수정하는 다른 도구의 영향 받을 수 있습니다.
+
+  > 예시: `npx intlayer doc translate --custom-instructions "URL 번역을 피하고, 마크다운 형식을 유지하세요"`
+
+  > 예시: `npx intlayer doc translate --custom-instructions "$(cat ./instructions.md)"`
+
+**Git 옵션:**
+
+- **`--git-diff`**: 기본 브랜치(기본값 `origin/main`)에서 현재 브랜치(기본값 `HEAD`)로 변경된 내용이 포함된 사전에서만 실행합니다.
+- **`--git-diff-base`**: git diff의 기준 참조를 지정합니다 (기본값 `origin/main`).
+- **`--git-diff-current`**: git diff의 현재 참조를 지정합니다 (기본값 `HEAD`).
+- **`--uncommitted`**: 커밋되지 않은 변경 사항을 포함합니다.
+- **`--unpushed`**: 푸시되지 않은 변경 사항을 포함합니다.
+- **`--untracked`**: 추적되지 않은 파일을 포함합니다.
+
+  > 예시: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > 예시: `npx intlayer doc translate --uncommitted --unpushed --untracked`
 
 > 출력 파일 경로는 다음 패턴을 대체하여 결정됩니다
 >
-> - `/{{baseLocale}}/` 는 `/{{locale}}/` 로 변경 (Unix)
-> - `\{{baseLocale}}\` 는 `\{{locale}}\` 로 변경됩니다 (Windows)
-> - `_{{baseLocale}}.` 는 `_{{locale}}.` 로 변경됩니다
-> - `{{baseLocale}}_` 는 `{{locale}}_` 로 변경됩니다
-> - `.{{baseLocaleName}}.` 는 `.{{localeName}}.` 로 변경됩니다
+> - `/{{baseLocale}}/` 는 `/{{locale}}/` 로 대체됩니다 (Unix)
+> - `\{{baseLocale}}\` 는 `\{{locale}}\` 로 대체됩니다 (Windows)
+> - `_{{baseLocale}}.` 는 `_{{locale}}.` 로 대체됩니다
+> - `{{baseLocale}}_` 는 `{{locale}}_` 로 대체됩니다
+> - `.{{baseLocaleName}}.` 는 `.{{localeName}}.` 로 대체됩니다
 >
 > 만약 해당 패턴이 발견되지 않으면, 출력 파일은 파일 확장자에 `.{{locale}}` 을 추가합니다. 예를 들어 `./my/file.md` 는 프랑스어 로케일의 경우 `./my/file.fr.md` 로 번역됩니다.
 
 #### 문서 검토
 
-`doc review` 명령어는 다양한 로케일에 걸쳐 문서 파일의 품질, 일관성 및 완전성을 분석합니다.
+`doc review` 명령어는 다양한 로케일에 걸쳐 문서 파일의 품질, 일관성, 완전성을 분석합니다.
 
 ```bash
 npx intlayer doc review
 ```
 
-##### 인자:
+이미 번역된 파일을 검토하거나 번역이 올바른지 확인하는 데 사용할 수 있습니다.
 
-`doc review` 명령어는 `doc translate` 와 동일한 인자를 받아 특정 문서 파일을 검토하고 품질 검사를 적용할 수 있습니다.
+대부분의 사용 사례에서,
 
-##### 예시:
+- 이 파일의 번역본이 없을 때는 `doc translate` 명령어를 사용하는 것을 권장합니다.
+- 이 파일의 번역본이 이미 존재할 때는 `doc review` 명령어를 사용하는 것을 권장합니다.
 
-```bash
-npx intlayer doc review
- --doc-pattern "docs/ko/**/*.md"
- --locales fr es de
- --model chatgpt-4o-latest
- --custom-instructions "$(cat ./instructions.md)"
-```
+> 리뷰 프로세스는 동일한 파일을 완전히 검토할 때 번역 프로세스보다 더 많은 입력 토큰을 소비합니다. 그러나 리뷰 프로세스는 검토할 청크를 최적화하고 변경되지 않은 부분은 건너뜁니다.
+
+##### 인수:
+
+`doc review` 명령어는 `doc translate`와 동일한 인수를 받아 특정 문서 파일을 검토하고 품질 검사를 적용할 수 있습니다.
+
+만약 git 옵션 중 하나를 활성화했다면, 명령어는 변경된 파일 부분만 검토합니다. 스크립트는 파일을 청크 단위로 나누어 각 청크를 검토합니다. 청크에 변경 사항이 없으면, 검토 과정을 빠르게 진행하고 AI 제공자 API 비용을 제한하기 위해 해당 청크를 건너뜁니다.
 
 ## `package.json`에서 intlayer 명령어 사용하기
 
@@ -422,9 +493,51 @@ npx intlayer doc review
 }
 ```
 
-## intlayer 명령어 디버깅
+## CLI SDK
+
+CLI SDK는 Intlayer CLI를 자신의 코드에서 사용할 수 있게 해주는 라이브러리입니다.
+
+```bash packageManager="npm"
+npm install @intlayer/cli --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/cli --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/cli --save-dev
+```
+
+사용 예시:
+
+```ts
+import {
+  push,
+  pull,
+  fill,
+  build,
+  docTranslate,
+  docReview,
+} from "@intlayer/cli";
+
+push();
+// ...
+pull();
+// ...
+fill();
+// ...
+build();
+// ...
+docTranslate();
+// ...
+docReview();
+// ...
+```
+
+## intlayer 명령어 디버그
 
-### 1. **최신 버전을 사용하고 있는지 확인하기**
+### 1. **최신 버전을 사용하고 있는지 확인하세요**
 
 다음 명령어를 실행하세요:
 
@@ -444,9 +557,9 @@ npx intlayer dictionary build --help    # 특정 명령어에 대한 사용 가
 
 ### 3. **터미널을 재시작하세요**
 
-새로운 명령어를 인식하려면 때때로 터미널을 재시작해야 합니다.
+새 명령어를 인식하려면 때때로 터미널을 재시작해야 할 수 있습니다.
 
-### 4. **npx 캐시를 지우기 (이전 버전에 갇힌 경우)**
+### 4. **npx 캐시를 삭제하세요 (이전 버전에 갇힌 경우)**
 
 ```bash
 npx clear-npx-cache
@@ -454,4 +567,7 @@ npx clear-npx-cache
 
 ## 문서 이력
 
-- 5.5.10 - 2025-06-29: 초기 이력
+| 버전   | 날짜       | 변경 사항                         |
+| ------ | ---------- | --------------------------------- |
+| 5.5.11 | 2025-07-11 | CLI 명령어 매개변수 문서 업데이트 |
+| 5.5.10 | 2025-06-29 | 이력 초기화                       |