

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

# Amazon Q Developer for GitHub(미리 보기)
<a name="amazon-q-for-github"></a>

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

[Amazon Q Developer for GitHub 또는 GitHub Enterprise Cloud](https://github.com/marketplace/amazon-q-developer)를 사용하면 소프트웨어 개발 워크플로에 Amazon Q Developer 기능을 활용할 수 있습니다. 특수 개발 에이전트를 사용하면 새로운 아이디어를 구현하고, 품질 문제에 대한 코드를 검토하고, 단위 테스트를 통해 취약성을 해결할 수 있습니다. 에이전트가 작업을 완료하면 피드백을 제공할 수 있으며 에이전트는 이전 솔루션을 반복합니다. 자세한 내용은 [Amazon Q Developer 에이전트](#github-agents) 단원을 참조하십시오.

[https://github.com/marketplace/amazon-q-developer](https://github.com/marketplace/amazon-q-developer)를 통해 Amazon Q Developer 통합에 액세스하고 조직의 리포지토리에 대한 액세스 권한을 부여할 수 있습니다. Amazon Q Developer for GitHub를 시작하려면 [빠른 시작: 설치, GitHub의 기능 사용, 사용 한도 증가](github-quickstart.md)의 내용을 참조하세요.

**중요**  
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와 GitHub의 통합은 미국에서 데이터를 처리합니다. 자세한 내용은 [Cross-region processing in Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/cross-region-processing.html)를 참조하세요.

**참고**  
Amazon Q Developer for GitHub(미리 보기)는 현재 서비스 개선에 콘텐츠를 사용하지 않습니다. 향후 이를 활성화할 경우 적절한 공지와 이러한 사용을 옵트아웃할 수 있는 방법을 제공합니다.

**Topics**
+ [Amazon Q Developer 앱 설치 및 액세스 권한 부여](#github-concepts-set-up)
+ [Amazon Q Developer 에이전트](#github-agents)
+ [앱 설치 등록](#github-concepts-register-app-install)
+ [GitHub에서 브라우저 확장 사용](#github-concepts-extensions)
+ [GitHub 문제 및 풀 요청에서 슬래시 명령 사용](#github-slash-commands)
+ [빠른 시작: 설치, GitHub의 기능 사용, 사용 한도 증가](github-quickstart.md)
+ [GitHub에서 Amazon Q Developer로 기능 개발 및 반복](github-feature-development.md)
+ [GitHub에서 Amazon Q Developer로 코드 검토](github-code-reviews.md)
+ [Amazon Q Developer 콘솔에서 사용 한도 증가 및 세부 정보 구성](github-register-app-install.md)
+ [등록된 설치 세부 정보 구성](github-configuration.md)
+ [Amazon Q Developer for GitHub 문제 해결](github-troubleshooting.md)

## Amazon Q Developer 앱 설치 및 액세스 권한 부여
<a name="github-concepts-set-up"></a>

GitHub 조직 관리자는 시작하기 위해 AWS 계정을 설정할 필요 없이 [https://github.com/apps/amazon-q-developer](https://github.com/apps/amazon-q-developer)에서 Amazon Q Developer 앱을 무료로 설치하고 구성할 수 있습니다. 설치 프로세스 중에 GitHub 조직의 모든 또는 선택한 리포지토리에 대한 액세스를 제공하도록 선택합니다. 설치 및 권한 부여 후 GitHub의 Amazon Q Developer 기능에 대한 무료 사용에 액세스할 수 있습니다. [Amazon Q Developer 콘솔](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github)에 앱 설치를 등록하여 무료 사용을 늘릴 수 있습니다. 자세한 내용은 [빠른 시작: 설치, GitHub의 기능 사용, 사용 한도 증가](github-quickstart.md) 단원을 참조하십시오.

**중요**  
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)을 참조하세요.

**참고**  
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
```

## Amazon Q Developer 에이전트
<a name="github-agents"></a>

Amazon Q Developer 에이전트는 코딩, 테스트 및 배포부터 문제 해결에 이르기까지 소프트웨어 개발 수명 주기 전반에 걸쳐 지원을 제공합니다.
+ **Amazon Q 개발 에이전트** - 문제를 생성하고 기능 개발 레이블을 추가하면 Amazon Q Developer는 새 기능과 버그 수정을 자동으로 구현합니다. Amazon Q Developer는 변경 사항과 변경 사항 요약이 포함된 풀 요청을 생성합니다. 레이블을 적용하는 대신 문제에 대한 설명으로 `/q dev` 슬래시 명령을 사용하여 기능 개발을 시작할 수도 있습니다. 자세한 내용은 [GitHub에서 Amazon Q Developer로 기능 개발 및 반복](github-feature-development.md) 단원을 참조하십시오.
+ **Amazon Q 코드 검토 에이전트** - 새 풀 요청이 생성되거나 닫힌 풀 요청이 다시 열리면 Amazon Q Developer는 코드 검토를 자동으로 수행하고 코드 품질, 잠재적 문제 및 보안 문제에 대한 피드백을 제공합니다. 또한 Amazon Q Developer는 식별된 문제에 대한 수정 사항을 생성하며, 이를 검토하고 풀 요청에 커밋하도록 선택할 수 있습니다. 코드 검토에는 스레드 조사 결과가 포함된 코드 검토 요약이 포함됩니다. 풀 요청 설명의 `/q` 명령을 사용하여 코드 검토 결과에 대해 질문하여 Amazon Q Developer와 상호 작용할 수 있습니다.

  자동 코드 검토는 기존 풀 요청 내에서 이루어진 후속 커밋에 의해 트리거되지 않습니다. `/q review` 슬래시 명령을 사용하여 풀 요청 내에서 추가 코드 검토를 시작할 수 있습니다. 자세한 내용은 [GitHub에서 Amazon Q Developer로 코드 검토](github-code-reviews.md) 단원을 참조하십시오.

**중요**  
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)을 참조하세요.

## 앱 설치 등록
<a name="github-concepts-register-app-install"></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)을 참조하세요.

## GitHub에서 브라우저 확장 사용
<a name="github-concepts-extensions"></a>

지원되는 브라우저에서 Amazon Q Developer 확장을 사용하여 레이블 메뉴를 검색할 필요 없이 GitHub 문제에서 기능 개발을 위한 레이블을 빠르게 추가할 수 있습니다.

Amazon Q Developer 확장은 다음 브라우저에서 사용할 수 있습니다.
+ [Google Chrome](https://chromewebstore.google.com/detail/amazon-q-github-issue-hel/oefafjbablenakmhacfllkmpaeabnnfi)
+ [Mozilla Firefox](https://addons.mozilla.org/en-US/firefox/addon/amazon-q-github-issue-helper)
+ [Microsoft Edge](https://microsoftedge.microsoft.com/addons/detail/amazon-q-github-issue-helper/poghackjbfhejeppjaegbnblangjbmmc)

## GitHub 문제 및 풀 요청에서 슬래시 명령 사용
<a name="github-slash-commands"></a>

GitHub 문제 내의 설명에 슬래시 명령을 사용하거나 Amazon Q Developer를 호출하여 개발 작업을 수행하거나 지원을 제공하는 요청을 가져올 수 있습니다.
+ `/q dev` - GitHub 문제의 Amazon Q Developer를 호출하여 새로운 기능과 버그 수정을 자동으로 구현합니다. Amazon Q Developer는 변경 사항과 변경 사항 요약이 포함된 풀 요청을 생성합니다.
+ `/q review` - 풀 요청이 생성되거나 다시 열릴 때 Amazon Q Developer를 호출하여 코드 검토를 자동으로 수행합니다. 코드 검토는 코드 품질, 잠재적 문제 및 보안 문제에 대한 피드백과 스레드 조사 결과가 포함된 제안된 수정 사항 및 코드 검토 요약을 제공합니다. 풀 요청 설명에 `/q`를 사용하여 조사 결과와 상호 작용합니다. 자동 검토는 기존 풀 요청에 대한 후속 커밋에 의해 트리거되지 않습니다.
+ `/q help` - 슬래시 명령, 기능, 사용자 지정 세부 정보, *Amazon Q Developer 가이드*의 [Amazon Q Developer for GitHub(미리 보기)](#amazon-q-for-github) 설명서 링크를 포함하여 Amazon Q Developer for GitHub에 대한 정보를 제공합니다.