セットアップ
JetBrains AI を搭載した JetBrains IDE(2025.3以降)で(最新版に更新してください):- 設定 > ツール > AI Assistant > Agents を開くか、エージェントピッカーメニューで 「ACP Registry からインストール…」 を選択します。
- Factory Droid を見つけます。
- インストール をクリックします。
- AI チャットパネルを開き、エージェントドロップダウンから Factory Droid を選択します。
- 認証されていない場合は、認証が必要であることを示すメッセージが表示されます。
- 表示されたデバイスコードを控えて、「ログイン」ボタンをクリックします。
- ウェブブラウザが開き、Factory へのログイン/サインアップ、その後デバイスコードの確認画面が表示されます。
(代替)手動セットアップ
JetBrains 内で Droid を手動で設定したい場合は、以下の手順に従ってください。-
Factory CLI のインストール(Windows ARM マシンを除くすべてのオペレーティングシステムでサポート)
-
以下を使用してインストール:
-
droidバイナリが PATH に含まれていることを確認してください(または完全パスをメモしてください)。
-
以下を使用してインストール:
-
(オプション)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 エントリを追加します:
command–droidバイナリの完全パスargs– Droid を exec モードで実行し、ACP を JetBrains に返す
env ブロックを追加します:
JetBrains で Droid セッションを開始
エージェントサーバーが設定されると、AI Assistant UI を通じて Droid と完全にやり取りできます。AI チャットパネルを開く
- どこでも検索:
Shift+Shiftを押し、「AI Assistant」 と入力してツールウィンドウを開きます。 - メニュー: 表示 → ツールウィンドウ → AI Assistant に移動します(IDE により名前は若干異なる場合があります)。
Factory Droid で新しいチャットを開始
- AI チャット パネルで + 新しいチャット をクリックします。
- 左下のエージェントドロップダウンで Factory Droid を選択します。
- CLI と同様にチャットを開始します。

既存セッションの再開
JetBrains は CLI コマンドではなく AI チャット UI を通じてセッションを管理します。- AI チャットパネルで、右上の 時計アイコン をクリックします。
- 過去の会話を選択して再開します。

モデルと自律制御
AI チャットフッターから直接モデルと自律レベルを変更できます。モデルの切り替え
- AI チャットパネル下部の モデルドロップダウン を使用します。
- Factory でサポートされている任意のモデルを選択します(例:Claude Opus/Sonnet、GPT-5.1 バリアント、または BYOK で設定されたその他のモデル)。

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

エディターコンテキストと制限事項
現在の JetBrains 統合は ACP を使用しますが、完全なエディターコンテキストを Droid に公開しません。- 開いているファイル、選択範囲、診断の自動共有なし
- Droid パッチに直接接続された IDE ネイティブ差分ビューアーなし
- 明確なプロンプトを使用し、ファイルをパスで参照し、自律モードと仕様スタイルプランニングに依存して大きな変更を管理します。
トラブルシューティング
Factory Droid が AI チャットに表示されない、または応答しない場合:- CLI を確認:
- 通常のターミナルで
droid exec --output-format acpを実行し、バイナリと API キーが機能することを確認します。
- 通常のターミナルで
- エージェントサーバー設定 を再確認:
droidへの正しいパスargsにexecと--output-format acpの両方が含まれているFACTORY_API_KEYが存在し有効である
- Windows on ARM ではないことを確認してください。これはまだサポートされていません。
