开始在 Visual Studio Code 中使用 Amazon Q 开发者版

将 AI 编码助手 Amazon Q 集成至 VS Code 中。本指南涵盖了安装扩展的步骤，包括代码完成对话框和通过生成式 AI 提升生产力的功能。

Amazon Q 现已集成至 IDE，帮助您提高开发效率。您可以要求 Amazon Q 解释陌生代码库中的程序逻辑、快速识别并修复错误、生成功能测试。其功能包括：

• 行内代码补全：使用行内代码建议功能，帮助您提高编程效率。支持包括 Java、Python、TypeScript、Terraform、AWS CloudFormation 和 CDK 在内的超过 15 种语言。
• 聊天：生成代码、重构现有代码、解释代码，并回答有关软件开发的问题。
• 代码分析：分析并修复代码中的安全漏洞。（需添加自动扫描和项目扫描）支持包括 Java、Python、TypeScript 和 C# 在内的 10 多种语言。
• 代码参考日志：使用代码参考日志，引用与训练数据类似的 Amazon Q 代码。
• 软件开发代理*：让 Amazon Q 在您的工作区中的多个文件上计划和实施新功能。在 Amazon Q 聊天框中输入 ”/” 以打开快捷菜单并选择 /dev 动作。
• 代码转换代理*：只需几分钟而非数周，即可轻松升级您的 Java 应用程序。现已支持将 Java 8 或 11 Maven 项目升级至 Java 17。在 Amazon Q 聊天框中输入 ”/” 以打开快捷菜单并选择 /transform 动作。

* 需要 Amazon Q 开发者版 Pro 等级权限

CodeWhisperer 现已并入 Amazon Q。CodeWhisperer 提供的所有功能，包括行内代码建议、安全扫描等，现在都可以在 Amazon Q 开发者版中使用。请阅读参考文档《如何切换至 Amazon Q 开发者版》。

Visual Studio Code 是一款轻量但功能强大的源代码编辑器，可在您的台式机上运行，适用于 Windows、macOS 和 Linux。请确认您已经安装了适合您操作系统的 Visual Studio Code。您可以在官方文档中查阅安装步骤。

打开 Visual Studio Code，在左侧的活动栏上点击“扩展”。

在扩展中搜索“Amazon Q”以进行安装。如有必要，请重启或重新加载 VSCode。

如果您已经安装了 AWS Toolkit，请进行升级。若您的 Amazon Q 已经连接至 Amazon CodeWhisperer，无论许可是否到期，我们都会自动为您安装全新的 Amazon Q。

您可以选择以下两种登录方式。本篇将对两种验证方式进行说明：

1. 使用 Builder ID 的个人用户享受 Free Tier
2. 使用 AWS IAM Identity Center 的专业用户享受 Pro Tier

您可以在 IAM Identity Center 中使用员工身份来访问工作内容、使用 AWS Builder ID 来访问私人内容。这些身份彼此独立。更多详情请参考《 Amazon Q 开发者版定价》文档。

在 Visual Studio Code 左侧的活动栏打开 Amazon Q。您将看到以下界面：

通过这个选项免费使用 Amazon Q。您无需使用亚马逊云科技账户，但需要注册一个 AWS Builder ID。AWS Builder ID 将作为您的个人档案，访问特定的工具和服务。AWS Builder ID 的注册是免费的。您只需支付 Builder ID 之外的、亚马逊云科技账户中所使用的亚马逊云科技资源的费用。AWS Builder ID 和亚马逊云科技账户的根用户可以使用同一个邮箱进行注册。

• 在第一步中，选择首个选项“免费使用”并点击“继续”。
• 您将收到一个带有验证码的弹出窗口，点击“在浏览器中继续访问”。

• 您将跳转到浏览器页面。确认验证码一致后，请点击“确认并继续”。
• 页面跳转后请注册或登录 AWS Builder ID（见下图）。如果您已经登录了 AWS Builder ID，登录窗口将不会再次显示。
• 开启 IDE 扩展的亚马逊云科技服务访问权限

• 完成后切换回 IDE。现在，您已经成功使用 AWS Builder ID 登录 Amazon Q。此时，Q Chat 聊天窗口应自动打开。

在下方状态栏中点击“Amazon Q”即可看到更多选项，包括“暂停自动提示”、“打开设置”或“登出”。

您可以跳过下一步，转到第三步。

请注意！！下述步骤会产生费用。如果您只希望进行测试，请在最后移除用户以降低费用。

这种验证方法需要您拥有激活 IAM Identity Centre 的亚马逊云科技账户。Amazon Q 需要使用 IAM Identity Center。如果您的 AWS Organization 尚未激活 IAM Identity Center，账户管理员需先激活账户中的 IAM Identity Center 来设置 Amazon Q。请参考分步指引。

您的账户管理员需在 IAM Identity Center 中为您创建一个身份，并为其订阅开发者版 Pro。

账户管理员需提供以下两点关键信息，以便您可以通过 Visual Studio Code 进行登录：

• Start URL
• AWS Region

您可以在 IAM Identity Center 的 AWS Console中找到上述信息，亚马逊云科技访问网址位于“设置”的 Identity Source 选项卡上。

在 Visual Studio Code 中，请按以下步骤进行验证：

• 在 Amazon Q 的登录窗口中，选择首个选项“使用 Pro 许可”并点击“继续”。
• 您将需要输入之前提到的 Start URL 和 AWS Region。
• 您将收到一个带有验证码的弹出窗口，点击“在浏览器中继续访问”。

• 您将跳转到浏览器页面。确认验证码一致后，请点击“确认并继续”。
• 页面跳转后请登入您的 Identity Center 账户。操作完成后开启“允许访问”。

• 现在，您已经成功使用 Pro 许可完成 Amazon Q 的登录。您可以返回 Visual Studio Code IDE。

此时，Q Chat 聊天窗口应自动打开。

您可以在 Visual Studio Code 的活动栏中找到 Amazon Q。

• 打开您的源代码或 GitHub 库。
• 选择代码，右键发送至 Amazon Q 以解释代码，或打开文件并请求 Amazon Q 解释代码。

当您验证通过 Amazon Q 开发者版 Pro 许可，并已完成步骤一至三的相关操作：

— 开始使用 IDE 中的 Amazon Q 开发者版软件开发代理（原 Amazon Q 功能开发）。

— 开始使用 Amazon Q 开发者版代码转换代理（原 Amazon Q 代码转换）。