Open Code Review 사용법: 알리바바 AI 코드리뷰 도구와 클로드 코드 비교
홍승협(준이아빠) / 데이터 분석, AI 실무 교육
Open Code Review는 알리바바가 사내에서 쓰다가 오픈소스로 공개한 AI 코드리뷰 명령줄 프로그램입니다. 정해진 검사 절차와 모델 판단을 나눈 구조, 클로드 코드와 비교한 벤치마크 수치, 설치와 첫 실행 명령을 정리합니다.
3줄 요약
이번 방문에서 한 편은 바로 볼 수 있습니다.
Open Code Review는 알리바바가 사내에서 쓰다가 오픈소스로 공개한 AI 코드리뷰 명령줄 프로그램입니다. ocr이라는 명령으로 실행하고, Git 변경분을 읽어 줄 단위로 지적 사항을 답니다.
AI에게 코드리뷰를 맡기는 방식은 이미 익숙합니다. 클로드 코드나 코덱스에 변경분을 보여 주고 문제를 찾아 달라고 하면 답이 나오고, 그 결과를 커밋 전에 확인하는 사람도 늘었습니다.
덜 알려진 쪽은 그 결과가 얼마나 일정한지입니다. 공항 검색대에서 모든 가방이 X선 장비를 빠짐없이 지나가는 것과 달리, 범용 에이전트에 리뷰를 맡기면 변경 파일 몇 개는 그냥 지나칠 수 있습니다. 지적한 줄 번호가 실제 위치와 어긋나는 경우도 생깁니다. 공식 문서와 공개된 벤치마크를 근거로 2026년 9월 16일 기준의 내용을 정리합니다.
알리바바 사내 도구가 공개된 배경
이 도구는 알리바바 그룹의 사내 AI 코드리뷰 도구로 2년 가까이 쓰였습니다. 공식 설명에 따르면 사내 개발자 수만 명이 사용했고 그동안 찾아낸 결함이 수백만 건입니다. 그 기록을 바탕으로 2026년 5월 저장소를 공개했습니다.
공개 이후 반응은 숫자로 확인됩니다. 2026년 9월 16일 기준 깃허브 별은 28,596개이고, npm 패키지의 최근 30일 내려받기는 329,386건입니다. 한국어 README도 함께 제공되어 원문을 영어나 중국어로 읽지 않아도 됩니다.
라이선스는 Apache-2.0이고 구현 언어는 Go입니다. 회사 저장소에 붙여 쓸 때 라이선스 조건이 걸리는 경우는 드문 편입니다.
범용 에이전트에 리뷰를 맡길 때 생기는 문제 세 가지
공식 문서는 클로드 코드에 스킬을 붙여 리뷰를 맡겼을 때 겪는 문제를 세 가지로 정리합니다.
- 변경분을 다 보지 않습니다. 변경 파일이 많아지면 일부만 골라 보고 나머지를 지나치는 일이 생깁니다.
- 위치가 어긋납니다. 지적한 줄 번호나 파일 이름이 실제 문제 위치와 맞지 않는 경우가 있습니다.
- 품질이 들쭉날쭉합니다. 자연어 지시로만 움직이면 문구를 조금 바꿔도 결과가 달라지고, 왜 그런지 따져 보기 어렵습니다.
원인으로 지목된 것은 모델 성능이 아니라 구조입니다. 리뷰 절차 전체를 말로만 시키면 무엇을 꼭 해야 하는지 고정할 수단이 없습니다.
검사 절차와 모델 판단을 나눈 구조
이 도구의 설계는 두 부분으로 나뉩니다. 검색대에서 모든 가방을 장비에 통과시키는 일은 기계가 맡고 열어 볼지 말지는 사람이 정하듯, 틀리면 안 되는 단계는 코드로 고정하고 판단이 필요한 단계만 모델에 넘깁니다.
코드로 고정한 쪽은 이렇습니다.
- 파일 선택: 어떤 파일을 봐야 하고 어떤 파일을 걸러야 하는지 프로그램이 정합니다.
- 파일 묶기: 서로 관련된 파일을 한 묶음으로 만들어 하위 에이전트에 넘깁니다. 번역 파일 두 개처럼 짝이 되는 파일이 함께 검토됩니다.
- 규칙 연결: 파일 성격에 맞는 검토 규칙만 골라 붙여 모델이 볼 내용을 줄입니다.
- 위치 보정: 지적 사항의 위치를 따로 검증해 내용 판단과 분리합니다.
모델에 맡긴 쪽은 상황에 따라 달라지는 판단과 필요한 맥락을 찾아오는 일입니다. 코드리뷰에 맞춰 다듬은 지시문과 도구 묶음을 쓰는데, 공식 문서는 실제 사용 기록에서 도구 호출 빈도와 반복률을 분석해 정리한 구성이라고 설명합니다.
클로드 코드와 비교한 벤치마크 수치
AACR-Bench는 인기 오픈소스 저장소 50개에서 실제 풀 리퀘스트 200건을 뽑아 10개 언어로 구성한 벤치마크입니다. 시니어 엔지니어 80여 명이 교차 검증한 정답 이슈 1,505건을 정답지로 삼았습니다.
같은 모델을 쓴 조합만 뽑아 비교하면 차이가 분명해집니다.
| 조합 | F1 | 정밀도 | 재현율 | 평균 시간 | 평균 토큰 |
|---|---|---|---|---|---|
| 클로드 4.6 오퍼스 + Open Code Review | 25.10% | 33.90% | 20.00% | 1분 23초 | 385K |
| 클로드 4.6 오퍼스 + 클로드 코드 | 11.57% | 7.23% | 28.90% | 13분 6초 | 5,664K |
정밀도는 지적한 항목 가운데 실제 결함의 비율이고, 재현율은 실제 결함 가운데 찾아낸 비율입니다. 표를 보면 두 조합이 잘하는 부분이 서로 다릅니다. 전용 도구 쪽은 지적의 적중률이 높고 시간과 토큰을 적게 쓰지만, 범용 에이전트 쪽은 더 많이 찾아냈습니다.
읽을 때 조심할 점이 두 가지 있습니다.
첫째, 이 수치는 도구를 만든 쪽이 측정한 값입니다. 자체 벤치마크를 공개했다는 점은 확인되지만, 제3자가 같은 조건으로 재현한 결과는 아직 공개되지 않았습니다.
둘째, 1위 조합의 F1도 25.10%입니다. 절반에 한참 못 미치는 값이라 어느 쪽을 골라도 사람 검토를 대신할 수준은 아닙니다. 먼저 훑어 주는 도구로 두고, 놓친 것이 있다는 전제로 쓰는 편이 안전하다고 생각합니다.
설치와 첫 실행 명령
준비물은 Git 2.41 이상입니다. 설치는 npm 전역 설치로 끝나고, 설치 스크립트나 깃허브 릴리스 파일을 쓰는 방법도 문서가 함께 안내합니다.
npm install -g @alibaba-group/open-code-review설치하면 ocr 명령을 쓸 수 있습니다. 리뷰를 돌리기 전에 모델을 지정합니다.
ocr config provider # 제공자를 고르거나 직접 추가
ocr config model # 고른 제공자의 모델 선택설정을 마치면 저장소에서 바로 실행합니다. 자주 쓰는 형태는 네 가지입니다.
ocr review # 스테이징, 미스테이징, 미추적 변경을 모두 검토
ocr review --from main --to feature-branch # 분기 지점 이후 변경만 검토
ocr review --commit abc123 # 커밋 하나만 검토
ocr scan --path internal/agent # 변경분이 아니라 파일 전체를 검토마지막 scan은 처음 보는 저장소를 살필 때 쓰는 명령입니다. Git 이력이 없어도 되고 디렉터리를 지정할 수 있어서, 넘겨받은 코드를 훑을 때 쓸 만합니다.
결과를 파일로 남기려면 형식과 출력 경로를 지정합니다.
ocr review --format json --output result.json위임 모드로 API 키 없이 쓰는 방법
이 도구를 쓰려면 별도 모델 요금이 든다고 생각하기 쉬운데, 위임 모드를 쓰면 그렇지 않습니다.
위임 모드는 파일 선택과 규칙 연결만 이 도구가 맡고 실제 리뷰는 원래 쓰던 코딩 에이전트가 자기 모델로 수행하는 방식입니다. 클로드 코드 구독을 이미 쓰고 있다면 API 키를 따로 넣지 않아도 됩니다.
ocr delegate preview
ocr delegate rule src/main.go src/handler.go클로드 코드와 코덱스, 커서, 오픈코드에서 쓰는 플러그인이 저장소에 함께 들어 있어서 슬래시 명령으로 부르는 것도 가능합니다. 깃허브 액션과 깃랩 CI 연동 문서도 제공됩니다.
자주 묻는 질문
Open Code Review는 클로드 코드를 대신하나요?
역할이 다릅니다. 클로드 코드는 코드를 작성하고 고치는 도구이고, 이 도구는 변경분을 검토하는 한 가지 일만 합니다. 위임 모드를 쓰면 두 도구를 함께 두는 형태가 되므로 둘 가운데 하나를 고르는 문제로 보지 않아도 됩니다.
한국어 코드 주석이나 변수명도 검토되나요?
10개 언어를 대상으로 벤치마크했다고 밝힌 것은 프로그래밍 언어를 가리킵니다. 자연어 처리는 쓰는 모델의 능력을 따라가므로, 한국어 주석이 섞인 저장소에서 어떻게 나오는지는 직접 돌려 확인하는 쪽이 확실합니다.
회사 코드를 외부로 보내는 것이 걱정되면 어떻게 하나요?
리뷰를 수행하는 주체는 설정한 모델입니다. 사내 규정상 외부 API로 코드를 보낼 수 없다면 사내에 올린 모델을 제공자로 지정하거나, 이미 승인받은 코딩 에이전트에 넘기는 위임 모드를 쓰는 선택지가 있습니다. 어느 쪽이든 실제 전송 경로를 먼저 확인하는 것이 좋습니다.
3줄 요약
- Open Code Review는 알리바바가 사내에서 2년간 쓰다가 2026년 5월 오픈소스로 공개한 AI 코드리뷰 명령줄 프로그램이고 Apache-2.0 라이선스입니다.
- 파일 선택과 규칙 적용은 코드로 고정하고 판단만 모델에 맡기는 구조여서, 자체 벤치마크에서 같은 모델을 쓴 클로드 코드보다 정밀도가 높고 토큰은 약 9분의 1만 들었습니다.
- 재현율은 범용 에이전트보다 낮게 설계되었고 1위 조합의 F1도 25.10%에 그치므로, 사람 검토를 대체하는 도구가 아니라 먼저 훑는 도구로 두는 편이 맞습니다.
Sources:
이 글이 도움이 되셨다면 공유해 주세요
메신저로 바로 보내거나 링크를 복사할 수 있습니다.
Written by
데이터로 설명하는 마케터
Open Code Review가 범용 코딩 에이전트보다 재현율을 낮게 잡은 이유는 무엇일까요?
이 글이 도움이 되었나요?
다음 단계
이어서 읽기 좋은 글
맥용 클로드 데스크톱 앱 설치와 사용법: 클로드 코드와 다른 점
클로드 데스크톱 앱은 앤트로픽이 맥과 윈도우, 리눅스용으로 내놓은 설치형 프로그램입니다. 2026년 9월 15일 기준 맥 설치 순서와 요금제별로 열리는 기능, 브라우저판이나 터미널용 클로드 코드와 달라지는 점을 공식 문서 기준으로 정리했습니다.
같이 보면 좋은 글
챗GPT 데스크톱 앱은 오픈AI가 맥과 윈도우, 리눅스에 내놓은 공식 앱입니다. 2026년 9월 15일 기준 설치 경로와 로그인 방식, 앱샷과 컴퓨터 사용처럼 데스크톱에만 있는 기능, 운영체제별로 달라지는 점을 공식 문서 기준으로 정리했습니다.
2026. 9. 15.
AI 말투 교정은 AI가 만든 초안에서 기계가 쓴 티가 나는 표현을 찾아 사람이 쓰는 말로 바꾸는 작업입니다. 번역투와 과장, AI식 지시문, 문어체 어휘의 교정 사례 36건을 정리하고 검사를 자동화하는 네 단계를 덧붙였습니다.
2026. 9. 15.
코덱스 CLI의 첫 세션은 어느 폴더에서 열지, 어디까지 허용할지, 어떤 규칙 파일을 읽게 할지, 무엇부터 맡길지를 정하는 단계입니다. 처음 치는 명령, 승인 범위를 바꾸는 방법, AGENTS.md를 두는 순서를 공식 문서로 확인해 정리했습니다.
2026. 9. 15.
클로드 코드 코덱스 연결은 두 도구가 한 저장소에서 같은 규칙 파일을 읽고 서로의 수정을 덮어쓰지 않게 맞추는 작업입니다. CLAUDE.md와 AGENTS.md를 한 벌로 묶는 방법, 어느 쪽에 어떤 일을 맡길지 정하는 기준, 작업 폴더를 나누는 순서를 공식 문서로 확인해 정리했습니다.
2026. 9. 15.ADVERTISEMENT