Claude Code에서 Codex 사용하기: 공식 플러그인 설치·검증

Claude Code에서 작업하다가 Codex에 코드 검토를 맡기거나 대화 맥락을 넘겨 작업을 이어갈 수 있다. Windows에서 공식 플러그인을 설치하고 두 기능을 시험했다.

OpenAI의 codex-plugin-cc는 Claude Code에서 Codex에 코드 검토와 개발 작업을 맡길 수 있는 플러그인이다. 대화를 Codex 세션으로 가져오는 기능도 있다.

Windows에 설치해 보니 코드 리뷰는 정상적으로 끝났다. 대화 이전에는 문제가 있었다. 경로 비교 오류를 고친 뒤 최초 이전에 성공했고, 이미 양쪽에서 이어 쓴 대화는 별도 세션으로 가져오도록 로컬 패치를 추가했다.

개인 브리지와는 어떻게 다른가?

앞서 다룬 개인 브리지의 세션 전환과 기록 위치에서는 Claude Code 인터페이스에서 OpenAI 모델을 실행했다. 개인 스크립트가 지정한 Claude 세션 기록을 별도 폴더에 복사하고, 그 사본에서 작업을 이어가는 방식이었다.

공식 플러그인은 같은 기기에 설치된 Codex CLI·app server를 호출한다. Claude Code에서 일을 맡긴 뒤 결과를 받거나, 대화를 Codex로 가져와 그쪽에서 계속할 수 있다.

명령별 설명은 공식 사용 안내에 있다. 이번에는 설치부터 일반 코드 리뷰, 대화 이전과 재개까지 시험했다.

Windows에 설치하기

2026년 10월 18일 기준 검증 환경은 다음과 같다.

처음 확인했을 때 플러그인은 설치되어 있지 않았다. PowerShell에서 다음 명령을 실행했다.

claude plugin marketplace add openai/codex-plugin-cc
claude plugin install codex@openai-codex

설치 후 새 Claude Code 프로세스를 실행했다. 플러그인 자체 진단에서 준비 상태와 Codex 인증을 모두 확인했다. 준비 상태를 확인할 때는 Claude Code 대화 안에서 다음 명령을 사용할 수 있다.

/codex:setup

자동 반복 리뷰 설정은 꺼진 상태로 두었다.

Claude Code 대화 안에서 설치하려면 공식 설치 안내를 따르면 된다.

이번 시험에서는 claude -p 비대화형 모드로 실제 플러그인 명령을 호출했다. 대화형 터미널 화면이나 Codex 데스크톱 앱에서 직접 조작하는 과정까지 확인한 것은 아니다.

코드 리뷰에 계산 오류를 넣어 봤다

제품 코드 대신 작은 검증용 Git 저장소를 준비했다. 정상 할인 계산식을 커밋한 뒤, 백분율을 비율로 바꾸는 / 100을 지웠다.

정상 계산식:

exports.discount = (price, percent) =>
  price * (1 - percent / 100);

리뷰 대상으로 만든 변경:

exports.discount = (price, percent) =>
  price * (1 - percent);

가격 100에 할인율 20을 넣으면 결과는 80이어야 한다. 변경된 함수를 실행하니 -1900이 나왔다.

이 상태에서 다음 명령을 호출했다.

/codex:review --wait

약 45초 뒤 리뷰가 끝났다. Codex는 백분율 변환이 빠진 문제를 P1으로 지적했다. discount(100, 20)이 80 대신 -1900을 반환한다는 예시도 정확했다.

리뷰 전후 파일의 SHA-256 해시는 같았다. 오류를 설명했지만 파일은 고치지 않았다.

오류 하나를 의도적으로 넣은 작은 예제이므로, 이 결과만으로 대규모 프로젝트의 결함 탐지율이나 리뷰 품질 전체를 평가하기는 어렵다.

대화 이전은 한 번에 되지 않았다

공식 문서에 따르면 /codex:transfer는 Claude 대화를 Codex 세션으로 가져온 뒤 재개 명령을 안내한다. 공식 이전 기능 설명

/codex:transfer

처음 실행했을 때는 가져온 세션이 기록되지 않았다는 오류가 나왔다. 그런데 가져오기 기록을 살펴보니 Codex 세션은 이미 만들어져 있었다.

문제는 Windows 경로 비교였다. 가져오기 기록에는 \\?\ 접두사가 붙어 있었고, 플러그인이 비교하는 경로에는 없었다. 같은 파일을 가리키지만 문자열이 달라 세션을 찾지 못했다.

이 부분을 수정하고 새 대화에서 다시 실행하자 세션 ID와 재개 명령이 정상적으로 나왔다.

codex resume <session-id>

안내된 ID를 사용해 codex exec resume으로 재개했다. 이전 대화의 내용을 물을 때는 정답을 다시 제공하지 않았다.

Codex는 표식 MAPLE-836, 잘못된 계산값 -1900, 기대값 80을 기억했다. 다음 작업이 할인 계산의 / 100 복원이라는 점도 맞혔다.

이미 가져온 대화를 다시 넘기려면

재이전에서는 다른 문제가 생겼다. 이전 성공을 확인하려고 Codex 쪽에 질문을 추가했고, Claude 원본에서도 대화를 이어갔다. 그러자 두 기록이 갈라졌다.

이 상태에서 일반 재이전은 거부됐다. 기존 Codex 대화에 Claude의 새 내용을 그대로 덧붙일 수 없기 때문이다.

기존 기록을 보존하면서 최신 Claude 대화를 별도 세션으로 가져오도록 로컬 옵션을 추가했다.

/codex:transfer --fresh

/codex:transfer --fresh는 이번에 로컬 패치로 추가한 옵션이다. 수정하지 않은 공식 1.0.6에서 지원하는 명령은 아니다.

재검증에서는 Claude 원본에 새 표식 CEDAR-915를 넣고, 다음 작업도 바꿨다. 계산식부터 고치는 대신 0% 할인 테스트를 먼저 추가하도록 했다.

새로 가져온 Codex 세션은 최신 표식과 바뀐 작업 순서를 정확히 답했다. 이전 지시와도 구분했다. 통합 검사에서는 원본 Claude 파일과 기존 Codex 대화 파일의 해시가 유지됐고, 가져오기용 사본은 원본과 바이트 단위로 일치했다.

경로 비교 수정과 로컬 --fresh 옵션의 동작은 Windows 오류와 재이전 문제 해결기에 정리했다.

이번 시험에서 확인한 범위

대화 이전 결과에는 로컬 수정이 포함돼 있다. 공식 배포본이 고쳐졌다는 뜻은 아니며, 업데이트하거나 재설치하면 수정이 사라질 수 있다.

개인 브리지에서 넘어오는 경우에는 기록 위치도 확인해야 한다. 설치된 플러그인은 가져오기 원본을 ~/.claude/projects 아래로 제한하고 있었다. 별도 폴더에 있는 브리지 사본을 그대로 가져오는 동작은 시험하지 않았다.

대화를 재개한 뒤에는 마지막 작업 내용과 실제 파일 상태를 대조하고, 이후 어느 쪽에서 작업을 이어갈지 정해 두는 편이 좋다.

검증 기록: 2026년 10월 18일. 공식 1.0.6과 로컬 패치 결과를 구분했습니다.