設定

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

​

設定へのアクセス

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"
  ]
}

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

​

セッションデフォルト

新しいセッションが開始されるときに適用されるデフォルト値です。上記の表にあるsessionDefaultSettings.interactionModeとsessionDefaultSettings.autonomyLevelもあわせて参照してください。

設定	型	オプション	デフォルト	説明
sessionDefaultSettings.specModeModel	string	任意の利用可能なモデルID	modelを継承	セッションがSpec Modeで開始されたときに使用するモデルを上書きします。
sessionDefaultSettings.specModeReasoningEffort	string	off, none, low, medium, high	モデルのデフォルト	Specモデルに適用される推論努力。

​

表示とUI

droidがターミナルでコンテンツをどのように描画するかを調整します。

設定	型	オプション	デフォルト	説明
toolResultDisplay	string	expanded, compact	expanded	ツール結果をトランスクリプトでどのように表示するか。
showTokenUsageIndicator	boolean	true, false	false	入力欄の下部にライブのトークン使用量インジケーターを表示します。
logoAnimation	string	once, always, off	once	起動時にdroidロゴをアニメーションさせます。
theme	string	テーマID（/themesを参照）	システムテーマ	TUIで使用するカラーテーマ。
overrideTerminalColors	boolean	true, false	false	droidのテーマでターミナルのカラースキームを強制的に上書きします。
nerdFont	boolean	true, false	false	UIでNerd Fontのグリフを有効にします（ターミナルにNerd Fontが必要です）。

​

追加の音声・通知設定

音声通知セクションを拡張し、ベル、イベントごとのフォーカスモード、サブエージェントのアクティビティに対するトグルを追加します。

設定	型	オプション	デフォルト	説明
subagentSounds	string	on, off	off	サブエージェントのライフサイクルイベント（開始、完了、エラー）の音声を再生します。

​

ミッション設定

ミッション — マルチエージェントオーケストレーションの実行を設定します。

設定	型	オプション	デフォルト	説明
missionModelSettings.workerModel	string	任意の利用可能なモデルID	継承	ミッションのワーカーサブエージェントが使用するデフォルトモデル。
missionModelSettings.workerReasoningEffort	string	off, none, low, medium, high	モデルのデフォルト	ミッションワーカーの推論努力。
missionModelSettings.validationWorkerModel	string	任意の利用可能なモデルID	継承	ミッションのバリデーター（scrutiny / user-testingワーカー）が使用するモデル。
missionModelSettings.validationWorkerReasoningEffort	string	off, none, low, medium, high	モデルのデフォルト	バリデーションワーカーの推論努力。
missionModelSettings.skipScrutiny	boolean	true, false	false	ミッション中のscrutiny検証マイルストーンをスキップします。
missionModelSettings.skipUserTesting	boolean	true, false	false	ミッション中のuser-testing検証マイルストーンをスキップします。
missionOrchestratorModel	string	任意の利用可能なモデルID	継承	ミッションオーケストレーターが使用するモデル。
missionOrchestratorReasoningEffort	string	off, none, low, medium, high	モデルのデフォルト	ミッションオーケストレーターの推論努力。
keepSystemAwakeDuringMissions	boolean	true, false	true	ミッション実行中にOSがスリープしないようにします。

​

コンテキストとコンパクション

モデルのコンテキストウィンドウ内に収めるために、droidが会話をいつ・どのようにコンパクションするかを制御します。

設定	型	オプション	デフォルト	説明
compactionTokenLimit	number	トークン数	モデル依存	現在のセッションの自動コンパクションをトリガーするトークンしきい値。
compactionTokenLimitPerModel	object	{ "<modelId>": number }マップ	{}	compactionTokenLimitのモデルごとの上書き。
compactionModelMode	string	same, <modelId>	same	コンパクションを実行するモデル：sameは現在のセッションモデルを使用し、特定のモデルIDを指定することもできます。

​

Spec Mode設定

Spec Modeによって作成される永続的なspecストアを制御します。

設定	型	オプション	デフォルト	説明
specSaveDir	string	ディレクトリパス	~/.factory/specs	保存されたspecを書き込むディレクトリ。~の展開をサポートします。

​

インフラストラクチャ

ステータスライン、worktree、リクエストタイムアウトに関するシステムレベルの設定。

設定	型	オプション	デフォルト	説明
statusLine	object	{ "command": string, "padding"?: number, "maxRows"?: number }	未設定	カスタムステータスライン設定。commandが実行され、その標準出力が入力欄の上に表示されます。/statuslineで対話的に設定できます。
worktreeDirectory	string	ディレクトリパス	~/.factory/worktrees	--worktree / -wで作成されるgit worktreeのデフォルト親ディレクトリ。
llmRequestTimeout	number	ミリ秒	製品のデフォルト	個々のLLMリクエストが中断されるまでのタイムアウト。

​

エンタープライズおよび組織レベルの設定

エンタープライズ / 組織レベル。 以下の設定は通常、組織管理者によって管理され、Factory webアプリまたは管理されたsettings.jsonを通じてメンバーに配布されます。個々のユーザーが直接設定することは通常ありません。

設定	型	オプション	デフォルト	説明
maxAutonomyLevel	string	off, low, medium, high	high	エンタープライズ。 任意のセッションで使用できる最大自律レベル。ユーザーが選択したより高いレベルはこの値に制限されます。
modelPolicy	object	{ "allowedModelIds"?: string[], "blockedModelIds"?: string[], "allowCustomModels"?: boolean, "allowedBaseUrls"?: string[] }	未設定	エンタープライズ。 メンバーが選択できるモデルを制限し、カスタムモデルの許可可否を制御し、カスタムモデルプロバイダーのベースURLを許可リスト化します。
mcpPolicy	object	{ "enabled"?: boolean, "allowlist"?: string[] }	未設定	エンタープライズ。 MCPサーバーの実行可否と許可されるサーバーを制御します。MCPを参照してください。
missionPolicy	object	{ "restrictedAccess"?: boolean, "allowedUserIds"?: string[] }	未設定	エンタープライズ。 ミッションを起動できるユーザーを制限します。
networkPolicy	object	{ "allowedIps": string[] }	未設定	エンタープライズ。 droidセッションからのアウトバウンドネットワークアクセスを allowedIps に指定したIPまたはCIDRレンジに制限します。
sandbox	object	{ "enabled"?: boolean, "mode"?: string, "filesystem"?: object, "network"?: object }	未設定	エンタープライズ。 ツール実行のファイルシステムとネットワーク隔離を制御するサンドボックス設定。
restrictMemberVisibility	boolean	true, false	false	組織レベル。 管理者以外のユーザーから他の組織メンバーを非表示にします。
restrictApiKeyCreationToManagers	boolean	true, false	false	組織レベル。 組織のマネージャーのみがAPIキーを作成できます。
sessionRetentionDays	number	14–365	組織のデフォルト	組織レベル。 同期されたセッション履歴が削除されるまで保持される日数。
wikiCloudSync	boolean	true, false	true	組織レベル。 生成されたWikiコンテンツをFactoryクラウドに同期します。
managedComputersEnabled	boolean	true, false	false	エンタープライズ。 組織でFactoryマネージドのリモートコンピューターを有効にします。
byomComputersEnabled	boolean	true, false	false	エンタープライズ。 メンバーがdroid computer registerで自分のマシンを登録できるようにします（BYOM）。

​

設定例

{
  "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キーの追加