계정 내에서 GitHub를 활성화하는 방법에 대한 자세한 정보는 커넥터를 사용하여 Claude의 기능 확장하기를 참조하세요.
GitHub 저장소를 Claude에 직접 연결하여 소프트웨어 개발 작업에 대한 포괄적인 컨텍스트를 제공하세요. 목록에서 저장소를 선택하여 쉽게 추가할 수 있으며, Claude가 코드베이스를 더 잘 이해하고 지원하도록 도와줍니다.
GitHub 저장소를 추가하는 방법
참고: 현재 GitHub로 인증되지 않은 경우, 이 통합을 사용하기 전에 GitHub로 리디렉션되어 인증해야 합니다.
채팅
채팅 인터페이스의 왼쪽 아래 모서리에 있는 "+" 버튼을 클릭하세요.
드롭다운에서 "GitHub에서 추가"를 선택하세요.
파일 브라우저를 사용하여 특정 파일 및 폴더를 선택하세요.
메시지를 보내면 Claude가 콘텐츠에 액세스하고 처리하여 응답에 반영합니다.
프로젝트
프로젝트 지식 섹션의 오른쪽 위 모서리에 있는 "+" 버튼을 클릭하세요.
드롭다운에서 "GitHub"를 선택하세요.
액세스 가능한 저장소를 검색하거나 저장소 URL을 붙여넣으세요.
파일 브라우저를 사용하여 특정 파일 및 폴더를 선택하세요.
선택한 콘텐츠가 프로젝트 지식에 추가되어 Claude가 액세스하고 처리할 수 있습니다.
"동기화" 아이콘을 사용하여 코드베이스의 최신 버전으로 작업하고 있는지 확인할 수 있습니다.
"파일 구성" 아이콘을 사용하여 Claude가 분석하는 파일 및 폴더를 수정할 수 있습니다.
비공개 저장소에 연결하기
유효한 URL을 입력한 후 Claude가 저장소에 액세스할 수 없으면 Claude를 비공개 저장소에 연결하려고 시도하고 있을 가능성이 높습니다: GitHub 앱 링크를 따라가서 GitHub 관리자인 경우 저장소에 대한 액세스 권한을 부여하거나 GitHub 조직의 관리자에게 요청을 보낼 수 있습니다.
가능하면 직접 액세스 권한을 부여하세요: Claude가 모든 저장소 또는 특정 저장소에만 액세스하도록 선택할 수 있습니다.
필요한 권한이 없으면 액세스 권한을 요청하세요: GitHub 조직의 관리자가 요청에 대한 이메일 알림을 받게 됩니다. 요청이 승인되면 Claude에서 저장소를 동기화하고 액세스할 수 있습니다.
모범 사례
작게 시작하기: 코드베이스의 작은 부분을 선택하여 분석하는 것부터 시작하세요. 이렇게 하면 Claude가 코드를 어떻게 해석하고 논의하는지 익숙해질 수 있습니다.
반복 및 개선: Claude의 초기 응답이 질문을 완전히 해결하지 못하면 후속 질문을 하거나 설명을 요청하는 것을 주저하지 마세요.
인간 전문 지식과 결합: Claude의 통찰력을 팀과의 추가 조사 및 논의의 출발점으로 사용하세요. Claude의 작업을 검토하세요.
신중한 파일 선택: "파일 구성"을 사용할 때 선택 사항을 전략적으로 고려하세요. 현재 작업 또는 프로젝트의 중심이 되는 핵심 파일 및 디렉토리를 포함하되, 토큰 제한 내에서 유지하고 초점을 유지하기 위해 불필요한 파일 선택을 피하세요.
정기적인 업데이트: Claude가 코드베이스의 최신 버전으로 작업하고 있는지 확인하기 위해 프로젝트의 GitHub 동기화를 주기적으로 새로 고쳐야 합니다. 특히 새로운 분석을 시작하기 전이나 저장소에 중요한 변경 사항이 있을 때 그렇습니다.
문제 해결
연결 후 조직의 저장소가 나타나지 않음
GitHub 연결이 연결됨으로 표시되지만 특정 조직의 비공개 저장소가 나타나지 않으면 해당 조직에서 SSO(Single Sign-On)가 필요할 수 있습니다. SSO가 필요한 경우 각 사용자는 해당 조직에 대해 Claude 앱을 별도로 승인해야 합니다. 그렇게 할 때까지 GitHub는 연결이 정상적으로 작동하더라도 해당 조직의 비공개 저장소를 보기에서 필터링합니다.
Claude가 이 상태를 감지하면 저장소 선택기에 SSO를 승인하라는 배너가 표시됩니다. Claude 앱을 조직에 대해 승인하려면:
github.com/settings/applications로 이동하여 Claude 항목을 엽니다.
조직 액세스에서 관련 GitHub 조직 옆의 "승인"을 클릭하세요.
버튼이 "승인" 대신 "요청"으로 표시되면 앱을 직접 승인할 권한이 없습니다. GitHub 조직 관리자가 조직의 OAuth 애플리케이션 정책 설정에서 요청을 승인해야 합니다.
중요: Claude 설정에서 GitHub를 연결 해제했다가 다시 연결해도 이 문제가 해결되지 않습니다. 새로운 연결은 SSO가 필요한 조직을 자동으로 승인하지 않으므로 위의 승인 단계를 완료해야 합니다.
조직에서 EMU(Enterprise Managed Users)가 있는 GitHub Enterprise Cloud를 사용하는 경우 Claude 앱도 엔터프라이즈 수준에서 승인되어야 합니다. Claude Code에 대한 코드 검토 설정에서 자세히 알아보세요.
자주 묻는 질문
GitHub에서 어떤 정보를 검색합니까?
특정 분기의 저장소에 있는 파일(이름 및 내용)만 동기화됩니다. 커밋 기록, PR 또는 기타 메타데이터는 검색하지 않습니다.
저장소를 프로젝트에 추가한 후 업데이트되면 어떻게 됩니까?
"지금 동기화"를 클릭하여 저장소에서 최신 변경 사항을 가져올 수 있습니다. 이렇게 하면 이전에 선택한 모든 파일 및 폴더가 업데이트됩니다.
단일 프로젝트 또는 채팅에 여러 저장소를 추가할 수 있습니까?
예, 여러 저장소를 추가하여 개발 작업에 대한 포괄적인 컨텍스트를 Claude에 제공할 수 있습니다. 저장소는 Claude의 컨텍스트 윈도우 내에 맞아야 합니다.
저장소에 대한 액세스 권한을 잃으면 어떻게 됩니까?
저장소에 대한 액세스 권한을 잃으면 이전에 추가된 프로젝트에서 해당 내용을 볼 수 없습니다. 저장소 미리보기가 제거되지만 대화 기록은 유지됩니다.
커넥터 디렉토리에서 사용 가능한 모든 커넥터를 찾아보세요.