---
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/ja/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
# Unix系システムの場合
sudo npm install -g intlayer

# または npm のデフォルトディレクトリを変更する
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
# ~/.profile または ~/.bashrc に以下を追加：
export PATH=~/.npm-global/bin:$PATH
```
