> ## 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.

# クイックスタート

> インタラクティブなターミナルUIでDroid CLIを5分で使い始める。

このクイックスタートガイドでは、わずか数分でFactory の開発エージェントとの協業を開始できます。Droidがあなたのコードベースを理解し、思慮深い変更を行い、既存のワークフローと統合する方法を体験できます。

## 始める前に

以下をご用意ください：

* コードプロジェクト内で開いたターミナル
* Git リポジトリ（完全なワークフローデモンストレーションのため推奨）

## ステップ1: Droid CLIをインストールして開始

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

  ```bash Homebrew theme={null}
  brew install --cask droid
  ```

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

  ```bash npm theme={null}
  npm install -g droid
  ```
</CodeGroup>

<Note>
  **Linuxユーザー:** 正しく動作させるには`xdg-utils`がインストールされていることを確認してください。インストール: `sudo apt-get install xdg-utils`
</Note>

次に、プロジェクトに移動してDroid CLIを開始します。

<CodeGroup>
  ```bash theme={null}
  # Navigate to your project
  cd /path/to/your/project

  # Start interactive session
  droid
  ```
</CodeGroup>

<img src="https://mintcdn.com/factory-docs-cli-sandbox-mcp-whole-process/J3EpqKPhhjL4L-lY/images/droid_tui_intro.png?fit=max&auto=format&n=J3EpqKPhhjL4L-lY&q=85&s=2b0cadaa7c432493633e4d3bedc30f30" alt="Droid CLI" height="450" className="rounded-lg" data-path="images/droid_tui_intro.png" />

フルスクリーンのターミナルインターフェースでDroidのウェルカム画面が表示されます。プロンプトが表示された場合は、ブラウザ経由でサインインしてFactoryの開発エージェントに接続してください。

## ステップ2: コードベースを探索

まず、Droidにあなたのプロジェクトを理解してもらいましょう。以下の質問のいずれかを試してみてください：

```

> analyze this codebase and explain the overall architecture

```

```

> what technologies and frameworks does this project use?

```

```

> where are the main entry points and how is testing set up?

```

Droidはファイルを文脈的に読み取り、組織の知識を活用してプロジェクト構造と規約に関する包括的な洞察を提供します。

## ステップ3: 初回のコード変更を実行

それでは、簡単な修正でDroidの動作を見てみましょう：

```

> add comprehensive logging to the main application startup

```

Droidは以下を実行します：

1. 現在のログ設定を分析
2. 明確な計画とともに具体的な変更を提案
3. 何が修正されるかを正確に表示
4. 変更を行う前にあなたの承認を待機

この透明なレビュープロセスにより、すべてのコード修正に対して完全な制御を維持できます。

## ステップ4: エンタープライズワークフローを体験

Droidのエンタープライズ機能を示すより複雑なタスクを試してみてください：

```

> audit this codebase for security vulnerabilities and create a remediation plan

```

または、リンクを貼り付けてチームのツールからのコンテキストを提供してください：

```

> implement the feature described in this Jira ticket: https://company.atlassian.net/browse/PROJ-123

```

Factory App経由でこれらのプラットフォームを統合している場合、DroidはJira、Notion、Slack、その他のソースからコンテキストを自動的に読み取ることができます。DroidはMCP統合を介して追加のツールにも接続でき、さらなる機能を提供します。

## ステップ5: バージョン管理を処理

Droidは Git 操作を対話的で賢いものにします：

```

> review my uncommitted changes and suggest improvements before I commit

```

```

> create a well-structured commit with a descriptive message following our team conventions

```

```

> analyze the last few commits and identify any potential issues or patterns

```

## 基本的なコントロール

日常的に使用する主要な操作は以下の通りです：

| アクション          | 実行内容                                        | 使用方法                      |
| -------------- | ------------------------------------------- | ------------------------- |
| メッセージ送信        | タスクまたは質問を送信                                 | 入力して**Enter**を押す          |
| 複数行入力          | より長いプロンプトを記述                                | **Shift+Enter**で改行        |
| 変更を承認          | 提案された修正を受け入れ                                | TUIで変更を受け入れ               |
| 変更を拒否          | 提案された修正を拒否                                  | TUIで変更を拒否                 |
| モード切り替え        | モード間を切り替え                                   | **Shift+Tab**             |
| Bashモード        | AIの解釈なしでシェルコマンドを直接実行                        | 入力が空の状態で`!`を押す；戻るには`Esc`  |
| トランスクリプト表示     | メッセージ詳細を含む詳細なトランスクリプトを切り替え                  | **Ctrl+O**                |
| ミッションコントロール    | Mission Control オーバーレイを切り替え（オーケストレーターセッション） | **Ctrl+T**                |
| オーバーレイを閉じる     | アクティブなオーバーレイまたはメニューを閉じる                     | **Escape**                |
| トランスクリプトをスクロール | 過去のターンを移動                                   | **Alt+Up** / **Alt+Down** |
| ショートカット表示      | 利用可能なコマンドをすべて表示                             | \*\*?\*\*を押す              |
| セッション終了        | Droidを終了                                    | **Ctrl+C**または`exit`を入力    |

<a id="useful-slash-commands" />

### 便利なスラッシュコマンド

よく使う操作への簡単なショートカット：

* `/review` - AI搭載コードレビューワークフローを開始（[learn more](/jp/cli/features/code-review)）
* `/settings` - Droidの動作、モデル、設定を構成
* `/model` - セッション中にAIモデルを切り替え
* `/sessions` - 過去のセッションを一覧表示し再開
* `/fork` - 現在のセッションを新しいブランチへフォーク
* `/compress` - 現在のセッションを圧縮してコンテキストを解放
* `/missions` - Missions メニューを開いてマルチエージェントプロジェクトを起動
* `/droids` - カスタム Droid（専門サブエージェント）を管理
* `/skills` - プロンプトベースのスキル（再利用可能な手順）を管理
* `/hooks` - ライフサイクル自動化のためのツール実行フックを管理
* `/plugins` - プラグインとマーケットプレイスを管理
* `/mcp` - Model Context Protocol サーバーを管理
* `/account` - ブラウザでFactory アカウント設定を開く
* `/billing` - 請求設定を表示・管理
* `/help` - 利用可能なコマンドをすべて表示

[カスタムスラッシュコマンドの作成方法を学ぶ →](/jp/cli/configuration/custom-slash-commands)

## 協業のベストプラクティス

**コンテキストを具体的に：**
次の代わりに：「バグを修正して」
こう試してください：「設定された30分ではなく5分後にユーザーがログアウトされる認証タイムアウトの問題を修正して」

**複雑な機能には仕様モードを使用：**
より大きな機能については、[Specification Mode](/jp/cli/user-guides/specification-mode)を使用してください。これは明示的に要求しなくても実装前に自動的に計画を提供します。

**組織の知識を活用：**

```

> following our team's coding standards, implement the user preferences feature described in ticket PROJ-123

```

**レビューワークフローを使用：**
承認前にDroidの提案された変更を常にレビューしてください。透明な差分表示により、何が修正されるかを正確に理解できます。

## エンタープライズチーム向けプロ・ティップス

**セキュリティファーストアプローチ：**
Droidは自動的にセキュリティへの影響を考慮し、コード生成時に潜在的な脆弱性にフラグを立てます。

**コンプライアンス統合：**
MCP を介してコンプライアンスツールを接続し、すべての変更が組織の標準を満たすようにします。

**チームの知識共有：**
Droidは組織のパターンから学習し、チームメンバーとプロジェクト間での一貫性を維持するのに役立ちます。

## 次のステップ

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

  <Card title="設定" icon="gear" href="/jp/cli/configuration/settings">
    チームのワークフローに合わせてDroidをカスタマイズする
  </Card>

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

  <Card title="IDE連携" icon="code" href="/jp/integrations/ide-integrations">
    お気に入りのエディター内でDroidを使用する
  </Card>
</CardGroup>

```
```
