メインコンテンツへスキップ

​
設定へのアクセス

droidの設定を構成するには：
  1. droidを実行します
  2. /settingsを入力します
  3. 対話的に設定を調整します
変更は即座に有効になり、設定ファイルに保存されます。

​
設定の保存場所

OS場所
macOS / Linux~/.factory/settings.json
Windows%USERPROFILE%\.factory\settings.json
ファイルが存在しない場合は、droidを初回実行時にデフォルト値で作成されます。

​
ローカルオーバーライド

任意の.factory/フォルダ内で、settings.jsonと並んでsettings.local.jsonを作成できます：
  • ~/.factory/settings.local.json（ユーザーレベル）
  • <project>/.factory/settings.local.json（プロジェクトレベル）
ローカルオーバーライドは、同じレベルの対応するsettings.jsonの上にマージされ、同じ階層の優先順位に従います。マシン固有の設定をバージョン管理から除外したい場合は、.gitignoreにsettings.local.jsonを追加してください。

​
利用可能な設定

設定オプションデフォルト説明
modelopus, opus-4-6, opus-4-6-fast, sonnet, sonnet-4-6, gpt-5.4, gpt-5.2, gpt-5.2-codex, gpt-5.3-codex, haiku, gemini-3.1-pro, gemini-3-flash, droid-core, glm-5, kimi-k2.5, minimax-m2.5, custom-modelopusdroidが使用するデフォルトのAIモデル
reasoningEffortoff, none, low, medium, high（利用可能性はモデルに依存）モデル依存のデフォルトモデルが実行する構造化思考の量を制御します。
autonomyModenormal, spec, auto-low, auto-medium, auto-highnormaldroid開始時のデフォルト自律モードを設定します。
cloudSessionSynctrue, falsetrueCLIセッションをFactory webにミラーします。
diffModegithub, unifiedgithub分割GitHub形式のdiffと単一カラム表示を選択します。
completionSoundoff, bell, fx-ok01, fx-ack01、またはカスタムファイルパスfx-ok01レスポンス完了時の音声合図。
awaitingInputSoundoff, bell, fx-ok01, fx-ack01、またはカスタムファイルパスfx-ack01droidがユーザー入力を待機している時の音声合図。
soundFocusModealways, focused, unfocusedalwaysサウンド通知を再生するタイミング。
commandAllowlistコマンドの配列安全なデフォルト値を提供追加確認なしで実行されるコマンド。
commandDenylistコマンドの配列制限的なデフォルト値を提供常に確認が必要なコマンド。
includeCoAuthoredByDroidtrue, falsetrueコミットにDroid共同作成者トレーラーを自動追加。
enableDroidShieldtrue, falsetrueシークレットスキャンとgitガードレールを有効化。
hooksDisabledtrue, falsefalse全フック実行をグローバルに無効化。
ideAutoConnecttrue, falsefalse外部ターミナルからIDEへの自動接続。
todoDisplayModeinline, pinnedpinnedUIでのtodoリストの表示方法。
showThinkingInMainViewtrue, falsefalseメインチャットビューでのAI思考/推論ブロックの表示。
customModelsモデル設定の配列[]BYOKのカスタムモデル設定。BYOK docsを参照してください。

​
モデル

droidを動かすデフォルトのAIモデルを選択します：
  • opus - Claude Opus 4.5（現在のデフォルト）
  • opus-4-6 - Claude Opus 4.6、Max推論機能を持つ最新フラグシップモデル
  • opus-4-6-fast - Claude Opus 4.6 Fast、高速レスポンス用にチューニングされたモデル
  • sonnet - Claude Sonnet 4.5、コストと品質のバランス型
  • sonnet-4-6 - Claude Sonnet 4.6、Sonnet価格帯でMax推論を搭載
  • gpt-5.4 - GPT-5.4、922Kコンテキストと Extra High推論を搭載した最新OpenAIモデル
  • gpt-5.2 - OpenAI GPT-5.2
  • gpt-5.2-codex - GPT-5.2-Codex、Extra High推論機能を持つOpenAIコーディングモデル
  • gpt-5.3-codex - GPT-5.3-Codex、Extra High推論と詳細性サポートを持つ最新OpenAIコーディングモデル
  • haiku - Claude Haiku 4.5、高速で費用対効果の高いモデル
  • gemini-3.1-pro - Gemini 3.1 Pro
  • gemini-3-flash - Gemini 3 Flash、高速で安価（0.2×倍率）
  • droid-core - GLM-4.7 オープンソースモデル
  • glm-5 - GLM-5 オープンソースモデル
  • kimi-k2.5 - Kimi K2.5 画像サポート付きオープンソースモデル
  • minimax-m2.5 - MiniMax M2.5 推論サポート付きオープンソースモデル（0.12×倍率）
  • custom-model - BYOK経由で設定されたカスタムモデル
You can also add custom models and BYOK.

​
推論努力レベル

reasoningEffortは、モデルが回答前に実行する構造化思考の量を調整します。利用可能な値はモデルによって異なりますが、通常は以下を含みます：
  • off / none – 構造化推論を無効化（最速）。
  • low、medium、high – より複雑な推論のために段階的に検討時間を増加。
Anthropicモデルはoffがデフォルトで、GPT-5はmediumで開始します。

​
自律レベル

autonomyModeは、セッション開始時にdroidがどの程度積極的にコマンドを実行するかを制御します。normalから始めるか、auto-*プリセットを選択して追加のアクションを事前承認してください。

​
Diffモード

droidのコード変更の表示方法を制御します：
  • github – 並列表示、より高精度な表示（推奨）。
  • unified – 従来の単一カラムdiff形式。

​
クラウドセッション同期

このスイッチをオンにすると、すべてのCLIセッションがFactory webにミラーされ、ブラウザで会話を再確認できます：
  • true – セッションをウェブアプリに同期。
  • false – セッションをローカルのみに保持。

​
サウンド通知

droidイベントの音声フィードバックを設定します： 完了音（completionSound） - レスポンス終了時に再生：
  • fx-ok01 – 内蔵完了音（デフォルト） - ソフトな成功音
  • fx-ack01 – 代替内蔵効果音 - 触覚的なリップル音
  • bell – システムターミナルベルを使用
  • off – サウンド通知なし
  • カスタムパス – 独自のサウンドファイルのパスを指定（例："/path/to/sound.wav"）
入力待機音（awaitingInputSound） - droidがユーザー入力を待機している時に再生。完了音と同じオプション、デフォルトはfx-ack01。 サウンドフォーカスモード（soundFocusMode） - サウンドの再生タイミングを制御：
  • always – ウィンドウフォーカスに関係なくサウンドを再生（デフォルト）
  • focused – ターミナルがフォーカスされている時のみサウンドを再生
  • unfocused – ターミナルがフォーカスされていない時のみサウンドを再生
Access sound settings via /settings or Shift+Tab → Settings in the TUI.

​
フック

hooksDisabled設定は、フック設定を削除することなく、すべてのフック実行を無効にするグローバルトグルを提供します：
  • false – フックが有効で正常に実行されます（デフォルト）
  • true – すべてのフックがグローバルに無効化されます
これは/hooksメニューや/settingsからも切り替えできます。

​
IDE自動接続

ideAutoConnect設定は、外部ターミナル（IDEの内蔵ターミナル以外）から実行時にdroidが自動的にIDEに接続するかを制御します：
  • false – IDEターミナル内で実行時のみ自動接続（デフォルト）
  • true – 任意のターミナルからIDEへ自動接続

​
Todo表示モード

todoDisplayMode設定は、UIでのtodoリストの表示方法を制御します：
  • pinned – Todoリストを入力エリアの上に固定表示（デフォルト）
  • inline – Todoリストをメッセージフロー内にインライン表示

​
コマンド許可リスト・拒否リスト

これらの設定を使用して、droidが自動実行できるコマンドと絶対に実行してはいけないコマンドを制御します：
  • commandAllowlist – この配列のコマンドは安全として扱われ、自律プロンプトに関係なく追加確認なしで実行されます。頻繁に使用する低リスクユーティリティのみを含めてください（例：ls、pwd、dir）。
  • commandDenylist – この配列のコマンドは常に確認が必要で、破壊的または危険なため通常はブロックされます（例：再帰的なrm、mkfs、特権システム操作）。
両方のリストに含まれるコマンドは、拒否リストの動作がデフォルトになります。どちらのリストにもないコマンドは、セッションで選択した自律レベルにフォールバックします。

​
許可/拒否設定の例

{
  "commandAllowlist": [
    "ls",
    "pwd",
    "dir"
  ],
  "commandDenylist": [
    "rm -rf /",
    "mkfs",
    "shutdown"
  ]
}
これらの配列を定期的に確認・更新して、ワークフローとセキュリティポスチャに一致させてください。特にチーム間で設定を共有する場合は重要です。

​
設定例

{
  "model": "opus",
  "reasoningEffort": "low",
  "diffMode": "github",
  "cloudSessionSync": true,
  "completionSound": "fx-ok01",
  "awaitingInputSound": "fx-ack01",
  "soundFocusMode": "always",
  "todoDisplayMode": "pinned"
}

​
さらなる情報が必要ですか？