open-code-review/plugins/open-code-review/CODEX.ko-KR.md
seunghun chae fb819510ca
feat(codex): add local Codex plugin support (#69)
* feat(codex): add local Codex plugin support

* docs: add Korean documentation

* docs(codex): address plugin review feedback
2026-06-08 00:34:21 +08:00

2.2 KiB

Open Code Review Codex 플러그인 사용법

이 문서는 로컬 Codex에서 Alibaba Open Code Review를 사용하는 방법을 설명합니다.

개요

이 플러그인은 Open Code Review를 Codex 내부 LLM backend로 바꾸지 않습니다. Codex에서 로컬 ocr CLI를 호출할 수 있도록 skill을 제공하는 통합입니다.

Codex
  └─ Open Code Review plugin
      └─ ocr review --audience agent

사전 준비

ocr CLI가 설치되어 있어야 합니다.

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

설치 확인:

command -v ocr
ocr version

OCR 자체의 LLM 설정도 필요합니다.

ocr llm test

이 명령이 실패하면 Codex 플러그인 설치와 별개로 OCR의 LLM 설정을 먼저 완료해야 합니다.

Codex에서 설치

Codex에서 이 repo를 marketplace로 추가합니다.

codex plugin marketplace add alibaba/open-code-review
codex

Codex 안에서 /plugins를 열고 Open Code Review를 설치 및 활성화합니다.

로컬 checkout 또는 fork에서 테스트할 때는 다음을 사용할 수 있습니다.

codex plugin marketplace add .
codex

사용 예시

새 Codex thread에서 다음처럼 요청합니다.

@Open Code Review review my current changes

브랜치 비교:

@Open Code Review review this branch against main

검토 후 안전한 항목만 수정:

@Open Code Review review and fix high-confidence issues

내부적으로 실행되는 명령

현재 workspace 변경사항 검토:

ocr review --audience agent

특정 commit 검토:

ocr review --audience agent --commit <sha>

브랜치 비교:

ocr review --audience agent --from <base-ref> --to <head-ref>

미리보기:

ocr review --preview

주의사항

  • 이 플러그인은 OpenAI Responses API endpoint를 설정하지 않습니다.
  • 이 플러그인은 OPENAI_API_KEYgpt-5.1-codex-max 설정을 요구하지 않습니다.
  • OCR 자체는 별도의 LLM 설정이 필요합니다.
  • 파일 수정은 사용자가 명시적으로 요청한 경우에만 수행합니다.
  • commit 생성은 사용자가 명시적으로 요청한 경우에만 수행합니다.