메인 콘텐츠로 건너뛰기
Git 공급자를 한 번 연결하면 선택한 저장소의 모든 새 풀 리퀘스트가 자동으로 AI 리뷰를 받습니다. Code Review가 처음이라면 먼저 개요를 읽어보세요.

​
사전 요구 사항

  • 저장소 액세스 권한이 있는 GitHub, GitLab, Bitbucket, 또는 Azure DevOps 계정
  • 조직의 앱 설치 또는 액세스 토큰 생성 권한
  • CloudThinker 워크스페이스

​
저장소 연결

1

Code Review 열기

탐색 메뉴에서 Code Review로 이동하세요.
Code Review 온보딩
2

설정 시작

Get Started with Code Review를 클릭하여 설정 마법사를 여세요.
Code Review 설정 - 공급자 선택
3

공급자 선택

Git 공급자로 GitHub, GitLab, Bitbucket, 또는 Azure DevOps를 선택하세요.
Git 공급자 선택
4

인증

Install GitHub App을 클릭하여 GitHub App 설치를 시작하세요.GitHub가 조직을 선택하고 저장소 액세스를 허용하는 페이지로 리디렉션합니다. 승인 후 마법사가 자동으로 재개됩니다. 웹훅은 GitHub App에 의해 등록됩니다 — 수동 웹훅 설정이 필요 없습니다.
GitHub 조직에 CloudThinker를 설치하려면 Organization Owner 권한이 필요합니다. 소유자가 아니라면 소유자에게 앱 설치를 요청하세요.
5

저장소 선택

코드 리뷰에 활성화할 저장소를 선택하고 Complete를 클릭하여 설정을 완료하세요.
저장소 선택
설정 후 저장소 설정에서 자동 리뷰, 리뷰 모드, 파이프라인 모니터링, 필터를 저장소별로 조정할 수 있습니다.성공 기준: Code Review 대시보드에 저장소가 표시됩니다 — CloudThinker가 이제 풀 리퀘스트와 머지 리퀘스트를 모니터링합니다.
설정 완료

​
웹훅 설정

GitHub와 Bitbucket은 웹훅을 자동으로 등록하므로 별도 작업이 필요 없습니다. GitLab과 Azure DevOps는 수동 웹훅 설정이 필요합니다:
GitLab 계정을 연결한 후 GitLab 프로젝트 또는 그룹에서 웹훅을 설정하세요:
  1. 프로젝트/그룹 → Settings → Webhooks로 이동
  2. 설정 마법사에 표시된 웹훅 URL 붙여넣기
  3. 제공된 시크릿 토큰 입력
  4. 다음 트리거 활성화:
    • Merge request events
    • Comments
    • Pipeline events
  5. Add webhook 클릭

​
풀 리퀘스트 생성

1

저장소 열기

GitHub, GitLab, Bitbucket, 또는 Azure DevOps에서 연결된 저장소로 이동하세요.
2

풀 리퀘스트 생성

코드 변경 사항이 포함된 새 풀 리퀘스트를 생성하세요. CloudThinker가 PR을 감지하고 diff를 분석하여 요약 코멘트와 인라인 코멘트를 게시합니다 — 일반적으로 1~2분 내에, 수동 트리거 없이.
풀 리퀘스트 생성
발견 항목에는 버그 탐지(로직 오류, 널 참조, 경쟁 조건), 보안 취약점(인젝션 위험, 하드코딩된 시크릿), 코드 품질(네이밍, 복잡도, 중복), 성능(비효율적인 쿼리, N+1 패턴)이 포함됩니다.

​
발견 항목 검토

1

CloudThinker에서 상태 확인

CloudThinker 대시보드에서 모든 풀 리퀘스트의 리뷰 상태를 확인하세요.
코드 리뷰 상태
2

Git 공급자에서 발견 항목 확인

풀 리퀘스트를 열어 AI가 생성한 요약과 인라인 코드 코멘트를 확인하세요. 각 코멘트에는 심각도 수준(Critical, High, Medium, Low), 문제 설명, 수정 제안이 포함됩니다.
요약 보기
발견 항목 보기
PR에서 @cloudthinker-ai에게 답글을 달아 질문하거나, 재리뷰를 요청하거나, 리뷰를 건너뛸 수 있습니다 — mention commands 참고.

​
리뷰 모드

저장소별로 리뷰 모드를 설정하고 저장소 설정에서 언제든지 전환할 수 있습니다:
모드설명
Fast빠른 분석, 낮은 비용. 작은 PR과 빠른 피드백에 적합합니다.
Advanced보안, 성능, 정확성, 패턴에 대한 전문 에이전트 분할 심층 분석. 중요한 저장소에 최적입니다.

​
파이프라인 모니터링

CloudThinker는 CI/CD 파이프라인 실패를 모니터링합니다. 파이프라인이 실패하면 CloudThinker가:
  1. 실패한 파이프라인 실행을 감지합니다
  2. 실패한 작업 로그를 가져와 분석합니다
  3. 발견 항목과 수정 제안을 PR에 직접 게시합니다
파이프라인 모니터링은 워크스페이스별로 켜고 끌 수 있으며 기본적으로 활성화되어 있습니다. Azure DevOps의 경우 CloudThinker는 풀 리퀘스트 이벤트(git.pullrequest.created, git.pullrequest.updated)와 함께 build.complete 이벤트를 모니터링합니다.

​
필터 설정

저장소별 필터를 사용하여 CloudThinker가 리뷰하는 PR과 MR을 제어하세요:
  • 레이블 필터: 특정 레이블이 있는 PR 포함 또는 제외
  • 작성자 필터: 특정 작성자 포함 또는 제외(봇 작성자 제외에 유용)
  • 브랜치 필터: 특정 패턴과 일치하는 브랜치 포함 또는 제외(대상 브랜치, 즉 병합되는 브랜치 기준으로 필터링)
제외 필터가 먼저 확인됩니다. 포함 필터는 모두 통과해야 합니다. 제외 필터와 일치하는 PR은 FILTERED로 표시되고 완전히 건너뜁니다.

​
증분 리뷰

열린 PR에 새 커밋을 푸시하면 CloudThinker가 증분 리뷰를 수행합니다 — 전체 PR이 아닌 새로운 변경 사항만 분석합니다. 이를 통해 리뷰가 빠르게 유지되고 실제로 변경된 내용에 집중할 수 있습니다.

​
다음 단계

Mention commands

PR 코멘트에서 리뷰 봇과 상호작용 — 재리뷰, 질문, 또는 리뷰 건너뛰기

리더보드

팀 리뷰 활동과 코드 품질 개선을 시간별로 추적하세요

Convention rules

저장소에 이미 있는 파일로 팀의 코딩 컨벤션을 리뷰에 가르치세요

알림

코드 리뷰 발견 항목을 전달할 위치를 설정하세요