ローカライゼーション向けClaude Codeスキル
npx skills add globalize-now/globalize-skillsを実行すると、ハードコードされた文字列を抽出し、ロケールファイルを生成し、Gitへのプッシュのたびに翻訳を同期するClaude Codeスキルがインストールされます。ダッシュボードも手動レビューも不要です。
Claude Codeはファイルを自律的に編集するエージェント型のコーディングツールです。globalize.nowはそのワークフローにスムーズに組み込まれます。コマンドを一つ実行するだけで、エージェントが文字列を抽出しロケールファイルを生成し、Claude Codeが変更をコミットします。以降のGitプッシュのたびに翻訳は同期され続け、手作業は一切必要ありません。
前提条件
- Claude Codeで作業したことのあるプロジェクト（Next.js、React、Vueなど）
- Gitリポジトリ
- Node.js 18以上
- Claude Codeがインストールされ、認証済みであること
Claude Codeでglobalize.nowをセットアップする方法
Claude Codeのプロジェクトディレクトリを開く
Claude Codeが編集を行っているリポジトリにcdで移動し、パスがGitのルートと一致するようにします。
スキルインストーラーを実行する
globalize.nowでリポジトリを接続してアプリ上で変換するか、プロジェクトのルートからGlobalizeスキルをインストールし、エージェントにi18nの土台構築と文字列スキャンを任せます。
npx skills add globalize-now/globalize-skills --allハードコードされたUI文字列をスキャンする
globalize.nowにツリー全体を走査させ、コンポーネント内にまだ埋め込まれているユーザー向け英語文字列を一覧化します。
提案された翻訳キーの構造を確認する
リファクタリングを適用する前に、名前空間、命名規則、複数形処理のフックを確認してください。
リファクタリングとロケールファイルを適用する
作業内容を承認し、コンポーネントがランタイムのヘルパー関数を呼び出すようにし、JSONカタログをGitに反映させます。
Claude Codeでコミットしてプッシュする
Claude Codeにマージ可能な差分をステージングし、コミット、プッシュさせることで、以降のプッシュでも自動同期が続くようにします。
MCP経由で接続する（任意）
Claude CodeからGlobalizeを操作したいですか？コードがi18n対応済みになったら、MCPを接続してください。
claude mcp add --transport http globalize https://api.globalize.now/mcp詳細：MCPを接続する →
よくある問題
Claude Codeとglobalize.nowが両方ともコンポーネントを編集しようとする
解決方法: まずglobalize.nowを実行してキーとロケールファイルを確立してください。その後Claude Codeは、随所にハードコード文字列を再導入するのではなく、翻訳エントリのほうを編集するようになるはずです。
Claude Codeが新しい文字列を追加した場合、抽出処理を再実行するにはどうすればよいですか？
解決方法: globalize.nowはGitへのプッシュのたびに自動的に実行されるため、変更のたびにインストーラーを手動で再実行しなくても、新しい文字列は検出されます。
よくある質問
globalize.nowはClaude Codeに特化して動作しますか？
はい。globalize.nowはエージェントスキルとリポジトリから実行するCLIとして提供されており、Claude Codeも同じコマンドを実行し、生成された差分をコミットできます。この連携はGitネイティブな仕組みで、ロケールファイルが一度存在すれば、以降のプッシュのたびに翻訳の整合性が保たれます。エディタとバージョン管理以外に別途ダッシュボードは必要ありません。
globalize.nowを認識させるためにClaude Codeを設定する必要はありますか？
必要なのは npx skills add globalize-now/globalize-skills を実行し、セッションを動かしているエージェントがスキルを利用できるようにすることだけです。このブートストラップ手順以外に、Claude Code専用のプラグインは存在しません。インストール後は、他のAIコーディング環境と同様のローカライゼーション関連の指示文でClaude Codeにプロンプトを送ってください。
Claude Codeとglobalize.nowは同じGitワークフローを共有できますか？
両者は同じリポジトリの履歴を共有すべきです。globalize.nowがキーとロケールJSONを書き込み、Claude Codeはそれらのファイルを既に含むブランチ上で機能開発を続けます。通常どおりプルリクエストを通じてマージすることで、レビュアーはプロダクトコードと翻訳の更新を同時に確認できます。その後globalize.nowはプッシュを監視し、下流のロケールを最新の状態に保ちます。
Claude Codeがハードコードされたテキストを含む新しいUIを生成した場合、どうなりますか？
次にGitへプッシュされた際、globalize.nowが新しい文字列を検出し、キーを提案してカタログを自動的に更新します。これにより、英語のJSXとロケールファイルの間にずれが生じるのを防げます。PRのレビューは引き続き必要ですが、機能ブランチごとに手動でバンドルをエクスポートしたり、その場限りのスクリプトを再実行したりする必要はありません。
globalize.nowはClaude Codeによるコードベースの編集能力に影響しますか？
いいえ。最初の抽出処理の後も、Claude Codeはコンポーネントへの完全なアクセス権を保持します。コンポーネントは単に、生の文字列の代わりに翻訳ヘルパーを参照するようになるだけです。globalize.nowはファイルをロックしたり、異なるエディタのワークフローを要求したりすることはありません。コミットがGitを通じて流れる限り、両方のツールは協調して動作します。これはすでにClaude Codeプロジェクトが採用しているリリース方式そのものです。
Claude Codeとglobalize.nowを組み合わせることで最も恩恵を受けるのはどのようなリポジトリですか？
UIテキストがまだインラインで記述されている、AIが編集を行うJavaScriptまたはTypeScriptアプリが最も恩恵を受けます。エージェントは画面をすばやく作り上げていきますが、globalize.nowはその開発スピードを、大規模な書き直しをせずに構造化されたi18nへと転換します。すでにすべての文字列をロケールファイルに格納している場合は抽出作業は少なくて済みますが、多くのClaude Codeのプロトタイプは依然として、globalize.nowが自動化する最初のパスを必要としています。
Claude Codeでglobalize.nowを試す
プロジェクトのルートから開始してください：
npx skills add globalize-now/globalize-skills --all