Configure agent authorization

To work on a task, an agent needs an available authorization source. Air in IDEs offers the following options:

Agent login – the authorization that the agent manages itself. Air in IDEs reuses an existing login when it detects one on your machine; otherwise, the agent starts its own authorization flow.
JetBrains AI – an eligible JetBrains AI license or organization workspace associated with your JetBrains Account.
Junie Lite – a free model tier of Junie that requires only a JetBrains Account.
Configured provider – a third-party AI provider that you configure in Air in IDEs with the credentials that it requires.

The source that you select also determines how the work of an agent is billed. When an agent works through JetBrains AI, your JetBrains AI access and subscription cover the usage. When an agent works through a configured provider or through its own authorization, the subscription, billing, and terms of that provider apply.

Air in IDEs detects the agents installed on your machine together with the configuration that they already use. If such an agent is already authorized, for example, because you have previously logged in to it, a session starts with that authorization, so you do not need to configure anything in the IDE. An agent that has no authorization yet starts its own authorization flow instead.

In a session, this source is represented by the Agent login entry in the list opened by clicking the button.

Session prompt area with the authorization list open, showing the Agent login entry managed by the agent at the top of the list.

Use JetBrains AI

If your JetBrains Account has an eligible JetBrains AI license or organization workspace assigned to it, you can use it with the agents that support JetBrains AI authorization. Currently, these are the following agents:

The JetBrains account entry at the top of the AI | Air | Accounts page holds this authorization. To log in to your JetBrains Account:

After you log in, the entry shows the name of your account, a list of available JetBrains AI licenses or organizations associated with your account, and how many of your monthly credits are left. To review the licenses of your account, click next to the account name and select Manage Subscriptions.

Personal account

For an account that works with a subscription of its own, the list holds the eligible JetBrains AI licenses of that account. To select a specific license, click and select the required one from the list.

Accounts settings with the logged-in JetBrains account entry, an eligible personal JetBrains AI license selected, and the monthly credits left.

Organization account

For an account that belongs to organizations which supply credits to it, the list holds the organization workspaces of these organizations. Click to select the organization workspace to spend credits from.

When you select an organization workspace, you spend the credits of the organization, and the AI policies that its administrator configured for this organization workspace apply to your sessions. For example, the policies can limit which agents and providers are available to you.

AI | Air | Accounts settings with the JetBrains account entry, the list of organization workspaces that supply credits, and the monthly credits left.

Use Junie Lite

If you do not have a subscription with a specific agent or a provider yet, try Junie Lite: it is free with a JetBrains Account. Junie Lite is a free model tier of Junie, JetBrains' coding agent. It does not require a JetBrains AI license: access to the model is granted automatically.

To use Junie Lite:

Press Ctrl+Alt+S and select AI | Air | Accounts.
On the JetBrains account entry, click Log in and complete the login in the browser.
Once logged in, click on the JetBrains account entry and select Junie Lite Only.
Start a session with Junie. The free Lite model is automatically selected for the agent.

For more information about Junie Lite, such as its usage limits and how your data is handled, refer to the Junie Lite documentation.

Use a configured AI provider

Air in IDEs supports several third-party AI providers. You can configure a provider using the credentials and settings that it requires, such as an API key, and switch between the configured providers as your tasks require.

The following providers are available:

Anthropic – provides the Claude family of models through the Anthropic API. Create a key on the API keys page of the Claude Console.
OpenAI – provides the GPT family of models through the OpenAI API. Create a key on the API keys page of the OpenAI platform.
Gemini – provides the Gemini family of models through the Gemini API. Create a key in Google AI Studio.
OpenRouter – provides models from many vendors through a single API key. Because OpenRouter supports both the Anthropic and the OpenAI API, agents that use either API can work through it. Create a key in your OpenRouter account.

Each provider works only with the agents that support its API.

Add an AI provider

Press Ctrl+Alt+S and select AI | Air | Accounts. Alternatively, click in the session and select Accounts.
Click More Providers and select the provider that you want to add.
In the dialog that opens, enter the credentials that you obtained from the provider and configure any additional settings required to finish the configuration.
Click the Test Connection button to check whether the connection to the provider is established.
Click OK to save the settings.

The configured provider appears in the AI Providers list and becomes available for selection in sessions with the agents that support it.

Edit or remove a provider

To change or delete the configuration of a provider, click on its entry in the AI Providers list and select the action that you need.

Accounts settings with the menu open on the OpenAI API key entry, offering the Edit and Remove provider actions.

Select the authorization for a session

Every authorization source is selected in the session. Click the button below the prompt field and select the source for the session:

Session controls below the prompt field with the authorization widget open, listing Agent login, JetBrains AI, a configured OpenAI provider, and the Accounts item.

Agent login – the authorization that the agent manages itself. Select this entry to let the agent handle authorization: if Air in IDEs detects an existing login, it reuses it, and an authorized agent starts directly. Otherwise, the agent starts its own authorization flow.
JetBrains AI – your JetBrains Account, with access to JetBrains AI.
One entry for every compatible provider configured on the Accounts page.

Sending a prompt in a session where the agent has no authorization yet also starts the authorization procedure. The agent responds with the Choose a sign-in method to continue list, which holds the same authorization sources. You can authorize the agent by selecting the preferred option from the list.

Agent session where the first message triggers the sign-in method list with the agent account, JetBrains AI organization workspaces, and Add an AI provider.

30 October 2026