メインコンテンツまでスキップ

設定リファレンス

このページは、Elftia でユーザーが設定可能なすべての設定項目の完全なリファレンスです。設定はタブ別に整理されており、アプリケーション内の設定ページに対応しています。

一般設定​

Settings → General にあります。

言語​

設定オプションデフォルト説明
インターフェース言語簡体字中国語 / English / 日本語システムに従うアプリケーションインターフェースの表示言語

言語の変更は、再起動なしですぐに反映されます。

プロキシ​

設定オプションデフォルト説明
プロキシモードシステムプロキシ / カスタムプロキシ / プロキシなしシステムプロキシネットワークリクエストに使用するプロキシ方式
カスタムプロキシ URLテキスト入力空「カスタムプロキシ」モードでのみ有効

詳しくは、プロキシの使用 を参照してください。

起動​

設定種類デフォルト説明
自動起動トグルオフオペレーティングシステムの起動時に Elftia を自動的に実行する
起動時に最小化トグルオフ自動起動後にウィンドウを表示せず、トレイに最小化する

トレイ​

設定種類デフォルト説明
トレイに最小化トグルオフウィンドウを閉じたときにアプリケーションを終了せず、システムトレイに最小化する

通知​

設定種類デフォルト説明
デスクトップ通知トグルオン新しいメッセージが届いたときにシステム通知を表示する
通知音トグルオンアラートが届いたときに通知音を再生する

環境ツール​

一般設定ページの下部にあり、システムにインストールされている開発ツールの状態を表示します。

ツール目的自動インストール可能
Node.jsMCP サーバーランタイムいいえ
Gitバージョン管理いいえ
ripgrep (rg)高速ファイル検索はい
uvPython パッケージマネージャーはい
uvxPython ツールランナーはい

「自動インストール可能」と表示されているツールは、「インストール」ボタンをクリックすると自動的にインストールできます。

外観設定​

Settings → Appearance にあります。詳細な説明は、テーマと外観 を参照してください。

設定種類デフォルト説明
テーマモードライト / ダーク / システムに従うシステムに従うインターフェースの配色
アクセントカラーカラーピッカープリセットブルーボタン、リンク、その他の要素に使うテーマカラー
UI フォントテキスト入力Interインターフェーステキストのフォント
コードフォントテキスト入力JetBrains Monoコードブロック用の等幅フォント
壁紙（ライトモード）画像アップロード / URLなしライトモード用の背景壁紙
壁紙（ダークモード）画像アップロード / URLなしダークモード用の背景壁紙
ぼかし強度スライダー 0-306壁紙に適用するガウスぼかしの量
マスクの不透明度スライダー 0-10070壁紙マスクレイヤーの不透明度
コンパクトウィンドウで壁紙を無効化トグルオンウィンドウが小さいときに壁紙を自動的に無効化する
カスタム CSSCSS エディター空カスタムスタイルを注入する
リモートリソースを許可トグルオフリモート画像とフォントの読み込みを許可する
リモートドメインのホワイトリストリストデフォルトリストリソースの読み込みを許可するドメイン

プロバイダー設定​

Settings → Provider Settings にあります。詳細な説明は、LLM プロバイダー設定 を参照してください。

各プロバイダーでは、次のオプションを設定できます。

設定種類説明
API Keyパスワード入力プロバイダーの API キー
Base URLテキスト入力API エンドポイントアドレス（カスタムエンドポイントに対応）
有効トグルこのプロバイダーを有効化するかどうか
API キープール複数キー管理負荷分散用に複数の API Key を設定する

API キープール​

各プロバイダーでは複数の API Key を設定でき、システムは重み付きラウンドロビンでそれらを自動選択します。

設定種類説明
キーリストリスト複数の API Key エントリ
重み数値各キーの選択重み
有効/無効トグル個別キーの有効状態

キーで 429（レート制限）または 529（過負荷）エラーが発生した場合、システムは別の利用可能なキーに自動的に切り替え、失敗したキーにクールダウン期間を設定します（60 秒から 15 分までの指数バックオフ）。

デフォルトモデル​

Settings → Default Models にあります。

設定用途説明
一般チャット日常会話用のデフォルトモデル新しい会話を作成するときに自動的に選択される
長文コンテキスト長いドキュメントを処理するためのモデルコンテキストがしきい値を超えたときに自動的に切り替わる
Web 検索検索要約用のモデルWeb 検索を有効にしたときに使用される
画像生成画像生成モデル画像を作成するときに使用される
バックグラウンドタスクバックグラウンド処理用のモデル会話タイトル生成、要約などに使用される

各カテゴリでは、有効化されているすべてのプロバイダーの利用可能なモデルから選択できます。

Agent 設定（Clawia）​

Settings → Clawia（Agent 設定タブ）にあります。

Agent エンジン​

設定オプションデフォルト説明
Agent バックエンドClaude SDK / TinyElf / CLIClaude SDKAgent 実行エンジン
  • Claude SDK: Anthropic の Agent SDK を使用し、最も完全な機能を提供します。
  • TinyElf: 任意の LLM プロバイダーに対応する内蔵の軽量 Agent エンジンです。
  • CLI: コマンドライン経由で外部 Agent ツールを呼び出します（Claude Code CLI、Codex CLI など）。

CLI バックエンド設定（CLI モードのみ）​

設定種類デフォルト説明
CLI ツール選択Claude Code使用する CLI バックエンド
タイムアウト数値（秒）3001 回の実行における最大時間
PTY モードトグルオフ実行に疑似端末を使用する
PTY 列数数値120PTY 端末の幅
PTY 行数数値40PTY 端末の高さ

プロンプトバージョン​

設定オプションデフォルト説明
プロンプトバージョンV1 / V2 / V3 / V4V4システムプロンプトの構築方法
  • V1: SDK プリセット + 単純な追記（時刻、ワークスペース、メモリ、チャンネル）
  • V2: 完全にカスタマイズされたシステムプロンプト（PromptBuilder）
  • V3: V2 + 5 層構造（bootstrap、onboarding、memory、channels、dynamic）
  • V4: SDK プリセット + bootstrap ファイル + soul/memory/onboarding/channels/scheduling
ヒント

V4 は推奨されるデフォルトバージョンであり、SDK の最適化とプロジェクト固有のカスタマイズを組み合わせています。ほとんどのユーザーはこの設定を変更する必要はありません。

セキュリティ設定​

設定オプションデフォルト説明
GuardianAgent モードオフ / 監視 / ガード / 厳格オフAI 安全性レビューのレベル

詳細は セキュリティ設定 を参照してください。

セッションモード​

設定オプションデフォルト説明
デフォルトセッションモード継続 / 新規継続アプリケーションを開いたときのデフォルト動作
  • 継続: アプリケーションを開いたときに前回の会話セッションを復元します。
  • 新規: アプリケーションを開くたびに新しい会話セッションを作成します。

開発者モード​

設定種類デフォルト説明
開発者モードトグルオフ有効にすると DevTools と追加のデバッグ情報にアクセスできます

開発者モードは、Settings → About で特定の操作（バージョン番号を連続クリック）を行って有効化する必要があります。有効化すると、Clawia タブに開発者モードのトグルが表示されます。

Web 検索設定​

Settings → Web Search にあります。詳細な説明は、Web 検索機能 を参照してください。

設定種類説明
検索プロバイダー選択Web 検索エンジンのプロバイダーを選択する
整理戦略選択検索結果の整理方法
圧縮設定オプション検索結果コンテンツの圧縮レベル
ドメインブラックリストリストこれらのドメインから検索結果を取得しない

システム設定​

Settings → System にあります。

診断ツール​

操作説明
診断情報のエクスポート診断情報（ログ、設定、ランタイム環境）をエクスポートする
キャッシュをクリアローカルキャッシュデータをクリアする
診断ログをコピー診断ログをクリップボードにコピーする
添付ファイルを整理関連付けられていない添付ファイルをクリーンアップする

データベースメンテナンス​

操作説明
データベースサイズ現在の SQLite データベースファイルサイズを表示する
VACUUMデータベース圧縮最適化を実行し、削除済みデータが使用していた領域を回収する

リソースクリーンアップ​

操作説明
クリーンアップ可能な項目安全に削除できる孤立リソースの数量とサイズを表示する
リソースをクリーンアップリソースクリーンアップを実行する

データのインポートと移行​

操作説明
Legacy JSONL インポート高速なページネーション付きクエリのために ~/.claude/projects/*.jsonl をデータベースに同期する
サムネイル生成既存画像のサムネイルを一括生成し、リストとギャラリーの読み込み速度を向上させる
添付ファイルストレージ移行古い media:// 添付ファイルを resource:// コンテンツアドレス可能ストレージへ移行し、重複排除して容量を節約する

実験的機能​

テスト中の一部の新機能は、このセクションで切り替えられます。実験的機能は不安定な場合があり、上級ユーザーにのみ推奨されます。

機能説明
新しいファイルシステムストリーム検索、ripgrep 統合、自動フォールバック機構
最適化されたファイルツリー強化されたツリー描画と増分更新

問題が発生した場合は、いつでもオフに切り替えて安定版に戻すことができます。

:::info Design Studio はデフォルトで有効です Design Studio はバージョン 0.1.7 以降、デフォルトで有効になっており、Experimental Features には含まれなくなりました。ナビゲーションバーには 🎨 Design Studio エントリが直接表示されます。残る唯一の要件は、現在の LLM プロバイダーエンジンが Design アダプターをサポートしていることです（api エンジンはサポートしていません）。詳細は Design Studio を参照してください。 :::

About​

Settings → About にあります。

情報説明
バージョン現在の Elftia バージョン
更新を確認新しいバージョンが利用可能かどうかを手動で確認する
開発者モードバージョン番号を連続クリックすると有効化される
DevTools開発者モードで Electron DevTools を開く/閉じる
アカウント状態ログイン状態とメンバーシップ情報

セキュリティ関連設定の詳細な説明については、引き続き セキュリティ設定 をお読みください。