핵심 요약
- OCR은 코드 심사 전용 CLI이며 챗봇이 아니다. Git diff를 읽고 → 도구 호출로 맥락을 검색 → 행 단위 리뷰 의견을 출력한다. 동일 모델에서 Claude Code 범용 심사보다 Token은 약 1/9, Precision/F1은 더 높다(Recall은 다소 낮아 노이즈를 줄이는 설계).
- 12개 이상 내장 Provider:
anthropic(Claude),openai(GPT), 통의dashscope, DeepSeek, Kimi, 지谱z-ai등. 프로토콜은 Anthropic Messages와 OpenAI Chat Completions 두 가지뿐. - Gemini는 내장 표에 없지만 Google OpenAI 호환 API로 커스텀 Provider에 등록 가능. Vertex AI 기업 게이트웨이도 동일.
- 두 가지 실행 레인: ① OCR 자체 LLM(
ocr review); ② Delegation Mode(ocr delegate)——OCR은 파일 선별과 규칙만, 심사는 Claude Code / Cursor 등 Agent가 자체 모델로 수행. - 모델 성능이 갈림길이 아니라 심사 파이프라인(결정론적 엔지니어링 + Agent)과 과금 레인(OCR API vs 구독 Delegation)이 갈림길이다.
결론 먼저: Open Code Review는 Claude·GPT 기본 지원, Gemini는 커스텀 경로
심사 품질 상한은 모델이 정하지만 신호 대 잡음비와 비용은 OCR의 결정론적 파이프라인이 정한다——같은 Claude Opus라도 OCR은 Claude Code에서
/code-review를 맨 실행하는 것보다 Token을 아끼고 오탐이 적다.
2026년 8월 기준 alibaba/open-code-review 공식 설정 문서에 13개 내장 Provider가 나열된다. 본문 주제와 직결되는 세 경로:
- Claude(권장 기본) —
ocr config set provider anthropic, 프로토콜은 네이티브anthropic. 모델 예:claude-opus-4-6,claude-sonnet-4-6.ANTHROPIC_API_KEY또는 Claude Code의ANTHROPIC_*환경 변수를 자동 읽음. - GPT —
provider openai,https://api.openai.com/v1경유. ChatGPT Team / API 한도를 이미 쓰는 팀, 또는gpt-5.x/o-series추론 모델을 쓰려는 시나리오. - Gemini — 내장 preset 없음.
custom_providers로 Google OpenAI 호환 엔드포인트(https://generativelanguage.googleapis.com/v1beta/openai/) 지정, 모델에gemini-2.5-pro등 설정. 기업은 Vertex 게이트웨이 URL 가능.
이미 Open Code Review Claude 생태계(Claude Code 플러그인 설치)라면 Delegation Mode도 선택: OCR은 외부 API에 닿지 않고 심사 로직을 Claude Code 세션 내 모델에 위임——구독 한도와 OCR 심사가 같은 청구 라인. 「OCR 자체 API Key」와는 완전히 다른 비용 구조다.
1. 왜 「Claude Code로 잠깐 심사」로는 부족하고 Open Code Review가 필요한가
Claude Code에는 /code-review Skill이 있어 동작한다. 그러나 알리바바가 사내 2년 대규모 검증 끝에 OCR을 단독 OSS화한 배경에는 다음 세 가지 통증이 있다.
- 커버리지 부족 — 큰 diff에서 범용 Agent는 「중요 파일만 본다」 경향이 있어 병렬 변경 파일을 놓친다. OCR은 결정론적 파일 선택 + 지능형 bundling(예:
message_en.properties와message_zh.properties를 한 묶음)으로 전체 커버를 보장. - 행 번호 드리프트 — 범용 Agent 코멘트 행 번호가 diff와 어긋나기 쉽다. OCR에는 독립 위치 특정·반성 모듈이 행 수준 앵커를 보정.
- 품질 변동 + Token 낭비 — 순수 자연어 Skill은 디버깅이 어렵다. OCR 공식 벤치마크(50 OSS 저장소, 200 실 PR, 10개 언어)에서 동일 모델로 F1 / Precision이 Claude Code 범용 심사를 크게 상회, Token은 약 1/9, 소요 시간도 짧다. Recall이 다소 낮은 것은 의도적으로 보고를 줄여 오탐 triage 비용을 낮추는 설계.
다시 말해 Open Code Review Claude는 「Claude를 한 겹 더 씌우는 것」이 아니라 Claude를 심사에 최적화된 파이프라인에 올리는 것이다. 모델을 GPT나 Gemini로 바꿔도 파이프라인은 동일——이것이 멀티 모델 지원의 본질이다.
2. Open Code Review란? 모델 연결은 몇 종류인가
2.1 제품 포지셔닝
OCR은 npm install -g @alibaba-group/open-code-review로 설치하는 글로벌 CLI(명령 ocr). 전형적 흐름:
ocr config provider # 대화형 Provider + 모델 + 연결 테스트
ocr review # 워크스페이스 staged/unstaged 변경 심사
ocr review --from main --to feature/x # 브랜치 비교
ocr scan --path internal/agent # 전체 파일 스캔(diff 없어도 됨)Agent 도구에는 file_read, code_search, file_read_diff, code_comment 등——patch 표면만이 아니라 파일 간 참조 가능.
2.2 세 가지 모델 연결 방식
| 연결 유형 | 진입점 | 전형 모델 | 설정 비용 | 적합 대상 |
|---|---|---|---|---|
| 내장 Provider | ocr config provider |
Claude, GPT, DeepSeek, 통의… | 낮음(API Key만) | 대부분 팀의 기본 경로 |
| 커스텀 Provider | custom_providers.* |
Gemini, 자체 vLLM, 기업 게이트웨이 | 중간(URL + protocol) | 기존 모델 게이트웨이 / 컴플라이언스 내망 |
| Delegation Mode | ocr delegate |
Claude Code / Cursor 현재 모델 | OCR Key 제로 | 구독 보유·API 청구 억제 |
2.3 내장 Provider 전체 목록(2026-08)
아래는 Base URL이 프리셋됨. API Key(또는 해당 환경 변수)만 있으면 됨:
| 이름 | 프로토콜 | 대표 모델 / 용도 | 환경 변수 |
|---|---|---|---|
anthropic | anthropic | Claude Opus / Sonnet | ANTHROPIC_API_KEY |
openai | openai | GPT-5.x / o-series | OPENAI_API_KEY |
dashscope | openai | 통의 Qwen 시리즈 | DASHSCOPE_API_KEY |
deepseek | openai | DeepSeek V3 등 | DEEPSEEK_API_KEY |
kimi | openai | Moonshot Kimi | MOONSHOT_API_KEY |
z-ai | openai | 智谱 GLM | Z_AI_API_KEY |
volcengine | openai | 火山方舟 | ARK_API_KEY |
baidu-qianfan | openai | 文心千帆 | QIANFAN_API_KEY |
또한 dashscope-tokenplan, tencent-tokenhub, hy-tokenplan, mimo, minimax 등 국내 Token 플랜형 엔드포인트 | |||
설정 파일은 ~/.opencodereview/config.json. 일회성 모델 덮어쓰기는 ocr review --model claude-sonnet-4-6로 파일 수정 불필요.
3. Claude, GPT, Gemini: 세 가지 설정 경로 상세
3.1 Claude(Open Code Review에서 가장 매끄러운 경로)
Claude는 네이티브 Anthropic 프로토콜을 쓰며 OpenAI 호환 레이어가 아니다——도구 호출과 Messages API 동작이 가장 안정적이고 알리바바 사내 프로덕션에서도 가장 검증된 조합.
# 대화형(권장)
ocr config provider
# anthropic 선택 → ANTHROPIC_API_KEY 붙여넣기 → claude-opus-4-6 선택
# CI 비대화형
ocr config set provider anthropic
ocr config set model claude-sonnet-4-6
ocr config set providers.anthropic.api_key "$ANTHROPIC_API_KEY"
ocr llm testClaude Code 환경 재사용: 로컬에 ANTHROPIC_AUTH_TOKEN / ANTHROPIC_BASE_URL(Claude Code 동일)을 export했으면 OCR이 자동 인식, 이중 설정 불필요. Claude Code 플러그인 설치 후 IDE slash command로 동일 심사 규칙 실행.
선정 가이드: PR 머지 전 게이트 → Sonnet(비용 관리); 보안/동시성/자금 핵심 모듈 → Opus. thinking 끄고 Token 절약: ocr config set providers.anthropic.extra_body '{"thinking":{"type":"disabled"}}'.
3.2 GPT(OpenAI 공식 레인)
ocr config set provider openai
ocr config set model gpt-5.2
ocr config set providers.openai.api_key "$OPENAI_API_KEY"
ocr review --from origin/main --to HEADGPT는 OpenAI Platform에서 API를 일원 조달하는 팀, 또는 GitHub Copilot 생태계에서 OpenAI 모델족에 익숙한 팀에 적합. OCR은 OpenAI 프로토콜 URL 정규화를 지원하며 Azure OpenAI도 custom_providers로 배포 엔드포인트 지정 가능.
Claude와 비교: OCR 파이프라인 안에서는 차이는 주로 추론 스타일(GPT는 규약 점검, Claude는 경계 조건)이며 OCR 기능 결핍이 아니다——도구 세트는 동일.
3.3 Gemini(커스텀 Provider, 비내장)
Google은 내장 표에 없지만 Gemini API가 OpenAI 호환 레이어를 제공. 커스텀 Provider로 연결:
ocr config set provider gemini-google
ocr config set custom_providers.gemini-google.url \
https://generativelanguage.googleapis.com/v1beta/openai/
ocr config set custom_providers.gemini-google.protocol openai
ocr config set custom_providers.gemini-google.model gemini-2.5-pro
ocr config set custom_providers.gemini-google.api_key "$GEMINI_API_KEY"
ocr config set custom_providers.gemini-google.models \
"gemini-2.5-pro,gemini-2.5-flash,gemini-2.0-flash"
ocr llm test대형 monorepo를 긴 컨텍스트로 심사할 때 Gemini의 백만 토큰급 context에 이론적 이점이 있으나 OCR 자체가 파일 bundling과 병렬 샤딩을 하므로 대부분 PR에서는 만 컨텍스트가 불필요. 더 현실적인 이유는 Google AI Studio / Vertex 계약으로 청구를 GCP에 모으려는 경우.
Vertex AI 기업 배포: url을 리전 엔드포인트(예: https://us-central1-aiplatform.googleapis.com/... OpenAI 어댑터 경로)로 바꾸고 protocol은 openai 유지. Gemini 배경은 사이트 Gemini 3.5 Pro 해설 참고.
4. Claude vs GPT vs Gemini: 5차원 비교(OCR 파이프라인 내)
| 모델족 | 진입점 / 프로토콜 | 실행 능력(OCR 내) | 컨텍스트 / 비용 | 권한 / 컴플라이언스 | 적합 대상 |
|---|---|---|---|---|---|
| Claude | 내장 anthropic; Claude Code로 Delegation 가능 |
도구 호출 최안정; 플러그인 / Skill 원클릭 통합 | Opus는 고가지만 누락 적음; 맨 Agent 대비 Token 약 9배 절약 | Anthropic 기업 컴플라이언스; Bedrock 커스텀 URL | 심사 품질 최우선; Claude Code 구독 보유 |
| GPT | 내장 openai |
Claude와 동일 파이프라인; o-series는 느리지만 깊은 추론 | API 단가 모델별 변동; Team 한도는 OCR에 직결 안 됨 | OpenAI 데이터 정책; Azure 프라이빗 배포 | OpenAI 단일 벤더 전략 팀 |
| Gemini | 커스텀 openai 프로토콜 엔드포인트 |
기능 완전; ocr llm test로 자체 검증 권장 |
Flash는 CI 대량 처리에 저렴; Pro는 코어 경로 심사 | GCP / Vertex IAM; 국내 직연결은 네트워크에 따름 | Google 계약 보유; 초장단일 파일 ocr scan |
프로그래밍 Agent 횡단 비교(심사 전용 아님)는 GPT-5.6과 Claude, Gemini 대체 의사결정 가이드 참고——그쪽은 「코드를 쓰는」 시나리오. 본문은 「코드를 심사하는」 시나리오로 비용 구조가 완전히 다르다.
5. Delegation Mode: Open Code Review Claude의 「API Key 제로」 경로
심사용 API를 별도 구매하고 싶지 않거나 회사가 OCR에 프로덕션 Key 보유를 금지하면 Delegation Mode:
ocr delegate preview
ocr delegate rule src/handler.go src/handler_test.go
# OCR이 규칙과 파일 목록 출력 → Claude Code / Cursor Agent에 붙여넣어 실행이 모드에서:
- OCR이 결정론적 단계 담당: 파일 선택, 규칙 매칭(NPE, 스레드 안전, SQL 인젝션 등 내장 규칙), 심사 태스크 패키지 생성.
- LLM 추론은 Claude Code, Codex, Cursor 등 설치된 Agent가 수행——기존 구독 또는 Agent 한도 사용.
- 공식 Claude Code 플러그인, Codex Skill, Cursor Skill로 slash command 실행.
이것이 「Open Code Review Claude」 검색 의도의 최단 경로: 심사 규칙은 OCR, 모델 청구는 Claude Code Pro/Max. 대가로 OCR 자체 모델 시 CI 무인 병렬 실행력은 잃는다(CI Runner에서 Agent도 돌리는 경우 제외).
6. 시나리오 선택 매트릭스
| 시나리오 | 권장 모델 / 모드 | 이유 | 비추천 |
|---|---|---|---|
| 개인 개발자, Claude Pro 보유 | Delegation + Claude Code 플러그인 | OCR API 비용 제로; 맨 /code-review보다 규칙 안정 |
Anthropic API Key 중복 구매 |
| 팀 PR 게이트(GitHub Actions) | OCR + Claude Sonnet API | 스크립트화·병렬화·Token 관리 용이 | Delegation(CI에 대화형 Agent 없음) |
| OSS, 글로벌 기여자 | OCR + GPT-5 mini / Flash | 단가 낮음, 영어 코멘트 품질 충분 | 기본 Opus(비용 과다) |
| 금융 / 보안 민감 모듈 | Claude Opus + ocr scan |
높은 Precision; 전체 파일 감사 | diff 표면만 훑기 |
| GCP 기업 계약 | 커스텀 Gemini + Vertex | 청구 GCP 집중; IAM 통일 | 억지로 Anthropic 계약 추가 |
| 국내 내망, 외부 API 없음 | dashscope / deepseek 내장 Provider | 국내 엔드포인트 프리셋 | api.anthropic.com 직연결 |
7. 권장 스택(Stack)
【Stack A — 개인 개발자 · Claude 구독파】
심사: OCR Claude Code 플러그인 + Delegation Mode
코딩: Claude Code CLI(Sonnet 기본)
트리거: 로컬 pre-push → ocr delegate preview
업그레이드: PR 커지면 ocr review --model claude-opus-4-6(API 종량)
【Stack B — 10인 엔지니어 팀 · API 통합 청구】
심사: GitHub Action에서 ocr review(Sonnet)
코딩: Cursor + Claude Code 병행
모델: 조직 ANTHROPIC_API_KEY; CI 개인 Key 금지
규칙: .ocr/rules 커스텀 경로 필터
【Stack C — 멀티클라우드 모델 · 비용 최적화】
일상 PR: GPT-5 mini(openai provider)
금요 보안 스캔: Gemini 2.5 Pro(custom provider)
코어 릴리스 브랜치: Claude Opus
전환: ocr review --model <name> 일회 덮어쓰기
【Stack D — 클라우드 Mac CI Runner】
실행: kvmboot 클라우드 Mac M4 상주 Runner
심사: ocr review --from main --to $PR_BRANCH
환경: xcodebuild / 실기기 빌드와 동일 머신, 심사 직후 테스트
참고: 사이트 Claude Code 클라우드 Mac 듀얼 Agent 글Claude Code 구독 비용과 Delegation 손익은 Claude Code 2026 가격 해설 참고. Skills로 심사 강화는 Claude Code Skills 랭킹(/code-review와 OCR 병용, OCR 전문·Skill 범용).
8. 자주 하는 오해
- 오해 1: OCR은 Claude만 지원한다.내장에 OpenAI와 십여 국내/OSS 엔드포인트도 있다. Claude는 권장 기본일 뿐 유일하지 않다.
- 오해 2: Gemini는 OCR에서 못 쓴다.쓸 수 있다——
custom_providers+ OpenAI 프로토콜. 원클릭 preset만 없고 URL 설정 두 단계 추가. - 오해 3: 더 강한 모델로 바꾸면 오탐이 사라진다.OCR Precision은 파이프라인에서 온다. Opus로 맨 교체해도 OCR+Sonnet보다 못할 수 있다.
- 오해 4: Delegation과 ocr review 효과가 완전 동일하다.규칙 선별은 같지만 Delegation은 Agent 세션 품질에 의존. CI 무인은 API 모드.
- 오해 5: ChatGPT Plus 구독이 OCR에 그대로 쓰인다.Plus는 채팅 제품. OCR에는 API Key(OpenAI Platform) 또는 Codex/Agent Delegation 필요.
- 오해 6: 심사 언어는 모델을 따른다.코멘트 언어는
ocr config set language 한국어로 제어하며 Provider와 무관.
9. 실행 단계(7단계)
- OCR 설치:
npm install -g @alibaba-group/open-code-review,ocr --version과 Git ≥ 2.41 확인. - 과금 레인 결정: Claude Code 구독 있으면 먼저 Delegation 시도. CI 게이트 필요 시 API Key 준비.
- Provider 설정:
ocr config provider로 anthropic / openai / 커스텀 Gemini 선택;ocr llm test반드시 통과. - 로컬 스모크: 실제 저장소에서
ocr review, 행 단위 코멘트가 diff와 맞는지 확인. - Agent 플러그인 설치(선택): Claude Code / Cursor에 OCR 플러그인, 팀 slash command 통일.
- CI 연결: 공식 CI/CD 문서로 PR 트리거;
--model로 일상 심사와 보안 스캔 분리. - 월간 회고: API 청구 vs 오탐 triage 공수 비교. 맹목적 Opus 승급 대신 모델 티어 조정.
심사와 빌드를 같은 파이프라인에 두려면 OCR과 xcodebuild를 같은 클라우드 Mac 실행 노드에 배치해, 심사 후 원격 Runner 대기로 절약한 Token을 다시 잡아먹지 마라.
10. FAQ
Open Code Review는 Claude를 지원하나?
지원한다. anthropic은 내장 Provider로 네이티브 Messages API. Opus / Sonnet 설정 가능. Claude Code 플러그인 + Delegation으로 구독 재사용.
GPT / OpenAI를 지원하나?
내장 openai Provider로 지원. OPENAI_API_KEY 설정. Azure OpenAI는 커스텀 URL.
Gemini를 지원하나?
내장 preset 없음. custom_providers로 Google OpenAI 호환 엔드포인트 지정. Vertex 기업도 동일.
Claude Code /code-review와 차이는?
동일 모델에서 OCR이 Token 절약, 행 수준 정위 정확, 오탐 적음. Claude Code Skill은 유연하나 품질 변동 큼. 병용 가능: OCR은 CI 게이트, Skill은 로컬 빠른 스캔.
API Key 없이 쓸 수 있나?
가능. ocr delegate로 추론을 Claude Code / Cursor 등 Agent에 위임. OCR은 파일과 규칙 담당.
한 번 심사에서 모델을 임시 변경할 수 있나?
가능: ocr review --model claude-opus-4-6 일회 덮어쓰기, config.json 수정 불필요.
11. 정리
Open Code Review는 어떤 AI를 지원하나?——Claude와 GPT는 즉시 사용, 국내에는 통의·DeepSeek·Kimi 등도 있다. Gemini는 커스텀 OpenAI 호환 레인. Delegation Mode는 모델 선택을 Claude Code / Cursor에 맡겨 「Open Code Review Claude」로 Key 중복을 피한다.
선정에서 「어떤 모델이 최강인가」에 갇히지 마라. OCR에서는 파이프라인이 모델명보다 중요. 먼저 과금 레인(API vs 구독 Delegation), 다음 시나리오 티어(Sonnet 일상 / Opus 게이트 / Flash 절약), 마지막 Provider 미세 조정. 그래야 Claude, GPT, Gemini가 교체 가능한 엔진이 되고 세 번 바퀴를 다시 만들지 않는다.
CI에서 OCR + 빌드, 클라우드 Mac 한 대로
Open Code Review가 PR에서 코드를 심사한 뒤 다음은 xcodebuild, 서명, 통합 테스트——심사 Runner와 빌드 Runner가 분리되면 대기열과 컨텍스트 전환이 아낀 Token을 다시 먹는다. kvmboot 클라우드 Mac mini M4를 통합 실행 노드로: ocr review와 iOS/macOS 빌드를 동일 머신에서 완료. Apple Silicon 통합 메모리가 병렬 심사 worker를 받치고 macOS 네이티브 환경으로 WSL 불필요. 7×24 상시 온라인으로 GitHub Actions self-hosted·launchd 정기 스캔에 적합.
먼저 일일 요금으로 「OCR 심사 → 빌드 → 테스트」 파이프라인을 통과하고 만족하면 월 계약으로. kvmboot 클라우드 Mac은 Open Code Review + Apple 툴체인의 가성비 실행면—— 플랜 보기 . Claude / GPT / Gemini 심사 결과를 그 자리에서 검증하고 다음 머신을 기다리지 마라.