本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 快速入门：安装、在 GitHub 中使用功能及提高使用限制
<a name="github-quickstart"></a>

**注意**  
GitHub 版 Amazon Q 开发者版目前处于预览发布阶段，功能可能会发生变更。

本教程将逐步指导您完成以下任务：

1. 从 GitHub Marketplace 安装 Amazon Q 开发者版应用程序，并授予其对您存储库的访问权限。

1. 通过为功能开发添加标签或创建新的代码审查拉取请求，开始使用 Amazon Q Developer 来处理问题。或者，你可以在问题中使用斜杠命令来启动功能开发。还能在拉取请求中使用斜杠命令启动额外的代码审查。

1. （可选）使用您的 AWS 账户注册安装的 Amazon Q Developer 应用程序，以提高使用限制。

## 步骤 1：在 GitHub 中安装 Amazon Q 开发者版并授权访问
<a name="github-quickstart-step-1"></a>

您可以GitHub免费使用 Amazon Q Developer，无需设置 AWS 账户即可开始使用。在 GitHub 中使用 Amazon Q 开发者版的第一步是从 [https://github.com/marketplace/amazon-q-developer](https://github.com/marketplace/amazon-q-developer) 安装该应用程序。在此过程中，您可以授予 Amazon Q 开发者版对 GitHub 中所有存储库或选定存储库的访问权限。

**重要**  
要安装 Amazon Q 开发者版应用程序并授权其访问 GitHub 存储库，您必须满足 GitHub 组织的相关要求。有关更多信息，请参阅《GitHub 文档》**中的[安装 GitHub 应用程序的要求](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app)和[组织中的角色](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)。

**要安装 Amazon Q 开发者版并授权访问，请执行以下步骤**

1. 导航至 [GitHub 版 Amazon Q 开发者版应用程序](https://github.com/marketplace/amazon-q-developer)页面。

1. 如有需要，可使用您的 GitHub 凭证登录 [https://github.com/](https://github.com/) 账户。

1. 查看 Amazon Q 开发者版应用程序的概述和功能，然后选择**安装**。

1. 选择以下任一方式配置对 GitHub 存储库的访问权限：

   1. 要提供对所有当前和未来存储库的访问权限，请选择**所有存储库**。

   1. 要提供对特定存储库的访问权限，请选择**仅选定存储库**，选择**选择存储库**下拉菜单，然后选择您希望允许访问的存储库。

1. 选择**安装**，完成在 GitHub 中安装 Amazon Q 开发者版并授权其访问您存储库的操作。

在 GitHub 中完成应用程序安装和授权访问后，系统会将您重定向至 GitHub 中的 Amazon Q 开发者版概览页面。您可以导航至您的 GitHub 存储库，开始使用 Amazon Q 开发者版的功能。

**注意**  
如果您的 GitHub 企业组织已启用 IP 允许列表，则必须在 GitHub 应用程序中确认允许的 IP 地址。您也可以选择将这些 IP 地址自动添加到您的允许列表中。有关更多信息，请参阅《GitHub 文档》**中的[允许 GitHub 应用程序访问](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps)和[启用允许的 IP 地址](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#enabling-allowed-ip-addresses)。  
以下是用于访问您 GitHub 资源的 IP 地址：  

```
34.228.181.128
44.219.176.187
54.226.244.221
```

## 步骤 2：在 GitHub 中使用 Amazon Q 开发者版功能
<a name="github-quickstart-step-2"></a>

在中安装 Amazon Q Developer 应用程序GitHub并授权访问您的存储库后，您可以开始使用 Amazon Q Developer 代理在整个软件开发生命周期中获得支持，从编码、测试和部署到应用程序故障排除。有关更多信息，请参阅以下任一文档：

**重要**  
Amazon Q Developer 应用程序会尝试在您授权访问的GitHub存储库中自动创建 **Amazon Q 开发代理**标签。如果标签不是自动创建的，或者是无意中删除的，则可以在中手动创建GitHub。必须将该标签命名为 **Amazon Q 开发代理**，才能将其识别为 Amazon Q 开发者标签并进行处理。有关更多信息，请参阅《GitHub 文档》**中的[创建标签](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label)。
+ [在 GitHub 中使用 Amazon Q 开发者版开发功能并迭代](github-feature-development.md)
+ [在 GitHub 中使用 Amazon Q 开发者版进行代码审查](github-code-reviews.md)

## 步骤 3：提高免费使用限额并配置详细信息
<a name="github-quickstart-step-3"></a>

您可以在 GitHub 中免费使用 Amazon Q 开发者版代理，无需先设置 AWS 账户即可开始。每月为你提供的功能开发和代码审查的调用次数有限。您可以随时通过使用您的 AWS 账户注册安装的 Amazon Q Developer 应用程序来增加免费使用量。注册后，您还可以配置相关详细信息，例如禁用代码审查、添加用于搜索和筛选的标签等。有关更多信息，请参阅 [在 Amazon Q 开发者版控制台中提高使用限额并配置的详细信息](github-register-app-install.md)。

**重要**  
要在 Amazon Q 开发者版控制台中注册应用程序安装，您必须满足 GitHub 组织的相关要求。有关更多信息，请参阅*GitHub文档*中的[GitHub应用程序安装要求](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app)[以及OAuth 应用程序和组织](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps#oauth-apps-and-organizations)。