2026년 3월 30일, 보기 드문 일이 벌어졌습니다. OpenAI가 자사 도구를 경쟁사의 터미널 안으로 직접 넣어 배포한 것입니다. 그 결과물이 codex-plugin-cc이고, 하나의 창 안에서 두 에이전트를 함께 쓰는 방식이 달라졌습니다.
codex-plugin-cc란 무엇이며, OpenAI는 왜 Claude Code용으로 만들었나
codex-plugin-cc는 Anthropic의 Claude Code CLI 안에서 Codex 코딩 에이전트를 실행하는 공식 OpenAI 플러그인입니다. 저장소는 openai/codex-plugin-cc이며, Apache-2.0 라이선스를 따르고, 사실상 순수 JavaScript로 작성되어 있습니다 . 눈에 띄는 지점은 방향입니다. 프런티어 모델 업체가 경쟁사 생태계를 위해 도구를 패키징했다는 점입니다.
새로운 런타임은 아닙니다. OpenAI는 개발자 포럼 공지에서 이렇게 설명했습니다.
"It is not a separate runtime. It is Codex, just invoked from inside Claude Code." — OpenAI (source: OpenAI Developer Community)
이 플러그인은 이미 사용자의 컴퓨터에 설치된 Codex CLI와 앱 서버에 작업을 위임하며, 기존 인증과 설정을 그대로 재사용합니다 . 유지보수도 활발합니다. v1.0.0은 2026년 3월 30일에 나왔고, 현재 v1.0.6은 2026년 7월 8일에 배포되었습니다. 넉 달 동안 패치 릴리스가 여섯 번 나온 셈입니다 . 2026년 6월 기준 주간 사용자 500만 명을 넘긴 바로 그 Codex 에이전트가, 다른 터미널 표면에 올라온 것입니다 .
내 컴퓨터에 필요한 조건
필수 조건은 많지 않지만 구체적입니다. Node.js 18.18.0 이상이 필요합니다. 이는 플러그인의 package.json에 선언된 강제 엔진 조건(engines: ">=18.18.0")이지 권장 하한선이 아니므로, 더 오래된 런타임에서는 설치가 거부됩니다 . 계정 측면에서는 ChatGPT 구독, 무료 티어 포함, 또는 OpenAI API 키가 있으면 Codex를 사용할 수 있습니다 .
인증은 다시 입력하지 않고 기존 상태를 이어받습니다. 로컬에서 이미 Codex에 로그인되어 있다면 플러그인이 그 상태를 자동으로 재사용하므로 두 번째 로그인이 필요 없습니다 . 아직 Codex가 설치되어 있지 않다면? npm이 있을 때 /codex:setup이 npm install -g @openai/codex 실행을 제안할 수 있고, 먼저 해당 명령을 직접 실행해도 됩니다 .
마켓플레이스 추가부터 /codex:setup까지 설치 순서
공식 설치 경로 전체는 활성 Claude Code 세션 안에서 실행하는 네 개의 슬래시 명령으로 이뤄집니다. 바이럴 클립에서 말하는 두 개가 전부는 아닙니다 . 아래 순서대로 진행합니다.
/plugin marketplace add openai/codex-plugin-cc— 현재 세션 안에 OpenAI가 배포한 마켓플레이스를 등록합니다. Claude Code는 마켓플레이스를 카탈로그처럼 취급하므로, 그 안의 항목을 설치하기 전에 먼저 추가해야 합니다 ./plugin install codex@openai-codex— 해당 카탈로그에서 플러그인을 설치합니다. 이름에 주의해야 합니다. 플러그인 이름은codex이고, 마켓플레이스 이름은openai-codex이므로 참조 형식이codex@openai-codex가 됩니다 ./reload-plugins— 반드시 실행해야 합니다. 이 단계를 건너뛰면/codex:*스킬이 나타나지 않고,codex:codex-rescue서브에이전트도/agents에 표시되지 않습니다 ./codex:setup— Codex가 설치되어 있고 인증되어 있는지 확인합니다. Codex가 없고 npm을 사용할 수 있으면npm install -g @openai/codex실행을 제안합니다. Codex는 있지만 로그인되어 있지 않다면 Claude Code에서!codex login을 실행하라고 안내합니다 .
실제로 쓰기 전에 확인하세요. /codex:setup이 오류 없이 끝나면 /codex:review가 응답해야 하고, codex:codex-rescue 서브에이전트가 /agents에 보여야 합니다 . 둘 중 하나라도 보이지 않는다면 /reload-plugins를 다시 실행하세요. 명령 표면이 나타나지 않는 가장 흔한 이유는 reload 단계를 건너뛴 것입니다.
두 명령어 설명이 놓치는 부분
바이럴처럼 퍼진 "명령어 두 개, 30초" 설명은 마켓플레이스 추가와 플러그인 설치, 즉 1단계와 2단계만 다룹니다. /reload-plugins를 건너뛰면 플러그인은 등록되지만 잠든 상태로 남습니다. 실행 중인 세션에 /codex:* 슬래시 명령어가 로드되지 않기 때문에 아무것도 작동하지 않는 것처럼 보입니다 . /codex:setup을 건너뛰면 플러그인은 Codex가 설치되어 있고 인증도 되어 있는지 확인하지 않습니다. 실패가 읽을 수 있는 오류가 아니라 조용히 발생하므로, 디버깅하기 가장 까다로운 형태가 됩니다 .
실제 업무에 쓰기 전에 특히 주의해야 할 동작이 두 가지 있습니다.
- 리뷰 게이트가 선택 사항인 데는 이유가 있습니다. 설정 플래그로 켜면 Claude Code
Stop훅을 사용해 Claude가 응답할 때마다 Codex를 실행합니다. OpenAI와 실무자들은 이 방식이 Claude/Codex 루프를 계속 돌려 사용 한도를 빠르게 소진할 수 있다고 경고합니다. 기본값이 아니라 선택 옵션으로 다루세요 . - 과금은 따로 유지됩니다. Codex 사용량은 Codex 한도에, Claude 사용량은 Claude 한도에 잡힙니다. 공유 할당량도 없고 계정 간 컨텍스트도 없습니다. 이 플러그인은 Claude 계정 상태가 아니라 로컬 Codex 인증을 재사용합니다 .
최신 상태로 유지하는 것도 중요합니다. 2026년 7월 8일에 출시된 v1.0.6은 git 명령어의 셸 확장을 제거했습니다. 저장소 안에서 셸 명령을 실행하는 플러그인에는 정확성과 보안 측면에서 중요한 수정입니다. 이전 빌드에는 Windows 호환성과 앱 서버 준비 상태 관련 회귀가 있었으므로, 최근 버전으로 고정해 두는 편이 좋습니다 .
깔끔하게 설치한 뒤 사용할 수 있는 슬래시 명령어
/codex:setup이 끝나면 플러그인은 집중된 /codex:* 슬래시 명령어 묶음과 /agents에서 보이는 codex:codex-rescue 서브에이전트를 제공합니다 . 이는 범용 오케스트레이션 런타임이 아니라 명령어 표면입니다. 각 명령어는 로컬 체크아웃에 대해 하나의 Codex 동작으로 매핑됩니다.
| 명령어 | 역할 | 주요 플래그 |
|---|---|---|
/codex:review | 커밋되지 않은 변경사항이나 브랜치 diff를 읽기 전용으로 Codex가 리뷰 | --base, --wait, --background |
/codex:adversarial-review | 같은 방식으로 대상을 고르되, 버그뿐 아니라 설계 결정과 가정까지 의심하며 살펴보는 리뷰 | --base + 선택적 초점 텍스트 |
/codex:rescue | 조사나 수정을 codex:codex-rescue 서브에이전트에 위임 | --model (spark → gpt-5.3-codex-spark), --resume, --fresh, --effort |
/codex:transfer | 더 긴 위임을 위해 현재 Claude Code 세션을 지속되는 Codex 스레드로 넘김(v1.0.5에서 추가) | — |
/codex:status · /codex:result · /codex:cancel | 백그라운드 작업 관리 | — |
실무적으로는 블로킹 방식의 --wait에 의존하기 전에 백그라운드 작업으로 실행하고 /codex:status와 /codex:result로 확인하며, 필요하면 /codex:cancel로 취소하는 습관이 좋습니다. --wait는 Codex가 응답할 때까지 터미널을 붙잡아 둡니다 . 핵심은 간단합니다. 최근 빌드로 고정 설치하고, /codex:review를 한 번 실행해 서브에이전트가 응답하는지 확인한 다음, 리뷰 명령어를 릴리스 체크리스트에 넣으세요. 그러면 하나의 터미널에서 Claude가 계획하고 Codex가 리뷰하는 흐름을 갖게 됩니다 .
자주 묻는 질문
codex-plugin-cc를 쓰려면 유료 OpenAI 플랜이 필요한가요?
아니요. ChatGPT 무료 계정도 가능하며, OpenAI API 키로도 사용할 수 있습니다 . 플러그인은 자체 자격 증명을 관리하지 않습니다. 로컬 Codex 설치에 이미 들어 있는 인증을 그대로 재사용합니다. 해당 머신에서 Codex에 이미 로그인되어 있다면 그 인증이 자동으로 사용됩니다. 아니라면 Claude Code에서 !codex login을 한 번 실행하면 됩니다.
Codex 플러그인이 내 Claude 계정이나 과금을 공유하나요?
아니요. Codex 사용량은 Codex 한도에, Claude 사용량은 Claude 한도에 잡힙니다. 공유 할당량도, 계정 간 인증도, 연결된 과금도 없습니다 . 이 플러그인은 로컬에 설치된 Codex CLI와 앱 서버를 호출하는 편의용 브리지입니다. 두 에이전트가 컨텍스트, 계정, 권한을 공유한다는 뜻은 아닙니다. 특히 선택 사항인 "리뷰 게이트"는 주의해서 보세요. Claude/Codex 루프가 Codex 한도를 빠르게 소진할 수 있습니다.
2단계까지 했는데 /codex:* 명령어가 왜 보이지 않나요?
대부분은 설치 명령어 두 개까지만 실행하고 /reload-plugins를 건너뛴 경우입니다. 마켓플레이스를 추가하고 플러그인을 설치하면 등록은 되지만, 실행 중인 세션에는 새 스킬이 아직 로드되지 않습니다. /reload-plugins를 실행한 뒤 /codex:setup을 실행하면 /codex:* 슬래시 명령어와 codex:codex-rescue 서브에이전트가 /agents에 나타납니다 . 그래서 "두 명령어"라는 설명은 실제로는 네 단계에 가깝습니다.
/codex:review와 /codex:adversarial-review는 무엇이 다른가요?
/codex:review는 커밋되지 않은 변경사항이나 main 같은 base ref 기준 브랜치 diff를 대상으로 표준 읽기 전용 Codex 리뷰를 실행하며, --base, --wait, --background를 지원합니다 . /codex:adversarial-review는 같은 방식으로 대상을 고르되, 선택적 초점 텍스트를 더해 설계 결정과 가정을 적극적으로 의심하는 리뷰를 수행합니다. 단순 변경 요약이 아니라 병합 전의 두 번째 의견이 필요할 때 adversarial 리뷰를 쓰면 됩니다.
codex-plugin-cc는 Claude Code용 "OpenAI Developers" 플러그인과 같은 것인가요?
아니요. openai/openai-developers-for-claude는 Docs MCP 서버와 API 설정 스킬을 묶은 별도 플러그인이고, openai/codex-plugin-cc는 Codex 코딩 에이전트 자체를 노출합니다 . 두 플러그인은 서로 다른 저장소에 있으며 목적도 다릅니다. 하나를 설치한다고 다른 하나까지 생기지는 않습니다. 코드 리뷰와 작업 위임이 목표라면 필요한 것은 codex-plugin-cc입니다.
영상 / 자료
- OpenAI — 코드 에디터에서 쓰는 OpenAI Codex
- OpenAI — Codex 앱으로 작업 자동화하기
- AI Master — Claude Code로 AI 에이전트 만드는 법(Claude AI 에이전트 튜토리얼)
이 글이 도움이 되셨다면, 새 글이 올라올 때마다 이메일로 받아보세요.
