FAQ

yakuとは？

yaku（訳）は、ターミナルからテキスト、ファイル、開発出力を翻訳するCLIツールです。stdin、ファイル、または引数から読み込み、翻訳されたテキストをstdoutに出力します。jqやsedのようなツールですが、自然言語向けです。

詳しい比較はなぜyaku？をご覧ください。Google翻訳、汎用AI CLI（llm、sgpt、aichat）、Translate Shellとの比較を掲載しています。

CLIはオープンソース（BSD 3-Clauseライセンス）で、自分のAPIキーを使えば無料で利用できます。api.yakulang.comのホステッドサービスはセットアップ不要で動作し、無料枠も含まれています。プランの詳細とクォータ制限はホステッドサービスとプランをご覧ください。

4つのバックエンドに対応しています：

バックエンド	デフォルトモデル	使い方
ホステッド (`api.yakulang.com`)	サーバー側	デフォルト — セットアップ不要
Google Gemini	`gemini-2.5-flash`	`yaku config set backend gemini`
OpenAI	`gpt-4o-mini`	`yaku config set backend openai`
Anthropic	`claude-haiku-4-5-20251001`	`yaku config set backend anthropic`

OpenAIバックエンドは、OpenAI互換APIにも対応しています（Groq、Together.ai、DeepSeek、Ollama）。詳しくはバックエンドをご覧ください。

選択したLLMバックエンドが翻訳できるすべての言語に対応しています。yakuはハードコードされた言語リストを持っていません。言語コードをそのままモデルに渡します。詳しくは言語をご覧ください。

ローカルバックエンド（Gemini、OpenAI、Anthropic）： yakuはテキストをLLM APIに直接送信し、結果を返します。yaku側では何も保存しません。データの取り扱いについては、ご利用のLLMプロバイダーのプライバシーポリシーをご確認ください。

ホステッドバックエンド： テキストは翻訳のためにapi.yakulang.comに送信されます。ホステッドサービスはレスポンス返却後にテキストを保持しません。

はい、OpenAI互換バックエンドを使ってローカルモデルで利用できます。例えば、Ollamaの場合：

yaku --backend openai \
  --api-base http://localhost:11434/v1 \
  --model llama3 \
  --to ja "Hello"

用語集ファイルを使います。プロジェクトルートに.yaku-glossary.yamlを作成してください：

ja:
  Kubernetes: ~     # 英語のまま保持
  container: コンテナ   # 常にこの訳語を使用

yakuは自動的にこのファイルを読み込み、すべての翻訳プロンプトに用語を注入します。

はい、ローカルバックエンドで使えます。--promptオプションを使うと、yakuの組み込みシステムプロンプトを完全に置き換えます：

yaku --to ja --prompt my-prompt.txt -f docs.en.md

カスタムプロンプトはローカルバックエンド（Gemini、OpenAI、Anthropic）でのみ動作します。ホステッドバックエンドはサーバー側のプロンプトを使用し、--promptは無視されます。詳しくはカスタムプロンプトをご覧ください。

yakuのバージョン（yaku version）、実行したコマンド、エラーメッセージを添えて、issueを開いてください。