> For the complete documentation index, see [llms.txt](https://docs.crew.you/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.crew.you/ko/service-connections/github.md).

# GitHub

GitHub 계정을 연결하면 저장소, 이슈, Pull Request를 관리하고, 코드 변경까지 대화를 통해 할 수 있어요.

> **요금제 요건:** GitHub 연동은 **Pro** 요금제에서 사용할 수 있어요.

## GitHub 연결하기

Crew는 안전하고 세밀한 권한 관리를 위해 **Crew Agent**라는 **GitHub App**을 사용해요.

1. 사이드바의 **설정**으로 이동
2. **서비스 연결** 섹션으로 스크롤
3. GitHub 옆의 **연결** 클릭
4. GitHub으로 이동해서 **Crew Agent** 앱 설치
5. 접근을 허용할 저장소를 선택 (전체 또는 특정 저장소)
6. 앱을 승인하면 Crew로 돌아와요

연결이 완료되면 설정 페이지에 GitHub 사용자 이름이 표시돼요.

### GitHub App을 쓰는 이유

Crew Agent GitHub App이 제공하는 장점:

* **세밀한 권한 관리** — 내가 선택한 저장소에만 접근 가능
* **안전한 코딩 에이전트** — 개인 접근 토큰 없이도 코딩 에이전트가 저장소를 클론하고 PR을 만들 수 있어요
* **자동 토큰 갱신** — 토큰 만료 시 재연결할 필요 없어요

### 재연결

Crew가 접근할 수 있는 저장소를 변경하고 싶으면, 설정 페이지에서 GitHub 연결을 해제했다가 다시 연결하세요. 재설치 과정에서 저장소 선택을 업데이트할 수 있어요.

## 할 수 있는 일

### 저장소 관리

> "내 GitHub 저장소 목록 보여 줘."

> "my-org/my-repo에서 열린 이슈 보여 줘."

> "frontend 저장소의 최근 Pull Request 뭐가 있어?"

### 이슈 관리

> "my-org/api-server에 '로그인 타임아웃 수정' 제목으로 버그 설명 포함한 이슈 만들어 줘."

> "전체 저장소에서 나에게 할당된 이슈 목록 보여 줘."

> "backend 저장소의 이슈 #42 닫아 줘."

### Pull Request

> "design-system 저장소의 열린 PR 보여 줘."

> "PR #15 상태 어때?"

> "PR 리뷰 코멘트 작성해 줘."

### 코딩 에이전트

**코딩 에이전트**는 실제로 저장소에 코드 변경을 할 수 있는 강력한 기능이에요:

> "my-org/frontend-app에서 로그인 페이지 CSS 정렬 이슈 수정해 줘. 제출 버튼이 가운데 정렬돼야 해."

> "my-org/api-server의 인증 모듈을 세션 쿠키 대신 JWT 토큰 방식으로 리팩토링해 줘."

코딩 에이전트 사용 시:

1. Crew가 안전한 환경에서 저장소를 클론해요
2. 요청한 변경을 자율적으로 수행해요
3. 변경 사항을 새 브랜치에 커밋해요
4. 리뷰를 위한 Pull Request를 생성해요

백그라운드에서 실행되니까 작업 중에도 계속 채팅할 수 있어요. PR이 준비되면 알림이 와요.

## 실전 활용 시나리오

### 버그 분류

> "메인 저장소의 열린 버그 이슈를 최신순으로 보여 주고, 상위 5개 요약해 줘."

### 코드 리뷰 준비

> "내가 리뷰해야 할 열린 PR 목록과 각각 무슨 변경인지 요약해 줘."

### 빠른 수정

> "my-org/docs의 README에 오타가 있어 — 'recieve'를 'receive'로 고치고 PR 만들어 줘."

## 참고 사항

* 코딩 에이전트는 브랜치와 PR을 생성하며, main에 직접 푸시하지 않아요
* 변경 사항은 항상 직접 리뷰한 후 머지하세요
* 저장소 접근은 GitHub App 설치 시 명시적으로 허용한 저장소에만 가능해요