Add it to your Gemfile

gem 'copy_tuner_client'

Create config/initializers/copy_tuner.rb

CopyTunerClient.configure do |config|
  config.api_key = 'YOUR-API-KEY'
  config.project_id = 77
  config.host = 'COPY-TUNER-HOST-NAME'
  config.html_escape = true

  # I18n keys and messages will be sent to server if the locale matches
  config.locales = [:ja, :en]
end

該当のRailsプロジェクトで下記のrakeを実行する

bundle exec rake copy_tuner:export

これで、config/locales/copy_tuner.yml に翻訳ファイルが作成されます。

config.local_first_key_regexp を設定すると、locale を除いたキー（例 views.foo.bar）がその正規表現にマッチした場合、CopyTuner サーバのキャッシュをスキップして、ローカルの config/locales/*.yml（I18n::Backend::Simple）を優先的に参照します。

CopyTunerClient.configure do |config|
  # ...
  # views.* で始まるキーはローカル YAML を優先する
  config.local_first_key_regexp = /\Aviews\./
end

CopyTuner で一元管理している翻訳を、views.* のような単位で段階的にローカル YAML へ移行するためのオプションです。

• マッチしたキーは CopyTuner キャッシュを一切参照せず、ローカル YAML のみを引きます（完全分離）。
• ローカル YAML にも存在しない場合は未訳（nil / MissingTranslation）となります。CopyTuner へのフォールバックや新規キーのアップロードは行いません。これにより移行漏れを未訳として検知できます。
• マッチしたキーには、ビューヘルパー（t / translate）および SimpleForm のラベルで CopyRay オーバーレイマーカー（<!--COPYRAY key-->）を注入しません。これらのキーは CopyTuner 上で編集できないため、編集可能だと誤認させないためです。

local_first_key_regexp の設定有無にかかわらず、以下の Rails 標準キーは常にローカル YAML 優先になります（CopyTuner をバイパス）。

• number.format / number.currency.format / number.percentage.format / number.human.format（およびその配下）

これらは precision（整数）や significant / strip_insignificant_zeros（真偽値）といった非文字列値を含みます。CopyTuner は文字列値しか保持できないため、経由するとこれらが欠落し、number_to_currency などが意図しない表示（小数桁数や記号の崩れ）になります。これを防ぐため gem 側で固定的にローカル優先にしています。

アプリ独自の number.* キー（例 number.gift_amount）は対象外で、従来どおり CopyTuner で管理できます。

exclude_key_regexp との違い:

exclude_key_regexp は 非推奨です（将来のリリースで削除予定）。設定すると deprecation 警告が出ます。代わりに local_first_key_regexp を使ってください。

# Before（非推奨）
config.exclude_key_regexp = /\Aja\.views\./

# After: locale プレフィックス（ja.）を外して指定する
config.local_first_key_regexp = /\Aviews\./

移行時の注意:

• 対象キーの形式が異なります。exclude_key_regexp は locale 付き（ja.views.foo）、local_first_key_regexp は locale を除いた形式（views.foo）でマッチします。正規表現から locale プレフィックスを外してください。
• 挙動も少し変わります。exclude_key_regexp はアップロードを抑止するだけで lookup 時は CopyTuner キャッシュを参照し続けますが、local_first_key_regexp は lookup 時に CopyTuner キャッシュをスキップしてローカル YAML を優先します（完全分離）。ローカル管理へ移行する用途では local_first_key_regexp のほうが適切です。

skills/copy-tuner/ に Claude Code 向けのスキルが含まれています。

i18n キーの操作を支援するスキルです。翻訳キーの検索・登録・確認などの依頼に自動的に使用されます。

gh skill install SonicGarden/copy-tuner-ruby-client copy-tuner --scope project

詳細: skills/copy-tuner/SKILL.md

src以下を編集してください。 app/assets/*を直接編集したらダメよ！

$ yarn dev   # 開発時
$ yarn build   # ビルド

$ bundle exec rspec

$ bundle exec rake build      # build gem to pkg/ dir
$ bundle exec rake install    # install to local gem
$ bundle exec rake release    # release gem to rubygems.org