

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 快速入門：安裝、使用 GitHub 中的功能，以及提高用量限制
<a name="github-quickstart"></a>

**注意**  
Amazon Q Developer for GitHub 為預覽版本，並可能有所變更。

本教學課程提供下列任務的逐步解說：

1. 從 GitHub Marketplace 安裝 Amazon Q Developer 應用程式，並提供儲存庫的存取權。

1. 在問題中開始使用 Amazon Q Developer，方法是新增標籤進行功能開發，或建立新的提取請求進行程式碼檢閱。或者，您可以在問題中使用斜線命令來啟動功能開發。您也可以使用斜線命令在提取請求內初始化其他程式碼檢閱。

1. （選用） 向 AWS 您的帳戶註冊 Amazon Q Developer 應用程式安裝，以提高您的用量限制。

## 步驟 1：在 GitHub 中安裝 Amazon Q Developer 並授權存取
<a name="github-quickstart-step-1"></a>

您可以GitHub免費使用 Amazon Q Developer，而無需設定 AWS 帳戶即可開始使用。在 GitHub 中使用 Amazon Q Developer 的第一步，是從 [https://github.com/marketplace/amazon-q-developer](https://github.com/marketplace/amazon-q-developer) 安裝應用程式。在此過程中，您可以為 Amazon Q Developer 提供您所有 GitHub 儲存庫或所選取儲存庫的存取權。

**重要**  
若要安裝 Amazon Q Developer 應用程式並授權存取 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 Developer 並授權存取**

1. 瀏覽至 [Amazon Q Developer for GitHub 應用程式](https://github.com/marketplace/amazon-q-developer)頁面。

1. 如有需要，使用您的 GitHub 憑證登入 [https://github.com/](https://github.com/) 帳戶。

1. 檢閱 Amazon Q Developer 應用程式的概觀和功能，然後選擇**安裝**。

1. 執行下列其中一項操作來設定對 GitHub 儲存庫的存取權：

   1. 若要提供所有目前和未來儲存庫的存取權，請選擇**所有儲存庫**。

   1. 若要提供特定儲存庫的存取權，請依序選擇**僅選取的儲存庫**、**選取儲存庫**下拉式清單，然後選擇您要允許存取的儲存庫。

1. 選擇**安裝**以完成在 GitHub 中安裝 Amazon Q Developer 的程序，並授權它存取您的儲存庫。

在 GitHub 中安裝應用程式並授權存取後，系統會將您重新導向至 GitHub 中的 Amazon Q Developer 概觀頁面。您可以瀏覽至 GitHub 儲存庫以開始使用 Amazon Q Developer 功能。

**注意**  
如果您的 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)。  
下列 IP 位址可用於存取您的 GitHub 資源：  

```
34.228.181.128
44.219.176.187
54.226.244.221
```

## 步驟 2：在 GitHub 中使用 Amazon Q Developer 功能
<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 Developer 開發功能和進行迭代](github-feature-development.md)
+ [在 GitHub 中使用 Amazon Q Developer 檢閱程式碼](github-code-reviews.md)

## 步驟 3：提高免費用量限制並設定詳細資訊
<a name="github-quickstart-step-3"></a>

您可以在 GitHub 中免費使用 Amazon Q Developer 代理程式，不需設定 AWS 帳戶即可開始使用。您每月獲得有限的調用，以進行功能開發和程式碼檢閱。您可以隨時向 AWS 帳戶註冊 Amazon Q Developer 應用程式安裝，以增加您的免費用量。註冊也可讓您設定詳細資訊，例如停用程式碼檢閱，以及新增用於搜尋和篩選的標籤。如需詳細資訊，請參閱[在 Amazon Q Developer 主控台中提高用量限制和設定詳細資訊](github-register-app-install.md)。

**重要**  
若要在 Amazon Q Developer 主控台中註冊應用程式安裝，您必須符合 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)。