# gt: General Translation CLI tool: CLI の設定
URL: https://generaltranslation.com/ja/docs/cli/guides/configuring.mdx
---

title: CLI の設定
description: "General Translation の gt.config.json を設定する方法を説明します。このガイドでは、ロケール、ファイル、保存オプションの設定を扱います。"
related:
  links:
    - /docs/cli/guides/generating-translations
    - /docs/cli/guides/managing-translations
    - /docs/cli/guides/using-auto-jsx
    - /docs/cli/guides/branching

---

CLI は、プロジェクトのルートにある `gt.config.json` ファイルを読み取り、何を翻訳するかと、結果の保存先を決定します。このガイドでは、そのファイルの作成方法と編集方法を説明します。

*注: このガイドでは、一般的な設定項目を扱います。利用可能なすべてのフィールドについては、[設定リファレンス](/docs/cli/reference/config)を参照してください。*

## 設定ファイルを作成する [#create]

`gt.config.json` は、3つの方法で作成できます。ワークフローに合った方法を選んでください。

### a) セットアップウィザードを一括で実行する

[`gt init`](/docs/cli/reference/commands/init) を実行すると、フレームワークの検出、依存関係のインストール、設定ファイルの作成、認証情報の生成を一度に行えます。

```bash
npx gt init
```

### b) 設定ファイル のみを作成する

依存関係をインストールしたり、フレームワークのセットアップを変更したりせずに `gt.config.json` のみを作成するには、[`gt configure`](/docs/cli/reference/commands/configure) を実行します。

```bash
npx gt configure
```

### c) 手動で記述する

自分でファイルを作成し、エディタでの検証や自動補完のために`$schema`参照を追加します。

```json title="gt.config.json"
{
  "$schema": "https://assets.gtx.dev/config-schema.json",
  "defaultLocale": "en",
  "locales": ["fr", "es"]
}
```

## ロケールを設定する [#locales]

`defaultLocale` にはソースコンテンツの言語を設定し、`locales` には対象の言語を列挙します。

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["fr", "es", "ja"]
}
```

どちらも `en`、`en-US`、`zh` のような標準的なロケールコードを使用します。完全な一覧は、[対応ロケール](/docs/platform/dashboard/reference/supported-locales)を参照してください。

ロケールにカスタムのエイリアスを使うには — たとえば `zh` の代わりに `cn` を使う場合 — 正式なコードを指す `customMapping` エントリを追加してください。

```json title="gt.config.json"
{
  "customMapping": {
    "cn": { "code": "zh" }
  }
}
```

## 翻訳するファイルを選択する [#files]

翻訳したいファイルタイプごとにキーを持つ `files` オブジェクトを追加します。各タイプでは、`include` 配列に glob パターンを指定します。このパターンでは `[locale]` プレースホルダーを使ってソースファイルの場所を特定し、翻訳後のファイルの保存先も指定します。

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["fr", "es"],
  "files": {
    "json": {
      "include": ["locales/[locale]/**/*.json"]
    },
    "mdx": {
      "include": ["content/docs/[locale]/**/*.mdx"]
    }
  }
}
```

CLI は、ソースファイルを検索する際は `[locale]` を `defaultLocale` に置き換え、翻訳を保存する際は各ターゲットコードに置き換えます。タイプごとのオプションについては [File formats](/docs/cli/reference/formats/gt-jsx-files) を、詳細なマッチングについては [`include`](/docs/cli/reference/config#files) を参照してください。

## 翻訳の保存先を選択する [#storage]

`gt-next`、`gt-react`、または `gt-react-native` を使用している場合は、翻訳をどのように配信するかを決めます。

* アプリに翻訳をバンドルするには、**ローカルに保存**します。`[locale]` を含む `output` パスを指定した `gt` エントリを追加します。
* 翻訳をバンドルせずに Runtime で読み込むには、**CDN に公開**します。`publish` を `true` に設定します。

```json title="gt.config.json"
{
  "files": {
    "gt": {
      "output": "public/i18n/[locale].json"
    }
  }
}
```

[CDN 公開](/docs/cli/reference/config#cdn-publishing)を参照して、公開をグローバル、ファイルごと、またはコマンドごとに制御してください。

## 認証情報を追加する [#credentials]

[`translate`](/docs/cli/reference/commands/translate) コマンドの実行には、本番用の API キーとプロジェクト ID が必要です。これらは `gt.config.json` には含めず、代わりに環境変数として設定してください。

```bash title=".env"
GT_API_KEY=your-api-key
GT_PROJECT_ID=your-project-id
```

[`gt auth`](/docs/cli/reference/commands/auth) を実行すると、これらが生成されて `.env.local` に自動的に書き込まれます。
## Next steps

- /docs/cli/guides/generating-translations
- /docs/cli/guides/managing-translations
- /docs/cli/guides/using-auto-jsx
- /docs/cli/guides/branching