本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 在 IDE 中安装 Amazon Q 开发者版扩展程序或插件
要在集成式开发环境 (IDE) 中设置 Amazon Q 开发者版，请完成以下步骤。安装 Amazon Q 扩展程序或插件后，通过 IAM Identity Center 或 AWS 构建者 ID进行身份验证。通过使用建筑商 ID 进行身份验证，无需 AWS 账户即可免费使用 Amazon Q。
首先，请下载适用于您的 IDE 的 Amazon Q 扩展程序或插件：
+ [下载 Amazon Q for Eclipse](https://marketplace.eclipse.org/content/amazon-q)
+ [下载 Amazon Q for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=AmazonWebServices.amazon-q-vscode)
+ [下载适用于 Amazon Q JetBrains IDEs](https://plugins.jetbrains.com/plugin/24267-amazon-q/)
+ [在中下载 Amazon Q AWS Toolkit for Visual Studio](https://marketplace.visualstudio.com/items?itemName=AmazonWebServices.AWSToolkitforVisualStudio2022)
**注意**
通常，通过 IAM Identity Center 进行身份验证的会话的默认持续时间为 8 小时。但是，对于 Amazon Q，默认会话持续 90 天（如果您在 2024 年 4 月 18 日或之后设置 IAM Identity Center）。有关更多信息，请参阅《AWS IAM Identity Center 用户指南》**中的[如何在 IDE 中延长 Amazon Q 的会话持续时间](https://docs.aws.amazon.com/singlesignon/latest/userguide/configure-user-session.html#90-day-extended-session-duration)。
要登录并进行身份验证，请完成本节中的步骤。
**Topics**
+ [先决条件：支持的 IDE 版本](#q-in-IDE-setup-prereqs)
+ [在 Eclipse IDEs 中进行身份验证](#setup-eclipse)
+ [在 JetBrains IDEs 中进行身份验证](#setup-jetbrains)
+ [在 Visual Studio Code 中进行身份验证](#setup-vscode)
+ [在 Visual Studio 中进行身份验证](#setup-vs)
+ [在 AWS 控制台中使用 IAM 委托人](#q-no-IAM-in-IDEs)
## 先决条件：支持的 IDE 版本
+ Amazon Q 支持的最低 Eclipse 版本为 2024-06（4.32）。
+ Amazon Q 支持的最低版本 JetBrains IDEs （包括IntelliJ和PyCharm）是 2024.3。
+ Amazon Q 支持的最低 Visual Studio Code 版本为 1.85.0。
+ 仅 Visual Studio for Windows 受 Amazon Q 支持。支持的最低 Visual Studio 版本是 Visual Studio 2022 版本 17.7。所有 Visual Studio 2022 版本均受支持。
## 在 Eclipse IDEs 中进行身份验证
订阅 Amazon Q Developer Pro，您可以通过 IAM 身份中心免费进行身份验证， AWS 构建者 ID 也可以通过 IAM 身份中心进行身份验证。选择您的身份验证方法以查看开始在 Eclipse 中使用 Amazon Q 的步骤。
------
#### [ Builder ID ]
此过程不要求您拥有构建者 ID。如果您尚未注册构建者 ID，则有机会在登录过程中注册。
1. 在 Eclipse 中安装 [Amazon Q 插件](https://marketplace.eclipse.org/content/amazon-q)。
1. 选择 IDE 右上角的 Amazon Q 图标。
1. IDE 底部会打开一个 Amazon Q 选项卡。在**选择登录选项**下，选择**个人账户**，然后选择**继续**。系统会将您重定向到浏览器。
1. 按照浏览器中的说明使用构建者 ID 进行身份验证。验证完成后，返回 Eclipse IDE。
1. 要开始使用 Amazon Q，选择 Amazon Q 图标以打开 Amazon Q 聊天面板。
------
#### [ IAM Identity Center ]
在开始此过程之前，您的管理员应满足以下要求：
+ 已经在 IAM Identity Center 为您创建身份
+ 已将该身份订阅到 Amazon Q 开发者版专业套餐
在您的身份订阅 Amazon Q 开发者版专业套餐后，请完成以下步骤进行身份验证：
1. 在 Eclipse 中安装 [Amazon Q 插件](https://marketplace.eclipse.org/content/amazon-q)。
1. 选择 IDE 右上角的 Amazon Q 图标。
1. IDE 底部会打开一个 Amazon Q 选项卡。在**选择登录选项**下，选择**公司账户**，然后选择**继续**。
1. 输入您的管理员从 [Amazon Q 订阅控制台](manage-account-details.md)获得的**起始 URL**。
1. 选择您的管理员 AWS 区域 在其中设置您[的 IAM 身份中心实例](https://docs.aws.amazon.com/singlesignon/latest/userguide/identity-center-instances.html)的。
1. 选择**继续**。系统会将您重定向到浏览器。
1. 按照浏览器中的说明使用 IAM Identity Center 进行身份验证。验证完成后，返回 Eclipse IDE。
1. 要开始使用 Amazon Q，选择 Amazon Q 图标以打开 Amazon Q 聊天面板。
------
## 在 JetBrains IDEs 中进行身份验证
订阅 Amazon Q Developer Pro，您可以通过 IAM 身份中心免费进行身份验证， AWS 构建者 ID 也可以通过 IAM 身份中心进行身份验证。选择您的身份验证方法以查看在 JetBrains IDE 中开始使用 Amazon Q 的步骤。
------
#### [ Builder ID ]
此过程不要求您拥有构建者 ID。如果您尚未注册构建者 ID，则有机会在登录过程中注册。
1. 在您的 JetBrains IDE 中安装 [Amazon Q 插件](https://plugins.jetbrains.com/plugin/24267-amazon-q/)。
1. 在您的 IDE 中选择 Amazon Q 图标。
默认情况下，该图标将位于界面的一侧。
1. 按照浏览器中的说明使用构建者 ID 进行身份验证。
1. 要开始使用 Amazon Q，请选择 Amazon Q 图标与 Amazon Q 聊天，或者从 IDE 底部的导航栏中选择 **Amazon Q**。
------
#### [ IAM Identity Center ]
在开始此过程之前，您的管理员应满足以下要求：
+ 已经在 IAM Identity Center 为您创建身份
+ 已将该身份订阅到 Amazon Q 开发者版专业套餐
在您的身份订阅 Amazon Q 开发者版专业套餐后，请完成以下步骤进行身份验证：
1. 在您的 JetBrains IDE 中安装 [Amazon Q 插件](https://plugins.jetbrains.com/plugin/24267-amazon-q/)。
1. 在您的 IDE 中选择 Amazon Q 图标。
默认情况下，该图标将位于界面的一侧。
1. 选择**公司账户**。
1. 提供管理员从 [Amazon Q 订阅控制台](manage-account-details.md)获得的**起始 URL**。
1. 提供您的管理员 AWS 区域 在其中设置您的 IAM 身份中心[实例](https://docs.aws.amazon.com/singlesignon/latest/userguide/identity-center-instances.html)的。
1. 选择**继续**。将关注点切换到您的 Web 浏览器。
1. 按照浏览器中的说明使用 IAM Identity Center 进行身份验证，然后返回 IDE。
1. 如果您的管理员配置了多个 Amazon Q 开发者版配置文件，您将看到自己有权访问的所有配置文件。请选择符合当前工作需求的配置文件，或管理员指示您使用的配置文件。有关配置文件的更多信息，请参阅[什么是 Amazon Q 开发者版配置文件？](subscribe-understanding-profile.md)。
若仅存在一个可用配置文件，系统将自动选择该配置文件，您可直接开始使用 Amazon Q。
更改 Amazon Q 开发者版配置文件，请从 IDE 底部选择 **Amazon Q**，然后选择**更改配置文件**。在出现的窗口中，选择要使用的配置文件。
1. 要开始使用 Amazon Q，请选择 Amazon Q 图标与 Amazon Q 聊天，或者从 IDE 底部的导航栏中选择 **Amazon Q**。
------
## 在 Visual Studio Code 中进行身份验证
订阅 Amazon Q Developer Pro，您可以通过 IAM 身份中心免费进行身份验证， AWS 构建者 ID 也可以通过 IAM 身份中心进行身份验证。选择您的身份验证方法以查看开始在 VS Code 中使用 Amazon Q 的步骤。
------
#### [ Builder ID ]
此过程不要求您拥有构建者 ID。如果您尚未注册构建者 ID，则有机会在登录过程中注册。
1. 在 VS Code 中安装 [Amazon Q 扩展程序](https://marketplace.visualstudio.com/items?itemName=AmazonWebServices.amazon-q-vscode)。
1. 在您的 IDE 中选择 Amazon Q 图标。
默认情况下，该图标将位于界面的一侧。
1. 按照浏览器中的说明使用构建者 ID 进行身份验证。
1. 要开始使用 Amazon Q，请选择 Amazon Q 图标与 Amazon Q 聊天，或者从 IDE 底部的导航栏中选择 **Amazon Q**。
------
#### [ IAM Identity Center ]
在开始此过程之前，您的管理员应满足以下要求：
+ 已经在 IAM Identity Center 为您创建身份
+ 已将该身份订阅到 Amazon Q 开发者版专业套餐
在您的身份订阅 Amazon Q 开发者版专业套餐后，请完成以下步骤进行身份验证：
1. 在 VS Code 中安装 [Amazon Q 扩展程序](https://marketplace.visualstudio.com/items?itemName=AmazonWebServices.amazon-q-vscode)。
1. 在您的 IDE 中选择 Amazon Q 图标。
默认情况下，该图标将位于界面的一侧。
1. 选择**公司账户**。
1. 提供管理员从 [Amazon Q 订阅控制台](manage-account-details.md)获得的**起始 URL**。
1. 提供您的管理员 AWS 区域 在其中设置您的 IAM 身份中心[实例](https://docs.aws.amazon.com/singlesignon/latest/userguide/identity-center-instances.html)的。
1. 选择**继续**。将关注点切换到您的 Web 浏览器。
1. 按照浏览器中的说明使用 IAM Identity Center 进行身份验证，然后返回 IDE。
1. 如果您的管理员配置了多个 Amazon Q 开发者版配置文件，您将看到自己有权访问的所有配置文件。请选择符合当前工作需求的配置文件，或管理员指示您使用的配置文件。有关配置文件的更多信息，请参阅[什么是 Amazon Q 开发者版配置文件？](subscribe-understanding-profile.md)。
若仅存在一个可用配置文件，系统将自动选择该配置文件，您可直接开始使用 Amazon Q。
更改 Amazon Q 开发者版配置文件，请从 IDE 底部选择 **Amazon Q**，然后选择**更改配置文件**。在命令面板中，选择要使用的配置文件。
1. 要开始使用 Amazon Q，请选择 Amazon Q 图标与 Amazon Q 聊天，或者从 IDE 底部的导航栏中选择 **Amazon Q**。
------
## 在 Visual Studio 中进行身份验证
要从 Visual Studio 的 Toolkit for Visual Studio 连接到您的 AWS 帐户，请完成以下步骤打开 ** AWS Toolkit 用户界面入门**（连接 UI）。
1. 在 Visual Studio 主菜单中，展开**扩展程序**，然后展开 **AWS Toolkit**。
1. 从 **AWS Toolkit** 菜单选项中选择**开始使用**。
1. ** AWS 工具包连接入门用户界面将**在 Visual Studio 中打开。
订阅 Amazon Q Developer Pro，您可以通过 IAM 身份中心免费进行身份验证， AWS 构建者 ID 也可以通过 IAM 身份中心进行身份验证。选择您的身份验证方法，查看在 Visual Studio 中开始使用 Amazon Q 的步骤。
------
#### [ Builder ID ]
1. 在 Visual Studio 中，从主菜单展开**扩展程序**，然后展开 **AWS 工具包**子菜单。
1. 选择**开始使用**。**开始使用**选项卡将在 Visual Studio 编辑器窗口中打开。
1. 在 **Amazon Q** 部分，选择**启用**。
1. 在**免费套餐**部分，选择**注册或登录**按钮。
1. 确认您要在默认 Web 浏览器中打开 AWS 授权请求门户。
1. 按照默认 Web 浏览器中的提示进行操作。身份验证过程完成时，您会收到通知，此时便可安全关闭浏览器窗口，返回到 Visual Studio。
------
#### [ IAM Identity Center ]
1. 在 Visual Studio 中，从主菜单展开**扩展程序**，然后展开 **AWS 工具包**子菜单。
1. 选择**开始使用**。**开始使用**选项卡将在 Visual Studio 编辑器窗口中打开。
1. 在 **Amazon Q** 部分，选择**启用**。您需填写“专业套餐”部分的信息以完成身份验证。
1. 凭证配置文件由以下信息组成：配置文件名、起始 URL、配置文件区域或 SSO 区域，这些信息由您所在公司或组织的管理员提供。有关 IAM Identity Center 凭证的信息，请参阅《IAM Identity Center 用户指南》**中的[什么是 IAM Identity Center？](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html)。
如果您已有凭证配置文件，在“专业套餐”面板的下拉菜单中选择该配置文件，然后选择**连接**。
若要创建新的凭证配置文件，请在“专业套餐”部分填写以下字段：
1. 在**配置文件名**文本框中，输入您要用于身份验证的 IAM Identity Center 的配置文件名。
1. 在**起始 URL** 文本框中，输入与您的 IAM Identity Center 凭证关联的起始 URL。
1. 从**个人资料区域（默认为 us-east-1**）下拉菜单中，选择 AWS 区域 由您正在进行身份验证的 IAM Identity Center 用户个人资料定义的。
1. **从 **SSO 区域（默认为 us-east-1）下拉菜单中，选择由您的 IA** M 身份中心证书定义的 **SSO** 区域，然后选择 **Connect** 按钮打开使用 IAM 身份中心登录对话框。 AWS **
1. 确认您要在默认 Web 浏览器中打开 AWS 授权请求门户。
1. 按照默认 Web 浏览器中的提示进行操作。身份验证过程完成时，您会收到通知，此时便可安全关闭浏览器窗口，返回到 Visual Studio。
1. 将弹出**登录 Amazon Q** 窗口。在“凭证配置文件”下拉菜单中，选择您在之前步骤中用于进行身份验证的配置文件。
1. 如果您的管理员配置了多个 Amazon Q 开发者版配置文件，系统会提示您从下拉菜单中选择一个 Q 开发者版配置文件。请选择符合当前工作需求的配置文件，或管理员指示您使用的配置文件。有关配置文件的更多信息，请参阅[什么是 Amazon Q 开发者版配置文件？](subscribe-understanding-profile.md)。
若仅存在一个可用配置文件，系统将自动选择该配置文件，您可直接开始使用 Amazon Q。
要更改您的 Amazon Q 开发者版配置文件，请从 IDE 底部选择 **Amazon Q**，然后选择**更改 Q 开发者版配置文件**。在出现的窗口中，选择要使用的配置文件。
您也可以通过选择聊天窗口右上角的溢出菜单，然后选择**更改 Q 开发者版配置文件**来更改您的配置文件。
------
有关在 Toolkit for Visual Studio 中进行身份验证的更多信息，请参阅《AWS Toolkit for Visual Studio 用户指南》**中的[开始使用](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/getting-set-up.html)。
## 在 AWS 控制台中使用 IAM 委托人
根据您的使用方式 AWS，您可能习惯于使用您的 IAM 证书登录所有 AWS 服务的控制台。但是，您不能在 IDE 中作为 IAM 主体或通过 IAM 角色使用 Amazon Q 开发者版。您必须使用 IAM Identity Center 或构建者 ID 的凭证进行身份验证。