設定

設定ファイル

yakuはYAMLファイルに設定を保存します。場所は以下で確認できます：

yaku config path

ファイルは最初にyaku config setを実行したときに自動作成されます。直接編集することもできます — yakuはコメントとフォーマットを保持します。

全設定フィールド

フィールド	型	デフォルト	説明
`api-key`	`string`		ローカルバックエンド（Gemini、OpenAI、Anthropic）用のLLM APIキー。
`default-target`	`string`		デフォルトのターゲット言語。`--to`を省略可能にします。
`backend`	`string`	`hosted`	LLMバックエンド：`hosted`、`gemini`、`openai`、`anthropic`。設定時に検証されます。
`model`	`string`	`backend`のデフォルト	モデル名の上書き（例: `gemini-2.5-flash`、`gpt-4o-mini`）。
`api-base`	`string`		ローカルバックエンド用の API ベース URL オーバーライド。OpenAI 互換プロバイダーでよく使用。
`hosted-url`	`string`	`https://api.yakulang.com`	ホステッドサービスのAPIエンドポイント。認証エンドポイントは自動的に導出されます（`api.`プレフィックスを除去）。
`prompt`	`string`		カスタムシステムプロンプトファイルのパス。すべての翻訳に適用されます。

設定ファイルの例

api-key: AIzaSy...your-gemini-key
default-target: ja
backend: gemini
model: gemini-2.5-flash

設定の管理

# 値を設定
yaku config set default-target ja

# 値を読み取り（ファイルのみ、環境変数は無視）
yaku config get default-target

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

環境変数

環境変数は設定ファイルの値を上書きします。CI/CD、コンテナ、プロジェクト間の切り替えに便利です。

変数	上書きする設定フィールド	例
`YAKU_API_KEY`	`api-key`	`export YAKU_API_KEY=AIza...`
`YAKU_DEFAULT_TARGET`	`default-target`	`export YAKU_DEFAULT_TARGET=ja`
`YAKU_BACKEND`	`backend`	`export YAKU_BACKEND=openai`
`YAKU_MODEL`	`model`	`export YAKU_MODEL=gpt-4o`
`YAKU_API_BASE`	`api-base`	`export YAKU_API_BASE=https://api.groq.com/openai/v1`
`YAKU_HOSTED_URL`	`hosted-url`	`export YAKU_HOSTED_URL=https://api.staging.yakulang.com`

環境変数の上書き動作

YAKU_*環境変数が設定されている場合 — 空文字列であっても — 対応する設定ファイルの値を上書きします。これにより、キーソースが失敗したときのサイレントフォールバックを防ぎます：

# 明示的に空 → 設定ファイルを上書き、キーが空になる
YAKU_API_KEY="" yaku --backend gemini --to ja "test"
# Error: YAKU_API_KEY is set but empty (check your key source).

バックエンド固有のAPIキーフォールバック

YAKU_API_KEYがまったく設定されていない（空文字列でもない）場合で、設定ファイルにapi-keyもない場合、yakuは解決されたバックエンド（--backendオプションを含む）に基づいて以下のバックエンド固有の環境変数をチェックします：

バックエンド	フォールバック変数
`gemini`	`GOOGLE_API_KEY`
`openai`	`OPENAI_API_KEY`
`anthropic`	`ANTHROPIC_API_KEY`

これにより、他のツール（Google Cloud SDKやOpenAI CLIなど）の既存の環境変数を追加設定なしで使用できます。--backendと組み合わせれば、設定を変更せずにプロバイダーを切り替えられます：

export GOOGLE_API_KEY=your-gemini-key
export OPENAI_API_KEY=your-openai-key
yaku --backend gemini --to ja "Hello"
yaku --backend openai --to ja "Hello"

優先順位

同じ設定が複数の場所で指定された場合、最も優先度の高いソースが使われます：

コマンドラインオプション（最高） — 例: --to ja
環境変数 — 例: YAKU_DEFAULT_TARGET=ja
設定ファイル — ~/.config/yaku/config.yaml
組み込みデフォルト（最低）

例：設定ファイルにdefault-target: enがあっても、yaku --to jaを実行するとターゲット言語はjaになります。

エラー処理

設定ファイルが存在しない場合： yakuは組み込みデフォルトを使用します。エラーなし。
YAML構文エラー： yakuはstderrに警告を出力し、デフォルトで続行します。
未知の設定キー： yaku config setは上記リストにないキーを拒否します。
無効な設定値： yaku config setは値を検証します。backendはhosted、gemini、openai、anthropicのいずれかでなければなりません。default-targetフィールドは有効なBCP 47言語コードでなければなりません。