Lingo.dev CLI は、プロジェクト設定を通じてコードベースをローカライゼーションエンジンに接続します。すべての lingo push はお使いのエンジンを経由し、ブランドボイス、用語集、ルール、モデル設定が自動で適用されます。コードの変更も、新たな依存関係の追加も不要です。
変わること#
| 導入前 | 導入後 | |
|---|---|---|
| 翻訳パイプライン | Lingo.devの標準パイプライン | お使いのローカライゼーションエンジン |
| ブランドボイス | なし | 対象ロケールごとに適用 |
| 用語集 | なし | リクエストごとに意味ベースでマッチング |
| ルール | なし | 対象ロケールごとに含まれる |
| モデル選択 | Lingo.dev標準 | フォールバックを含むモデル設定 |
| 品質レビュー | なし | 設定済みのAI評価者が自動実行 |
セットアップ#
1
エンジンに接続する
プロジェクトのルートでlingo linkを実行します:
bash
lingo linkorganizationとlocalization engineを選ぶか、新しく作成します。linkはorgIdとengineIdを.lingo/config.jsonに書き込みます。毎回同じエンジンを使えるように、これをコミットしてください。エンジンIDはダッシュボードからも確認でき、eng_で始まります（例: eng_SxjMwMsfOIsvV1wh）。
2
認証する
bash
lingo loginブラウザが開いて認証を行い、セッションが保存されます。CIや非対話環境で使う場合は、代わりにAPIキーを渡してください:
bash
lingo login --api-key lk_...または、環境変数として設定します:
bash
export LINGO_API_KEY="lk_..."APIキーはダッシュボードのAPI Keysページから生成できます。
3
Pushする
bash
lingo pushCLI はソースファイルをお使いのエンジンに送り、翻訳結果をディスクに書き戻します。その際、ブランドボイス、用語集、ルール、モデル設定が自動で適用されます。
設定リファレンス#
.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（セルフホスト環境またはステージング用） |
動作イメージ#
CLIが生成するすべての翻訳は、エンジンのフルパイプラインを通過します:
- Brand voiceがロケールごとのトーンや丁寧さを調整
- Glossary itemsが意味ベースのマッチングで用語を正確に統一
- ルール は、ロケールごとの言語ルールを適用します
- Model configsが適切なLLMを選択し、自動フォールバックを実行
- AI Reviewersが各リクエスト後に品質を自動評価
翻訳は、APIや各種連携からのリクエストと並んで、トリガータイプとしてapiReportsに表示されます。
