> ## Documentation Index
> Fetch the complete documentation index at: https://factory-docs-cli-sandbox-mcp-whole-process.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ビデオウォークスルー

> Droid CLIのインストール、設定、主要機能を説明する動画チュートリアル

<iframe className="w-full aspect-video rounded-xl" src="https://youtube.com/embed/aw0thMXwAMY" title="Droid CLI動画ウォークスルー" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

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

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

<CodeGroup>
  ```bash macOS/Linux theme={null}
  curl -fsSL https://app.factory.ai/cli | sh
  ```

  ```powershell Windows theme={null}
  irm https://app.factory.ai/cli/windows | iex
  ```
</CodeGroup>

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

```bash theme={null}
which droid
```

Droid CLIを開始します：

```bash theme={null}
cd /path/to/your/project
droid
```

### 初回認証

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

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

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

### ヘルプメニュー

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

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

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

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

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

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

<Note>
  Bashモードでは、プロンプトが`$`に変わります。シェルコマンドを入力して`Enter`を押し、通常のチャットに戻るには`Esc`を押します。
</Note>

## 自律モード

`Shift + Tab`を押して異なる自律レベルを切り替えます：

[仕様モードについて詳しく見る →](/jp/cli/user-guides/specification-mode)

<AccordionGroup>
  <Accordion title="仕様モード（調査と計画のみ）">
    Droidは変更を加えずに調査して計画を作成します。実行前に何が起こるかを理解するのに最適です。

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

  <Accordion title="低モード（読み取り専用 + 安全なコマンド）">
    ファイルの読み取りと、低リスクで読み取り専用のコマンド実行を許可します。

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

  <Accordion title="Mediumモード（ファイル編集を許可）">
    ファイル変更と、簡単に戻せる中リスクのコマンドを有効にします。

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

  <Accordion title="高モード（保護付きですべてのコマンド）">
    すべてのコマンドを許可しつつ、許可/拒否リストで安全性を維持します。

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

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

[自律性設定を構成する →](/jp/cli/configuration/settings)

## スラッシュコマンド

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

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

### モデルの切り替え

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

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

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

[モデル選択について学ぶ →](/jp/cli/user-guides/choosing-your-model)

### セッション管理

`/sessions`でアクセス：

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

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

## 設定 & 構成

`/settings`で設定にアクセスし、エクスペリエンスをカスタマイズできます：

[設定ドキュメント全体 →](/jp/cli/configuration/settings)

### コア設定

<CardGroup cols={2}>
  <Card title="モデルと推論">
    新しいセッションのデフォルトモデルと推論レベルを選択する
  </Card>

  <Card title="Diffモード">
    コード変更の表示方法を設定する
  </Card>

  <Card title="GitHub完了">
    GitHub Copilot形式の補完を有効/無効にする
  </Card>

  <Card title="クラウド同期">
    セッションをFactory Appに同期
  </Card>
</CardGroup>

### 詳細設定

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

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

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

    [Droid Shieldについて詳しく見る →](/jp/cli/account/droid-shield)
  </Accordion>

  <Accordion title="仕様をMarkdownとして保存">
    仕様モードで生成された仕様を参照・ドキュメント用のMarkdownファイルとしてマシンに自動保存します。

    [仕様モードについて詳しく見る →](/jp/cli/user-guides/specification-mode)
  </Accordion>

  <Accordion title="許可リストと拒否リスト">
    高自律性モードでも承認が必要なコマンドを設定します。高モードでも、ファイル削除操作はデフォルトで確認が必要です。

    [自動実行設定について詳しく見る →](/jp/cli/user-guides/auto-run)
  </Accordion>
</AccordionGroup>

### IDE統合

設定メニューから直接VS Code、Cursor、その他のIDEのdroidエクステンションをインストールできます。

[IDE連携について詳しく見る →](/jp/integrations/ide-integrations)

## 構成ファイル

`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
```

<Tip>
  詳しく見る: [設定](/jp/cli/configuration/settings) | [カスタムスラッシュコマンド](/jp/cli/configuration/custom-slash-commands) | [カスタムDroid](/jp/cli/configuration/custom-droids) | [MCP設定](/jp/cli/configuration/mcp)
</Tip>

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

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

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

<Steps>
  <Step title="プロバイダードキュメントを探す">
    [独自キーの使用ドキュメント](/jp/cli/byok/overview)にアクセスし、プロバイダー（OpenRouter、Fireworksなど）を選択します
  </Step>

  <Step title="設定テンプレートをコピー">
    選択したプロバイダーのJSON設定をコピーします
  </Step>

  <Step title="config.jsonに追加">
    設定を`~/.factory/config.json`に貼り付け、APIキーを追加します
  </Step>

  <Step title="モデルを選択">
    CLIで`/model`を使用して、新しく追加したモデルを選択します
  </Step>
</Steps>

[すべてのBYOKプロバイダーを見る →](/jp/cli/byok/overview)

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

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

```json theme={null}
{
  "autoModeAllow": [],
  "autoModeDeny": [
    "git push",
    "rm -rf",
    "npm publish"
  ]
}
```

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

### mcp.json - MCP統合

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

```json theme={null}
{
  "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設定について詳しく見る →](/jp/cli/configuration/mcp)

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

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

### Droidの管理

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

### カスタムDroidの作成

[カスタムDroidについて詳しく見る →](/jp/cli/configuration/custom-droids)

<Steps>
  <Step title="スコープを選択">
    droidを**プロジェクトレベル**（特定リポジトリ）にするか、**個人用**（すべてのプロジェクトで利用可能）にするかを決めます
  </Step>

  <Step title="生成方法">
    手動で作成するか、droidの支援で生成するかを選択します:

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

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

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

  <Step title="ツールを有効化">
    droidがアクセスできるツールと機能を選択します
  </Step>

  <Step title="保存して編集">
    設定を確認し、必要に応じて詳細を編集します
  </Step>
</Steps>

### 使用例

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

## MCP統合

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

### CLI経由でのMCP追加

`/mcp add`コマンドを使用：

```bash theme={null}
/mcp add
```

次にMCPの詳細を提供：

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

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

```bash theme={null}
/mcp list
```

これにより、構成済みの各MCPサーバーに接続し、現在の接続ステータス（**connected**、**connecting**、**needs authentication**、**failed**）が表示されます。OAuthが必要なサーバーは、インタラクティブな`/mcp`マネージャーでサインインを完了するまで**needs authentication**と表示されます。

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

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

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

```json theme={null}
{
  "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"
      }
    }
  }
}
```

### 人気のMCP統合

* **Brave Search** - Web検索機能
* **Playwright** - ブラウザ自動化
* **GitHub** - リポジトリと課題管理
* **Filesystem** - 拡張ファイルシステムアクセス
* **Postgres** - データベースクエリ
* **Slack** - チームコミュニケーション

[すべてのMCPサーバーを見る →](/jp/cli/configuration/mcp)

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

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

<Steps>
  <Step title="Spec Modeで開始">
    仕様モードになるまで`Shift + Tab`を押します

    ```
    Create an authentication system with GitHub and Google OAuth
    ```
  </Step>

  <Step title="計画を確認">
    Droidが詳細な仕様を生成します:

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

  <Step title="仕様を反復改善">
    実装前に計画を改善します:

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

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

  <Step title="承認して続行">
    計画に満足したら、高モードで実装に進みます
  </Step>

  <Step title="変更を確認">
    Droidは変更内容を正確に表示し、承認を待ちます
  </Step>
</Steps>

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

[仕様モードの完全ガイドを読む →](/jp/cli/user-guides/specification-mode)

[大規模機能の実装について学ぶ →](/jp/cli/user-guides/implementing-large-features)

## まとめ

以下を学習しました：

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

## 次のステップ

<CardGroup cols={2}>
  <Card title="Droidとの話し方" icon="comments" href="/jp/cli/getting-started/how-to-talk-to-a-droid">
    droidとのコミュニケーションのベストプラクティスを学ぶ
  </Card>

  <Card title="よくあるユースケース" icon="lightbulb" href="/jp/cli/getting-started/common-use-cases">
    実践的なワークフローとシナリオを確認
  </Card>

  <Card title="パワーユーザーになる" icon="bolt" href="/jp/cli/user-guides/become-a-power-user">
    高度なテクニックと生産性向上のヒント
  </Card>

  <Card title="AGENTS.mdガイド" icon="file-lines" href="/jp/cli/configuration/agents-md">
    プロジェクト固有の規約を文書化する
  </Card>
</CardGroup>