OpenAI가 Anthropic의 제품에 공식 플러그인을 제공한다. AI 업계에서 경쟁사끼리 이런 협력은 극히 이례적이다.

Codex 플러그인이란

2025년 5월, OpenAI는 자사의 코딩 에이전트 Codex를 출시했다. Codex는 코드 리뷰, 버그 수정, 리팩토링 등을 자율적으로 수행하는 AI 코딩 에이전트다.

그런데 흥미로운 일이 벌어졌다. OpenAI가 경쟁사인 Anthropic의 Claude Code 안에서 Codex를 바로 사용할 수 있는 공식 플러그인을 직접 만들어 배포한 것이다. 보통 AI 업계에서 경쟁사끼리 이런 식의 통합은 거의 볼 수 없다. Google이 ChatGPT 플러그인을 만들거나, Meta가 Copilot 확장을 배포하는 상황을 상상해보면 얼마나 이례적인지 감이 올 것이다.

OpenAI 입장에서는 "어차피 Claude Code가 시장을 먹었으니, Codex도 한 번 맛 봐라" 라는 전략이고, 개발자 입장에서는 Claude Code를 벗어나지 않고도 Codex의 코드 리뷰와 작업 위임 기능을 쓸 수 있으니 양쪽 모두에게 이득이다.

최근 들어 개인적으로는 Claude Code가 CLAUDE.md를 무시하거나, SKILL.md를 읽어놓고 컨벤션을 지키지 않는 등 종종 엇나간다고 느꼈다. 반면 Codex는 규칙을 따르는 일이나 코드 리뷰의 안정성 면에서 훨씬 신뢰가 갔다. 다만 순수한 코드 작성 능력만 보면 여전히 Claude Code가 한 수 위라고 느꼈다. 그래서 OpenAI가 공식 지원하는 플러그인을 통해 Claude Code 안에서 코드는 Claude가 작성하고, 리뷰는 Codex가 맡을 수 있다는 점이 무척 반갑다. 개인적으로는 거의 최선의 조합에 가깝다.

이 글에서는 codex-plugin-cc의 설치부터 실전 사용법까지 정리한다. 3주 전 출시되어 아직 공식 지원 기능이 얼마 되지 않지만, 앞으로 계속 지원될 예정 같으니 github를 항상 참고하자.

요구사항 및 설치

요구사항

ChatGPT 무료 계정으로도 사용할 수 있다는 점이 진입 장벽을 크게 낮춘다. 다만 실제 사용해보면 무료 계정으론 한계가 있어, 금방 유료 계정으로 전환해야 하며, 토큰 소모가 이중으로 발생함을 주의해야 한다.

설치

Claude Code 안에서 순서대로 실행한다.

/plugin marketplace add openai/codex-plugin-cc

/plugin install codex@openai-codex

/reload-plugins

/codex:setup

/codex:setup은 Codex가 설치되어 있는지, 인증이 완료되었는지를 확인해준다. Codex가 없고 npm이 사용 가능한 환경이라면 자동 설치를 제안하기도 한다.

직접 설치하려면 아래 명령어를 사용한다.

npm install -g @openai/codex

Codex 로그인이 안 되어 있다면 Claude Code 안에서 바로 로그인할 수 있다.

!codex login

설치가 완료되면 슬래시 커맨드 목록과 /agents에서 codex:codex-rescue 서브에이전트를 확인할 수 있다.

슬래시 커맨드

Codex 플러그인은 6개의 슬래시 커맨드를 제공한다.

/codex:review

현재 작업 중인 변경사항에 대해 Codex 코드 리뷰를 실행한다. Codex 안에서 /review를 실행하는 것과 동일한 품질의 리뷰를 받을 수 있다.

# 커밋되지 않은 변경사항 리뷰
/codex:review
 
# 특정 브랜치 기준 비교 리뷰
/codex:review --base main
 
# 백그라운드에서 실행
/codex:review --background

멀티 파일 변경의 경우 시간이 꽤 걸릴 수 있어서, --background 플래그로 백그라운드 실행을 권장한다. 이 커맨드는 읽기 전용이므로 코드를 변경하지 않는다.

/codex:adversarial-review

일반 리뷰와 달리, 구현 방향과 설계 결정에 의도적으로 도전하는 리뷰다.

# 기본 실행
/codex:adversarial-review
 
# 캐싱/재시도 설계에 대해 도전
/codex:adversarial-review --base main challenge whether this was the right caching and retry design
 
# 백그라운드에서 레이스 컨디션 집중 리뷰
/codex:adversarial-review --background look for race conditions and question the chosen approach

/codex:review와 달리 플래그 뒤에 포커스 텍스트를 추가할 수 있다. 인증, 데이터 유실, 롤백, 레이스 컨디션 등 특정 위험 영역에 집중하도록 지시할 수 있어서, 배포 전 설계 검증에 유용하다.

/codex:rescue

Codex에게 작업을 위임하는 커맨드다. codex:codex-rescue 서브에이전트를 통해 실행된다.

# 버그 조사 위임
/codex:rescue investigate why the tests started failing
 
# 최소 패치로 수정 요청
/codex:rescue fix the failing test with the smallest safe patch
 
# 이전 작업 이어서 진행
/codex:rescue --resume apply the top fix from the last run
 
# 모델과 노력도 지정
/codex:rescue --model gpt-5.4-mini --effort medium investigate the flaky integration test
 
# 빠른 처리용 경량 모델 사용
/codex:rescue --model spark fix the issue quickly

--resume과 --fresh 플래그로 이전 작업을 이어갈지, 새로 시작할지를 선택할 수 있다. 둘 다 생략하면 해당 레포의 최근 rescue 스레드를 이어갈 것인지 물어본다.

슬래시 커맨드 없이 자연어로도 위임이 가능하다.

Ask Codex to redesign the database connection to be more resilient.

spark을 모델로 지정하면 gpt-5.3-codex-spark으로 매핑된다. 빠른 처리가 필요할 때 유용하다.

/codex:status, /codex:result, /codex:cancel

백그라운드 작업을 관리하는 세 가지 커맨드다.

# 현재 실행 중인 작업 확인
/codex:status
 
# 특정 작업 확인
/codex:status task-abc123
 
# 완료된 작업의 결과 조회
/codex:result
 
# 실행 중인 작업 취소
/codex:cancel task-abc123

/codex:result는 Codex 세션 ID도 함께 제공한다. 이 ID를 사용하면 Codex에서 해당 작업을 직접 이어서 진행할 수 있다.

codex resume <session-id>

/codex:setup

설치 상태와 인증을 확인하는 것 외에, 리뷰 게이트(Review Gate) 를 관리할 수 있다.

# 리뷰 게이트 활성화
/codex:setup --enable-review-gate
 
# 리뷰 게이트 비활성화
/codex:setup --disable-review-gate

리뷰 게이트를 활성화하면 Claude의 응답에 대해 Codex가 자동으로 리뷰를 실행한다. 문제가 발견되면 Claude가 먼저 수정하도록 차단한다.

리뷰 게이트는 Claude/Codex 간 긴 루프를 만들 수 있어 사용량이 빠르게 소모될 수 있다. 세션을 적극적으로 모니터링할 때만 활성화하는 것을 권장한다.

실전 워크플로우

배포 전 리뷰

가장 기본적인 사용법이다. PR을 올리기 전에 Codex에게 리뷰를 맡긴다.

/codex:review --base main --background

리뷰가 완료되면 결과를 확인한다.

/codex:status
/codex:result

버그 조사 위임

CI에서 빌드가 실패하거나, flaky 테스트가 발생했을 때 Codex에게 조사를 맡긴다.

/codex:rescue investigate why the build is failing in CI

Claude로 작업하던 중 특정 문제만 Codex에게 넘기고 싶을 때 유용하다. 컨텍스트 전환 없이 바로 위임할 수 있다.

설계 검증

중요한 변경 전에 adversarial review로 설계를 검증한다.

/codex:adversarial-review --background look for race conditions and question the chosen approach

일반 리뷰가 "코드가 올바른가" 를 확인한다면, adversarial review는 "이 접근 자체가 맞는가" 를 질문한다.

장기 작업 + 모니터링

시간이 오래 걸리는 작업은 백그라운드로 돌리고, 필요할 때 확인한다.

# 백그라운드 작업 시작
/codex:rescue --background investigate the regression
 
# 나중에 확인
/codex:status
/codex:result

Codex 설정

Codex 플러그인은 로컬 Codex CLI를 감싸는(wrapping) 구조다. 별도의 런타임을 만들지 않고, 사용자 환경에 설치된 codex 바이너리를 그대로 사용한다.

따라서 기존 Codex 설정이 플러그인에도 그대로 적용된다.

config.toml

기본 모델이나 reasoning effort를 변경하려면 config.toml에 설정한다.

model = "gpt-5.4-mini"
model_reasoning_effort = "high"

설정 우선순위는 다음과 같다.

프로젝트 레벨 설정은 해당 프로젝트가 trusted로 등록되어 있어야 적용된다.

더 많은 설정 옵션은 Codex config reference에서 확인할 수 있다.

Codex로 작업 이어가기

플러그인에서 위임한 작업은 Codex에서 직접 이어갈 수도 있다.

# 특정 세션 이어가기
codex resume <session-id>
 
# 최근 세션 목록에서 선택
codex resume

세션 ID는 /codex:result나 /codex:status에서 확인할 수 있다. Claude Code에서 시작한 작업을 Codex에서 이어서 리뷰하거나 수정할 수 있다.

FAQ

Codex 계정이 별도로 필요한가?

이미 로컬에서 Codex에 로그인되어 있다면 별도 설정 없이 바로 사용할 수 있다. 플러그인은 로컬 Codex CLI의 인증 상태를 그대로 사용한다.

아직 Codex를 사용한 적이 없다면 ChatGPT 계정 또는 API 키로 로그인해야 한다. /codex:setup으로 상태를 확인하고, !codex login으로 로그인하면 된다.

별도의 Codex 런타임을 사용하는가?

아니다. 플러그인은 로컬에 설치된 Codex CLI와 Codex app server를 그대로 사용한다.

• 동일한 Codex 설치를 사용한다
• 동일한 인증 상태를 공유한다
• 동일한 레포지토리와 로컬 환경에 접근한다

기존 API 키나 base URL 설정을 유지할 수 있는가?

가능하다. 플러그인이 로컬 Codex CLI를 사용하므로, 기존 로그인 방식과 설정이 그대로 적용된다.

OpenAI provider를 다른 엔드포인트로 지정해야 한다면, Codex config에서 openai_base_url을 설정하면 된다.