# Air を使い始める

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/idea/llms.txt).

[Air](https://www.jetbrains.com/ja-jp/air/ides/) を使用して、AI コーディングエージェントを IntelliJ IDEA 内で直接実行およびオーケストレーションします。

このガイドに従って IDE における JetBrains Air をインストールし、最初のエージェント  セッション  を開始し、  コンテキスト  を提供して、  エージェント  が提案した変更をレビューします。

## 1. JetBrains Air を IDE にインストール

IDE における JetBrains Air は、IDE でコーディングエージェントを実行するためのワークスペースを提供する別個のプラグインです。

IDE における JetBrains Air プラグインは IDE にバンドルされているため、インストールする必要はありません。 プラグインが有効化されていることを確認するには:

Procedure:

1. [設定を開く](jetbrains://tool/settings?name=Plugins)か、IDE で `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) を押してから  `プラグイン`  を選択します。

2. バンドル   セクションで、一覧から   Air   プラグインを見つけ、有効化されていることを確認します。

> **Note:**
> プラグイン自体は無料ですが、使用するエージェントには独自のアカウントまたはサブスクリプションが必要な場合があります。

## 2。 プロジェクトを開く

エージェントセッションは、IDE で開いているプロジェクトのファイルと構成を使用します。

Procedure:

* エージェントを操作するプロジェクトを開きます。

## 3。 エージェントを選択してセッションを開始する

IDE における JetBrains Air はプリセットからセッションを開始します。プリセットとは、モデル、エフォート、アクセスレベル、その他のセッションオプションを事前に選択するエージェント構成です。 IDE における JetBrains Air がマシン上で検出した、またはインストールしたサポート対象エージェントごとに、プリセットが自動的に作成されます。

Procedure:

* メインツールバーで、   新規セッション   をクリックして選択したエージェントでセッションをすぐに開始するか、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.chevronDown.svg) をクリックして一覧から特定のエージェントプリセットを選択します。 これにより、新しいエディタータブでエージェントとの新しいセッションが開きます。

![新しいセッションで使用可能なプリセットとエージェントのデフォルト、さらに Add Agents 項目を一覧表示する、メインツールバーのエージェントウィジェットメニュー。](https://resources.jetbrains.com/help/img/idea/2026.3/air_widget_overview.png)

## 4。 エージェントを認可する

タスクに取り組むには、エージェントに利用可能な  認可ソース  が必要です。 セッションで最初のメッセージを送信した後、エージェントが既存の構成を取得したか、構成が必要かを確認できます:

Procedure:

1. プロンプトフィールドにメッセージを入力し、  `Enter`  を押します。

IDE における JetBrains Air がマシン上でエージェントがすでに使用している認可を検出すると、エージェントはメッセージに応答し、 [次のステップ](#configure-agent) に進むことができます。

2. 代わりにエージェントが   続行するには、サインインメソッドを選択してください。   一覧を表示した場合は、使用する認可メソッドをクリックするか、 `Up` (Windows), `↑` (macOS), `↑` (IntelliJ IDEA Classic (macOS)), `↑` (macOS System Shortcuts), `Up` (XWin), `Up` (GNOME), `Up` (KDE), `Up` (Emacs), `Up` (Sublime Text), `↑` (Sublime Text (macOS)), `Up` (Visual Studio), `↑` (Visual Studio (macOS)), `Up` (NetBeans), `Up` (Eclipse), `↑` (Eclipse (macOS)) と `Down` (Windows), `↓` (macOS), `↓` (IntelliJ IDEA Classic (macOS)), `↓` (macOS System Shortcuts), `Down` (XWin), `Down` (GNOME), `Down` (KDE), `Down` (Emacs), `Down` (Sublime Text), `↓` (Sublime Text (macOS)), `Down` (Visual Studio), `↓` (Visual Studio (macOS)), `Down` (NetBeans), `Down` (Eclipse), `↓` (Eclipse (macOS)) の方向キーで選択して、  `Enter`  を押します。

![最初のメッセージが、エージェントアカウント、JetBrains AI ワークスペース、「AI プロバイダーを追加」を含むサインインメソッド一覧のトリガーとなるエージェントセッション。](https://resources.jetbrains.com/help/img/idea/2026.3/air_choose_sign_in_method.png)

> **Note:**
> 一覧には、選択したエージェントで利用可能なメソッドが含まれています。

3. 認可を完了します:

エージェントログイン:

エージェントによっては、ブラウザーまたはターミナルで認可を完了するよう求められる場合があります。

1.

開いたブラウザーまたはターミナルでログイン情報を入力するか、エージェントが提供する別の認可フローに従います。

2.

セッションに戻ります。

JetBrains AI:

JetBrains AI 認可をサポートするエージェントは、対象ライセンスまたは JetBrains Account に関連付けられた組織ワークスペースがある場合、   JetBrains AI   エントリを提供します。

1.  一覧から   JetBrains AI   エントリを選択します。

2.  選択したエージェントへの接続が確立されるまで待ちます。

サードパーティ AI プロバイダー:

独自のプロバイダーサブスクリプションを通じて作業するには、このオプションを使用します。   AI プロバイダーを追加   オプションを選択すると、  `ツール | Air | アカウント`  設定ページが開きます:

1.

他のプロバイダー   をクリックし、追加するプロバイダーを選択します。

![構成済みの OpenAI API 鍵エントリと、利用可能な API 鍵タイプを一覧表示するその他のプロバイダーポップアップがあるアカウント設定。](https://resources.jetbrains.com/help/img/idea/2026.3/air_accounts_settings_key_configured.png)

2.

開いたダイアログで、API 鍵など、プロバイダーが要求する資格情報を入力し、追加設定を構成します。

> **Tip:**
> 接続のテスト   ボタンをクリックして、プロバイダーへの接続が確立されているかどうかを確認します。

3.

OK   をクリックして設定を保存します。

4.

セッションに戻り、一覧で構成済みのプロバイダーを選択します。

認可が完了すると、エージェントはタスクに取り組む準備が整います。

## 5. エージェントを構成する

必要に応じて、タスクの最初のリクエストを送信する前にエージェントを構成できます。 利用可能なオプションは選択したエージェントによって異なりますが、通常は次のことができます:

Procedure:

* 処理モデルとタスクの推論エフォートを選択します。

* 確認を求めずにエージェントが実行できるアクションを決定するアクセスレベルを選択します。

* 選択したエージェントで利用可能なその他の設定を構成します。

## 6. タスクを説明してコンテキストを追加する

エージェントに具体的な目標と、それを完了するための十分な情報を提供します。 期待される結果を説明し、重要な制約を挙げ、エージェントが調査する必要があるプロジェクト項目を添付します。

Procedure:

1. 自然言語を使用して、プロンプトフィールドにリクエストを入力します。

2. ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) ボタンをクリックし、エージェントがタスクに必要とするファイル、コミット、または  スキル  を添付します。

![プロンプトフィールドで開いているコンテキスト追加のコンテキストメニュー。リクエストにプロジェクトファイル、画面コンテキスト、コミット、スキルを添付するオプションが一覧表示されています。](https://resources.jetbrains.com/help/img/idea/2026.3/air_add_context.png)

> **Tip:**
> プロジェクトファイルやフォルダーを  `@file:`  と  `@folder:`  で参照することもできます。  `$`  シンボルでスキルを参照します。

## 7. プロンプトを送信してタスクを進める

プロンプトにタスクと必要なコンテキストが含まれている場合は、それを送信してエージェントを開始します。 その後、エージェントは進捗を報告し、作業中に質問する場合があります。

Procedure:

1. プロンプトフィールドの右下隅にある ![](https://resources.jetbrains.com/help/img/idea/2026.3/sendNowMenuItem.svg)   送信   をクリックするか、  `Enter`  を押します。

2. エージェントの進捗を確認し、要求された情報を提供します。

## 8. 変更をレビューして管理する

変更をコミットする前に結果をレビューします。 セッションタブでは、最新のイテレーションでエージェントが変更したファイル、またはプロジェクト内のすべての未コミットの変更をレビューできます。

前回のターン以降の変更:

エージェントがメッセージの処理を完了すると、セッションチャットに、このイテレーションで変更されたファイルの一覧が表示されます。 この一覧には、変更されたファイル数と、各ファイルで追加および除去された行数が表示されます。

![セッションチャット。前回のターン以降に変更された二つのファイルの一覧と、プロンプトフィールドの上にある Review ボタンが表示されています。](https://resources.jetbrains.com/help/img/idea/2026.3/air_review_changes_in_chat.png)

Procedure:

変更をレビューするには:

* 一覧内のファイルをクリックして、そのファイルの diff を開きます。

* 一覧の右上隅にある ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.vcs.diff.svg)   レビュー   をクリックして、一覧の最初のファイルからレビューを開始し、そこから残りのファイルに進みます。

一覧はエージェントが応答したメッセージに属するため、会話の履歴に残ります。 次のイテレーションでは、その中で変更されたファイルを含む独自の一覧が追加されます。

すべての未コミットの変更:

このセッションや他のセッション中に行われた変更を含め、プロジェクト内のすべての未コミットの変更をレビューするには:

Procedure:

1. セッションタブの右上隅にある ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.vcs.diff.svg)   ブランチの変更箇所   をクリックします。

![セッションタブで、ヘッダーのブランチの変更ボタンがハイライト表示され、その下にエージェントの返信と、前回のターン以降に変更された四つのファイルの一覧があります。](https://resources.jetbrains.com/help/img/idea/2026.3/air_review_branch_changes.png)

変更されたすべてのファイルを含む diff ビューアーが開きます。

![ツールバーコントロールとガター内のボタンがある diff ビューアー。](https://resources.jetbrains.com/help/img/idea/2026.3/air_diff_viewer_no_callouts.png)

2. ツールバーの ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.left.svg) ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.right.svg) 矢印を使用して、変更されたファイル間を移動し、結果を確認します。

3. 必要に応じて変更を保持または元に戻します。 変更を元に戻すには、その横のガターにある ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.diff.revert%4014x14.svg) をクリックします。

再作業が必要な場合は、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/chatMode.svg) をクリックして変更された行にメモを追加し、次のメッセージでエージェントに送信します。

4. ツールバーの   セッションを開く   をクリックしてセッションに戻り、エージェントとの会話を続けます。

## 次のステップ

Air ドキュメントで IntelliJ IDEA の Air の使用方法を確認してください:

* [鍵となる概念](https://www.jetbrains.com/ja-jp/help/air-ides/air-key-concepts.html)

* [セッションを開始、続行、またはフォークする](https://www.jetbrains.com/ja-jp/help/air-ides/air-start-a-new-session.html)

* [エージェントと対話する](https://www.jetbrains.com/ja-jp/help/air-ides/air-interact-with-the-agent.html)

* [プリセットを構成および管理する](https://www.jetbrains.com/ja-jp/help/air-ides/air-configure-presets.html)

* [AI で変更をレビューする](https://www.jetbrains.com/ja-jp/help/air-ides/air-review-agent-changes.html)

