OpenCodeReview는 Alibaba Group 내부에서 2년간 수만 명의 개발자에게 제공돼 수백만 건의 코드 결함을 찾은 AI 코드 리뷰 CLI를 오픈소스로 전환한 프로젝트임

• Git diff와 변경 파일을 configurable LLM에 전달하며, 에이전트가 전체 파일·저장소·다른 변경 파일을 탐색해
  라인 단위 리뷰 의견을 생성함
• 50개 오픈소스 저장소의 실제 PR 200개와 10개 언어를 대상으로 80명 이상의 시니어 엔지니어가 검증한 결과, Claude Code보다
  Precision과 F1이 높고 토큰은 약 1/9만 사용했지만 Recall은 낮았음
• 파일 선택·관련 파일 묶음·규칙 매칭·의견 위치 보정은
  결정론적 로직으로 통제하고, 동적 판단과 문맥 검색은 코드 리뷰 전용 프롬프트와 도구를 갖춘 에이전트가 담당함
  ocr review

는 작업 공간·브랜치 범위·커밋을 검토하고 ocr scan

은 전체 파일을 감사하며, Delegation Mode에서는 별도 LLM 설정 없이 Claude Code·Codex·Cursor 같은 코딩 에이전트가 리뷰를 수행할 수 있음

OpenCodeReview의 역할

• OpenCodeReview는 Git 변경 사항을 읽어 configurable LLM으로 검토하는
  AI 코드 리뷰 CLI임

• Alibaba Group의 공식 내부 AI 코드 리뷰 도우미로 시작해 지난 2년간 수만 명의 개발자에게 제공됨

• 대규모 환경에서 수백만 건의 코드 결함을 식별한 뒤 오픈소스 프로젝트로 전환됨

• 모델 엔드포인트를 설정하면 사용할 수 있음

• 에이전트는 도구를 사용해 전체 파일을 읽고, 저장소를 검색하며, 다른 변경 파일에서 문맥을 가져와
  라인 단위 의견을 생성함
  ocr scan

은 의미 있는 diff가 없는 디렉터리나 익숙하지 않은 코드베이스를 감사할 수 있도록 파일 전체를 검토함

벤치마크와 정밀도 우선 전략

• 실제 환경 기반 벤치마크는
  50개 인기 오픈소스 저장소, 실제 Pull Request 200개, 프로그래밍 언어 10개로 구성됨

• 80명 이상의 시니어 엔지니어가 교차 검증함

• 정답 데이터에는 주석 처리된 이슈 1,505개가 포함됨

• 같은 기반 모델을 사용한 범용 에이전트 Claude Code와 비교해
  Precision과 F1이 더 높고, 토큰은 약 1/9만 소비하며 리뷰도 더 빠르게 완료함

• Recall은 범용 에이전트보다 낮으며, 이는 노이즈를 줄이고
  정밀도를 높이기 위한 의도적 절충임

• 평가 항목은 다음과 같음
  F1

: 정밀도와 재현율의 조화 평균으로 전체 리뷰 품질을 나타냄
Precision

: 보고된 이슈 중 실제 결함의 비율로, 높을수록 확인할 오탐이 적음
Recall

: 실제 결함 중 발견한 비율로, 높을수록 리뷰를 빠져나가는 결함이 적음
Avg Time

: 리뷰당 실제 경과 시간으로 CI 파이프라인 지연에 영향을 줌
Avg Token

: 리뷰당 총 토큰 사용량으로 API 비용에 직접 영향을 줌

범용 에이전트의 코드 리뷰 문제

• 대규모 변경에서는 일부 파일만 선택적으로 검토해 중요한 변경을 놓치는
  불완전한 커버리지가 발생할 수 있음
• 보고한 문제의 줄 번호나 파일 참조가 실제 위치에서 벗어나는
  위치 드리프트가 생길 수 있음
• 자연어로 구동되는 Skills는 디버깅하기 어렵고, 작은 프롬프트 변화에도 리뷰 품질이 크게 흔들릴 수 있음
• 순수 언어 중심 아키텍처에는 리뷰 절차를 강제하는
  하드 제약이 부족함

결정론적 엔지니어링과 에이전트의 결합

• OpenCodeReview는 실패해서는 안 되는 절차를 결정론적 엔지니어링으로 통제하고, 동적 판단과 문맥 검색을 에이전트에 맡김
  정확한 파일 선택 로직이 검토 대상과 제외 대상을 결정해 중요한 변경 누락을 방지함
• 관련 파일을 하나의 리뷰 단위로 묶는
  스마트 파일 번들링을 적용함
  message_en.properties

와 message_zh.properties

같은 관련 파일을 함께 처리함

• 각 번들은 격리된 문맥을 가진 하위 에이전트에서 실행됨

• 분할 정복 방식으로 큰 변경에서도 안정성을 유지하고 병렬 리뷰를 지원함

• 템플릿 엔진 기반의 세밀한 규칙 매칭이 파일 특성에 맞는 리뷰 규칙만 적용해 모델이 불필요한 정보에 주의를 빼앗기지 않도록 함

• 독립적인
  의견 위치 지정과 반영 모듈이 AI 피드백의 위치 및 내용 정확도를 개선함

• 에이전트에는 코드 리뷰에 맞게 최적화한 프롬프트를 사용해 효과를 높이면서 토큰 소비를 줄임

• 전용 도구 모음은 대규모 프로덕션의 도구 호출 추적을 분석해 설계됨

• 호출 빈도 분포와 도구별 반복 호출률을 분석함

• 새 도구가 전체 호출 체인에 미치는 영향을 반영함

• 범용 에이전트 도구보다 코드 리뷰에서 안정적이고 예측 가능한 동작을 목표로 함

설치와 리뷰 실행

Git 2.41 이상이 필요하며, diff 생성·코드 검색·저장소 작업에 Git을 사용함

• npm으로 전역 설치하면
  ocr

명령을 사용할 수 있음

npm install -g @alibaba-group/open-code-review

• Delegation Mode를 사용하지 않는다면 리뷰 전에 LLM 공급자와 모델을 구성해야 함

ocr config provider
ocr config model

• 대화형 UI가 공급자 선택, API 키 입력, 모델 설정을 안내하고 연결 상태를 자동으로 테스트함
  ocr review

는 여러 범위의 변경을 검토함

ocr review
ocr review --from main --to feature-branch
ocr review --commit abc123

• 중단된 브랜치 범위 또는 커밋 리뷰는 세션 ID로 재개할 수 있음

ocr session list
ocr review --from main --to feature-branch --resume <session-id>

ocr scan

은 Git 이력이 없어도 저장소 전체, 디렉터리 또는 특정 파일을 검토함

ocr scan
ocr scan --path internal/agent

Delegation Mode에서는 OCR이 파일 선택과 규칙 해석을 담당하고, 사용 중인 AI 코딩 에이전트가 자체 LLM으로 리뷰함

ocr delegate preview
ocr delegate rule src/main.go src/handler.go

통합과 확장

• 공식 문서는 설치, CLI, 리뷰 규칙, 구성, 문제 해결 방법을 제공함
• MCP Server를 통해 리뷰 에이전트에 외부 도구를 추가할 수 있음
• Claude Code, Codex, Cursor, OpenCode 및 Skill 호환 에이전트와 통합할 수 있음
• 리뷰 실행 방식은 두 가지임
• CI/CD 통합은 GitHub Actions, GitLab CI, GitFlic CI, Gerrit을 지원함
• Session Viewer는 브라우저에서 리뷰 세션을 탐색하고 재생함
• OpenTelemetry 연동으로 리뷰 과정을 관측할 수 있음
• 라이선스는
  Apache-2.0임