open-code-review: OpenCodeReview – AI 기반, 라인 정확도 높은 코드 리뷰 (모든 Git 저장소에 적용)

open-code-review: OpenCodeReview – AI 기반, 라인 정확도 높은 코드 리뷰 (모든 Git 저장소에 적용)

OpenCodeReview – AI 기반 코드 리뷰 CLI

What it is – 어떤 Git 저장소에서도 LLM 기반 코드 리뷰어를 실행할 수 있는 명령줄 도구입니다. diff(또는 전체 파일)를 읽고, 관련 스니펫을 구성 가능한 대형 언어 모델로 전송하여 구조화된 라인 수준의 주석을 반환합니다. 이 프로젝트는 알리바바의 내부 코드 리뷰 어시스턴트에서 시작되었으며 현재 오픈 소스입니다.

Key capabilities

  • Diff‑aware reviewing – git diff 출력을 파싱하여 정확히 변경된 파일을 선택하고, 관련 파일을 번들링하여 모델에 전달합니다.
  • Full‑file scan (ocr scan) – Git 기록이 없을 때 전체 코드베이스를 감사할 수 있습니다.
  • Deterministic engineering layer – 하드코딩된 파일 선택, 번들링, 규칙 매칭 및 주석 위치 지정을 통해 리뷰를 안정적이고 정확하게 유지합니다.
  • Agent layer – 조정된 프롬프트와 소규모 목적별 도구 세트를 사용하여 LLM이 추가 컨텍스트(전체 파일 내용, 리포지토리 검색)를 검색하고 더 깊은 피드백을 생성할 수 있도록 합니다.
  • Multi‑model support – Anthropic, OpenAI 등 내장 제공업체가 있으며, 간단한 JSON 설정 또는 환경 변수를 통해 커스텀 엔드포인트도 추가할 수 있습니다.
  • Integration hooks – Claude Code, Codex, Cursor 및 범용 스킬/플러그인으로 제공되며, /open-code-review:review 같은 슬래시 명령을 노출합니다.

Installation

  • NPM (권장): npm install -g @alibaba-group/open-code-review → ocr 명령을 제공합니다.
  • Binary releases: 한 줄 명령어 curl …/install.sh | sh (macOS/Linux) 또는 PowerShell irm …/install.ps1 | iex (Windows). SHA‑256 검증이 내장되어 있습니다.
  • From source: git clone … && make build && sudo cp dist/opencodereview /usr/local/bin/ocr

First‑time setup

  1. ocr config provider 를 실행(대화형)하거나 ocr config set … 를 실행(CI 친화적)하여 제공자를 선택하고, API 키를 제공하며 모델을 선택합니다.
  2. ocr llm test 로 연결을 테스트합니다.
  3. Git 저장소 내에서 simplement ocr review 를 실행하여 스테이지드/언스테이지드 모든 변경 사항을 검토하거나, --from main --to feature 또는 --commit <sha> 와 같은 플래그를 사용하여 특정 범위를 지정할 수 있습니다.
  4. 전체 저장소 감사를 위해서는 ocr scan 을 사용하세요(선택적으로 --path <dir> 옵션 사용 가능).

Typical workflow

# configure once
ocr config provider            # pick Anthropic, OpenAI, etc.
ocn config model               # choose claude‑sonnet‑4‑6, gpt‑4o, …
ocn llm test                   # verify connectivity

# review a PR locally
cd my‑project
ocr review                     # diff‑mode review

# CI integration
ocr config set provider openai
ocr config set providers.openai.api_key $OPENAI_API_KEY
ocr review --from $BASE --to $HEAD --no‑interactive

Why it matters – 일반적인 에이전트(예: Claude Code)와 비교하여 OpenCodeReview는 더 높은 정확도를 달성하고 토큰 사용량을 약 1/9 수준으로 크게 줄여 CI 파이프라인에서 비용을 절감하고 소음을 줄입니다. 결정적 사전 처리는 모든 변경된 파일이 검토되고 주석이 올바른 줄 번호에 배치되도록 보장합니다.

Where to learn more – 공식 사이트 https://open-codereview.ai, 저장소 내 벤치마크 그래픽, 그리고 다국어 README(영어, 중국어, 일본어, 한국어, 러시아어).

Sources