# gt: General Translation CLI tool: gt login
URL: https://generaltranslation.com/ja/docs/cli/reference/commands/login.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: ホスト型 CLI ワークフローで使用するアカウントにサインインします。gt login コマンドの API リファレンスです。

既存のセットアップを認証するには、login を使用します。ガイドに沿ってプロジェクトをセットアップする場合は、[`gt init`](/docs/cli/reference/commands/init) を実行してください。`gt init` はプロジェクトまたはキーを作成する際、ツーリングキーも保存済みのログインもない場合に、自動的にサインインを行います。スコープ付きのキーを作成するには、[`gt api-key create`](/docs/cli/reference/commands/api-key-create) を使用します。

## 概要 [#overview]

[Node.js 20 以降](/docs/cli/quickstart#quickstart)が必要です。現在サポート期間中の LTS リリースの使用を推奨します。

```bash
npx gt login [options]
```

| パラメータ                           | 説明                                          | 型         | 任意 | デフォルト            |
| ------------------------------- | ------------------------------------------- | --------- | -- | ---------------- |
| [`--no-browser`](#flags)        | ローカルのブラウザコールバックではなく、デバイス認可を使用します。           | `boolean` | はい | `false`          |
| [`-c, --config <path>`](#flags) | 設定ファイル。その `baseUrl` によってサインイン先の API が決まります。 | `string`  | はい | `gt.config.json` |

<Callout type="info">
  **v2.22 での変更:** 従来の auth コマンドとそのキー種別フラグは削除されました (エイリアスとしても残っていません) 。アカウントへのサインインは login に置き換わり、プロビジョニングは init と明示的なキー作成で行います。既存の API キーは引き続き使用できます。
</Callout>

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

* ブラウザが開き、アカウントへの CLI のアクセスを承認できます。
* アクセスできるプロジェクトと操作は、アカウントの権限によって決まります。
* `--no-browser` を指定した場合、またはこのマシンでブラウザコールバックを待ち受けられない場合は、デバイス認可を使用します。検証用の URL とコードが表示されるので、別のデバイスで承認してください。
* SSH セッションでは自動的にデバイス認可を使用します。ブラウザの起動に失敗しただけではモードは切り替わりません。表示された認可 URL を手動で開くか、`--no-browser` を指定して再実行してください。
* 保存されるのはアカウントセッションであり、プロジェクトの選択は保存されません。API キーの作成や `.env.local` への書き込みは行いません。Runtime SDK は CLI セッションを読み込みません。

プロジェクトのバインディング、明示的に指定したキーの優先順位、CI 用の認証情報については、[CLI の設定](/docs/cli/guides/configuring#credentials)を参照してください。

## フラグ [#flags]

**`--no-browser`** · **型** `boolean` · **任意** · **デフォルト** `false`

ブラウザを開かずにデバイス認可を使用します。ただし、人による承認は引き続き必要なため、CI での無人認証には使用できません。

**`-c, --config <path>`** · **型** `string` · **任意** · **デフォルト** `gt.config.json`

自動検出された `gt.config.json` の代わりに、指定した設定ファイルから [`baseUrl`](/docs/cli/reference/config#base-url) を読み込みます。ただし、`GT_API_URL` が設定されている場合はそちらが優先されます。`gt` 2.23.0 以降が必要です。

[グローバルオプション](/docs/cli/reference/global-options)も使用できます。

## 例 [#examples]

```bash
# このマシンのブラウザでサインイン
npx gt login

# 別のデバイスでサインインを承認
npx gt login --no-browser
```

承認後、[`gt whoami`](/docs/cli/reference/commands/whoami) でログイン中のアカウントを確認できます。保存されたセッションを削除するには、[`gt logout`](/docs/cli/reference/commands/logout) を使用します。

## 保存場所とトラブルシューティング [#storage]

セッションは、`XDG_STATE_HOME` が絶対パスの場合は `$XDG_STATE_HOME/gt/credentials.json` に、それ以外の場合は `~/.local/state/gt/credentials.json` に保存されます。相対パスが指定された XDG 値は無視されます。

認証情報ファイルには、対応している環境では所有者のみがアクセスできるファイル権限が設定されます。ただし、暗号化や OS のキーチェーンへの保存は行われません。旧形式で保存されたログイン情報は自動では移行されません。保存済みの認証情報が古い、または無効になっている場合は、再度サインインしてください。破損した認証情報ファイルは `.corrupt-<timestamp>` という名前のバックアップとして保持されます。

CLI では、コマンドを実行するたびにサインインし直す必要はありません。複数の CLI プロセスから同じ保存済みログイン情報を同時に更新することは避けてください。

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.