개발 워크플로 비용 가이드
AI 코드 리뷰와 GitHub PR 비용 계산 방법
저장소 용량만 토큰으로 바꾸지 마세요. PR diff, 필요한 코드 컨텍스트, 리뷰 출력, 후속 라운드, 캐시와 재시도를 모델 호출별로 나눠야 실제 AI 코드 리뷰 비용에 가까워집니다.
저장소 크기보다 리뷰 범위가 먼저입니다
500MB 저장소에도 의존성, 빌드 결과, 이미지와 데이터셋이 대부분일 수 있습니다. 반대로 25MB짜리 소스 전용 저장소도 코드가 밀집된 텍스트라 토큰 수가 클 수 있습니다. 저장소 전체 용량을 글자 수처럼 환산하면 과대 또는 과소 추정하기 쉽습니다.
먼저 의존성 폴더, 컴파일 결과, minified 파일, 생성 파일, 로그, 캐시, 바이너리와 리뷰에 무관한 큰 lockfile을 제외하세요. 그다음 PR diff, 변경 파일 전체, 관련 호출부와 스키마, 테스트, 저장소 지시문, 도구 결과로 대표 입력을 구성합니다.
다섯 가지 사용량을 분리하세요
- 새 입력: PR diff, 새 댓글, 최신 테스트 출력과 이번에 검색한 파일입니다.
- 캐시 입력: 제공사의 조건을 충족해 할인되는 반복 지시문과 안정적인 저장소 컨텍스트입니다.
- 출력: 리뷰 결과, 인라인 댓글, 요약, 패치와 청구 대상 추론 토큰입니다.
- 후속 호출과 재시도: 수정 검증, 새 커밋 재검토, 실패한 도구 호출과 다시 만든 패치입니다.
- 비토큰 비용: CI 러너, 코드 검색, 샌드박스, 저장소 인덱스와 저장 비용입니다.
새 입력과 캐시 입력은 겹치면 안 됩니다. 전체 프롬프트를 일반 입력 단가로 계산한 뒤 같은 캐시 토큰을 다시 더하지 마세요. 캐시 적격 조건과 쓰기·저장 비용은 제공사마다 다르므로 실제 usage 필드를 확인해야 합니다.
코드 리뷰 비용 계산식
호출 비용 = (새 입력 토큰 × 입력 단가 + 캐시 입력 토큰 × 캐시 단가 + 청구 대상 출력 토큰 × 출력 단가) / 1,000,000
PR 리뷰 비용 = 최초 호출과 후속 호출 비용의 합 + 도구·인프라 비용
월 비용 = 월 리뷰 수 × 평균 리뷰 비용 + 별도 청구되는 공용 인프라 비용
계산 예시: 최초 리뷰와 후속 리뷰 2회
최초 리뷰에 18,000토큰 diff, 관련 소스·테스트 42,000토큰, 지시문 2,000토큰과 도구 출력 10,000토큰을 보낸다고 가정합니다. 입력은 총 72,000토큰이고 리뷰 출력은 3,000토큰입니다.
후속 호출 2회는 각각 캐시 가능한 54,000토큰을 재사용하고 새 입력 8,000토큰과 출력 1,500토큰을 사용합니다. 예시로 새 입력 100만 토큰당 $2, 캐시 입력은 $0.20, 출력은 $8을 적용합니다.
- 최초 리뷰: (72,000 × $2 + 3,000 × $8) / 1,000,000 = $0.1680
- 후속 리뷰 1회: (8,000 × $2 + 54,000 × $0.20 + 1,500 × $8) / 1,000,000 = $0.0388
- PR 1건 합계: $0.1680 + 2 × $0.0388 = $0.2456
- 월 600건: 모델 사용료 $147.36 + CI·도구·캐시 저장 비용
위 단가는 계산 구조를 보여주기 위한 예시이며 특정 모델이나 코드 리뷰 제품의 현재 견적이 아닙니다. 캐시가 적용되지 않으면 후속 호출의 입력 62,000토큰 전체를 일반 입력 단가로 다시 계산하세요.
diff만 볼지, 관련 코드까지 볼지 결정하세요
diff 전용 리뷰는 가장 저렴하지만 호출부, 권한, 스키마와 테스트에 미치는 영향을 놓칠 수 있습니다. 표적 컨텍스트 방식은 변경 파일 전체와 관련 심볼 몇 개를 추가합니다. 전체 프로젝트 컨텍스트를 사용하는 에이전트도 모든 저장소 바이트를 한 프롬프트에 넣는다는 뜻은 아닙니다. 검색, 선택, 요약과 여러 모델 호출로 구성될 수 있습니다.
작은 PR, 일반 PR, 큰 PR을 각각 표본으로 고르고 모든 호출의 새 입력, 캐시 입력, 출력, 모델, 도구 비용과 완료 상태를 기록하세요. 새 커밋 뒤 재검토와 시스템 오류 재시도도 구분해야 합니다. 평균 비용과 상위 구간 비용뿐 아니라 유효한 지적 1건당 비용, 병합 PR 1건당 비용도 함께 보면 품질을 희생한 절감을 피할 수 있습니다.
GitHub Copilot 리뷰는 API 토큰 계산과 다릅니다
직접 만든 API 리뷰 봇은 모델 제공사의 입력·캐시·출력 단가로 계산할 수 있습니다. 반면 GitHub Copilot 코드 리뷰는 현재 GitHub AI Credits를 사용하고, 비공개 저장소의 리뷰 워크플로는 GitHub Actions minutes도 소비할 수 있습니다. 구독료만 보거나 임의의 모델 토큰 단가로 환산하지 말고 조직의 Billing Usage Report, Copilot 사용량과 Actions 사용량을 함께 확인하세요.
정책과 포함량은 바뀔 수 있습니다. 배포 전에 GitHub의 Copilot 청구 문서와 코드 리뷰 Actions 과금 안내에서 현재 계정과 저장소에 적용되는 조건을 확인하세요.
필요한 컨텍스트를 유지하며 비용 줄이기
저장소 맵은 한 번 만들고 관련 디렉터리와 심볼만 검색하세요. 생성 파일과 긴 성공 로그를 프롬프트에서 제외하고, 테스트 실패는 핵심 구간만 전달하며, 안정적인 지시문은 적격할 때 재사용합니다. 파일 분류·요약에는 작은 모델을, 보안이나 여러 파일을 함께 판단하는 최종 검증에는 더 강한 모델을 배치할 수도 있습니다.
여러 단계를 거치는 리뷰 봇은 AI 에이전트 비용 가이드로 도구 호출과 부분 재시도를 계산하고, 반복되는 저장소 지시문은 프롬프트 캐싱 가이드로 캐시 적중분을 분리하세요.