AI 칼럼

코딩@donghyeok99운영진

Open Code Review: 빠뜨리는 파일 없이 줄 단위로 짚는 AI 코드 리뷰

알리바바가 2년 동안 사내에서 쓰던 AI 코드 리뷰 도구를 오픈소스 CLI로 내놨어요

ocr review를 치면 바뀐 파일이 줄지어 나오고, 짝이 되는 두 파일이 한 묶음으로 묶인 뒤 diff의 한 줄에 high·bug 코멘트가 꽂혀요.
ocr review를 치면 바뀐 파일이 줄지어 나오고, 짝이 되는 두 파일이 한 묶음으로 묶인 뒤 diff의 한 줄에 high·bug 코멘트가 꽂혀요.
누가
Alibaba가 만들었어요. 사내 공식 AI 코드 리뷰 도구로 2년간 쓰던 것을 커뮤니티용 오픈소스로 내놓았어요.
언제
저장소는 2026년 5월 18일에 열렸고, 최신 릴리스는 11월 15일의 v1.13.10이에요.
어디서
Windows, macOS, Linux의 터미널에서 돌고 Claude Code, Codex, Cursor, Kimi Code, OpenCode 플러그인이 있어요.

이게 불편했어요

에이전트에게 「이 PR 리뷰해 줘」라고 하면 파일이 많을수록 몇 개만 보고 끝내는 일이 생겨요. 지적한 줄 번호가 실제 코드와 어긋나서 어디를 말하는지 다시 찾아야 할 때도 있고, 프롬프트를 조금만 바꿔도 리뷰 품질이 흔들려요.

그래서 이렇게 풀어요

Open Code Review는 틀리면 안 되는 단계를 모델에게 맡기지 않아요. 어떤 파일을 볼지, 어떤 파일을 한 묶음으로 볼지, 파일마다 어떤 규칙을 적용할지는 코드가 정하고, 모델이 낸 코멘트의 위치도 따로 확인해요. 모델은 묶음마다 분리된 맥락에서 파일을 읽고 코드베이스를 검색하며 판단하는 일만 맡아요. README는 같은 모델로 Claude Code보다 정밀도와 F1이 높고 토큰은 약 9분의 1이라고 밝혀요.

README가 정리한 핵심 기능
README가 정리한 핵심 기능
AACR-Bench에서 범용 에이전트와 비교한 표
AACR-Bench에서 범용 에이전트와 비교한 표
ocr config provider의 모델 공급자 선택 화면
ocr config provider의 모델 공급자 선택 화면

안에서는 이렇게 돌아가요

  1. 1

    나 → ocr CLI

    ocr review작업 폴더의 staged, unstaged, untracked 변경을 모두 리뷰 대상으로 잡아요.cmd/opencodereview/review_cmd.go
  2. 2

    ocr CLI → Git

    git diffGit에서 변경 내용을 읽어 파일별 diff로 나눠요.internal/diff/git.go
  3. 3

    Git → ocr CLI

    파일별 diff → selectFiles경로와 확장자, 삭제 여부, diff 크기로 리뷰할 파일을 모델 없이 정해요.internal/agent/selection.go
  4. 4

    ocr CLI → 설정한 LLM

    관련 파일 묶음마다 리뷰 요청서로 관련된 파일을 최대 10개씩 한 묶음으로 만들어 묶음마다 따로 리뷰해요.internal/agent/grouping.go
  5. 5

    설정한 LLM → ocr CLI

    코멘트 → 위치 확인, 되짚기워커 풀이 코멘트의 줄 범위를 다시 맞추고 내용을 한 번 더 검토해요.internal/reviewtask/pool.go
  6. 6

    ocr CLI → 줄 단위 리뷰 코멘트

    ocr review --format json --output result.json터미널에 보여 주거나 JSON 파일로 저장해 에이전트가 이어서 고치게 해요.cmd/opencodereview/output.go

넣으면 이렇게 나와요

ocr review --from main --to feature-branchfeature-branch가 main에서 갈라진 뒤의 변경만 리뷰해요.
ocr scan --path internal/agentdiff 없이 폴더의 파일 전체를 리뷰해요. 낯선 코드베이스를 살필 때 써요.
ocr delegate preview파일 선택과 규칙만 OCR이 하고 리뷰는 지금 쓰는 에이전트가 해요. 따로 LLM 설정이 필요 없어요.

나한테 맞을까요

이럴 때 좋아요

  • 에이전트가 쓴 큰 변경을 커밋 전에 빠짐없이 훑고 싶을 때
  • PR마다 CI에서 리뷰 코멘트를 자동으로 달고 싶을 때(GitHub Actions, GitLab CI 연동 문서가 있어요)
  • 리뷰 지적이 정확한 줄에 붙어야 에이전트에게 바로 고치게 할 수 있을 때
  • Claude Code나 Codex 구독만으로 delegate 모드 리뷰를 돌리고 싶을 때

이건 안 돼요

  • README는 재현율(Recall)이 범용 에이전트보다 낮다고 밝혀요. 잡음을 줄이려고 정밀도를 택한 설계예요.
  • 기본 모드는 OCR에 모델 공급자를 따로 설정해야 해요. Claude Code 구독 로그인을 그대로 쓰지 않아요.
  • 벤치마크 수치는 프로젝트가 직접 만든 AACR-Bench 기준이에요.

발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요

로그인하면 글을 쓰고 댓글과 좋아요로 참여할 수 있어요.로그인

신고하기

사유

커뮤니티 규칙 보기