OpenAI Codex 플러그인 사용법 완벽 정리 — 설치부터 직접 만들기까지

OpenAI Codex 플러그인(Plugin)은 스킬(Skill), 앱 통합(App), MCP 서버 설정을 하나의 설치 가능한 번들로 묶어서 프로젝트나 팀 간에 재사용할 수 있게 해주는 Codex의 확장 시스템이에요. 2026년 3월 26일 Codex CLI 0.117.0에서 도입됐어요.

그동안 Codex에서 스킬을 쓰려면 개별로 설정하고, 앱 연동은 따로 하고, MCP 서버는 또 따로 잡아야 했죠. 플러그인은 이 세 가지를 하나의 폴더로 패키징해요. npm 패키지처럼 설치하고 바로 쓸 수 있어요.

핵심 기능

1. 스킬 번들링: 반복적인 코딩 워크플로우를 SKILL.md로 정의하고 플러그인에 묶을 수 있어요. 에이전트가 상황에 맞게 자동으로 발견해서 실행해요.

2. 앱 통합 패키징: Slack, Figma 등 외부 도구와의 연결 설정을 .app.json으로 함께 배포할 수 있어요. 팀원이 플러그인만 설치하면 앱 연동도 자동으로 따라와요.

3. MCP 서버 설정 동봉: 외부 도구나 공유 컨텍스트를 제공하는 MCP 서버 설정을 .mcp.json으로 포함시킬 수 있어요. 별도로 MCP 설정을 만질 필요가 없어요.

4. 마켓플레이스 지원: OpenAI가 큐레이팅한 공식 플러그인 디렉토리에서 검색하고 바로 설치할 수 있어요. 로컬 마켓플레이스도 만들 수 있어서 팀 전용 플러그인 배포도 가능해요.

이렇게 써보세요 — 실전 활용법

활용 1: 공식 플러그인 디렉토리에서 설치하기

가장 빠른 방법이에요. Codex 앱에서는 내장 플러그인 디렉토리를 열면 되고, CLI에서는 /plugins 명령어를 입력하면 돼요.

# CLI에서 플러그인 디렉토리 열기
/plugins

설치하고 싶은 플러그인을 선택하면 ~/.codex/plugins/cache/ 경로에 자동으로 다운로드돼요. ~/.codex/config.toml에서 플러그인을 개별로 켜고 끌 수도 있어요.

활용 2: 나만의 플러그인 직접 만들기

Codex에 내장된 @plugin-creator 스킬을 쓰면 폴더 구조와 매니페스트 파일을 자동으로 만들어줘요. 직접 만들고 싶다면 아래 구조를 따라하면 돼요.

my-plugin/
├── .codex-plugin/
│   └── plugin.json       # 필수 매니페스트
├── skills/
│   └── my-skill/
│       └── SKILL.md       # 스킬 정의
├── .app.json              # 앱 통합 설정 (선택)
├── .mcp.json              # MCP 서버 설정 (선택)
└── assets/                # 아이콘, 로고 (선택)

plugin.json의 최소 구성은 이래요:

{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "내 플러그인 설명",
  "skills": "./skills/"
}

활용 3: 팀 전용 로컬 마켓플레이스 운영하기

팀에서만 쓰는 플러그인이 있다면 로컬 마켓플레이스를 만들 수 있어요. 프로젝트 루트에 plugins/ 폴더를 만들고, .agents/plugins/marketplace.json을 설정하면 돼요.

{
  "name": "team-marketplace",
  "interface": {
    "displayName": "우리팀 플러그인"
  },
  "plugins": [
    {
      "name": "deploy-helper",
      "source": {
        "source": "local",
        "path": "./plugins/deploy-helper"
      },
      "policy": {
        "installation": "INSTALLED_BY_DEFAULT",
        "authentication": "ON_INSTALL"
      },
      "category": "DevOps"
    }
  ]
}

INSTALLED_BY_DEFAULT로 설정하면 팀원이 레포를 클론하는 순간 자동으로 플러그인이 활성화돼요.

플러그인 vs 로컬 스킬 — 언제 뭘 쓸까?

요금 & 시작하기

Codex 플러그인에 별도 비용은 없어요. 플러그인은 0.117.0에서 도입되었으므로 해당 버전 이상이면 사용할 수 있어요. 업데이트는 아래 명령어로:

npm install -g @openai/codex@latest

Codex 앱(데스크톱)이나 VS Code 확장에서도 플러그인을 쓸 수 있어요. 어디서 시작하든 같은 플러그인 생태계를 공유해요.

자주 묻는 질문

OpenAI Codex 플러그인은 무료인가요?

플러그인에 별도 비용은 없어요. 다만 Codex 사용에 필요한 OpenAI API 비용은 별도로 발생해요. 공식 플러그인 디렉토리의 플러그인도 추가 비용 없이 설치할 수 있어요.

Codex 플러그인과 Codex 스킬의 차이점은?

스킬(Skill)은 하나의 워크플로우를 정의하는 SKILL.md 파일이에요. 플러그인은 스킬 + 앱 통합 + MCP 서버 설정을 하나의 설치 가능한 패키지로 묶은 거예요. 스킬은 플러그인의 구성 요소 중 하나라고 보면 돼요.

직접 만든 플러그인을 공개 배포할 수 있나요?

현재 공식 퍼블릭 플러그인 퍼블리싱은 "coming soon" 상태예요. 지금은 로컬 마켓플레이스(레포 내 또는 개인 경로)를 통해 팀 단위로 배포할 수 있어요. 곧 셀프 서브 관리 기능이 추가될 예정이에요.

Codex 플러그인에서 MCP 서버를 어떻게 설정하나요?

플러그인 폴더에 .mcp.json 파일을 만들고, 매니페스트(plugin.json)에서 "mcpServers": "./.mcp.json"으로 경로를 지정하면 돼요. 플러그인 설치 시 MCP 서버 설정이 자동으로 적용돼요.