

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 빠른 시작: 설치, GitHub의 기능 사용, 사용 한도 증가
<a name="github-quickstart"></a>

**참고**  
Amazon Q Developer for GitHub는 평가판 릴리스 중이며 변경될 수 있습니다.

이 자습서에서는 다음 작업에 대한 연습을 제공합니다.

1. GitHub Marketplace에서 Amazon Q Developer 앱을 설치하고 리포지토리에 대한 액세스를 제공합니다.

1. 기능 개발을 위한 레이블을 추가하거나 코드 검토를 위한 새 풀 요청을 생성하여 문제에서 Amazon Q Developer를 시작합니다. 또는 문제에서 슬래시 명령을 사용하여 기능 개발을 시작할 수 있습니다. 슬래시 명령을 사용하여 풀 요청 내에서 추가 코드 검토를 시작할 수도 있습니다.

1. (선택 사항) Amazon Q Developer 앱 설치를 AWS 계정에 등록하여 사용 한도를 늘립니다.

## 1단계: GitHub에 Amazon Q Developer 설치 및 액세스 권한 부여
<a name="github-quickstart-step-1"></a>

시작하려면 AWS 계정을 설정하지 않고도 Amazon Q Developer를 GitHub 무료로 사용할 수 있습니다. 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 Developer 레이블로 인식하고 처리하려면 레이블의 이름을 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>

시작하려면 AWS 계정을 설정할 필요 없이 GitHub에서 Amazon Q Developer 에이전트를 무료로 사용할 수 있습니다. 기능 개발 및 코드 검토를 위해 매월 제한된 호출이 제공됩니다. 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)을 참조하세요.