トラブルシューティング

APIキーが必要

API key required for gemini backend.

  Option 1: Set via config:
    yaku config set api-key your-api-key

  Option 2: Set environment variable:
    export YAKU_API_KEY=your-api-key

  Option 3: Use hosted service (no key needed):
    yaku config set backend hosted

このエラーは、ローカルバックエンド（Gemini、OpenAI、Anthropic）をAPIキーなしで使用した場合に表示されます。

対処法： エラーメッセージに表示された3つのオプションのいずれかに従ってください。最も簡単な方法は、APIキーが不要なホステッドバックエンドを使うことです：

yaku config set backend hosted

または、お好みのバックエンドのAPIキーを設定してください。セットアップの詳細はバックエンドをご覧ください。

ターゲット言語が未指定

Error: target language required. Use --to <lang> or set default:

  yaku config set default-target ja

対処法： --toを指定するか、デフォルトを設定します：

# コマンドごとに指定
yaku --to ja "Hello"

# デフォルトを設定
yaku config set default-target ja

無効な言語コード

Error: unknown language "japanese". Did you mean "ja"?

対処法： 言語名ではなくBCP 47コードを使用してください：

# 間違い
yaku --to japanese "Hello"

# 正しい
yaku --to ja "Hello"

一般的なコードは言語をご覧ください。

無効なモード

Error: invalid mode "xxx". Use "translate" or "polish"

対処法： --modeオプションはtranslate（デフォルト）またはpolishのみ受け付けます：

yaku --mode translate --to ja "Hello"
yaku --mode polish --to en "fix the grammer"

ネットワークエラー / API到達不可

Error: failed to reach Gemini API. Check your network connection

対処法：

インターネット接続を確認。
プロキシの背後にいる場合は、HTTP_PROXY/HTTPS_PROXY環境変数を設定。
OpenAI互換プロバイダーを使用している場合は、--api-baseが正しいか確認。

入力が長すぎる

Error: input too long (8000 chars). Hosted service limit: 5000 chars per request

このエラーは、テキストがプランのリクエストあたり文字数制限を超えた場合に表示されます。制限はプランの種類に依存します — 詳しくはホステッドサービスとプランをご覧ください。

対処法：

ログイン — yaku loginで制限を5,000（匿名）から10,000（無料）文字に引き上げ。
テキストを小さなチャンクに分割。
ローカルバックエンド（Gemini、OpenAI、Anthropic）と自分のAPIキーを使用 — ローカルバックエンドには文字数制限なし。
yaku quotaで現在の制限を確認。

クォータ超過

Error: Daily limit reached (50/50). Run "yaku login" for higher limits, or use your own API key: yaku config set api-key
More info: https://docs.yakulang.com/guides/hosted-service/

ホステッドサービスの日次または月次リクエスト数をすべて使い切りました。

対処法：

ログイン — yaku loginで月次制限を100（匿名）から300（無料）に引き上げ。
自分のAPIキーを使用 — yaku config set api-key <key>でローカルバックエンドを使えばクォータ制限なし。
待つ — 日次制限はUTC深夜にリセット。
yaku quotaで現在の使用量を確認。

詳しくはホステッドサービスとプランをご覧ください。

モデルが見つからない

Error: model not found or no longer available. Omit --model to use the default

このエラーは、--modelの値がバックエンドで利用可能なモデルと一致しない場合に表示されます。

対処法：

--modelを省略してデフォルトモデルを使用。
プロバイダーのドキュメントでモデル名を確認。

レート制限超過

Error: API rate limit exceeded.

対処法： 待ってからリトライ。頻繁に発生する場合：

別のバックエンドに切り替え（--backend openai）
yaku loginでホステッドバックエンドのクォータを引き上げ
APIプロバイダーのレート制限ドキュメントを確認

無効または未認可のAPIキー

Error: invalid or unauthorized API key. Check your key:

  yaku config get api-key
  yaku config set api-key <new-key>

対処法：

キーを確認：yaku config get api-key
キーが使用しているバックエンドと一致しているか確認（例: GeminiキーをGeminiバックエンドで使う、OpenAIバックエンドでは使わない）。
プロバイダーのダッシュボードでキーを再生成。

リクエストタイムアウト

Error: request timed out. The API did not respond in time. Try again later

対処法： yakuのリクエストタイムアウトは30秒です。大きなファイルの場合：

ファイルを小さなチャンクに分割
インターネット接続速度を確認
別のバックエンドを試す

空の出力

yakuが出力を生成しない場合：

入力が空ではないか？（echo "" | yakuは何も返しません）
--verboseでAPI呼び出しが成功したか確認：
Terminal window
```
echo "test" | yaku --to ja --verbose
```
出力がリダイレクトされていないか確認：yaku --to ja "test" 2>/dev/null

設定ファイルの構文エラー

Warning: config file ~/.config/yaku/config.yaml has invalid YAML syntax: ...
  Open the file and fix the syntax, or delete it and reconfigure:
    ~/.config/yaku/config.yaml
  Using default config until fixed.

対処法： yakuは警告を出力しますがデフォルトで続行します。修正するには：

# 設定ファイルの場所を確認
yaku config path

# 手動で編集するか、削除して再設定
rm ~/.config/yaku/config.yaml
yaku config set default-target ja

無効な設定値

Error: invalid value "abcdefg" for backend. Valid values: hosted, gemini, openai, anthropic

このエラーは、yaku config setに認識されない値を指定した場合に表示されます。

対処法： エラーメッセージに表示された有効な値のいずれかを使用してください。例：

yaku config set backend gemini

検証されるフィールドはbackend（hosted、gemini、openai、anthropicのいずれか）とdefault-target（有効なBCP 47言語コード）です。

YAKU_API_KEYが設定されているが空

Error: YAKU_API_KEY is set but empty (check your key source).

  Example: YAKU_API_KEY=$(cat /path/to/key) yaku --backend gemini ...

このエラーは、YAKU_API_KEYが空文字列に設定されている場合に表示されます — 通常、キーを提供するコマンドがサイレントに失敗した場合（例: $(vault read ...)が何も返さなかった）です。

対処法： キーを提供するコマンドまたはファイルを確認してください。YAKU_API_KEYを設定するつもりがない場合は、unsetしてください：

unset YAKU_API_KEY

セッション期限切れまたは無効

Session expired or invalid. Run yaku login to re-authenticate.

このエラーはyaku whoami実行時に保存されたセッションが無効になっている場合に表示されます。CLIはセッションを自動的にリフレッシュしますが、セッションが完全に期限切れの場合は再認証が必要です。

対処法： 再認証してください：

yaku login

用語集が読み込まれない

用語集の用語が適用されていない場合：

ファイルの存在を確認：ls .yaku-glossary.yaml
言語セクションが--toターゲットと一致しているか確認（大文字小文字は区別しません）：--to jaならja:
--glossary <パス>で明示的に読み込みを指定
--no-glossaryが設定されていないか確認

まだ解決しない場合

以下の情報を添えてissueを開いてください：

yakuのバージョン（yaku version）
実行したコマンド
完全なエラーメッセージ
backend設定（yaku config get backend）