# gt: General Translation CLI tool: クイックスタート
URL: https://generaltranslation.com/ja/docs/cli/quickstart.mdx
---

title: クイックスタート
description: General Translation CLI (`gt`) の機能、使いどころ、そして最初のプロジェクトをどう翻訳するかを学びます。
related:
  links:
    - /docs/cli/guides/generating-translations
    - /docs/cli/guides/configuring
    - /docs/cli/guides/managing-translations
    - /docs/cli/guides/using-auto-jsx

---

General Translation CLI (`gt`) は、コマンドラインからプロジェクトの国際化を設定し、翻訳できるツールです。

[`gt-react`、`gt-next`、`gt-react-native`](/docs/react/overview) に加え、`next-intl` や `i18next` などのサードパーティ製 i18n ライブラリ、さらに JSON、YAML、Markdown、MDX などのスタンドアロンファイルにも対応しています。

## CLIでできること [#what-it-does]

CLI を使うと、次のことを直接行えます。

* **初期設定**: 依存関係をインストールし、フレームワークとの連携を設定して、`gt.config.json` を作成します。
* **翻訳**: ソースコンテンツを General Translation API に送信し、結果をコードベースまたは CDN に保存します。
* **CI の構成要素**: 分離された pipeline の各 stage 間で、翻訳のアップロード、エンキュー、ダウンロードを行います。
* **検証**: API を呼び出さずに、プロジェクト内の翻訳エラーを確認します。

## CLIを使うべき場面 [#when-to-use]

CLIは、次のような場合に使用します。

* ガイド付きウィザードで、翻訳用の新しいプロジェクトをセットアップする。
* ビルドやCIパイプラインの一部としてプロジェクトを翻訳する。
* フレームワークのライブラリを追加せずに、スタンドアロンのコンテンツファイルを翻訳する。
* 原文コンテンツと一緒に翻訳をバージョン管理で管理する。

## クイックスタート [#quickstart]

`gt` をインストールし、プロジェクトを設定して、最初の翻訳を実行しましょう。

### 1. `gt` をインストールする

CLI を開発依存関係として追加します。

<Tabs items={['npm', 'yarn', 'bun', 'pnpm']}>
  <Tab value="npm">
    ```bash
    npm install gt --save-dev
    ```
  </Tab>

  <Tab value="yarn">
    ```bash
    yarn add --dev gt
    ```
  </Tab>

  <Tab value="bun">
    ```bash
    bun add --dev gt
    ```
  </Tab>

  <Tab value="pnpm">
    ```bash
    pnpm add --save-dev gt
    ```
  </Tab>
</Tabs>

### 2. プロジェクトを設定する

セットアップウィザードを実行すると、フレームワークが検出され、`gt.config.json` が作成されて、認証情報が生成されます。

```bash
npx gt init
```

ウィザードでは、デフォルトロケールとターゲットロケールを設定し、翻訳の保存先を選んで、API キー と プロジェクト ID を `.env.local` に書き込みます。詳しい設定方法については [CLI の設定](/docs/cli/guides/configuring) を、コマンドの詳細については [`gt init`](/docs/cli/reference/commands/init) を参照してください。

### 3. 本番用の API キーを追加する

[`translate`](/docs/cli/reference/commands/translate) コマンドの実行には、本番用の API キーとプロジェクト ID が必要です。これらはウィザードで生成するか、[API キー ページ](https://generaltranslation.com/dashboard) で作成できます。CLI が参照できるよう、環境変数として設定してください。

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

*注: API キーは環境変数として設定し、`gt.config.json` には絶対に追加しないでください。*

### 4. プロジェクトを翻訳する

`translate` コマンドを実行すると、`gt.config.json` で設定されたすべてのファイルに加え、ソースコード内のインライン [`<T>`](/docs/react/reference/components/t) コンポーネントや辞書エントリも翻訳されます。

```bash
npx gt translate
```

翻訳はコードベースに保存され、すぐにコミットできます。本番用にビルドする前に、CI パイプラインでこれを実行してください。ワークフロー全体については、[翻訳を生成する](/docs/cli/guides/generating-translations)を参照してください。
## Next steps

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