Alibaba의 Open Code Review: 설치와 첫 번째 코드 검토

Ailoot 문서: API, 키 및 통합.

Open Code Review의 기능#

이 프로젝트는 Alibaba의 공식 저장소에 Apache-2.0 라이선스로 공개되어 있습니다. 개발자들은 README에서 프로그램 방식의 파일 선택 및 규칙과 코드를 분석하는 에이전트를 결합한다고 설명합니다. 의미 있는 diff, 즉 Git 변경 사항 모음이 없을 때 파일 전체를 검토하는 ocr scan 명령도 있습니다.

첫 번째 검토를 실행하고 자신의 코드에 대한 댓글을 직접 평가해 보세요. 여기서는 프로젝트의 토큰 절감량을 측정하지 않았습니다. 에이전트의 결과를 별도로 확인하는 것이 유용한 이유는 ‘완료’라는 잘못된 주장에 관한 글에서 설명합니다.

저장소 준비 및 OCR 설치#

이 설치 방법에는 Git 2.41 이상과 npm이 필요합니다. 비밀 정보가 없는 테스트 저장소로 시작하세요. 에이전트는 파일 전체를 읽고 코드베이스를 검색할 수 있으며, 작업 디렉터리 모드에서는 추적되지 않는 파일도 포함됩니다. 새 파일을 포함해 저장소 전체를 확인하세요. 선택한 모델로 전송할 수 없는 키나 데이터가 저장소에 없어야 합니다.

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

설치 후에는 ocr 명령을 사용할 수 있습니다. 비슷한 이름의 아무 패키지가 아니라 공식 README를 기준으로 설치 옵션과 패키지를 확인하세요.

모델 구성 및 코드 검토 실행#

터미널에서 다음 명령을 실행합니다.

ocr config provider
ocr config model

대화형 인터페이스에서 공급자를 선택하고 API 키를 입력한 뒤 모델을 구성하면 연결을 확인합니다. 키는 지정된 인터페이스에 입력하세요. 프로젝트 파일이나 커밋 메시지에 넣지 마세요. 검토를 실행하기 전에 선택한 공급자의 요금 부과 방식을 확인하세요. OCR의 라이선스가 무료라고 해서 모델 호출까지 무료인 것은 아닙니다.

프로젝트 디렉터리로 이동해 검토를 실행합니다. your-project를 프로젝트 경로로 바꾸세요.

cd your-project
ocr review

이 모드에서 ocr review는 스테이지된 변경 사항, 스테이지되지 않은 변경 사항, 새로 추가된 미추적 파일을 확인합니다. 댓글을 JSON으로 저장하려면 다음 명령을 사용할 수 있습니다.

ocr review --format json --output result.json

보고서를 커밋에 자동으로 추가하지 마세요. 먼저 민감한 코드나 데이터가 포함되어 있는지 확인하세요. 변경 사항과 관계없이 디렉터리의 파일 전체를 검토하는 별도 명령도 있습니다.

ocr scan --path internal/agent

internal/agent는 README에 나온 예시입니다. 프로젝트에 실제로 있는 경로로 바꾸세요. 전체를 스캔하기 전에 작은 디렉터리부터 시작해 댓글의 유용성과 실제 비용을 평가하세요.

검토가 유용한지 판단하는 방법#

댓글마다 해당 줄을 찾아 문제가 재현되는지 확인하세요. 테스트로 수정 사항을 확인하고, 오탐은 따로 기록하세요. 댓글이 없더라도 기능 테스트와 접근 제어 검사를 생략할 수는 없습니다.

개발자들은 README의 비교에서 OCR이 범용 에이전트보다 더 적은 비율의 문제를 감지한다고 언급합니다. 이는 연구 조건에서 개발자들이 제시한 주장이지, 사용자의 프로젝트 품질을 측정한 결과가 아닙니다. 여기서는 OCR의 정확도를 독립적으로 측정하지 않았습니다.

위임 모드의 차이#

일반 모드에서는 OCR에 구성된 모델을 사용합니다. 위임 모드에서는 OCR이 파일을 선택하고 규칙을 정하며, AI 에이전트가 자체 모델을 사용해 코드를 검토합니다. 이 모드에서는 별도의 모델 구성이나 OCR용 API 키가 필요하지 않습니다.

README에 나온 준비 명령은 다음과 같습니다.

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

경로를 자신의 경로로 바꾸세요. 명령 실행 후 연결된 에이전트에 분석을 맡기세요. 파일을 준비하는 것만으로는 아직 코드 검토가 아닙니다. 해당 에이전트의 요금 및 한도는 그대로 적용되므로, “별도 키가 필요하지 않다”는 말이 “무료 검토”를 뜻하지는 않습니다.

저장소에는 Claude Code, Codex 및 다른 에이전트와의 통합이 설명되어 있습니다. Codex를 사용한다면 먼저 Codex 스킬 작동 방식을 알아보세요. 다른 지원 도구를 사용한다면 Kimi Code 소개를 참고하세요. 일반 보고서를 이해한 다음에 통합을 연결하고, 보고서를 읽는 일을 대신하도록 두지 마세요.

실행 결과가 나오지 않는 경우#

필요한 Git 버전이 설치되어 있는지, 올바른 프로젝트 디렉터리에 있는지, 모델 연결이 작동하는지 확인하세요. 검토할 변경 사항이 없다면 빈 결과를 코드베이스 전체에 대한 검토라고 부르지 마세요. 파일 전체를 보려면 scan을 사용합니다. 익숙하지 않은 보고서 하나만으로 커밋을 자동 차단하도록 설정하지 마세요.

명령은 고정된 저장소 리비전의 공식 README와 대조해 확인했습니다. 사용자의 프로젝트에서 유료 실행은 하지 않았습니다. 첫 시도가 성공했다고 볼 기준은 명확한 댓글을 받고, 근거를 들어 각 댓글을 확인하거나 반박할 수 있는 것입니다.

Ailoot을 통해 AI 모델에 접근해야 한다면 Ailoot을 살펴보세요.