メインコンテンツへスキップ

セットアップ

JetBrains AI を搭載した JetBrains IDE(2025.3以降)で(最新版に更新してください):
  1. 設定 > ツール > AI Assistant > Agents を開くか、エージェントピッカーメニューで 「ACP Registry からインストール…」 を選択します。
  2. Factory Droid を見つけます。
  3. インストール をクリックします。
  4. AI チャットパネルを開き、エージェントドロップダウンから Factory Droid を選択します。
  5. 認証されていない場合は、認証が必要であることを示すメッセージが表示されます。
    1. 表示されたデバイスコードを控えて、「ログイン」ボタンをクリックします。
    2. ウェブブラウザが開き、Factory へのログイン/サインアップ、その後デバイスコードの確認画面が表示されます。

(代替)手動セットアップ

JetBrains 内で Droid を手動で設定したい場合は、以下の手順に従ってください。
  1. Factory CLI のインストール(Windows ARM マシンを除くすべてのオペレーティングシステムでサポート)
    • 以下を使用してインストール:
      curl -fsSL https://app.factory.ai/cli | sh
      
    • droid バイナリが PATH に含まれていることを確認してください(または完全パスをメモしてください)。
  2. (オプション)Factory API キー - ログインフローの代わりに API キーを設定できます:
    • https://app.factory.ai でサインアップします。
    • プロンプトが表示されたら支払い方法を追加します。
    • https://app.factory.ai/settings/api-keys で API キーを作成します。
    • シェルで FACTORY_API_KEY 環境変数を設定します(例:シェルプロファイルに export FACTORY_API_KEY=your_key_here を追加)。
You cannot sign up for Factory or manage billing entirely inside JetBrains. Account creation and API key management always happen in the web app.

Factory Droid をエージェントとして設定

~/.jetbrains/acp.json を編集し、agent_servers の下に Factory Droid エントリを追加します:
{
  "agent_servers": {
    "Factory Droid": {
      "command": "*path/to/droid/cli*",
      "args": ["exec", "--output-format", "acp"]
    }
  }
}
  • commanddroid バイナリの完全パス
  • args – Droid を exec モードで実行し、ACP を JetBrains に返す
ログインフローの代わりに API キーを使用したい場合は、env ブロックを追加します:
{
  "agent_servers": {
    "Factory Droid": {
      "command": "*path/to/droid/cli*",
      "args": ["exec", "--output-format", "acp"],
      "env": {
        "FACTORY_API_KEY": "*your API key from https://app.factory.ai/settings/api-keys*"
      }
    }
  }
}

JetBrains で Droid セッションを開始

エージェントサーバーが設定されると、AI Assistant UI を通じて Droid と完全にやり取りできます。

AI チャットパネルを開く

  • どこでも検索: Shift+Shift を押し、「AI Assistant」 と入力してツールウィンドウを開きます。
  • メニュー: 表示 → ツールウィンドウ → AI Assistant に移動します(IDE により名前は若干異なる場合があります)。

Factory Droid で新しいチャットを開始

  1. AI チャット パネルで + 新しいチャット をクリックします。
  2. 左下のエージェントドロップダウンで Factory Droid を選択します。
  3. CLI と同様にチャットを開始します。
セッションは Factory Droid の最後に選択された設定(モデル、自律レベルなど)を使用します。 AI Chat panel with + New Chat clicked and Factory Droid selected in the bottom-left dropdown

既存セッションの再開

JetBrains は CLI コマンドではなく AI チャット UI を通じてセッションを管理します。
  • AI チャットパネルで、右上の 時計アイコン をクリックします。
  • 過去の会話を選択して再開します。
AI Chat session history dropdown (clock icon) with previous Factory Droid sessions listed

モデルと自律制御

AI チャットフッターから直接モデルと自律レベルを変更できます。

モデルの切り替え

  • AI チャットパネル下部の モデルドロップダウン を使用します。
  • Factory でサポートされている任意のモデルを選択します(例:Claude Opus/Sonnet、GPT-5.1 バリアント、または BYOK で設定されたその他のモデル)。
AI Chat footer showing model dropdown expanded

自律レベルの変更

  • モデルセレクタの横の 自律ドロップダウン を使用します。
  • リスク許容度とワークフローに適した自律レベルを選択します。
推奨パターン:
  • 中規模および大規模なタスクでは プランニングファースト フロー(低自律、仕様スタイルのプロンプト)で開始します。
  • プランに満足したら、自律レベルを Auto low または Auto medium に上げて、Droid がより多くのステップを継続的な確認なしで実行できるようにします。
AI Chat footer showing autonomy dropdown expanded

エディターコンテキストと制限事項

現在の JetBrains 統合は ACP を使用しますが、完全なエディターコンテキストを Droid に公開しません。
  • 開いているファイル、選択範囲、診断の自動共有なし
  • Droid パッチに直接接続された IDE ネイティブ差分ビューアーなし
これを CLI へのリッチなチャットフロントエンドとして扱ってください:
  • 明確なプロンプトを使用し、ファイルをパスで参照し、自律モードと仕様スタイルプランニングに依存して大きな変更を管理します。

トラブルシューティング

Factory Droid が AI チャットに表示されない、または応答しない場合:
  • CLI を確認:
    • 通常のターミナルで droid exec --output-format acp を実行し、バイナリと API キーが機能することを確認します。
  • エージェントサーバー設定 を再確認:
    • droid への正しいパス
    • argsexec--output-format acp の両方が含まれている
    • FACTORY_API_KEY が存在し有効である
  • Windows on ARM ではないことを確認してください。これはまだサポートされていません。
MCP 関連の問題については、各 MCP サーバーのコマンド、引数、環境変数が JetBrains の外部で実行したときに有効であることを確認してください。