エンジンを接続

Lingo.dev CLI は、プロジェクト設定を通じてコードベースをローカライゼーションエンジンに接続します。すべての lingo push はお使いのエンジンを経由し、ブランドボイス、用語集、ルール、モデル設定が自動で適用されます。コードの変更も、新たな依存関係の追加も不要です。

変わること#

	導入前	導入後
翻訳パイプライン	Lingo.devの標準パイプライン	お使いのローカライゼーションエンジン
ブランドボイス	なし	対象ロケールごとに適用
用語集	なし	リクエストごとに意味ベースでマッチング
ルール	なし	対象ロケールごとに含まれる
モデル選択	Lingo.dev標準	フォールバックを含むモデル設定
品質レビュー	なし	設定済みのAI評価者が自動実行

セットアップ#

エンジンに接続する

プロジェクトのルートでlingo linkを実行します:

bash

lingo link

organizationとlocalization engineを選ぶか、新しく作成します。linkはorgIdとengineIdを.lingo/config.jsonに書き込みます。毎回同じエンジンを使えるように、これをコミットしてください。エンジンIDはダッシュボードからも確認でき、eng_で始まります（例: eng_SxjMwMsfOIsvV1wh）。

認証する

bash

lingo login

ブラウザが開いて認証を行い、セッションが保存されます。CIや非対話環境で使う場合は、代わりにAPIキーを渡してください:

bash

lingo login --api-key lk_...

または、環境変数として設定します:

bash

export LINGO_API_KEY="lk_..."

APIキーはダッシュボードのAPI Keysページから生成できます。

Pushする

bash

lingo push

CLI はソースファイルをお使いのエンジンに送り、翻訳結果をディスクに書き戻します。その際、ブランドボイス、用語集、ルール、モデル設定が自動で適用されます。

設定リファレンス#

`.lingo/config.json`#

項目	説明
`orgId`	エンジンを所有するorganizationです。`lingo link`で設定されます。
`engineId`	翻訳を実行するエンジン（`eng_...`）です。`lingo link`で設定されます。

sourceLocale、targetLocales、filesは、他のプロジェクトと同様に機能します。詳しくはConfigurationを参照してください。

環境変数#

変数	必須	デフォルト	説明
`LINGO_API_KEY`	CIのみ	-	Lingo.devのAPIキー（`lingo login`の代わり）
`LINGO_API_URL`	不要	`https://api.lingo.dev`	カスタムAPIベースURL（セルフホスト環境またはステージング用）