ビデオウォークスルー - Factory Documentation

インストール & セットアップ

お好みのターミナルでDroid CLIをインストールして開始しましょう。

curl -fsSL https://app.factory.ai/cli | sh

インストールを確認します：

which droid

Droid CLIを開始します：

cd /path/to/your/project
droid

初回認証

初回実行時には、オンボーディング画面が表示されます：

アカウントの作成またはログインを選択します
ブラウザで認証コードを確認します
ターミナルに戻ってdroidの使用を開始します

インターフェース & ショートカット

ヘルプメニュー

Shift + ?を押してヘルプメニューを開きます。表示される内容：

メッセージの送信方法と改行の作成方法
利用可能なキーボードショートカット
基本的なナビゲーションコマンド
自律モードオプション

ターミナル固有のキーバインド: 改行のデフォルトは\ + Enterですが、ターミナルのキーバインドに応じてShift + Enterなどの組み合わせに設定できます。設定オプションはCLIの/terminal-setupで確認してください。

基本的なキーボードショートカット

ショートカット	アクション
`Enter`	メッセージを送信
`\` + `Enter` (または `Shift + Enter`)	メッセージ内で改行
`Esc` (ダブルタップ)	現在の入力をクリア
`Shift + ?`	ヘルプメニューを開く
`Shift + Tab`	自律モードを切り替え
`/`	コマンドメニューを開く
`Cmd + Shift + H`	ルートディレクトリを表示
`Cmd + Shift + .`	隠しファイル/フォルダを表示
`Ctrl + C` または `exit`	droidを終了
`Ctrl + V`	画像を貼り付け

画像貼り付けショートカットはすべてのターミナルで機能しますが、具体的なキーバインドはターミナル設定によって異なる場合があります。

自律モード

Shift + Tabを押して異なる自律レベルを切り替えます：仕様モードについて詳しく見る →

仕様モード（調査と計画のみ）

Droidは変更を加えずに調査して計画を作成します。実行前に何が起こるかを理解するのに最適です。

ファイル編集なし
コマンド実行なし
詳細な仕様を作成
進める前に計画を反復改善できます

低モード（読み取り専用 + 安全なコマンド）

ファイルの読み取りと、低リスクで読み取り専用のコマンド実行を許可します。

ファイル読み取り
ディレクトリ一覧
安全な診断コマンド
変更なし

Mediumモード（ファイル編集を許可）

ファイル変更と、簡単に戻せる中リスクのコマンドを有効にします。

ファイルの作成・編集・削除
ビルドコマンドの実行
テスト実行
元に戻せる操作

高モード（保護付きですべてのコマンド）

すべてのコマンドを許可しつつ、許可/拒否リストで安全性を維持します。

完全なコマンド実行
ファイル削除操作（確認付き）
Git操作
許可/拒否リストで設定可能

高モードでも、ファイル削除のような危険な操作は、許可リストで明示的に設定しない限り常に承認が必要です。

自律性設定を構成する →

スラッシュコマンド

/を押してコマンドメニューにアクセスします。以下のオプションがあります：

Account & Billing - Factoryアカウントを管理
Model - AIモデルの切り替えと推論レベルの設定
Sessions - 過去のセッションの表示とナビゲーション
Settings - CLI設定の構成
Terminal Setup - キーバインドの構成
Custom Commands - custom slash commandsにアクセス
Droids - custom sub-agentsの管理
MCP - Model Context Protocol integrationsの構成

モデルの切り替え

/modelでモデルメニューにアクセス：

利用可能なモデルを表示
異なるタスクに応じてモデルを切り替え
該当する場合は推論レベルを設定

モデルごとに得意なタスクは異なります。複雑な計画には推論モデルを、定型的な編集には高速なモデルを使用します。

モデル選択について学ぶ →

セッション管理

/sessionsでアクセス：

すべての過去のセッションを表示
任意の過去のセッションにナビゲート
Webインターフェースでセッションを開く
中断したところから作業を続行

セッションがWebインターフェースに表示されるには、設定でクラウド同期が有効になっている必要があります。

設定 & 構成

/settingsで設定にアクセスし、エクスペリエンスをカスタマイズできます：設定ドキュメント全体 →

コア設定

モデルと推論

新しいセッションのデフォルトモデルと推論レベルを選択する

Diffモード

コード変更の表示方法を設定する

GitHub完了

GitHub Copilot形式の補完を有効/無効にする

クラウド同期

セッションをFactory Webプラットフォームに同期

詳細設定

PR上のDroid共同作成者

有効にすると、droidが作成を支援したプルリクエストに共同著者として追加されます。単独の著者にしたい場合は無効化できます。

Droid Shield

コード内の環境変数とシークレットを保護します。APIキー、パスワード、トークンなどの機密情報の誤コミットを防ぎます。

セキュリティ脆弱性から保護するため、有効のままにしてください。

Droid Shieldについて詳しく見る →

仕様をMarkdownとして保存

仕様モードで生成された仕様を参照・ドキュメント用のMarkdownファイルとしてマシンに自動保存します。仕様モードについて詳しく見る →

許可リストと拒否リスト

高自律性モードでも承認が必要なコマンドを設定します。高モードでも、ファイル削除操作はデフォルトで確認が必要です。自動実行設定について詳しく見る →

IDE統合

設定メニューから直接VS Code、Cursor、その他のIDEのdroidエクステンションをインストールできます。 IDE連携について詳しく見る →

構成ファイル

Cmd + Shift + Hを押してルートディレクトリを表示し、次にCmd + Shift + .を押して隠しファイルを表示して構成ディレクトリにアクセスします。~/.factory/フォルダにナビゲートします。

ディレクトリ構造

~/.factory/
├── config.json          # Model configuration and BYOK
├── settings.json        # CLI settings and allow/deny lists
├── mcp.json            # MCP integrations
├── droids/             # Custom sub-agents
├── commands/           # Custom slash commands
├── logs/               # Session logs
└── bug-reports/        # Crash reports

詳しく見る: 設定 | カスタムスラッシュコマンド | カスタムDroid | MCP設定

config.json - 独自キーの使用

独自のAPIキーを使用してカスタムモデルを構成：

{
  "models": [
    {
      "provider": "openrouter",
      "name": "anthropic/claude-3.5-sonnet",
      "apiKey": "your-api-key-here",
      "displayName": "Claude 3.5 Sonnet (OpenRouter)"
    }
  ]
}

プロバイダードキュメントを探す

独自キーの使用ドキュメントにアクセスし、プロバイダー（OpenRouter、Fireworksなど）を選択します

設定テンプレートをコピー

選択したプロバイダーのJSON設定をコピーします

config.jsonに追加

設定を~/.factory/config.jsonに貼り付け、APIキーを追加します

モデルを選択

CLIで/modelを使用して、新しく追加したモデルを選択します

すべてのBYOKプロバイダーを見る →

settings.json - 許可 & 拒否リスト

高自律モードで承認が必要なコマンドを構成：

{
  "autoModeAllow": [],
  "autoModeDeny": [
    "git push",
    "rm -rf",
    "npm publish"
  ]
}

高モードでも、autoModeDenyリストのコマンドは常に実行前に明示的な承認が必要です。

mcp.json - MCP統合

MCPツールを個別に有効または無効にします：

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "your-api-key"
      }
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-playwright"],
      "disabled": true
    }
  }
}

"disabled": trueを設定して、構成を削除せずに一時的にMCPを無効にできます。 MCP設定について詳しく見る →

カスタムDroid（サブエージェント）

カスタムdroidは特定のタスクを処理する専門的なAIエージェントです。/droidsでdroidメニューにアクセス：

Droidの管理

Import (i) - 他のエージェントからビルド済みdroidをインポート
Create (c) - 新しいカスタムdroidを作成
Edit - 既存のdroid構成を変更
Enable/Disable - droidのオン/オフを切り替え

カスタムDroidの作成

カスタムDroidについて詳しく見る →

スコープを選択

droidをプロジェクトレベル（特定リポジトリ）にするか、個人用（すべてのプロジェクトで利用可能）にするかを決めます

生成方法

手動で作成するか、droidの支援で生成するかを選択します:

I want a code review droid that checks for security issues and coding standards

Droidが適切な説明と設定を生成します

モデルを設定

継承: 親セッションと同じモデルを使用します
特定モデル: このdroid専用のモデルを選択します（例: 複雑な分析には推論モデルを使用）

ツールを有効化

droidがアクセスできるツールと機能を選択します

保存して編集

設定を確認し、必要に応じて詳細を編集します

使用例

コードレビュー Droid - プルリクエストの自動コードレビュー
Documentation Droid - ドキュメントの生成と保守
Test Generation Droid - 包括的なテストスイートの作成
Security Audit Droid - 脆弱性とセキュリティ問題のスキャン

MCP統合

Model Context Protocol (MCP)により、droidは外部ツールやデータソースと統合できます。

CLI経由でのMCP追加

/mcp addコマンドを使用：

/mcp add

次にMCPの詳細を提供：

Name: MCPの識別子
Command: 実行可能コマンド（例：npx、python）
Args: コマンド引数
Environment Variables: APIキーと構成

構成済みMCPのリスト表示

/mcp list

これにより、すべての構成済みMCPとそれらの有効/無効ステータスが表示されます。

MCPを追加または変更した後、変更を反映するためにCLIの再起動が必要な場合があります。

構成ファイル経由でのMCP追加

~/.factory/mcp.jsonを直接編集することもできます：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/directory"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

ワークフロー例：Specモードから実装まで

droidの機能を実演する完全なワークフローです：

Spec Modeで開始

仕様モードになるまでShift + Tabを押します

Create an authentication system with GitHub and Google OAuth

計画を確認

Droidが詳細な仕様を生成します:

アーキテクチャ上の判断
作成・変更するファイル
必要な依存関係
実装手順

仕様を反復改善

実装前に計画を改善します:

Change the plan to only include Github auth and not Google auth

Droidがそれに応じて仕様を更新します

承認して続行

計画に満足したら、高モードで実装に進みます

変更を確認

Droidは変更内容を正確に表示し、承認を待ちます

仕様モードは複雑な機能で特に強力です。コードを書く前にアプローチを検証できます。

仕様モードの完全ガイドを読む → 大規模機能の実装について学ぶ →

まとめ

以下を学習しました：

Droid CLIのインストールと認証
インターフェースのナビゲーションとキーボードショートカットの使用
自律モードの理解と切り替え
設定と設定の構成
BYOKでカスタムモデルの追加
カスタムdroid（サブエージェント）の作成と管理
MCP経由での外部ツールの統合
実装前の計画のためのspecモードの使用

次のステップ

Droidとの話し方

droidとのコミュニケーションのベストプラクティスを学ぶ

よくあるユースケース

実践的なワークフローとシナリオを確認

パワーユーザーになる

高度なテクニックと生産性向上のヒント

AGENTS.mdガイド

プロジェクト固有の規約を文書化する

ようこそ

インテグレーション

機能

リファレンス

エンタープライズ

リソース

Documentation Index

​インストール & セットアップ

​初回認証

​インターフェース & ショートカット

​ヘルプメニュー

​基本的なキーボードショートカット

​自律モード

​スラッシュコマンド

​モデルの切り替え

​セッション管理

​設定 & 構成

​コア設定

モデルと推論

Diffモード

GitHub完了

クラウド同期

​詳細設定

​IDE統合

​構成ファイル

​ディレクトリ構造

​config.json - 独自キーの使用

​settings.json - 許可 & 拒否リスト

​mcp.json - MCP統合

​カスタムDroid（サブエージェント）

​Droidの管理

​カスタムDroidの作成

​使用例

​MCP統合

​CLI経由でのMCP追加

​構成済みMCPのリスト表示

​構成ファイル経由でのMCP追加

​人気のMCP統合

​ワークフロー例：Specモードから実装まで

​まとめ

​次のステップ

Droidとの話し方

よくあるユースケース

パワーユーザーになる

AGENTS.mdガイド

インストール & セットアップ

初回認証

インターフェース & ショートカット

ヘルプメニュー

基本的なキーボードショートカット

自律モード

スラッシュコマンド

モデルの切り替え

セッション管理

設定 & 構成

コア設定

詳細設定

IDE統合

構成ファイル

ディレクトリ構造

config.json - 独自キーの使用

settings.json - 許可 & 拒否リスト

mcp.json - MCP統合

カスタムDroid（サブエージェント）

Droidの管理

カスタムDroidの作成

使用例

MCP統合

CLI経由でのMCP追加

構成済みMCPのリスト表示

構成ファイル経由でのMCP追加

人気のMCP統合

ワークフロー例：Specモードから実装まで

まとめ

次のステップ