> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/features-ko/resources-context/github-integration.md).

# GitHub 연동

이 문서에서는 **GitHub 연동** 기능을 설명합니다. GitHub 리포지토리를 연결하면 선택한 리포지토리의 코드를 자동 또는 수동으로 동기화할 수 있으며, AI가 코드 내용을 참조하면서 질문에 답변하거나 워크플로를 실행할 수 있게 됩니다.

## 사전 조건

| 작업              | 필요한 권한    |
| --------------- | --------- |
| GitHub 리포지토리 연결 | 관리자 / 소유자 |
| 리포지토리 선택·변경     | 관리자 / 소유자 |
| 동기화 대상 브랜치 변경   | 관리자 / 소유자 |
| 수동 동기화          | 관리자 / 소유자 |
| 동기화 설정 변경       | 관리자 / 소유자 |
| GitHub 연결 해제    | 관리자 / 소유자 |

## GitHub 리포지토리 연결하기

<figure><img src="/files/tpnp9MSYHmiy8As8D5zT" alt="GitHub 리포지토리 연결 화면 스크린샷"><figcaption><p>GitHub 리포지토리 연결 화면</p></figcaption></figure>

1. 워크스페이스 페이지에서 **리소스 및 컨텍스트** 탭을 선택하십시오.
2. **코드베이스**를 선택하십시오.
3. GitHub 카드의 **GitHub 연결**을 클릭하십시오.
4. GitHub의 Genesis 앱 설치 화면이 표시되면, 설치할 조직과 액세스를 허용할 리포지토리를 선택하여 설치하십시오.
5. Genesis로 돌아오면 **리포지토리 선택**을 클릭하십시오.
6. 동기화할 리포지토리를 선택하십시오.
7. **변경사항 저장**을 클릭하십시오.

## 리포지토리 선택·변경하기

GitHub 연결 후, 동기화할 리포지토리를 추가·변경할 수 있습니다. 리포지토리 선택을 해제하면 그 리포지토리에 해당하는 코드베이스는 자동으로 삭제됩니다.

<figure><img src="/files/iFmWFbTbtrseXqVfdeRC" alt="리포지토리 선택 화면 스크린샷"><figcaption><p>리포지토리 선택 화면</p></figcaption></figure>

1. 워크스페이스 페이지에서 **리소스 및 컨텍스트** 탭을 선택하십시오.
2. **코드베이스**를 선택하십시오.
3. **선택된 리포지토리** 섹션의 **편집**을 클릭하십시오.
4. 동기화할 리포지토리를 선택하거나 선택 해제하십시오.
5. **변경사항 저장**을 클릭하십시오.

## 동기화 대상 브랜치 변경하기

연결된 리포지토리별로 동기화할 브랜치를 변경할 수 있습니다. 지정하지 않은 경우 리포지토리의 기본 브랜치가 동기화됩니다.

<figure><img src="/files/Pvnfr5qHoo5aI5Lzip2s" alt="브랜치 선택기 스크린샷"><figcaption><p>브랜치 선택기</p></figcaption></figure>

1. 워크스페이스 페이지에서 **리소스 및 컨텍스트** 탭을 선택하십시오.
2. **코드베이스**를 선택하십시오.
3. **선택된 리포지토리** 섹션에서 대상 리포지토리 행에 표시된 현재 브랜치 이름 버튼을 클릭하십시오.
4. 목록에서 동기화할 브랜치를 선택하십시오. 검색 상자에 브랜치 이름을 입력하여 좁힐 수 있습니다.

## 수동으로 동기화하기

GitHub 리포지토리의 내용을 수동으로 최신 상태로 갱신합니다.

<figure><img src="/files/57Wa7f0fsQWKv1MjlNJA" alt="수동 동기화 버튼 스크린샷"><figcaption><p>수동 동기화 버튼</p></figcaption></figure>

1. 워크스페이스 페이지에서 **리소스 및 컨텍스트** 탭을 선택하십시오.
2. **코드베이스**를 선택하십시오.
3. GitHub 카드의 **동기화**를 클릭하십시오.

## 동기화 설정 변경하기

수동 동기화에 더해, 푸시/커밋 이벤트에 연동한 동기화나 스케줄에 따른 정기 동기화를 설정할 수 있습니다.

<figure><img src="/files/cFFbBOa8K5eca4RiuHWo" alt="동기화 설정 대화 상자 스크린샷"><figcaption><p>동기화 설정 대화 상자</p></figcaption></figure>

1. 워크스페이스 페이지에서 **리소스 및 컨텍스트** 탭을 선택하십시오.
2. **코드베이스**를 선택하십시오.
3. **동기화 설정** 섹션의 **설정**을 클릭하십시오.
4. 동기화 타이밍을 선택하십시오.
   * **수동 동기화**: 수동으로 트리거한 경우에만 동기화합니다.
   * **푸시/커밋 시 동기화 트리거**: 선택한 브랜치에 코드가 푸시되었을 때 자동으로 동기화합니다.
   * **자동 동기화 활성화**: 지정한 빈도·시각으로 정기적으로 동기화합니다. **빈도**(매일 / 매주 / 매월)와 **시각**을 지정하고, **매주**인 경우는 **요일**, **매월**인 경우는 **날짜**도 함께 지정합니다.
5. **저장**을 클릭하십시오.

## GitHub 연결 해제하기

<figure><img src="/files/I8RZjKi1mJi2r76zxI5w" alt="GitHub 연결 해제 메뉴 스크린샷"><figcaption><p>GitHub 연결 해제 메뉴</p></figcaption></figure>

1. 워크스페이스 페이지에서 **리소스 및 컨텍스트** 탭을 선택하십시오.
2. **코드베이스**를 선택하십시오.
3. GitHub 카드의 오른쪽 끝에 있는 **메뉴**(<img src="/files/Eif3PfKr886L3Ym6Y3j2" alt="" data-size="line">)를 클릭하십시오.
4. **연결 해제**를 클릭하십시오.

## 문제 해결

### GitHub 연동 오류

| 상황                               | 원인                             | 해결 방법                                                     |
| -------------------------------- | ------------------------------ | --------------------------------------------------------- |
| **GitHub 연결**에서의 인증에서 오류가 발생함    | GitHub 계정의 권한 부족, 또는 액세스가 거부됨  | GitHub 계정의 권한을 확인하고 다시 연결을 시도하십시오                         |
| "저장소 동기화에 실패했습니다"라고 표시됨          | 네트워크 오류 또는 GitHub API의 일시적인 장애 | **동기화**를 다시 클릭하여 수동 동기화를 시도하십시오                           |
| 동기화가 이미 진행 중이라는 메시지가 표시됨         | 다른 동기화 처리가 실행 중                | 현재 동기화가 완료될 때까지 기다린 후 다시 시도하십시오                           |
| "GitHub 연결 해제에 실패했습니다"라고 표시됨     | 네트워크 오류 또는 서버의 일시적인 장애         | 페이지를 새로 고침한 후 다시 시도하십시오                                   |
| "GitHub 설치를 불러오는 데 실패했습니다"라고 표시됨 | GitHub 연동 정보 가져오기에 실패함         | 페이지를 새로 고침하십시오. 해소되지 않는 경우 GitHub를 한 번 연결 해제한 후 다시 연결하십시오 |
| "코드 아카이브 삭제에 실패했습니다"라고 표시됨       | 삭제 처리 중에 오류가 발생함               | 페이지를 새로 고침한 후 다시 시도하십시오                                   |
| "브랜치를 불러오지 못했습니다"라고 표시됨          | 리포지토리의 브랜치 목록 가져오기에 실패함        | 페이지를 새로 고침하십시오. 해소되지 않는 경우 GitHub를 한 번 연결 해제한 후 다시 연결하십시오 |
| "브랜치 업데이트에 실패했습니다"라고 표시됨         | 네트워크 오류 또는 서버의 일시적인 장애         | 잠시 기다린 후 다시 시도하십시오                                        |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.genesis.autify.com/features-ko/resources-context/github-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.