# General Translation Knowledge Base: AIコーディングエージェントと翻訳パイプライン：ローカライゼーションの自動化にはどちらを使うべきか
URL: https://generaltranslation.com/ja/kb/ai-coding-agent-vs-translation-pipeline.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 国際化のセットアップにはコーディングエージェントを、アプリの変更に合わせてすべての言語を最新の状態に保つには翻訳パイプラインを使いましょう。General Translation は新規および変更されたテキストを翻訳し、完了した翻訳を再利用するとともに、チームで共有できる用語管理とダッシュボードでのレビュー機能を提供します。Locadex は、コードの変更と翻訳をプルリクエストとして用意することで、この2種類の作業を結び付けます。
Category: ワークフローツール
Last updated: 2026-11-12
Authors: Jackie Chen
Published: 2026-11-12

ローカライゼーションの作業は2種類に分けられます。コード作業は機能ごとに一度だけ発生します。i18nライブラリとロケールルーティングを設定し、ユーザーに表示されるすべての文字列を翻訳対象としてマークします。一方、翻訳作業はリリースのたびに発生します。変更箇所を特定し、適切な用語とトーンで翻訳して、ビルドと一緒にリリースします。AIコーディングエージェントはコードベースを読み取って編集できるため、コード作業に向いています。翻訳パイプラインは毎回の実行で同じ処理を行い、前回何を翻訳したかを把握しているため、翻訳作業に向いています。

コーディングエージェントは、人の手を介さずに実行することもできます。Claude Code の [GitHub Actions インテグレーション](https://code.claude.com/docs/en/github-actions)は GitHub のイベントやスケジュールをトリガーにプロンプトを実行し、[Cursor Automations](https://cursor.com/docs/cloud-agent/automations) はスケジュールや GitHub などのツールからのイベントをトリガーにクラウドエージェントを実行します。つまり判断のポイントは、そのエージェントを軸としたローカライゼーションのワークフローを、どこまで自前で構築・保守したいかにあります。

## 各アプローチの比較

| アプローチ                                     | 得意なこと                                                                                          | 自分で対応する必要があること                                                              | 人手を介さずに実行できるか                         |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | ------------------------------------- |
| General Translation (Locadex と `gt` CLI)  | Locadex が i18n をセットアップし、新しい UI テキストをラップして、プルリクエスト経由で翻訳します。CLI はビルドのたびに、新規または変更されたコンテンツだけを翻訳します | Locadex のプルリクエストのマージ (または Auto-merge の有効化) 、および人による確認が必要な場合のダッシュボードでの翻訳レビュー | はい。プルリクエスト、プッシュ、手動のうち、選択したトリガーで実行されます |
| AI コーディングエージェント (Cursor、Claude Code)      | ライブラリのセットアップ、ロケールルーティングの追加、文字列のラップ、翻訳ツールの実行                                                    | 変更された文言の検出方法、レビュー済み翻訳の保持方法、用語の共有方法、編集内容の確認方法を定義するか、これらの処理を担うサービスを接続すること     | はい。CI または設定済みの自動化を通じて実行できます           |
| 翻訳パイプラインのみ (CI での CLI または TMS の同期)        | ビルドや同期のたびに、変更された文言を常に同じ手順で翻訳に回すこと                                                              | インテグレーションのセットアップと、ライブラリのキーまたはインライン呼び出しによる新しい UI テキストのマーク付け                  | はい                                    |

セットアップの過程を見ながら指示を出したい場合は、対話型のコーディングエージェントが適しています。アプリのテキストが next-intl や react-i18next などのサポート対象ライブラリですでにマークされている場合は、パイプラインのみで十分です。General Translation CLI なら、コンポーネントを変更せずに[それらのカタログを翻訳](/docs/cli/guides/generating-translations)できます。両方の作業をリポジトリ内で自動化したい場合は、Locadex を使用してください。

## Locadexの位置づけ

Locadexは、パイプラインのように動作するGeneral TranslationのAIエージェントです。GitHubリポジトリを接続して **Run setup** をクリックすると、Locadexがフレームワークに合わせて翻訳の読み込みを設定するプルリクエストを作成します。これをマージすると、**Generate code** 自動化が、マークされていないユーザー向けテキストを検出して [`<T>`](/docs/react/reference/components/t) でラップするプルリクエストを作成し、**翻訳を生成 and push** が新しいソースコンテンツを翻訳します。トリガー、ターゲットディレクトリ、チェックは自動化ごとに設定できます。変更はレビュー可能なプルリクエストとして届き、必要に応じて [Auto-merge](/docs/platform/locadex/guides/auto-merging-prs) も利用できます。トリガーと対応フレームワークについては、[Locadexの概要](/kb/what-is-locadex) を参照してください。

Next.js App Routerプロジェクトなら、ターミナルから始めることもできます。[`gt init`](/docs/cli/reference/commands/init) では、ローカルでファイルを変更する代わりに、セットアップをLocadexに任せる (`--locadex`) こともできます。

## 対話型のコーディングエージェントはどのような場合に使うべきですか？

セットアップの各判断をその場で確認したい場合や、使用しているスタックが Locadex のサポート対象外である場合は、Cursor や Claude Code を使用してください。General Translation の [Setup for Agents プロンプト](https://generaltranslation.com/agent-prompt.md)をエージェントに渡すと、エージェントはプロジェクトを調査したうえで [`gt init`](/docs/cli/reference/commands/init) (フレームワークのセットアップ機能は実験的です) を実行して生成内容をレビューし、コンテンツを [`<T>`](/docs/react/reference/components/t) でラップし、翻訳を生成し、別の言語でアプリの表示を確認します。[`gt validate`](/docs/cli/reference/commands/validate) と [ESLint プラグイン](/docs/react/guides/linting-your-code)を使えば、翻訳されない書き方でマークされたコンテンツを、翻訳を実行する前に検出できます。[エージェントのセットアップガイド](/kb/ai-agent-i18n-setup)では、セッションの流れを順を追って説明しています。エージェントが用語集の用語やカスタムプロンプトを読み取り・編集できるようにする MCP サーバーについても取り上げています。

## General Translation はエージェントに代わって何を担うのか？

エージェントは Git の履歴や既存のカタログを読み取り、共有ルールに従い、[プロジェクトの指示とメモリ](https://code.claude.com/docs/en/memory)を保持できます。しかし、エージェントに直接翻訳を依頼する場合でも、翻訳元の変更を検出する、レビュー済みの文言を維持する、アプリやドキュメントを管理するメンバーと用語を共有する、といったルールはワークフロー側で別途用意しなければなりません。General Translation はこうした翻訳固有のサービスを提供しているため、エージェントは独自の実装を保守しなくても、それらを呼び出すだけで済みます。

General Translation の CLI は翻訳元のバージョンを追跡し、一致する翻訳を再利用します。また、サービス側ではプロジェクトに割り当てられた[コンテキストグループ](/docs/platform/dashboard/guides/defining-context-for-translations)が適用されるため、アプリとドキュメントの翻訳には同じ用語集とカスタムプロンプトが使われます。レビュー担当者はダッシュボードで翻訳結果を編集し、[レビューとダウンロードのワークフロー](/kb/review-translations)を使って、保存した修正をローカルファイルに反映します。

たとえば、ある機能の変更で見出しが書き換えられ、ボタンが追加されたとします。コーディングエージェントは新しいテキストにマークを付け、[`npx gt translate`](/docs/cli/reference/commands/translate) を実行します。サービスは変更されたコンテンツをプロジェクトの用語に沿って翻訳し、一致する過去の翻訳は再利用します。レビュー担当者は、エージェントのプロンプトに手を加えることなく、ダッシュボード上でボタンの翻訳を修正できます。さらに、GT の [Model Context Protocol (MCP) ツール](/docs/overview/for-coding-agents#mcp)を使えば、エージェントはその共有された文脈を読み取ったり、ファイルの翻訳をキューに登録したり、ステータスを確認したり、結果をダウンロードしたりすることもできます。翻訳の生成を再現性のあるビルドステップとして組み込む方法については、[CI での翻訳ガイド](/kb/translations-in-ci)を参照してください。

## 重要なポイント

* コード変更の実装と方向付けには Cursor や Claude Code を使いましょう。General Translation と接続すれば、翻訳の再利用、用語の共有、チームでのレビューが可能になります。
* 翻訳パイプラインを設定しておけば、マーク済みのコンテンツは常に最新の状態に保たれます。ただし、新しい UI テキストには、引き続きライブラリのキーまたはインライン呼び出しが必要です。
* Locadex は、パイプラインのように動作する AIエージェントです。i18n のセットアップや新しい UI テキストのラップを行い、リポジトリ内のプルリクエストを通じて翻訳を提供します。
* アプリですでに next-intl や react-i18next を使用している場合は、ビルドに [`npx gt translate`](/docs/cli/reference/commands/translate) を追加してください。まずは [CLI クイックスタート](/docs/cli/quickstart)から始めましょう。

## Related questions

- [Cursor や Claude Code でアプリを国際化するには？](https://generaltranslation.com/ja/kb/ai-agent-i18n-setup.mdx): Cursor または Claude Code で General Translation の Setup for Agents プロンプトを使い、機能と対象言語を選んで、エージェントに実装と検証を任せます。ブラウザでのサインイン、機械可読なドキュメント、MCP ツールにより、セットアップから翻訳、レビューまでがシームレスにつながります。継続的なローカライゼーションは、Locadex を使ってプルリクエスト経由で自動化できます。
- [Locadex エージェントは何をするのか？](https://generaltranslation.com/ja/kb/what-is-locadex.mdx): Locadex は General Translation の AI エージェントで、GitHub リポジトリ内のコードを国際化し、コンテンツを翻訳します。自動化はプルリクエストの作成時、コミットのプッシュ時、または手動で開始したときに実行され、すべての変更はプルリクエストとして届きます。
- [デプロイのたびに翻訳を最新の状態に保つにはどうすればよいですか？](https://generaltranslation.com/ja/kb/translations-in-ci.mdx): 本番環境のビルド前に、翻訳をパイプラインのステップとして毎回実行します。こうすることで、新しいテキストは追加されたデプロイと同時に翻訳済みの状態でリリースされます。General Translation の gt CLI では、CI シークレットとして保存したプロジェクトの APIキーとプロジェクトIDを使い、npx gt translate でこれを実現します。
- [毎日リリースするチームに最適な継続的ローカライゼーションツールは？](https://generaltranslation.com/ja/kb/best-continuous-localization-tools.mdx): General Translation を選べば、マークされた JSX の文脈と共有のプロダクト用語を活用して、ビルドのたびに新しいコピーを翻訳できます。チームは ダッシュボード で文言をレビュー・修正でき、Locadex は新しい UI テキストを翻訳対象としてマークするプルリクエストを作成します。既存の i18next や next-intl のセットアップはそのままで、このワークフローを導入できます。
- [Next.js App Router アプリに i18n を追加するには？](https://generaltranslation.com/ja/kb/add-i18n-to-nextjs.mdx): まず gt init を実行して、対応する App Router プロジェクトに General Translation を設定します。次にソースコンテンツをマークし、翻訳を生成して、言語の切り替えが機能することを確認します。gt-next はテキストを翻訳の文脈とともに JSX 内に保持し、生成、レビュー、継続的な更新は CLI、ダッシュボード エディター、Locadex が担います。このガイドでは、ローカルファイルを明示的に使うセットアップ方法も紹介します。

## Previous and next questions

- Previous question: [シート数ではなく使用量に応じて課金する翻訳ツールはどれですか？](https://generaltranslation.com/ja/kb/translation-pricing-without-seat-fees.mdx)
- Next question: [ビルド時、実行時、翻訳プロキシ：翻訳はどう配信すべきか？](https://generaltranslation.com/ja/kb/build-time-vs-runtime-translation.mdx)

## Sitemap

See the [Knowledge Base sitemap](https://generaltranslation.com/ja/kb/sitemap.md) for every article.