# Get started with Air

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

Use [Air](https://www.jetbrains.com.cn/en-us/air/ides/) to run and orchestrate AI coding agents directly inside IntelliJ IDEA.

Follow this guide to install JetBrains Air in IDEs, start your first agent session, provide context, and review the changes suggested by the agent. For a more detailed walkthrough, [watch the video](#watch-walkthrough) at the end of this guide.

## 1. Install JetBrains Air in IDEs

JetBrains Air in IDEs is a separate plugin that provides the workspace for running coding agents in the IDE.

The JetBrains Air in IDEs plugin is bundled with the IDE, so you do not need to install it. To make sure that the plugin is enabled:

Procedure:

1. [Open settings](jetbrains://tool/settings?name=Plugins) or press `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)) in your IDE and then select `Plugins`.

2. In the Bundled section, locate the Air plugin in the list and make sure it is enabled.

> **Note:**
> The plugin itself is free, but the agent you use may require its own account or subscription.

## 2. Open a project

Agent sessions work with the files and configuration of the project that is open in the IDE.

Procedure:

* Open the project where you want to work with an agent.

## 3. Select an agent and start a session

You can start a session with any agent that JetBrains Air in IDEs detects on your machine or that you install. If you have worked with the agent before, the session starts with the settings from your last session with it, such as the model, effort, and mode.

Procedure:

* In the main toolbar, either click New Session to immediately start a session with the selected agent, or click ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.chevronDown.svg) and select another agent from the list. This opens a new session with the agent in a new editor tab.

![Agent widget menu in the main toolbar listing the agents and presets available for a new session, and the Manage Agents item.](https://resources.jetbrains.com.cn/help/img/idea/2026.3/air_widget_overview.png)

## 4. Authorize the agent

To work on a task, an agent needs an available authorization source. As soon as the session opens, you can tell whether the agent picked up your existing configuration or you need to configure one:

Procedure:

1. If JetBrains Air in IDEs detects an authorization that the agent already uses on your machine, it selects it as an authorization source, and you can proceed to the [next step](#configure-agent).

If the Choose AI Provider list is shown instead, select the preferred authorization method.

![New Codex session with the Choose AI Provider list, showing a JetBrains AI organization workspace, two ChatGPT sign-in options, and Add API Key.](https://resources.jetbrains.com.cn/help/img/idea/2026.3/air_choose_sign_in_method.png)

> **Note:**
> The list holds the methods available for the selected agent.

2. Complete the authorization:

Agent login:

Depending on the agent, you may be prompted to complete the authorization in a browser or terminal.

1.

Provide your login details in the browser or terminal that opens, or follow another authorization flow that the agent provides.

2.

Return to the session.

JetBrains AI:

Agents that support JetBrains AI authorization offer a JetBrains AI entry if you have an eligible license or organization workspace associated with your JetBrains Account.

1.  Select the JetBrains AI entry from the list.

2.  Wait until the connection to the selected agent is established.

Third-party AI provider (BYOK):

Use this option to work through a provider subscription of your own. Selecting the Add API Key option opens the `AI | Air | Accounts` settings page:

1.

Click More Providers and select the provider that you want to add.

![Accounts settings with a configured OpenAI API key entry and the More Providers popup listing the available API key types.](https://resources.jetbrains.com.cn/help/img/idea/2026.3/air_accounts_settings_key_configured.png)

2.

In the dialog that opens, enter the credentials that the provider requires, such as an API key, and configure any additional settings.

> **Tip:**
> Click the Test Connection button to check whether the connection to the provider is established.

3.

Click OK to save the settings.

4.

Return to the session and select the configured provider in the list.

After the authorization completes, the agent is ready to work on the task.

## 5. Configure the agent

If needed, you can configure the agent before you send your first request for the task. The available options depend on the selected agent, but you usually can:

Procedure:

* Select a processing model and the reasoning effort for the task.

* Select an operation mode that determines which actions the agent can perform without asking for confirmation.

* Configure any other settings available for the selected agent.

## 6. Describe the task and add context

Give the agent a specific goal and enough information to complete it. Describe the expected result, mention important constraints, and attach the project items that the agent needs to inspect.

Procedure:

1. Type your request in the prompt field using natural language.

2. Click the ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg) button and attach the files, commits, or skills that the agent needs for the task.

![Add-context menu open in the prompt field, listing options to attach project files, screen context, commits, and skills to the request.](https://resources.jetbrains.com.cn/help/img/idea/2026.3/air_add_context.png)

> **Tip:**
> You can also reference project files and folders with `@file:` and `@folder:`. Reference skills with the `$` symbol.

## 7. Send the prompt and follow the task

When the prompt contains the task and required context, send it to start the agent. The agent then reports its progress and may ask you questions while it works.

Procedure:

1. Click ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/sendNowMenuItem.svg) Send in the bottom-right corner of the prompt field, or press `Enter`.

2. Follow the agent's progress and provide any information it requests.

## 8. Review and manage the changes

Review the result before committing the changes. In a code review, you go through the changed files and leave notes on the lines that need rework or an explanation. The agent receives the notes with your next message, and then answers your questions or updates the code.

Procedure:

1. When the agent finishes the task, click ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.vcs.diff.svg) Review Code in the header of the session tab.

![Session tab with the Review Code button and the +94 -0 line counts in the header, above an agent reply and a list of one file changed since the last turn.](https://resources.jetbrains.com.cn/help/img/idea/2026.3/air_start_code_review.png)

2. Select the changes to review. For the result of your first task, click Local changes to review all uncommitted changes.

![Review Code popup in the session header with Local changes selected under Uncommitted, above a list of the commits of the master branch.](https://resources.jetbrains.com.cn/help/img/idea/2026.3/air_code_review_scope.png)

The code review starts. The Review in progress tab of the Agent Sessions tool window lists the changed files, and the diff of the selected file opens in the Code Review editor tab.

![Review in progress tab with the tree of four changed files, three of them viewed, next to the Code Review tab with the diff of taskFormats.js and the Go to Session button on its toolbar.](https://resources.jetbrains.com.cn/help/img/idea/2026.3/air_code_review_in_progress.png)

3. Go through the changed files: select a file in the Review in progress tab, or use the ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.left.svg)![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.right.svg) buttons on the toolbar of the Code Review tab.

4. If a change is unclear or needs rework, leave a note: click ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/chatMode.svg) in the gutter next to the line, type your question or request, and press `Enter`.

![Code Review tab with a saved note card on line 28 and a note draft on line 32 that shows the Add sorting by due date session with the In code review label.](https://resources.jetbrains.com.cn/help/img/idea/2026.3/air_code_review_add_note.png)

5. When you have gone through all files, click Finish & Attach Comments in the Review in progress tab.

![Review in progress tab with the Local + 2 commits scope, nine changed files, two notes on taskManager.js, and the Finish & Attach Comments and Cancel buttons at the bottom.](https://resources.jetbrains.com.cn/help/img/idea/2026.3/air_finish_and_attach_comments.png)

The review ends, and the notes appear in the text field of the session as one attachment per file.

![Text field of the session with two attachments: reporting.test.js with one note and taskManager.js with two notes.](https://resources.jetbrains.com.cn/help/img/idea/2026.3/air_attached_code_notes.png)

6. Add a prompt if needed, for example `Address the notes`, and send the message. The agent answers your notes or updates the code.

7. Repeat the review until the changes suit you, and then commit them.

## Watch the walkthrough

Watch an eight-minute demo that goes beyond this guide. In the video, you learn how to:

* Choose the right agent for the job.

* Create separate sessions for different tasks.

* Track the agent's progress without watching every step.

* Start a request by pressing `Ctrl` twice.

* Switch between chat and terminal sessions.

* Dictate a prompt with voice input.

* Tell an unread update from a session that needs your input.

[Video](https://www.youtube.com/v/l7fRDT5TuyE)

## Next steps

Learn how to use Air in IntelliJ IDEA from the Air documentation:

* [Key concepts](https://www.jetbrains.com.cn/en-us/help/air-ides/air-key-concepts.html)

* [Start, continue, or fork a session](https://www.jetbrains.com.cn/en-us/help/air-ides/air-start-a-new-session.html)

* [Interact with the agent](https://www.jetbrains.com.cn/en-us/help/air-ides/air-interact-with-the-agent.html)

* [Configure and manage presets](https://www.jetbrains.com.cn/en-us/help/air-ides/air-configure-presets.html)

* [Review changes with AI](https://www.jetbrains.com.cn/en-us/help/air-ides/air-review-agent-changes.html)

