OpenQodex — 에이전트가 쓴 코드를 다른 에이전트가 푸시 전에 검토하는 오픈소스 리뷰 도구

코딩 에이전트에게 일을 맡기면 코드는 순식간에 쌓이는데, 그 코드를 누가 검토하느냐는 여전히 사람의 몫으로 남기 쉽습니다. 에이전트가 쓴 코드를, 그 에이전트와는 다른 리뷰어가 푸시 전에 꼼꼼히 살펴보는 오픈소스 도구가 있어요.

이게 뭐에요?

OpenQodex는 코딩 에이전트를 위한 오픈소스 AI 코드 리뷰 도구입니다. 에이전트가 작성한 변경 사항을 푸시하기 전에, 코드를 쓴 에이전트와는 별개의 리뷰어가 검토합니다. Claude Code, Codex, Cursor, Cline에서 쓸 수 있고, 터미널에서 npx openqodex init으로 설치한 뒤 에이전트에게 "openqodex로 내 변경 사항을 검토해줘"라고 말하면 됩니다. 리뷰 대상은 아직 푸시하지 않은 커밋과 커밋되지 않은 변경 사항 전체입니다.

뭐가 재밌어요?

• 쓴 에이전트와 다른 리뷰어가 봅니다: 리뷰는 코드를 작성한 세션의 기억 없이 새로 시작된 별도의 Claude Code 또는 Codex 프로세스가 맡습니다. 자기 코드를 자기가 검토하는 맹점을 피하려는 구조입니다. Cursor와 Cline에서는 리뷰를 시작할 수 있지만, 리뷰어 역할은 Claude Code나 Codex가 맡습니다.
• 스캐너가 먼저, AI가 그 다음입니다: 내장 스캐너 22개가 바뀐 파일에 맞는 검사를 먼저 돌립니다. 시크릿 유출, 보안 문제, 의존성 취약점, 린트, 워크플로, Dockerfile·Terraform·쿠버네티스, SQL 마이그레이션 등을 보는데, 결과는 바뀐 줄(line)에 대한 것만 남깁니다.
• 인용 줄을 스크립트가 대조합니다: 리뷰어는 발견 사항을 제시할 때 근거가 되는 코드 줄을 인용해야 하고, 스크립트가 그 인용이 실제 코드와 맞는지 확인합니다. 모든 스캐너 발견 사항에 답했는지, 모든 바뀐 줄이 리뷰어에게 전달됐는지도 스크립트가 검증합니다. 단계가 빠지면 "Review incomplete"와 함께 종료 코드 2로 끝납니다.
• 결과는 영수증 한 장으로 정리됩니다: 검토가 끝나면 판정과 발견 사항별 한 줄 요약이 담긴 영수증이 출력되고, report.html·report.md·report.json·report.sarif 형태의 보고서도 남습니다. 무엇을 고칠지는 사용자가 고른 뒤에만 에이전트가 고칩니다.
• 푸시 게이트는 기본적으로 경고만 합니다: 에이전트가 git push를 실행하기 전에 리뷰가 있는지 확인하는 게이트가 있지만, 기본값은 경고입니다. 설정에서 심각도를 지정했을 때만 해당 수준 이상의 발견 사항이 푸시를 막습니다.
• 코드 그래프도 함께 줍니다: openqodex graph로 "이 함수를 누가 호출하는지" 같은 질문에 답할 수 있고, MCP 서버를 통해 에이전트도 같은 그래프를 활용합니다. 자기 계정이나 API 키는 따로 필요 없고, 리뷰어는 사용자의 Claude Code·Codex 로그인으로 동작합니다. 단, GitHub Action에서 전체 리뷰를 돌릴 때는 Anthropic API 키가 필요하고, 키가 없으면 스캐너만 실행됩니다.

지금 상태는?

오늘 확인 기준으로 OpenQodex는 Apache-2.0 라이선스의 오픈소스로, GitHub 스타 약 1,099개·포크 76개 수준이며 2026년 10월 2일에 공개된 비교적 새 프로젝트입니다. Node.js 22 이상과 git이 필요하고, macOS와 Linux에서 동작하며 Windows나 WSL에서는 테스트되지 않았다고 안내돼 있습니다. GitHub에서 가져온 스캐너를 추가할 수도 있는데, 실행 전에 openqodex trust로 명시적으로 승인해야 합니다. OpenQodex 자체는 사용 데이터를 수집하지 않으며, 내장 스캐너는 코드를 외부로 보내지 않는다고 명시돼 있습니다. 심어진 버그가 있는 작은 저장소를 만들어 스캔해 보는 데모 명령도 있습니다.

한 줄 평: "에이전트에게 코드를 맡겼다면, 검토도 에이전트에게 맡기되 — 쓴 애와는 다른 애에게 맡기는 도구입니다."

링크 모음

• 공식 사이트: https://openqodex.com
• GitHub: https://github.com/openqodex/openqodex