Codex App v26.325.2171.0 기준
Codex 플러그인, 설치만 하면 다 되는 건 아닙니다
2026년 3월 26일, OpenAI가 Codex에 플러그인 디렉터리를 공식 출시했습니다.
Gmail, Google Drive, Slack을 Codex와 바로 연결할 수 있다고 해서 기대했는데 — 막상 설치해보면 생각보다 조건이 붙습니다.
요금제, 버그, 스킬과의 구조적 차이까지 공식 문서로 직접 확인한 내용을 정리했습니다.
Codex 플러그인이란 무엇인가
결론부터 말씀드리면, 플러그인은 Codex에서 쓸 수 있는 워크플로를 하나의 설치 가능한 패키지로 묶은 단위입니다. Gmail을 읽고 관리하거나, Google Drive에서 파일을 가져오거나, Slack 채널을 요약하는 작업을 “설치 한 번”으로 Codex에 연결할 수 있게 해줍니다. (출처: OpenAI 공식 플러그인 문서, 2026.03.26)
플러그인 하나는 세 가지 구성 요소를 포함할 수 있습니다. 첫 번째는 스킬(Skills) — 특정 작업 유형을 위한 재사용 가능한 지침입니다. 두 번째는 앱(Apps) — GitHub, Slack, Google Drive 같은 외부 서비스와의 연결입니다. 세 번째는 MCP 서버(MCP Servers) — 로컬 프로젝트 외부의 시스템에 대한 추가 도구 접근입니다. 이 세 가지가 한 패키지에 들어갑니다.
Codex 앱에서는 왼쪽 사이드바의 Plugins 탭을 열어 디렉터리를 탐색하고 설치할 수 있습니다. CLI에서는 codex /plugins 명령어를 입력하면 됩니다. 설치 후에는 프롬프트 창에서 바로 플러그인을 쓸 수 있고, @를 입력해 특정 플러그인을 명시적으로 호출하는 것도 됩니다.
스킬과 다른 점이 핵심입니다
많은 기사에서 “플러그인이 스킬을 대체한다”고 표현합니다. 공식 문서에는 정반대로 나와 있습니다.
공식 문서는 “플러그인은 로컬 스킬을 대체하는 게 아니라 보완하는 것”이라고 명확히 씁니다. 스킬은 워크플로를 설계하는 작성 형식(authoring format)이고, 플러그인은 그 스킬을 다른 사람이 설치할 수 있게 만드는 배포 단위(distribution unit)입니다. (출처: developers.openai.com/codex/skills, 2026.03.26)
쉽게 말하면 이렇습니다. 스킬은 내 컴퓨터나 팀 리포지토리에서 로컬로 동작하는 워크플로 파일입니다. 플러그인은 그 스킬을 포함해, 앱 연동과 MCP 서버 설정까지 한 꾸러미로 만든 설치 가능한 패키지입니다. 단순 개인 작업이라면 스킬만으로 충분하고, 팀에 배포하거나 앱 연동이 필요할 때 플러그인으로 가는 구조입니다.
| 구분 | 스킬(Skill) | 플러그인(Plugin) |
|---|---|---|
| 역할 | 워크플로 작성 형식 | 워크플로 배포 단위 |
| 포함 요소 | SKILL.md 파일 | 스킬 + 앱 + MCP 서버 |
| 적합한 상황 | 개인·팀 내부 워크플로 | 팀 간 배포, 앱 연동 |
| 공식 문서의 관계 정의 | 작성 형식으로 유지 | 스킬 보완, 대체 아님 |
* 출처: OpenAI 공식 플러그인 문서 및 스킬 문서 (2026.03.26)
요금제별로 쓸 수 있는 범위가 다릅니다
Codex 플러그인은 ChatGPT Plus, Pro, Business, Enterprise/Edu 요금제에서 사용할 수 있습니다. 제한된 기간 동안 Free와 Go 요금제도 Codex 자체는 쓸 수 있는데, 이 기간에도 플러그인이 적용되는지는 공식 문서에서 별도 이유를 밝히지 않았습니다. (출처: help.openai.com/ko-kr/articles/11369540, 2026.03.26)
Enterprise와 Business 워크스페이스에서는 플러그인 접근이 워크스페이스 앱 제어(RBAC)를 따릅니다. 관리자가 워크스페이스 설정에서 해당 앱을 활성화해야 구성원이 플러그인을 설치하고 쓸 수 있습니다. 즉, Plus나 Pro 개인 계정과 달리, Enterprise 환경에서는 관리자 설정이 선행되지 않으면 플러그인을 아예 접근할 수 없습니다. Enterprise 팀에서 쓰려면 먼저 관리자에게 확인이 필요합니다.
설치 후 화면이 안 뜨는 이유가 따로 있습니다
플러그인 기능이 출시된 당일(2026년 3월 26일), GitHub 공개 이슈 트래커에 관련 버그 리포트가 바로 올라왔습니다. Codex 앱 버전 26.325.2171.0을 쓰는 Plus 구독자가 올린 이슈로, Windows와 Mac 양쪽에서 재현됐습니다. (출처: github.com/openai/codex/issues/16006, 2026.03.26)
앱 시작 시 왼쪽 사이드바에 “New Plugin” 버튼이 잠깐 보였다가, 곧바로 “Skills”로 되돌아갑니다. 앱 서버 로그를 확인해보면 app/list, skills/list 요청만 반복되고 plugin/list 요청은 아예 발생하지 않습니다. 기능 플래그에서 plugins: stable: true로 확인됐음에도 화면에 표시되지 않는 상태입니다.
이 버그는 단순히 플러그인 화면을 열었을 때 로딩에 실패하는 문제(#15962)와 구별됩니다. 앱 자체가 시작 단계에서 플러그인 경로로 진입하지 못하고 스킬 화면으로 회귀하는 구조적 문제입니다. 공개 이슈 기준으로 아직 공식 수정이 나오지 않은 상태입니다. 플러그인 디렉터리가 안 보인다면 앱 업데이트 이후 재시도하거나 CLI로 접근하는 편이 현재로선 현실적입니다.
직접 만들 수도 있습니다 — 단, 이 조건에서만
공식 플러그인 디렉터리에 올리는 기능은 아직 “Coming soon” 상태입니다. 지금은 로컬이나 팀 내부에서 직접 만들어 쓰는 방식만 가능합니다. (출처: developers.openai.com/codex/plugins/build, 2026.03.26)
직접 플러그인을 만들려면 최소한의 구조가 필요합니다. 플러그인 폴더 안에 .codex-plugin/plugin.json 파일을 만들고, 스킬 디렉터리를 추가하면 됩니다. 공식 문서에서는 내장 스킬 $plugin-creator를 먼저 쓸 것을 권장합니다. 매니페스트 구성, 마켓플레이스 등록까지 자동으로 잡아주기 때문입니다.
마켓플레이스는 두 가지 범위로 나뉩니다. 리포지토리 루트의 $REPO_ROOT/.agents/plugins/marketplace.json에 두면 해당 리포지토리 전체에서 공유되고, 개인 홈 디렉터리의 ~/.agents/plugins/marketplace.json에 두면 내가 어떤 리포지토리를 열어도 적용됩니다. 팀 배포가 목적이라면 리포지토리 루트 경로를 쓰는 것이 맞습니다.
중요한 점이 있습니다. source.path는 마켓플레이스 루트를 기준으로 한 상대 경로여야 하고 반드시 ./로 시작해야 합니다. 절대 경로를 쓰면 Codex가 플러그인을 인식하지 못합니다. 변경 후에는 Codex를 재시작해야 반영됩니다.
클라우드 태스크 한도와 플러그인의 관계
MCP 서버가 포함된 플러그인은 매 메시지마다 추가 컨텍스트를 주입합니다. 공식 문서는 “MCP를 더 많이 추가할수록 메시지당 사용 한도가 더 빠르게 소진된다”고 명시합니다. (출처: developers.openai.com/codex/pricing, 2026.03.26)
Plus 요금제 기준으로 GPT-5.4 모델을 쓸 때 로컬 메시지 한도는 5시간 창 기준 33~168개입니다. 범위가 넓은 이유는 작업 크기와 컨텍스트 크기에 따라 달라지기 때문입니다. MCP 서버가 포함된 플러그인을 쓰면 메시지당 컨텍스트가 늘어나 하한인 33개에 가까워집니다. 즉, 플러그인을 많이 쓸수록 같은 시간 창에 보낼 수 있는 메시지 수가 줄어듭니다. (출처: developers.openai.com/codex/pricing, 2026.03.26)
공식 문서에서 제안하는 실용적 방법은 두 가지입니다. 첫째, 당장 쓰지 않는 MCP 서버는 비활성화해두는 것입니다. 둘째, 일상적인 작업에는 GPT-5.4-mini 모델로 전환하면 같은 한도를 약 2.5~3.3배 더 오래 쓸 수 있습니다. 플러그인이 편리한 만큼, 한도 소진 속도도 같이 고려해야 합니다.
| 요금제 | 로컬 메시지/5h | 클라우드 태스크/5h | 플러그인 사용 가능 |
|---|---|---|---|
| Plus | 33~168개 | 미제공 | ✓ |
| Pro | 223~1,120개 | 미제공 | ✓ |
| Business | 33~168개 | 크레딧제 | ✓ (관리자 활성화) |
| Enterprise | 크레딧제 | 크레딧제 | ✓ (RBAC 관리) |
| API Key | 토큰 과금 | 미제공 | 공식 문서에서 별도 이유를 밝히지 않았습니다 |
* 출처: developers.openai.com/codex/pricing (2026.03.26 기준, GPT-5.4 모델 기준)
Q&A
Q. Codex 플러그인은 무료로 쓸 수 있나요?
Q. 플러그인을 설치했는데 Codex 앱에서 화면이 안 보입니다. 어떻게 해야 하나요?
codex /plugins 명령어로 접근하거나, 앱 업데이트 이후 재시도를 권장합니다.
Q. 기존에 만들어둔 스킬이 플러그인으로 대체되나요?
Q. 공식 플러그인 디렉터리에 내가 만든 플러그인을 올릴 수 있나요?
Q. Enterprise에서 특정 팀에만 플러그인 접근을 줄 수 있나요?
마치며
솔직히 말하면, Codex 플러그인은 아직 “쓰기 편한 상태”까지는 도달하지 못했습니다. 출시 당일 앱 화면 버그가 접수됐고, 공식 디렉터리에 플러그인을 올리는 기능도 아직 준비 중입니다. 기능 자체의 구조 — 스킬과 플러그인의 관계, MCP 서버 포함 시 한도 소진 속도 — 는 꼼꼼하게 설계됐지만, 사용 환경이 아직 따라오지 못하고 있습니다.
지금 당장 써보고 싶다면 CLI 경로가 가장 안정적입니다. Gmail, Google Drive, Slack 플러그인 중 하나를 골라 codex /plugins로 설치하고 실제 작업에 붙여보는 것이 현 시점에서 현실적인 접근입니다. MCP가 포함된 플러그인을 쓸 때는 사용 한도 소진 속도가 빨라진다는 점도 미리 알고 시작하는 게 좋습니다.
본 포스팅 참고 자료
본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. Codex는 지속적으로 업데이트 중인 서비스로, 버그 수정 및 기능 변경이 수시로 이루어집니다. 최신 정보는 OpenAI 공식 문서에서 확인하시기 바랍니다.
댓글 남기기