---
createdAt: 2025-05-20
updatedAt: 2025-06-29
title: Intlayer 명령어 정의되지 않음
description: intlayer 명령어 정의되지 않음 오류를 해결하는 방법을 알아보세요.
keywords:
  - intlayer
  - 명령어
  - 정의되지 않음
  - 오류
  - vscode
  - 확장
  - 플러그인
  - 프레임워크
  - next.js
  - vite
slugs:
  - frequent-questions
  - intlayer-command-undefined
---

# Intlayer 명령어 정의되지 않음

## 개요

Intlayer CLI는 사전 구축, 번역 푸시 등 intlayer 콘텐츠를 편리하게 제어할 수 있는 방법을 제공합니다. 그러나 프로젝트가 작동하는 데 필수적인 것은 아닙니다. 만약 Next.js용 `withIntlayer()`나 Vite용 `intlayer()`과 같은 번들러 플러그인을 사용하고 있다면, Intlayer는 앱 빌드 또는 개발 서버 시작 시 자동으로 사전을 빌드합니다. 개발 모드에서는 변경 사항을 감지하여 콘텐츠 선언 파일을 자동으로 재빌드하기도 합니다.

intlayer 명령어에 접근하는 방법은 다음과 같습니다:

- `intlayer` CLI 명령어를 직접 사용하는 방법
- [VSCode 확장](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/vs_code_extension.md) 사용
- `@intlayer/cli` SDK 사용

## 문제점

`intlayer` 명령어를 사용하려고 할 때 다음과 같은 오류가 발생할 수 있습니다:

```bash
'intlayer'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램 또는 배치 파일로 인식되지 않습니다.
```

## 해결 방법

다음 해결 방법을 순서대로 시도해 보세요:

1. **명령어가 설치되어 있는지 확인**

```bash
npx intlayer -h
```

예상 출력:

```bash
Usage: intlayer [options] [command]

Intlayer CLI

Options:
    -V, --version            버전 번호 출력
    -h, --help               명령어 도움말 표시

Commands:
    dictionary|dictionaries  사전 관련 작업
    configuration|config     설정 관련 작업
    help [command]           명령어 도움말 표시
```

2. **intlayer-cli 패키지를 전역으로 설치**

```bash
npm install intlayer-cli -g -g
```

> 이미 `intlayer` 패키지를 설치한 경우에는 필요하지 않을 수 있습니다.

3. **패키지를 전역으로 설치**

```bash
npm install intlayer -g
```

4. **터미널 재시작**
   새로운 명령어를 인식하려면 터미널을 재시작해야 할 때가 있습니다.

5. **정리 후 재설치**
   위의 방법들이 효과가 없으면 다음을 시도하세요:

```bash
rm -rf node_modules package-lock.json
npm install
```

6. **설치 파일 확인**
   문제가 계속되면 다음 파일들이 존재하는지 확인하세요:
   - `node_modules/intlayer/dist/cjs/cli.cjs`
   - `node_modules/intlayer/package.json` (`bin` 필드가 `./dist/cjs/cli.cjs`를 참조해야 함)

7. **PATH 환경 변수 확인**
   npm 전역 bin 디렉토리가 PATH에 포함되어 있는지 확인하세요:

```bash
# Unix 기반 시스템(macOS/Linux)의 경우
echo $PATH
# /usr/local/bin 또는 ~/.npm-global/bin과 같은 경로가 포함되어야 합니다

# Windows의 경우
echo %PATH%
# npm 글로벌 bin 디렉토리가 포함되어야 합니다
```

8. **전체 경로를 사용하여 npx 실행**
   명령어가 여전히 인식되지 않는 경우, 전체 경로를 사용하여 npx를 실행해 보세요:

```bash
npx ./node_modules/intlayer/ dictionaries build
```

9. **충돌하는 설치 확인**

```bash
# 전역에 설치된 모든 패키지 목록 확인
npm list -g --depth=0

# 충돌하는 전역 설치 제거
npm uninstall -g intlayer
npm uninstall -g intlayer-cli
# 그런 다음 재설치
npm install -g intlayer
```

10. **Node.js 및 npm 버전 확인**
    호환 가능한 버전을 사용하고 있는지 확인하세요:

```bash
node --version
npm --version
```

    구버전을 사용 중이라면 Node.js와 npm을 업데이트하는 것을 고려하세요.

11. **권한 문제 확인하기**  
    권한 오류가 발생하는 경우:

```bash
# 유닉스 기반 시스템용
sudo npm install -g intlayer

# 또는 npm 기본 디렉토리 변경
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
# ~/.profile 또는 ~/.bashrc에 다음을 추가하세요:
export PATH=~/.npm-global/bin:$PATH
```
