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


