# gt: General Translation CLI tool: gt init
URL: https://generaltranslation.com/ja/docs/cli/reference/commands/init.mdx
---

title: gt init
description: General Translation のセットアップウィザードを実行して、プロジェクトを設定します。`gt init` コマンドの API リファレンス。

---

`init` はデフォルトのコマンドで、コマンドを指定せずに `npx gt` を実行すると `init` が実行されます。

このウィザードはフレームワークを検出し、プロジェクトに応じて依存関係のインストール、フレームワークの設定、`gt.config.json` の作成、認証情報の生成を行います。手順を追った説明については、[CLI の設定](/docs/cli/guides/configuring) を参照してください。

```bash
npx gt init
```

## 仕組み [#how-it-works]

1. フレームワークを検出します。Next.js App Router または Mintlify のプロジェクトでは、代わりに [Locadex](/docs/platform/locadex/quickstart) AI Agent の接続を提案します。
2. React ベースのプロジェクトでは、必要に応じて `gt-react` または `gt-next` をインストールし、フレームワークを設定します (実験的) 。Vite アプリには、既存のアプリ エントリより前に実行される [`initializeGTSPA`](/docs/react/reference/config#initialize-spa) ブートストラップを追加します。その他のサポート対象の React アプリでは、[`GTProvider`](/docs/react/reference/components/gt-provider) を使用します。
3. 不足しているデフォルトロケールとターゲットロケールの入力を求め、`gt.config.json` を作成または更新します。既存のロケール設定とファイル設定は保持されます。ローカルの Vite ストレージを使用する場合は、[`loadTranslations`](/docs/react/reference/functions/load-translations) ファイルと空のターゲットロケールファイルも作成します。
4. 設定されたワークフローで永続的な CLI のインストールが必要な場合、`gt` を開発依存関係としてインストールします。Vite フレームワークのセットアップでは `gt` は追加されません。引き続き `npx gt` で実行してください。
5. 必要に応じて API キー と プロジェクト ID を生成し、`.env.local` に書き込みます。

*注: React のセットアップ手順は実験的なため、すべてのプロジェクトで動作するとは限りません。適用される変更内容を確認してください。*

## フラグ [#flags]

| パラメータ                 | 説明                      | 型          | 任意 | デフォルト                                    |
| --------------------- | ----------------------- | ---------- | -- | ---------------------------------------- |
| `--src <paths...>`    | アプリのソースコードを指定するグロブパターン。 | `string[]` | はい | `src`, `app`, `pages`, `components` のグロブ |
| `-c, --config <path>` | 設定ファイルへのパス。             | `string`   | はい | `gt.config.json`                         |

## 例 [#example]

```bash
# セットアップウィザードを完全に実行する
npx gt init

# コマンドなしで gt を実行しても同じ動作になる
npx gt
```

## その他の注意事項 [#notes]

* `init` は、[`gt configure`](/docs/cli/reference/commands/configure) と [`gt auth`](/docs/cli/reference/commands/auth) をまとめて実行した場合と同じ手順に加え、実験的な React セットアップウィザードも実行します。特定の手順だけをやり直したい場合は、各コマンドを個別に実行してください。なお、ソースファイルをアップロードする [`gt setup`](/docs/cli/reference/commands/setup) は実行されません。
* モノレポでは、対象のアプリディレクトリから `init` を実行してください。現在のディレクトリが `pnpm-workspace.yaml` または `workspaces` フィールドを含むワークスペースルートである場合、コマンドはファイルを変更せずに停止します。
* Electron アプリケーションでは自動セットアップを利用できません。
* APIキーとプロジェクト ID は、`gt-react` や `gt-next` の利用には不要です。必要なのは General Translation API を呼び出す場合だけです。
* 実験的な React セットアップがお使いのプロジェクトで動作しない場合は、[React](/docs/react/react-quickstart) の Docs を参照して手動でセットアップしてください。