CLI 環境
認証情報、送信先、診断、運用者向けの設定を、プロジェクトのコンテンツ設定とは別に構成します。
マシン固有の設定は環境変数で指定します。ソースパス、翻訳先ロケール、出力構成は、プロジェクトで共有できるよう .lingo/config.json に保存してください。シークレットは、実行環境またはランナーのシークレットストアに保存してください。
認証情報と送信先 #
| 変数 | 動作 |
|---|---|
LINGO_API_KEY | 認証情報の優先順位は、呼び出し時に指定する --api-key より低く、保存済みのログイン情報より高くなります。 |
LINGO_API_URL | API のベースアドレス。既定値は https://api.lingo.dev。 |
送信先を変更すると、呼び出し元のコンテンツと認証情報がその送信先に送信されます。信頼でき、利用が認められたサービスのみを使用してください。
診断と無効化設定 #
| 変数 | 動作 |
|---|---|
LINGO_DEBUG | 空でない値を設定すると、起動時の診断が有効になります。 |
LINGO_TELEMETRY_DISABLED=1 または DO_NOT_TRACK=1 | CLI のテレメトリ(使用状況イベントと OTLP エクスポート)を無効にします。 |
NO_UPDATE_NOTIFIER=1 または LINGO_DISABLE_UPDATE_CHECK=1 | 自動更新チェックを無効にします。 |
NO_COLOR | 色の表示に影響します。 |
CI | 表示に影響します。CI 環境が検出された場合は、更新チェックもスキップします。 |
無効化するには、1 で指定された値を正確に使用してください。デバッグ診断には、Node のバージョン、プラットフォーム、現在の作業ディレクトリ、未加工のコマンドライン引数が含まれます。コマンドラインで指定した API キーが含まれる場合もあります。診断情報を共有する前にシークレットを削除してください。また、デバッグを無効にしても、プロセスや障害の調査時にシークレットが一切露出しなくなるわけではありません。
ローカルでのスコアリング #
lingo score には、Lingo へのログインとは別に OPENROUTER_API_KEY が必要です。モデル設定のプロバイダーフィールドは、通信方式の選択ではなく、OpenRouter のモデルスラッグの構成に使われます。
運用者向けログエクスポートの上書き設定 #
ログエクスポートでは、LINGO_SIGNOZ_INGEST_ENDPOINT、OTEL_EXPORTER_OTLP_LOGS_ENDPOINT、OTEL_EXPORTER_OTLP_ENDPOINT の順に設定が優先されます。取り込みキーの選択では、SIGNOZ_INGESTION_KEY より LINGO_SIGNOZ_INGEST_KEY が優先されます。OTEL_EXPORTER_OTLP_HEADERS で追加のヘッダーを指定できます。OTEL_SERVICE_NAME の既定値は @lingo.dev/cli です。
これらは翻訳ではなく、診断用のインフラストラクチャを設定するものです。キーや機密情報を含むヘッダーは、リポジトリ内のファイルやサポート用ログに含めないでください。通常の認証情報の選択については、認証で説明しています。プロジェクトのパスとロケールは、設定で管理します。