# gt: General Translation CLI tool: グローバルオプション
URL: https://generaltranslation.com/ja/docs/cli/reference/global-options.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: General Translation CLI 全体の出力、互換性チェック、コマンドヘルプを制御します。グローバル CLI オプションの API リファレンス。

グローバルオプションは、`gt` コマンドとそのサブコマンドに適用されます。`--quiet` オプションは、サブコマンドの前後どちらにも指定できます。

## 概要 [#overview]

```bash
npx gt [global options] <command>
```

| Option                                                        | 説明                                 | 型         | 任意 | デフォルト   |
| ------------------------------------------------------------- | ---------------------------------- | --------- | -- | ------- |
| [`--skip-version-check`](#skip-version-check)                 | モノレポ内のパッケージバージョンの整合性チェックをスキップします。  | `boolean` | はい | `false` |
| [`--suppress-id-compatibility-warning`](#suppress-id-warning) | React パッケージの ID 互換性に関する警告を非表示にします。 | `boolean` | はい | `false` |
| [`-q, --quiet`](#quiet)                                       | 情報ログを非表示にします。                      | `boolean` | はい | `false` |
| [`-h, --help`](#help)                                         | 現在のコマンドのヘルプを表示します。                 | `boolean` | はい | `false` |

## `--skip-version-check` [#skip-version-check]

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

モノレポ内の General Translation パッケージの整合性チェックをスキップします。その他の検証は引き続き実行されます。すべてのコマンドでこの動作を維持するには、`gt.config.json` に `"skipVersionCheck": true` を設定します。

## `--suppress-id-compatibility-warning` [#suppress-id-warning]

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

React パッケージ ID の互換性のない動作に関する警告を非表示にします。パッケージのバージョンや翻訳動作は変更されません。

## `-q, --quiet` [#quiet]

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

バナー、進行状況スピナー、情報ログを表示しません。警告とエラーは引き続き表示されます。ただし、コマンドが出力するデータは抑制されません。たとえば、[`gt api-key create`](/docs/cli/reference/commands/api-key-create) は、この場合も新しいシークレットを stdout に出力します。

`GT_LOG_FORMAT` が `json` または `agent` の場合、quiet モードではコンソールログレベルが `warn` に引き上げられます。`error` など、より制限の厳しい `GT_LOG_LEVEL` が設定されている場合でも、そのログレベルは引き下げられません。

ネストされたサブコマンドでも、どの位置でも機能します。

```bash
npx gt translate --quiet
npx gt git setup --quiet
```

*メモ: quiet モードはログのみを抑制し、対話は抑制しません。プロンプトは引き続き表示されるため、非対話的にコマンドを実行する際は、必要なオプションを指定してください。*

## `-h, --help` [#help]

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

コマンドを実行せずに、使用方法、オプション、利用可能なサブコマンドを表示します。

```bash
npx gt translate --help
```

## API 環境変数 [#api-url]

`GT_API_URL` は、すべてのコマンドで使用する API のオリジンを設定します。`gt.config.json` の [`baseUrl`](/docs/cli/reference/config#base-url) より優先され、どちらも設定されていない場合、CLI は `https://api.gtx.dev` を使用します。値が空の場合は未設定として扱われます。

```bash
GT_API_URL=https://api.example.com npx gt translate
```

## ログ出力用環境変数 [#logging]

これらの環境変数で CLI のログ出力を設定できます。すべてのコマンドに適用されます。

| 変数              | 説明                     | 値                                | デフォルト                                                  |
| --------------- | ---------------------- | -------------------------------- | ------------------------------------------------------ |
| `GT_LOG_LEVEL`  | コンソールに出力する最小ログレベル。     | `debug`, `info`, `warn`, `error` | `info`                                                 |
| `GT_LOG_FORMAT` | コンソールの出力形式。            | `default`, `json`, `agent`       | ターミナルでは `default`、CI 環境または stdout がターミナルでない場合は `agent` |
| `GT_LOG_FILE`   | 完全なログをこのファイルパスに書き込みます。 | ファイルパス                           | —                                                      |

`default` は対話型の表示形式で、ASCII バナーと CLI のバージョン行が表示されます。`json` は 1 行につき 1 つの JSON ログオブジェクトを出力します。`agent` はタイムスタンプ付きの `LEVEL: message` 形式のプレーンテキストを、色付けやバナーなしで 1 行ずつ出力します。`json` でもバナーは表示されません。

`gt` 2.26.10 以降、`GT_LOG_FORMAT` が未設定の場合は、stdout がターミナルでないとき、または `CI` が空でなく `false` でも `0` でもないときに `agent` が使用されます。これらの環境でも対話型の表示を使用するには、`GT_LOG_FORMAT=default` を設定してください。

`GT_LOG_FILE` は明示的に有効化するデバッグキャプチャ用の設定であり、[`--quiet`](#quiet) の影響を受けません。コンソール出力を抑制しながら、完全なログをディスクに保存するには、次のようにします。

```bash
GT_LOG_FILE=gt.log npx gt translate --quiet
```

[`gt api-key create`](/docs/cli/reference/commands/api-key-create) では、診断情報は stderr に出力されます。シークレットは JSON ログ出力を使用している場合でも加工されずにそのまま stdout に出力され、`GT_LOG_FILE` に記録されることはありません。

*メモ: `GT_LOG_FORMAT` または `GT_LOG_LEVEL` に無効な値を指定すると、コマンドはエラーで停止します。*

## Sitemap

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