設定

ドロイドの動作とワークフローとの統合を設定します。

​

設定へのアクセス

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の上に統合され、同じ階層の優先順位に従います。マシン固有の設定をバージョン管理から除外したい場合は、settings.local.jsonを.gitignoreに追加してください。

​

従来のDroid YAML設定

.droid.yamlは以前のプロジェクト設定インターフェースです。代わりに現在の.factory/ファイルを使用してください：

• Droidの設定とローカル上書きにはsettings.jsonとsettings.local.jsonを使用します。
• リポジトリの指示、規約、検証コマンドにはAGENTS.mdを使用します。
• 連携、自動化、再利用可能なワークフローにはMCPサーバー、フック、スキルを使用します。

​

利用可能な設定

設定	オプション	デフォルト	説明
model	任意の利用可能なモデルID	製品のデフォルト	droidが使用するデフォルトのAIモデル
reasoningEffort	off, none, low, medium, high（可用性はモデルに依存）	モデル依存のデフォルト	モデルが実行する構造化された思考の量を制御します。
sessionDefaultSettings.interactionMode	auto, spec	auto	新しいセッションをAutoとSpec Modeのどちらで開始するかを設定します。
sessionDefaultSettings.autonomyLevel	off, low, medium, high	off	新しいセッションのデフォルト自律レベルを設定します。
cloudSessionSync	true, false	true	CLIセッションをFactory webに同期します。
diffMode	github, unified	github	分割されたGitHubスタイルのdiffと単一列表示を選択します。
completionSound	off, bell, fx-ok01, fx-ack01、またはカスタムファイルパス	fx-ok01	レスポンス完了時の音声キュー。
awaitingInputSound	off, bell, fx-ok01, fx-ack01、またはカスタムファイルパス	fx-ack01	droidがユーザー入力を待機中の音声キュー。
soundFocusMode	always, focused, unfocused	always	音声通知を再生するタイミング。
commandAllowlist	コマンドの配列	安全なデフォルトが提供	追加確認なしで実行されるコマンド。
commandDenylist	コマンドの配列	制限的なデフォルトが提供	常に確認が必要なコマンド。
includeCoAuthoredByDroid	true, false	true	コミットにDroidの共同作成者トレーラーを自動追加します。
enableDroidShield	true, false	true	シークレットスキャンとgitガードレールを有効にします。
hooksDisabled	true, false	false	全てのフックの実行をグローバルに無効にします。
ideAutoConnect	true, false	false	外部ターミナルからIDEへの自動接続。
showThinkingInMainView	true, false	false	メインチャット画面にAIの思考/推論ブロックを表示します。
customModels	モデル設定の配列	[]	BYOK用のカスタムモデル設定。BYOKドキュメントを参照。

​

モデル

modelには、利用可能なモデルIDを設定します。カスタムモデルについては、Bring Your Own Key (BYOK)を参照してください。

​

推論努力

reasoningEffortは、モデルが回答前に実行する構造化された思考の量を調整します。利用可能な値はモデルによって異なりますが、通常は以下が含まれます：

• off / none – 構造化推論を無効化（最高速）。
• low, medium, high – より複雑な推論のため段階的に検討時間を増加。

Anthropicモデルはデフォルトでoff、GPT-5はmediumで開始します。

​

自律レベル

sessionDefaultSettings.interactionModeを使って新しいセッションをAutoとSpec Modeのどちらで開始するかを選び、sessionDefaultSettings.autonomyLevelでデフォルトの自律レベルを設定します。offでは手動承認を維持し、low、medium、highではそのリスクレベル以下の作業を事前承認します。

sessionDefaultSettings.autonomyModeは非推奨で、古い設定との互換性のために残されています。

​

Diffモード

droidがコード変更を表示する方法を制御します：

• github – 横並び、高忠実度レンダリング（推奨）。
• unified – 従来の単一列diff形式。

​

クラウドセッション同期

このスイッチをオンにすると、全てのCLIセッションがFactory webに同期され、ブラウザで会話を再確認できます：

• true – セッションをwebアプリに同期。
• false – セッションをローカルのみに保持。

​

音声通知

droidイベントの音声フィードバックを設定します：

完了音（completionSound） - レスポンス完了時に再生：

• fx-ok01 – 内蔵完了音（デフォルト） - ソフトな成功ブループ
• fx-ack01 – 代替内蔵効果音 - 触覚的リップルフィードバック
• bell – システムターミナルベルを使用
• off – 音声通知なし
• カスタムパス – 独自の音声ファイルへのパスを指定（例："/path/to/sound.wav"）

入力待機音（awaitingInputSound） - droidがユーザー入力を待機中に再生。完了音と同じオプション、デフォルトはfx-ack01。

音声フォーカスモード（soundFocusMode） - 音声再生タイミングを制御：

• always – ウィンドウフォーカスに関係なく音声を再生（デフォルト）
• focused – ターミナルがフォーカスされている時のみ音声を再生
• unfocused – ターミナルがフォーカスされていない時のみ音声を再生

TUIで/settingsまたはShift+Tab → Settingsから音声設定にアクセスできます。

​

フック

hooksDisabled設定は、フック設定を削除せずに全てのフック実行を無効化するグローバルトグルを提供します：

• false – フックが有効で正常に実行されます（デフォルト）
• true – 全てのフックがグローバルに無効

これは/hooksメニューまたは/settingsからも切り替えられます。

​

IDE自動接続

ideAutoConnect設定は、外部ターミナル（IDE内蔵ターミナル以外）からの実行時にdroidが自動的にIDEに接続するかを制御します：

• false – IDEターミナル内での実行時のみ自動接続（デフォルト）
• true – 任意のターミナルからIDEに自動接続

​

コマンド許可リストと拒否リスト

これらの設定を使用して、droidが自動実行できるコマンドと絶対に実行してはいけないコマンドを制御します：

• commandAllowlist – この配列内のコマンドは安全として扱われ、自律プロンプトに関係なく追加確認なしで実行されます。頻繁に使用する低リスクユーティリティのみを含めてください（例：ls、pwd、dir）。
• commandDenylist – この配列内のコマンドは常に確認が必要で、破壊的または危険なため通常ブロックされます（例：再帰的rm、mkfs、特権システム操作）。

両方のリストに登場するコマンドは、拒否リストの動作がデフォルトとなります。どちらのリストにもないコマンドは、セッションで選択した自律レベルにフォールバックします。

​

許可/拒否設定例

{
  "commandAllowlist": [
    "ls",
    "pwd",
    "dir"
  ],
  "commandDenylist": [
    "rm -rf /",
    "mkfs",
    "shutdown"
  ]
}

これらの配列を定期的に見直し更新して、ワークフローとセキュリティ体制に合わせてください。特にチーム間で設定を共有する場合は重要です。

​

設定例

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

---

​

さらに詳しく知りたい場合は？

• CLI概要 – メインのTUIワークフローを確認
• CLIリファレンス – コマンドフラグとオプション
• IDE統合 – エディター固有のセットアップ
• カスタムモデルとBYOK - カスタムモデルとAPIキーの追加