알리바바 코드리뷰 CLI, 토큰 9분의 1로 PR 검토 — Claude Code·Codex 설정법 정리
이번 주 GitHub 트렌딩에서 코딩 에이전트 확장 두 개를 골랐다. 알리바바의 open-code-review는 범용 에이전트보다 훨씬 적은 토큰으로 코드를 리뷰하며, 일주일 새 별 6,920개를 받았다. OpenSpec은 에이전트가 코드를 짜기 전에 '무엇을 만들지' 문서로 먼저 합의하게 한다. 둘 다 Claude Code와 Codex에서 쓸 수 있어 설정법을 각각 적었다.
1) open-code-review(OCR): 리뷰 전용 도구가 토큰을 9분의 1만 쓴다
- 대상: 공통(Claude Code 플러그인, Codex 플러그인, 스킬)
- 저장소: alibaba/open-code-review (https://github.com/alibaba/open-code-review), 별 4만 900개, Apache-2.0 라이선스
- 하는 일: Git 변경분(diff)을 읽고 버그·보안·성능 문제를 줄 단위 코멘트로 남긴다. 검토할 파일 선택과 규칙 적용은 고정된 절차가 맡고, 판단은 LLM(대규모 언어모델) 에이전트가 맡는다.
- 근거 수치: 알리바바는 오픈소스 저장소 50곳에서 10개 언어로 된 실제 PR(풀 리퀘스트, 코드 변경 요청) 200건을 골라 성능을 쟀다. 같은 모델을 쓴 Claude Code보다 정밀도와 F1 점수가 높았고, 토큰은 약 9분의 1만 썼다. 이 결과는 알리바바가 직접 발표한 수치다.
공통 준비: CLI(명령줄 도구)를 먼저 깐다
- npm install -g @alibaba-group/open-code-review
- ocr config provider → ocr config model → ocr llm test 순서로 모델을 연결한다(아래 위임 모드만 쓸 거라면 건너뛰어도 된다)
Claude Code에서 쓰는 법
- /plugin marketplace add alibaba/open-code-review
- /plugin install open-code-review@open-code-review
- 설치하면 /open-code-review:review, /open-code-review:delegate-review 두 명령이 생긴다
Codex에서 쓰는 법
- 터미널에서 codex plugin marketplace add alibaba/open-code-review 를 실행하고 codex 를 켠다
- /plugins 에서 Open Code Review를 설치·활성화한 뒤 새 작업을 연다
- "@Open Code Review review this branch against main"처럼 말로 부른다
활용 팁: API 키가 없으면 위임 모드를 쓴다
- 위임 모드(delegate)에서는 지금 쓰는 에이전트가 자기 모델로 리뷰를 돌리고, OCR은 파일 선택과 규칙 적용만 맡는다. 그래서 OCR용 API 키를 따로 넣지 않아도 된다. Claude Code라면 /open-code-review:delegate-review 를 부르면 된다.
2) OpenSpec: 코드보다 명세를 먼저 쓰게 한다
- 대상: 공통(Claude Code 스킬·슬래시 명령, Codex 스킬)
- 저장소: Fission-AI/OpenSpec (https://github.com/Fission-AI/OpenSpec), 별 7만 300개, 이번 주 +1,415개, MIT 라이선스
- 하는 일: 스펙 주도 개발(SDD, 요구사항 문서를 먼저 확정하고 구현하는 방식)을 돕는다. 에이전트가 proposal.md·design.md·tasks.md를 먼저 만들고, 사람이 승인한 뒤에야 구현한다.
설치(Node.js 20.19 이상)
- npm install -g @fission-ai/openspec@latest
- 프로젝트 폴더에서 openspec init --tools claude,codex 를 실행한다(대화형으로 고르려면 openspec init만 입력)
Claude Code에서 쓰는 법
- init이 .claude/skills 와 .claude/commands/opsx 에 파일을 만든다
- /opsx:propose <아이디어> → 계획 검토 → /opsx:apply → 끝나면 /opsx:archive 순서로 쓴다
Codex에서 쓰는 법
- Codex는 스킬만 지원하므로 init은 .agents/skills/openspec-*/SKILL.md 만 만든다
- 슬래시 대신 $openspec-propose 처럼 달러 기호로 부른다
활용 팁: 두 에이전트가 같은 명세를 공유한다
- 명세는 openspec/ 폴더에 마크다운으로 남는다. Claude Code로 제안서를 쓰고 Codex로 구현해도 같은 tasks.md를 따라간다. 완료한 변경은 openspec/changes/archive/ 로 옮겨져 이력으로 쌓인다.
두 도구 모두 버전마다 명령어 표기가 바뀔 수 있으니, 설치 전에 각 README를 확인하라. 오늘은 작업 중인 브랜치에서 /open-code-review:delegate-review 를 한 번 돌려 기존 리뷰 결과와 비교해 보라.
출처:
https://github.com/trending?since=weekly
https://github.com/alibaba/open-code-review
https://github.com/alibaba/open-code-review/blob/main/plugins/open-code-review/README.md
https://github.com/alibaba/open-code-review/blob/main/plugins/open-code-review/CODEX.ko-KR.md
https://github.com/Fission-AI/OpenSpec
https://github.com/Fission-AI/OpenSpec/blob/main/docs/supported-tools.md
댓글 (0)
아직 댓글이 없습니다.
댓글을 쓰려면 입장하세요.
← 목록