Open Code Review 소개
Open Code Review는 Git diff를 읽어 변경된 파일을 설정 가능한 LLM에 보내고, 도구 사용(tool-use) 능력을 갖춘 에이전트를 통해 라인 단위로 정밀한 리뷰 코멘트를 생성하는 AI 코드 리뷰 CLI 도구입니다. 에이전트는 단순히 diff만 보는 것이 아니라 파일 전체 내용을 읽고, 코드베이스를 검색하고, 함께 바뀐 다른 파일을 맥락으로 살펴본 뒤 깊이 있는 리뷰를 만들어 냅니다. 명령어는 ocr 로, 모델 엔드포인트만 설정하면 바로 사용할 수 있습니다.
이 도구는 Alibaba Group의 내부 공식 AI 코드 리뷰 어시스턴트로 출발했습니다. 저자들은 지난 2년간 수만 명의 개발자에게 서비스를 제공하며 수백만 건의 코드 결함을 찾아냈고, 대규모 환경에서 충분히 검증한 뒤 커뮤니티를 위한 오픈소스 프로젝트로 분리했다고 설명합니다. 프로젝트가 공개한 지표 그래픽에는 활성 사용자 20,000명 이상, 누적 코드 리뷰 작업 100만 건 이상, 일반적인 Agent + Skills 대비 1/5 수준의 토큰 비용, AACR-BENCH의 SEM.F1 점수 26.1%가 정리되어 있습니다.
핵심은 OpenAI와 Anthropic 호환 모델을 모두 쓸 수 있다는 점, 그리고 리뷰 과정을 자연어에만 맡기지 않고 결정론적 엔지니어링과 에이전트를 결합한 하이브리드 구조 로 만들었다는 점입니다. 이 설계는 큰 변경 묶음에서도 흔들리지 않는 안정성을 노립니다.
Open Code Review가 풀려는 문제
Claude Code와 스킬(Skills)처럼 범용 에이전트로 코드 리뷰를 해 본 사람이라면, 저자들이 지적하는 세 가지 문제를 한 번쯤 겪어 봤을 것입니다.
- 불완전한 커버리지: 변경 묶음이 커지면 에이전트가 일부 파일만 골라 리뷰하고 나머지를 빠뜨리는 경향이 있습니다.
- 위치 어긋남(position drift): 보고된 문제의 라인 번호나 파일 참조가 실제 코드 위치와 자주 어긋납니다.
- 불안정한 품질: 자연어로 구동되는 스킬은 디버깅이 어렵고, 사소한 프롬프트 변화에도 리뷰 품질이 크게 출렁입니다.
저자들은 그 근본 원인을 "순수하게 언어로만 구동되는 아키텍처는 리뷰 과정에 대한 하드 제약(hard constraints)이 없다" 는 데서 찾습니다. 즉 무엇을 반드시 리뷰해야 하는지, 결과를 어디에 붙여야 하는지를 모델의 판단에만 맡기면 통제하기 어렵다는 것입니다.
Open Code Review의 결정론적 엔진과 에이전트 하이브리드
Open Code Review의 핵심 철학은 결정론적 엔지니어링과 에이전트가 각자 잘하는 일을 맡도록 분리하는 것입니다. 틀리면 안 되는 단계는 엔지니어링 로직이 정확성을 보장하고, 동적인 판단이 필요한 부분만 에이전트가 담당합니다.
결정론적 엔지니어링이 맡는 하드 제약은 다음과 같습니다.
- 정밀한 파일 선택: 어떤 파일을 리뷰하고 어떤 파일을 걸러낼지 정확히 결정해, 중요한 변경이 누락되지 않게 합니다.
- 스마트 파일 번들링: 연관된 파일(예:
message_en.properties와message_zh.properties)을 하나의 리뷰 단위로 묶습니다. 각 묶음은 격리된 컨텍스트를 가진 서브 에이전트로 실행되어, 큰 변경 묶음에서도 안정적이고 자연스럽게 동시 리뷰를 지원합니다. - 세밀한 규칙 매칭: 파일 특성에 맞는 리뷰 규칙을 매칭해 모델의 주의를 좁게 집중시키고 정보 잡음을 원천에서 제거합니다. 템플릿 엔진 기반 규칙 매칭은 언어로만 규칙을 안내하는 방식보다 안정적이고 예측 가능합니다.
- 외부 위치·반영 모듈: 코멘트의 위치를 잡는 모듈과 코멘트 내용을 재검토하는 모듈을 독립적으로 두어, AI 피드백의 위치 정확도와 내용 정확도를 함께 끌어올립니다.
에이전트는 동적인 판단과 동적인 맥락 수집처럼 강점이 가장 잘 드러나는 곳에 집중합니다. 코드 리뷰에 맞춰 깊이 최적화한 시나리오별 프롬프트(scenario-tuned prompts)로 효과를 높이면서 토큰 사용을 줄이고, 대규모 운영 데이터의 도구 호출 추적을 분석해 코드 리뷰 전용으로 다듬은 도구셋을 사용합니다. 저자들은 호출 빈도 분포, 도구별 반복률, 새 도구가 전체 호출 사슬에 미치는 영향 등을 분석해 범용 에이전트 도구 모음보다 코드 리뷰에 더 안정적인 도구셋을 구성했다고 설명합니다.
Open Code Review 설치 및 사용
가장 간단한 방법은 npm 전역 설치입니다. 설치하면 ocr 명령을 어디서나 쓸 수 있고, GitHub Releases의 사전 빌드 바이너리나 소스 빌드로도 설치할 수 있습니다.
npm install -g @alibaba-group/open-code-review
리뷰 전에 LLM을 먼저 설정해야 합니다. 설정은 ~/.opencodereview/config.json 에 저장되며, 환경 변수가 설정 파일보다 우선합니다.
# LLM 설정 (Anthropic 예시)
ocr config set llm.url https://api.anthropic.com/v1/messages
ocr config set llm.auth_token your-api-key-here
ocr config set llm.model claude-opus-4-6
ocr config set llm.use_anthropic true
# 연결 확인
ocr llm test
설정이 끝나면 작업 디렉토리에서 바로 리뷰를 실행합니다. 워크스페이스의 모든 변경을 리뷰하거나, 두 ref를 비교하거나, 특정 커밋만 리뷰할 수 있습니다.
cd your-project
# 스테이징·언스테이징·추적되지 않은 변경 전체 리뷰
ocr review
# 두 브랜치 범위 비교
ocr review --from main --to feature-branch
# 단일 커밋 리뷰
ocr review --commit abc123
코딩 에이전트 워크플로 안에서 슬래시 커맨드로 통합할 수도 있습니다. 예를 들어 스킬로 설치하면 에이전트에게 ocr 호출 방법과 이슈 분류·수정 방식을 가르치며, Claude Code 플러그인과 Codex 플러그인 형태도 제공됩니다.
# 스킬로 설치
npx skills add alibaba/open-code-review --skill open-code-review
# Claude Code 플러그인으로 설치
/plugin marketplace add alibaba/open-code-review
/plugin install open-code-review@open-code-review
이 밖에 --format json 출력으로 GitHub Actions·GitLab CI 같은 CI/CD 파이프라인에 통합하는 예시가 examples/ 디렉토리에 정리되어 있습니다.
Open Code Review의 라이선스
Open Code Review는 Apache 2.0 라이선스로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용할 수 있습니다.
Open Code Review 공식 홈페이지
Open Code Review 프로젝트 GitHub 저장소
더 읽어보기
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다!
텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다. 
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 