Claude Code용 Codex 플러그인 사용법, 아직도 모르고 있었다면

경쟁사의 제품을 위한 기능을 출시하는 일이 있을까요? 상상하기 힘든 일이 현실에서는 발생했습니다. 

OpenAI가 Anthropic의 Claude Code 안에서 동작하는 공식 Codex 플러그인을 직접 개발해 공개한 것입니다. 마치 삼성이 애플 칩을 생산하듯, AI 코딩 도구에서도 비슷한 일이 일어났는데요. 

아는 사람만 누리고 있는 Claude Code의 Codex 플러그인, 어떤 기능이 있고 어떻게 사용하는지 정리했습니다.

왜 Claude Code에 

Codex 플러그인이 추가되었을까?

OpenAI가 직접 Claude Code에서 사용 가능한 Codex 플러그인을 개발해 공개했습니다. 경쟁사의 플랫폼 안에 직접 들어오는 방식으로 개발자 워크플로우를 확장한 것은 매우 이래적인 사례인데요. 

아마도 Claude Code와 직접 경쟁하기 보다 AI 코딩 1위로 꼽히는 Claude Code 사용자에게 Codex의 기능을 선보임으로써 Codex의 진입장벽을 낮추려는 의도로 보이고 있습니다. 

덕분에 사용자는 Claude Code 안에서 Codex가 제공하는 7가지 기능을 활용해 코드 리뷰와 보조 작업을 처리하며, 하나의 개발 환경 안에서 더 높은 완성도의 결과물을 만들 수 있게 되었습니다. 

Codex 플러그인은 어떤 기능을 제공할까?

Codex 플러그인은 코드 리뷰, 작업 위임, 상태 관리를 아우르는 7가지 기능을 제공해 Claude Code 안에서 Codex의 성능을 경험할 수 있게 했습니다.

Claude Code에 Codex 플러그인 설치하는 방법

Claude Code에서 Codex를 사용하려면 먼저 Claude Code 안에서 OpenAI Codex 플러그인 마켓플레이스를 추가한 뒤, Codex 플러그인을 설치해야 합니다.

터미널에서 Claude Code를 실행한 상태로 아래 명령어를 순서대로 입력합니다.

/plugin marketplace add openai/codex-plugin-cc

Claude Code에 OpenAI Codex 플러그인 마켓플레이스를 추가하는 과정으로, Claude Code가 Codex 플러그인을 설치할 수 있는 저장소를 인식하도록 등록하는 단계입니다.

등록한 OpenAI Codex 마켓플레이스에서 Codex 플러그인을 설치합니다. 설치가 완료되면 Claude Code 안에서 Codex 관련 명령어를 사용할 수 있는 준비가 됩니다.

Codex 플러그인을 어디에 설치할지 선택하는 화면이 나옵니다. 옵션은 아래와 같습니다.

• Install for you (user scope): 내 Claude Code 전체에서 사용
• Install for all collaborators on this repository (project scope): 현재 프로젝트를 함께 쓰는 팀원들도 사용
• Install for you, in this repo only (local scope): 현재 프로젝트에서만 나 혼자 사용

개인적으로 Claude Code에서 Codex를 계속 사용할 목적이라면 Install for you (user scope)를 선택하면 됩니다. 옵션을 선택하고 나면 Codex Plugin 설치가 완료됩니다.

플러그인을 설치한 뒤에는 Claude Code가 새로 설치한 플러그인을 인식해 활성화하도록 reload 명령어를 입력합니다. 이 과정을 거치지 않으면 설치는 되었더라도 바로 활성화되지 않을 수 있습니다.

활성화가 완료된 후 /Codex를 입력하면 codex 플러그인이 추가되고 /codex와 관련된 명령어들이 자동완성으로 표시된 것을 볼 수 있습니다. 

플러그인이 정상 작동할 준비가 되었는지 확인하기 위해 /Codex:setup을 실행합니다.

/codex:setup 명령어를 실행하면 Claude Code가 실행 권한을 확인하는 화면을 표시합니다. 

설정 확인을 계속 진행하려면 1. Yes 또는 2. Yes, and don't ask again을 선택하면 됩니다. 처음 실행하는 경우에는 1. Yes를 선택하는 것이 안전합니다. 

이후 로컬 환경에 Codex CLI가 설치되어 있지 않다면, Claude Code에서 Codex 설치 여부를 묻는 화면이 표시됩니다. Codex 플러그인을 사용하려면 Install Codex를 선택해 설치를 진행합니다. 

설치가 완료된 뒤 OpenAI 계정으로 로그인하면 Claude Code 안에서 Codex 플러그인을 사용할 수 있습니다. 

Claude Code 용 

Codex 플러그인을 활용하는 노하우 3가지

1. 평소에는 /codex:review로 2차 코드 리뷰를 받기

Claude Code로 기능 구현이나 수정 작업을 마친 뒤에는 바로 완료하지 말고 /codex:review를 실행해 Codex에게 한 번 더 검토를 맡기는 방식이 좋습니다. 

Claude Code가 작성한 코드를 Claude Code 스스로 다시 확인하는 것보다, Codex라는 다른 모델에게 리뷰를 맡기면 놓친 부분을 발견할 가능성이 높아집니다. 특히 코드 구조, 불필요한 중복, 예외 처리, 테스트 누락 여부를 확인할 때 유용합니다. 

"이 함수에서 예외 처리가 빠진 케이스가 있는지 확인해줘"처럼 작업 단위로 리뷰를 요청하면 결과를 검토하기 쉽습니다.

2. 중요한 변경 사항은 /codex:adversarial-review로 비판적으로 검토하기

로그인, 결제, 권한, 데이터 처리, 배포 관련 코드처럼 중요한 작업이라면 일반 리뷰보다 /codex:adversarial-review를 사용하는 것이 좋습니다. 

구현 방식을 그대로 받아들이기보다 설계 선택과 구현 접근을 비판적인 관점에서 전반적으로 검토하는 방식입니다.

일반 리뷰가 코드의 문제를 확인하는 과정이라면, adversarial review는 "이 설계가 정말 안전한가?", "실패할 수 있는 지점은 없는가?"를 따지는 검토에 가깝습니다. PR 전 최종 점검 용도로 활용하면 효과적입니다.

3. 막힌 작업은 /codex:rescue로 Codex에게 넘기기

Claude Code로 작업하다가 에러 원인이 잘 보이지 않거나 같은 해결 방식을 반복하고 있다면 /codex:rescue를 활용할 수 있습니다. 

이 기능은 단순 리뷰가 아니라 Codex가 별도의 에이전트처럼 작업을 이어받아 버그 원인 분석이나 수정을 직접 진행하는 방식입니다.

사용할 때는 처음부터 큰 작업을 통째로 넘기기보다는 범위를 좁혀 "이 에러의 원인을 찾아줘", "이 테스트가 실패하는 이유를 분석해줘", "이 파일의 리팩토링 방향만 제안해줘"처럼 구체적으로 맡겨야 결과를 검토하기 쉽습니다.

Claude Code 용 

Codex 플러그인을 사용할 때 주의사항 4가지

1. /Codex를 Claude Code의 보조 에이전트로 사용해야 합니다

Codex 플러그인은 Claude Code의 작업 흐름 안에 Codex를 추가하는 방식으로 이해해야 합니다. Claude Code가 메인 작업을 진행하고 코드 리뷰, 비판적 검토, 막힌 작업 등 Codex는 보조에 사용하는 것이 좋습니다.

2. 같은 파일을 동시에 수정하지 않도록 관리해야 합니다

Claude Code와 Codex가 동시에 같은 파일을 수정하면 변경 내용이 충돌할 수 있습니다. 특히 /codex:rescue처럼 Codex에게 작업을 위임하는 경우에는 어떤 파일을 수정해도 되는지, 어떤 범위까지만 검토할지 미리 정하는 것이 좋습니다. 

"전체 프로젝트를 수정해줘"보다 "이 파일의 오류 원인만 분석해줘", "이 테스트 실패 원인만 찾아줘"처럼 범위를 좁혀 요청하는 것이 안전합니다.

3. 중요한 작업은 결과를 한 번 더 검토해야 합니다

AI 코딩 도구가 제안한 수정안은 항상 정확하지 않을 수 있습니다. 로그인, 결제, 권한, 데이터 삭제, 배포 자동화처럼 중요한 기능은 Codex의 제안을 그대로 적용하지 말고 테스트와 코드 리뷰를 거쳐야 합니다. 

이때는 /codex:adversarial-review처럼 더 비판적인 검토 명령을 함께 활용하는 것이 좋습니다.

4. 사용량을 관리해야 합니다

Codex 플러그인 사용량은 Anthropic이 아닌 ChatGPT 구독 또는 OpenAI API 크레딧에서 차감됩니다. 

특히 /codex:adversarial-review나 /codex:rescue처럼 긴 작업을 반복적으로 실행하면 사용 한도가 빠르게 소진될 수 있습니다. 중요한 작업이나 대규모 변경 사항에 집중해서 사용하는 것이 좋습니다.

Claude Code의 성능을 더 극대화해서 사용하는 방법 3가가지

Claude Code /goal 출시: 목표만 주면 AI가 끝까지 처리한다

Claude Code Agent View 사용법 총정리: 실행 방법부터 주요 명령어까지

tmux 사용법, Claude Code와 연동한 멀티플렉서로 생산성을 극대화하는 방법