Skip to main content

​
Codex Plugin System Reference

Source: https://developers.openai.com/codex/plugins, https://developers.openai.com/codex/plugins/build Retrieved: 2026-04-11
이 문서는 vox.ai plugin이 Codex에서 동작하기 위한 참고 자료다. TEST.md의 미션 실행 시 참조한다.

​
Plugin 설치 방법

​
방법 1: Codex 앱 UI

  1. Codex 앱에서 Plugins 열기
  2. 검색하여 plugin 찾기
  3. Add to Codex 또는 + 버튼 클릭
  4. 인증 프롬프트가 뜨면 연결

​
방법 2: Codex CLI

codex
/plugins
plugin 목록에서 선택 → Install plugin

​
방법 3: 로컬 마켓플레이스

Repo marketplace: $REPO_ROOT/.agents/plugins/marketplace.json Personal marketplace: ~/.agents/plugins/marketplace.json

​
Plugin 구조

my-plugin/
├── .codex-plugin/
│   └── plugin.json           # 매니페스트 (필수)
├── skills/
│   └── my-skill/
│       └── SKILL.md
├── .app.json                 # 앱/커넥터 매핑 (선택)
├── .mcp.json                 # MCP 서버 구성 (선택)
└── assets/                   # 아이콘, 스크린샷 (선택)
주의: Codex는 .codex-plugin/plugin.json을 사용한다 (Claude Code는 .claude-plugin/plugin.json).

​
매니페스트 스키마

{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "설명",
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "apps": "./.app.json",
  "interface": {
    "displayName": "표시 이름",
    "shortDescription": "짧은 설명",
    "category": "Productivity"
  }
}

​
마켓플레이스 메타데이터

{
  "name": "marketplace-name",
  "interface": { "displayName": "표시 이름" },
  "plugins": [
    {
      "name": "my-plugin",
      "source": { "source": "local", "path": "./plugins/my-plugin" },
      "policy": {
        "installation": "AVAILABLE",
        "authentication": "ON_INSTALL"
      },
      "category": "Productivity"
    }
  ]
}

​
Plugin 사용

  • @plugin-name — 특정 plugin 호출
  • 또는 자연어로 요청하면 Codex가 적절한 plugin 자동 선택

​
Plugin 비활성화

# ~/.codex/config.toml
[plugins."plugin-name@marketplace-name"]
enabled = false

​
Claude Code와의 차이점

항목Claude CodeCodex
매니페스트 경로.claude-plugin/plugin.json.codex-plugin/plugin.json
마켓플레이스 경로.claude-plugin/marketplace.json.agents/plugins/marketplace.json
Skill 호출/plugin-name:skill-name@plugin-name 또는 $skill-name
설정 파일settings.jsonconfig.toml
캐시 위치~/.claude/plugins/cache/~/.codex/plugins/cache/