生成 AI の設定¶

Zenith Filer は生成 AI を活用した 8 種類以上の支援機能を搭載しています。AI 機能は Control Deck → 生成 AI で API プロバイダーとキーを設定してから利用します。

AI プロバイダー設定¶

設定場所: Control Deck → 生成 AI
対応プロバイダー: Claude / OpenAI / Azure OpenAI / Gemini / Ollama / Claude Code (CLI) の 6 種類
API キー管理: DPAPI で暗号化し、ローカルにのみ保存（外部送信なし）。「削除」で保存済みキーをクリア
テスト接続: API キー区分内の「テスト接続」ボタンで API キーの有効性を検証。

失敗時は HTTP ステータスコード別の具体的なガイド（キー無効、権限不足、レート制限など）を表示。 - モデル選択: プロバイダごとにドロップダウンから選択（空の場合はデフォルトモデルを使用） - モデル検証: モデル区分内の「モデル検証」ボタンで、選択したモデルが実際に使用可能かを検証。モデル名の誤りやアクセス権の問題を事前に確認可能。 - 応答を待つ時間: 概要タブで設定します。既定の「おまかせ」は接続先に応じて待ち時間を変えます（クラウドのプロバイダー 30 秒 / 思考型モデル 2 分 / Claude Code 4 分 / Ollama などローカル実行 5 分）。ローカルで動かすモデルは初回のモデルロードだけで数分かかることがあるため、応答が途中で打ち切られる場合は 5 分や 10 分を選んでください。 - OpenAI / Azure OpenAI の API 形式自動対応: GPT-4.1 等の従来モデルは Chat Completions API、GPT-5 系等の新世代モデルは Responses API と、モデルによって必要な API 形式が異なりますが、モデル名から自動判定して送信します。判定が外れた場合もエラー応答から検知して自動的にもう一方の形式へ切り替えるため、モデル名を選ぶだけで意識せず利用できます。 - AI ON/OFF: ステータスバーの Sparkles アイコンで AI 機能の有効/無効を切り替え。長押しで設定画面を直接開く。 - Ollama（ローカル LLM）プロバイダー: API キー不要でローカル実行可能な Ollama プロバイダーに対応。

ワンクリック自動インストール、推奨モデルのダウンロード管理、サーバーの自動起動・停止が可能です。Ollama タブでは、未インストール時にセットアップガイドが表示されます:
1. Ollama をインストール: ワンクリックで自動ダウンロード・インストール
2. サーバーを起動: インストール完了後にサーバーを起動
3. モデルをダウンロード: 推奨モデルから選択してダウンロード
各ステップは完了状態に応じて表示が切り替わります。サーバー起動後はガイドが消え、通常の設定画面（エンドポイント・モデル選択・推奨モデル一覧）が表示されます。
Claude Code (CLI) プロバイダー: ローカルにインストール済みの Claude Code をヘッドレス実行する API キー不要のプロバイダーです。Claude のサブスクリプション（Pro/Max）でログイン済みであれば、キーの設定なしで全 AI 機能を利用できます。
- 前提条件: Claude Code CLI がインストール済みで、ターミナルで claude を起動して /login でログイン済みであること
- インストール検出: Claude Code タブで検出状態とバージョンを表示。既定のインストール先（%USERPROFILE%\.local\bin\claude.exe）と PATH から自動検出し、必要なら実行ファイルパスを手動指定可能
- モデル選択: default（CLI 側の既定モデル）/ sonnet / opus / haiku / fable から選択
- 制約: 最大トークン数・Temperature の設定はこのプロバイダーでは適用されません。CLI の起動を伴うため、応答に数秒のオーバーヘッドがあります。また Claude Code 本体の更新により動作が変わる可能性があります
AI 設定の 7 タブ構成: AI 設定は概要・Ollama・Gemini・Azure OpenAI・OpenAI・Claude・Claude Code の 7 サブタブに分かれています。

概要タブでは自動機能別トグル（グリーティング・リネーム提案・二つ名生成・バックストーリー生成・バックアップサマリー）を個別にオン/オフできます。