공개 노트

Claude Code에서 Codex 플러그인 활용법 및 설치 가이드

2026-03-31Views 4,976약 9분

Summary

Claude Code 안에서 Codex를 부르는 방법

OpenAI `codex-plugin-cc` 정리와 실제 활용 포인트

OpenAI가 Claude Code에서 Codex를 호출할 수 있는 공식 플러그인 openai/codex-plugin-cc를 공개했습니다.
이 플러그인은 별도 독립 엔진이 아니라, 사용자 로컬의 Codex CLI와 Codex app server를 통해 Codex를 Claude Code 안에서 호출하는 구조입니다.
확인되는 주요 명령은
/codex:review, /codex:adversarial-review, /codex:rescue, /codex:status, /codex:result, /codex:cancel입니다.
따라서 이 플러그인은 단순한 “코드 자동 작성기”라기보다, 리뷰와 2차 검토, 그리고 일부 작업 위임을 Claude Code 워크플로우 안에 끼워 넣는 연결 레이어로 보는 편이 정확합니다.
사용하려면 ChatGPT 계정(무료 포함) 또는 OpenAI API key, 그리고 Node.js 18.18 이상이 필요합니다.

1. 무엇이 출시된 것인가요

이번에 공개된 것은 새로운 모델이 아니라,

Claude Code에서 Codex를 호출할 수 있게 해주는 공식 플러그인입니다.

OpenAI의 공식 GitHub 저장소 설명은 아래와 같습니다.

Use Codex from Claude Code to review code or delegate tasks.

즉, 핵심은 다음과 같습니다.

| 항목 | 내용 |

| 정식 명칭 | openai/codex-plugin-cc |

| 목적 | Claude Code 안에서 Codex 사용 |

| 기본 성격 | 리뷰 + 작업 위임 연결 플러그인 |

| 공개 형태 | GitHub 공개 저장소 |

| 초기 릴리스 | 2026년 3월 30일 |

2. 설치 방법

설치는 비교적 단순합니다.

2-1. 마켓플레이스 추가


/plugin marketplace add openai/codex-plugin-cc

2-2. 플러그인 설치


/plugin install codex@openai-codex

2-3. 플러그인 로드 후 설정


/reload-plugins

/codex:setup

/codex:setup은 Codex가 준비되어 있는지 확인합니다.

Codex가 아직 설치되지 않았고 npm이 사용 가능하면 설치를 제안할 수 있습니다.

수동 설치가 필요하면 다음 명령도 안내됩니다.


npm install -g @openai/codex

로그인이 안 되어 있다면 다음으로 로그인할 수 있습니다.


!codex login

3. 요구사항

플러그인을 쓰기 전에 필요한 조건은 명확합니다.

| 항목 | 요구사항 |

| 인증 | ChatGPT 계정(무료 포함) 또는 OpenAI API key |

| 런타임 | Node.js 18.18 이상 |

| Codex 준비 | 로컬 Codex CLI 설치 및 로그인 필요 가능 |

| 사용량 | 호출 시 Codex 사용량에 반영 |

여기서 중요한 점은

플러그인 사용량이 Codex 사용량에 합산된다는 부분입니다.

즉, Claude Code 안에서 부른다고 해서 별도 무료 레이어가 생기는 구조는 아닙니다.

4. 어떻게 동작하나요

이 플러그인은 “Claude Code가 자체적으로 Codex처럼 변신하는 구조”가 아닙니다.

공식 안내에 따르면, 플러그인은 로컬 Codex CLI와 Codex app server를 통해 위임합니다.

즉 구조는 대략 이렇게 이해하시면 됩니다.


Claude Code

  ↓

Codex Plugin

  ↓

로컬 Codex CLI

  ↓

Codex app server

  ↓

Codex 실행 및 결과 반환

이 구조 때문에 다음 특징이 생깁니다.

특징	설명
별도 런타임 아님	이미 쓰고 있는 Codex 설정을 재사용
로컬 인증 재사용	기존 ChatGPT 로그인 / API key 설정 사용
환경 재사용	기존 Codex config, MCP 설정, base URL 설정 반영 가능
진입 장벽 감소	Claude Code 사용자에게 Codex를 얹는 방식

OpenAI 커뮤니티 공지에서도 이 플러그인이 same local auth, config, environment, and MCP setup를 사용한다고 설명합니다.

즉, “완전히 새로운 무언가”보다는 기존 Codex를 Claude Code 안으로 끌어오는 어댑터에 가깝습니다.

5. 현재 확인되는 주요 명령어

공식 README 기준으로 확인되는 주요 명령은 다음과 같습니다.

명령어	설명	성격
`/codex:review`	일반적인 읽기 전용 코드 리뷰	리뷰
`/codex:adversarial-review`	더 비판적이고 공격적인 관점의 리뷰	리뷰
`/codex:rescue`	Codex에게 작업을 넘김	위임
`/codex:status`	백그라운드 작업 상태 확인	관리
`/codex:result`	작업 결과 확인	관리
`/codex:cancel`	작업 취소	관리

여기서 가장 많이 주목받는 것은 /codex:review와 /codex:adversarial-review입니다.

6. “리뷰 전용인가요?”에 대한 정확한 정리

이 부분은 표현을 조심해야 합니다.

6-1. 왜 리뷰 중심으로 보이느냐

실제 공개 문맥과 사용자 반응, 그리고 첫인상은 대부분 코드 리뷰 플러그인에 가깝습니다.

특히 /codex:review와 /codex:adversarial-review가 전면에 나오기 때문입니다.

6-2. 그런데 README는 작업 위임도 명시합니다

공식 README는 분명히 이렇게 적고 있습니다.

review
adversarial-review
rescue
status
result
cancel

즉, 공식 저장소 기준으로는 리뷰만 있는 것은 아닙니다.

다만 현재 사용자 경험상 가장 즉시 드러나는 가치는 리뷰와 2차 검토에 더 가깝다고 보는 편이 안전합니다.

6-3. 가장 보수적으로 표현하면

아래처럼 정리하는 것이 사실에 가장 가깝습니다.

표현	적절성
“완전한 구현 자동화 도구다”	과장 가능성 큼
“리뷰 중심 플러그인이다”	대체로 안전
“리뷰와 일부 작업 위임을 지원한다”	공식 README 기준 가장 정확

7. 각 명령은 언제 쓰면 좋은가요

7-1. `/codex:review`

가장 기본적인 리뷰입니다.

현재 브랜치나 변경 사항에 대해 읽기 전용 관점에서 품질 검토를 받는 흐름에 적합합니다.

7-2. `/codex:adversarial-review`

이 명령은 말 그대로 문제를 더 적극적으로 찾는 관점에 가깝습니다.

7-3. `/codex:rescue`

이 명령은 공식 README에 포함되어 있으며, 일부 작업을 Codex에 넘기는 흐름으로 이해할 수 있습니다.

다만 현재 공개 문서만으로는 구체적인 사용 시나리오가 충분히 세세하게 설명돼 있지는 않습니다.

그래서 블로그에서는 아래처럼 쓰는 편이 안전합니다.

/codex:rescue는 README 기준으로 작업 위임용 명령으로 소개되지만, 실제 팀 워크플로우에 넣기 전에는 작은 저장소나 보조 작업에서 먼저 검증하는 것이 좋습니다.

7-4. `/codex:status`, `/codex:result`, `/codex:cancel`

이 세 개는 한 세트로 보는 게 좋습니다.

명령어	의미
`/codex:status`	현재 진행 상황 확인
`/codex:result`	완료된 결과 확인
`/codex:cancel`	작업 중단

즉, 플러그인은 “한 번 호출하고 끝”이 아니라,

백그라운드 작업을 관리하는 흐름도 갖고 있습니다.

8. 실제 사용 예시

예시 1. PR 전 1차 리뷰


/codex:review --background

/codex:status

/codex:result

이런 식으로 먼저 돌려두고 결과를 확인하는 방식이 가능합니다.

예시 2. 취약점 의심 코드 점검


/codex:adversarial-review

예를 들어 다음과 같은 상황에서 유용합니다.

인증/인가 로직 변경
결제 처리 분기 수정
파일 업로드 / path 처리 코드 추가
SQL 조합 / 외부 입력 처리 변경

예시 3. 작업 위임 흐름 실험


/codex:rescue

/codex:status

/codex:result

아직 초기 공개 단계이므로,

이 명령은 대형 핵심 기능보다 보조성 작업이나 2차 검토성 작업부터 붙여보는 편이 현실적입니다.

9. 개발자 입장에서 왜 중요한가요

이 플러그인의 의미는 “Claude가 Codex를 이겼다/졌다” 같은 비교 구도가 아닙니다.

핵심은 서로 다른 에이전트를 한 워크플로우 안에서 섞어 쓰는 방식이 공식화되고 있다는 점입니다.

9-1. 컨텍스트 전환 감소

기존에는 다음처럼 움직여야 했습니다.


Claude Code에서 작업

→ 별도로 Codex 열기

→ 다시 결과를 가져오기

이제는 Claude Code 안에서 바로 연결할 수 있으니,

툴 간 왕복 비용이 줄어듭니다.

9-2. “작성”과 “검토”를 분리하기 쉬워짐

예를 들어 이렇게 역할을 나눌 수 있습니다.

단계	도구
설계 및 대화	Claude Code
1차 리뷰	Codex review
공격적 검토	Codex adversarial-review
최종 수정	개발자

즉, 한 명의 개발자가 다층 리뷰 구조를 더 쉽게 만들 수 있습니다.

9-3. AI를 하나 고르는 시대에서 조합하는 시대로

이 플러그인은 “최고의 AI 하나”를 고르는 게임보다,

각 도구를 어디에 배치하느냐가 더 중요해졌다는 신호로 볼 수 있습니다.

10. 지금 시점에서 확인되는 한계

공개 직후라서, 장점만 보기엔 이릅니다.

실제로 GitHub 이슈를 보면 초반 한계도 드러납니다.

10-1. 자유 질의 명령이 아직 없음

공개 이슈에는 다음과 같은 요청이 올라와 있습니다.

임의 질문을 Codex에 보내는 /codex:ask 같은 명령이 필요하다
현재 명령은 review / adversarial-review / rescue처럼 목적이 정해져 있다

즉, 지금은 범용 질의형 인터페이스가 아니라 목적형 명령 세트에 가깝습니다.

10-2. sandbox 관련 리뷰 오류 이슈 존재

공개 이슈에는 설치 직후 /codex:review 실행 시

sandbox variant 관련 오류가 발생했다는 보고도 있습니다.

이 말은 곧,

초기 릴리스 단계이며
환경별 안정성 차이가 있을 수 있고
팀 도입 전에는 소규모 검증이 필요하다는 뜻입니다.

10-3. 아직은 “가볍고 명확한 워크플로우”에 잘 맞음

현재 공개 정보 기준으로는 다음처럼 보는 것이 현실적입니다.

적합한 용도	덜 적합한 용도
PR 전 코드 리뷰	무거운 범용 질의 세션
보안성/논리성 2차 검토	복잡한 장기 협업 대화
배경 작업 결과 조회	모든 개발 과정을 이 플러그인 하나로 대체

11. 비용과 인증에서 알아둘 점

Codex는 ChatGPT 계정으로도 쓸 수 있고, API key로도 쓸 수 있습니다.

다만 둘은 비용 체계와 사용 경험이 완전히 같지는 않습니다.

로그인 방식	특징
ChatGPT 로그인	구독에 포함된 Codex 사용 경로 활용 가능
API key 로그인	OpenAI Platform 표준 API 과금 사용
공통점	둘 다 Codex CLI / 앱 / IDE에서 사용 가능
차이점	일부 ChatGPT 크레딧 기반 기능은 ChatGPT 로그인에서만 제공

따라서 팀 환경에서는 다음처럼 나뉠 수 있습니다.

개인 개발자: ChatGPT 로그인으로 시작
팀/서비스 환경: API key 기반으로 통제
커스텀 endpoint 필요: Codex config에서 openai_base_url 조정

12. 워크플로우에 넣는다면 이렇게 시작하는 것이 현실적입니다

추천 1단계: 리뷰 전용으로 붙이기

가장 안전한 시작점은 이것입니다.


코드 작성

→ /codex:review

→ 필요 시 /codex:adversarial-review

→ 수정

→ PR

추천 2단계: background 결과 확인 습관화


/codex:review --background

→ /codex:status

→ /codex:result

긴 리뷰를 기다리는 동안 다른 작업을 할 수 있습니다.

13. 이 플러그인을 어떻게 정의하면 가장 정확할까요

과장 없이 요약하면 이렇게 볼 수 있습니다.

codex-plugin-cc는 Claude Code 사용자가 기존 Codex CLI와 app server를 그대로 활용해,

리뷰와 일부 작업 위임을 Claude Code 안에서 처리할 수 있게 해주는 공식 플러그인입니다.

조금 더 직관적으로 말하면 이렇습니다.

표현	정확도
Claude Code용 Codex 리뷰 플러그인	높음
Claude Code용 Codex 연결 플러그인	높음
Claude Code 안의 완전한 자동 구현 엔진	낮음

결론

이번 공개의 포인트는 거창한 “세대 교체”보다 더 실용적입니다.

Claude Code 사용자는 익숙한 환경을 유지한 채
Codex의 리뷰 및 위임 기능을 끌어올 수 있고
OpenAI는 자사 Codex를 경쟁사 에이전트 환경 안에서도 쓰게 만드는 선택을 했습니다

이것이 의미하는 바는 단순합니다.

앞으로 중요한 것은 “어떤 AI 하나를 선택하느냐”보다

“어떤 워크플로우 안에 어떤 AI를 끼워 넣느냐”일 가능성이 높습니다.

한 줄 요약

codex-plugin-cc는 Claude Code를 Codex로 대체하는 도구가 아니라,

Claude Code 안에서 Codex의 리뷰와 위임 기능을 호출하게 해주는 공식 연결 레이어입니다.

참고 자료

OpenAI GitHub: openai/codex-plugin-cc
OpenAI Developer Community: Introducing Codex Plugin for Claude Code
OpenAI Developers: Codex Authentication
OpenAI Developers: Codex App Server
OpenAI Developers: Codex CLI
GitHub Issues: free-form prompt 요청, sandbox variant 오류 보고