Installing the Amazon Q Developer extension or plugin in your IDE
To set up Amazon Q Developer in your integrated development environment (IDE), complete the
following steps. After installing the Amazon Q extension or plugin, authenticate through IAM Identity Center or AWS Builder ID.
You can use Amazon Q for free, without an AWS account, by authenticating with Builder ID.
To get started, download the Amazon Q extension or plugin for your IDE:
In general, the default duration for a session that is authenticated through IAM Identity Center
is 8 hours. However, in the case of Amazon Q, the default
session lasts 90 days (if you set up IAM Identity Center on April 18, 2024 or later). For more information refer to How to extend the session duration for Amazon Q in the IDE in the IAM Identity Center User
Guide.
To sign in and authenticate, complete the steps in this section.
Prerequisite: Choose a supported version of your
IDE
-
The minimum version of Eclipse supported by Amazon Q is 2024-06 (4.32).
-
The minimum version of JetBrains IDEs (including IntelliJ and PyCharm) supported by
Amazon Q is 232.1. JetBrains versions 232, 233 and 241 are also supported.
-
The minimum version of Visual Studio Code supported by Amazon Q is 1.85.0.
-
Only Visual Studio for Windows is supported by Amazon Q. The minimum version
of Visual Studio supported is Visual Studio 2022 version 17.7. All Visual Studio 2022 editions are
supported.
Authenticating in Eclipse IDEs (Preview)
You can authenticate for free with AWS Builder ID or with IAM Identity Center with a Amazon Q Developer Pro
subscription. Choose your authentication method to see steps to start using Amazon Q in Eclipse.
- Builder ID
-
This procedure does not require you to have Builder ID. If you have not yet signed up for
Builder ID, you will have the opportunity to do so during the sign-in process.
-
Install the Amazon Q plugin in Eclipse.
-
Choose the Amazon Q icon in the top right corner of the IDE.
-
An Amazon Q tab opens at the bottom of the IDE. Under
Choose a sign-in option, choose Use for free, and then choose
Continue. You are redirected to your browser.
-
Follow the instructions in your browser to authenticate with Builder ID. When
you've completed authentication, return to the Eclipse IDE.
-
To begin using Amazon Q, choose the Amazon Q icon to open the chat Amazon Q panel.
- Amazon Q Developer Pro license
-
Before you begin this procedure, your administrator should have:
After your identity has been subscribed to Amazon Q Developer Pro, complete the following steps
to authenticate:
-
Install the
Amazon Q plugin in Eclipse.
-
Choose the Amazon Q icon in the top right corner of the IDE.
-
An Amazon Q tab opens at the bottom of the IDE. Under
Choose a sign-in option, choose Use with Pro license, and then choose
Continue.
-
Enter the Start URL that your administrator got from the Amazon Q subscription
console.
-
Choose the AWS Region in which your administrator set up your IAM Identity Center
instance.
-
Choose Continue. You are redirected to your browser.
-
Follow the instructions in your browser to authenticate with IAM Identity Center. When
you've completed authentication, return to the Eclipse IDE.
-
To begin using Amazon Q, choose the Amazon Q icon to open the chat Amazon Q panel.
Authenticating in JetBrains IDEs
You can authenticate for free with AWS Builder ID or with IAM Identity Center with a Amazon Q Developer Pro
subscription. Choose your authentication method to see steps to start using Amazon Q in your
JetBrains IDE.
- Builder ID
-
This procedure does not require you to have Builder ID. If you have not yet signed up for
Builder ID, you will have the opportunity to do so during the sign-in process.
-
Install the Amazon Q plugin in your JetBrains IDE.
-
Choose the Amazon Q icon in your IDE.
The icon will be on the side of the interface by default.
-
Follow the instructions in your browser to authenticate with Builder ID.
-
To begin using Amazon Q, choose the Amazon Q icon to chat with Amazon Q, or choose
Amazon Q from the navigation bar at the bottom of
your IDE.
- Amazon Q Developer Pro license
-
Before you begin this procedure, your administrator should have:
After your identity has been subscribed to Amazon Q Developer Pro, complete the following steps
to authenticate:
-
Install the Amazon Q plugin in your JetBrains IDE.
-
Choose the Amazon Q icon in your IDE.
The icon will be on the side of the interface by default.
-
Choose Use with Pro license.
-
Fill in the Start URL that your administrator got from the Amazon Q subscription
console.
-
Fill in the AWS Region in which your administrator set up your IAM Identity Center
instance.
-
Choose Continue. The focus will switch to your web
browser.
-
Follow the instructions in your browser to authenticate with IAM Identity Center.
-
To begin using Amazon Q, choose the Amazon Q icon to chat with Amazon Q, or choose
Amazon Q from the navigation bar at the bottom of
your IDE.
Authenticating in Visual Studio Code
You can authenticate for free with AWS Builder ID or with IAM Identity Center with a Amazon Q Developer Pro
subscription. Choose your authentication method to see steps to start using Amazon Q in VS Code.
- Builder ID
-
This procedure does not require you to have Builder ID. If you have not yet signed up for
Builder ID, you will have the opportunity to do so during the sign-in process.
-
Install the Amazon Q extension in VS Code.
-
Choose the Amazon Q icon in your IDE.
The icon will be on the side of the interface by default.
-
Follow the instructions in your browser to authenticate with Builder ID.
-
To begin using Amazon Q, choose the Amazon Q icon to chat with Amazon Q, or choose
Amazon Q from the navigation bar at the bottom of
your IDE.
- Amazon Q Developer Pro license
-
Before you begin this procedure, your administrator should have:
After your identity has been subscribed to Amazon Q Developer Pro, complete the following steps
to authenticate:
-
Install the Amazon Q extension in VS Code.
-
Choose the Amazon Q icon in your IDE.
The icon will be on the side of the interface by default.
-
Choose Use with Pro license.
-
Fill in the Start URL that your administrator got from the Amazon Q subscription
console.
-
Fill in the AWS Region in which your administrator set up your IAM Identity Center
instance.
-
Choose Continue. The focus will switch to your web
browser.
-
Follow the instructions in your browser to authenticate with IAM Identity Center.
-
To begin using Amazon Q, choose the Amazon Q icon to chat with Amazon Q, or choose
Amazon Q from the navigation bar at the bottom of
your IDE.
Authenticating in Visual Studio
To connect to your AWS accounts from the Toolkit for Visual Studio, open the Getting Started with
the AWS Toolkit User Interface (connection UI) by completing the following
procedure.
-
From the Visual Studio main menu, expand Extensions then expand the
AWS Toolkit.
-
From the AWS Toolkit menu options choose Getting
Started.
-
The Getting Started with the AWS Toolkit connection UI opens in
Visual Studio.
You can authenticate for free with AWS Builder ID or with IAM Identity Center with a Amazon Q Developer Pro
subscription. Choose your authentication method to see steps to start using Amazon Q in Visual Studio.
- Builder ID
-
-
From the Getting Started with the AWS Toolkit connection UI,
select the Amazon Q Developer radial to expand the Amazon Q Developer authentication
options.
-
From the I'm using Amazon Q Developer on my own section, choose the
Sign up or Sign in button to open the Log in with
AWS Builder ID dialog.
-
Choose the Proceed to Browser button to open the AWS
Authorize request site in your default web browser.
-
Follow the prompts in your default web browser. You're notified when the authorization
process is complete, and it's safe to close your browser and return to Visual Studio.
- Amazon Q Developer Pro license
-
-
From the Getting Started with the AWS Toolkit connection UI,
select the Amazon Q Developer radial to expand the Amazon Q Developer authentication
options.
If no stored credentials exist, proceed to Step 3 to add or
update your IAM Identity Center credentials.
-
From the My organization has enabled Amazon Q Developer section, expand
the Choose from an existing Profile or add new drop-down menu to
choose from your list of stored credentials.
-
From the Profile Type drop-down menu, choose
AWS IAM Identity Center.
-
In the Profile Name text field, enter the Profile
Name
of the IAM Identity Center profile you want to authenticate with.
-
In the Start URL text field, enter the Start
URL
that's attached to your IAM Identity Center credentials.
-
From the Profile Region (defaults to us-east-1) drop-down menu,
choose the Profile Region that's defined by the IAM Identity Center user profile
you're authenticating with.
-
From the SSO Region (defaults to us-east-1) drop-down menu,
choose the SSO Region that's defined by your IAM Identity Center credentials, then
choose the Connect button to open the Log in with AWS
IAM Identity Center dialog.
-
From the Log in with AWS IAM Identity Center dialog, choose the
Proceed to Browser button to open the AWS Authorize
request site in your default web browser.
-
Follow the prompts in your default web browser. You're notified when the authorization
process is complete, and it's safe to close your browser and return to Visual Studio.
For more information about authenticating in the Toolkit for Visual Studio, see Getting
Started in the AWS Toolkit for Visual Studio User Guide.
Using an IAM principal in your AWS
console
Depending on how you use AWS, you may be accustomed to using your IAM credentials to
sign in to the console for all AWS services. However, you cannot use Amazon Q Developer in the IDE
as an IAM principal, or with an IAM role. You must authenticate with credentials from
either IAM Identity Center or Builder ID.