플러그인

개요

플러그인은 스킬, 앱 통합, MCP 서버를 Codex에서 재사용할 수 있는 워크플로로 묶습니다.

예를 들어 플러그인으로 Codex의 기능을 확장할 수 있습니다.

Gmail 플러그인을 설치해 Codex가 Gmail을 읽고 관리하게 합니다.
Google Drive 플러그인을 설치해 Drive, Docs, Sheets, Slides에서 작업합니다.
Slack 플러그인을 설치해 채널을 요약하거나 답장을 작성합니다.

플러그인은 다음을 포함할 수 있습니다.

스킬: 특정 종류의 작업을 위한 재사용 가능한 지침입니다. Codex는 필요할 때 스킬을 불러와 올바른 단계를 따르고 작업에 맞는 참고 자료나 보조 스크립트를 사용합니다.
앱: GitHub, Slack, Google Drive 같은 도구와의 연결입니다. Codex는 이러한 도구에서 정보를 읽고 작업을 수행할 수 있습니다.
MCP 서버: Codex가 추가 도구나 공유 정보에 접근하게 하는 서비스입니다. 대개 로컬 프로젝트 밖의 시스템에서 제공됩니다.

더 많은 플러그인 기능이 곧 추가될 예정입니다.

플러그인 사용과 설치

Codex 앱의 플러그인 디렉터리

Codex 앱에서 Plugins 를 열어 선별된 플러그인을 탐색하고 설치합니다.

CLI의 플러그인 디렉터리

Codex CLI에서 플러그인 목록을 열려면 다음 명령을 실행합니다.

codex
/plugins

CLI 플러그인 브라우저는 플러그인을 marketplace별로 그룹화합니다. marketplace 탭으로 소스를 전환하고, 플러그인을 열어 세부 정보를 확인하고, marketplace 항목을 설치하거나 제거할 수 있습니다. 설치된 플러그인에서 Space를 누르면 활성화 상태를 전환합니다.

플러그인 설치와 사용

플러그인 디렉터리를 연 뒤 다음 단계를 따릅니다.

플러그인을 검색하거나 둘러본 뒤 세부 정보를 엽니다.
설치 버튼을 선택합니다. 앱에서는 더하기 버튼 또는 Add to Codex 를 선택합니다. CLI에서는 Install plugin을 선택합니다.
플러그인이 외부 앱을 필요로 하면 안내에 따라 연결합니다. 일부 플러그인은 설치 중 인증을 요청하고, 다른 플러그인은 처음 사용할 때까지 기다립니다.
설치 후 새 스레드를 시작하고 Codex에게 플러그인을 사용하라고 요청합니다.

플러그인을 설치한 뒤에는 프롬프트 창에서 직접 사용할 수 있습니다.

작업을 직접 설명하기: "오늘의 읽지 않은 Gmail 스레드를 요약해 줘" 또는 "Google Drive에서 최신 출시 노트를 가져와 줘"처럼 원하는 결과를 요청합니다. Codex가 작업에 맞는 설치된 도구를 선택하길 원할 때 사용합니다.
특정 플러그인 선택하기: @를 입력해 플러그인이나 함께 제공되는 스킬을 명시적으로 호출합니다. Codex가 사용할 플러그인이나 스킬을 구체적으로 지정하고 싶을 때 사용합니다.

권한과 데이터 공유 작동 방식

플러그인을 설치하면 해당 워크플로를 Codex에서 사용할 수 있지만, 기존 승인 설정은 계속 적용됩니다. 연결된 외부 서비스에는 해당 서비스의 인증, 개인정보, 데이터 공유 정책이 계속 적용됩니다.

함께 제공되는 스킬은 플러그인을 설치하는 즉시 사용할 수 있습니다.
플러그인에 앱이 포함되어 있으면 Codex가 설정 중 또는 처음 사용할 때 ChatGPT에서 해당 앱을 설치하거나 로그인하라고 요청할 수 있습니다.
플러그인에 MCP 서버가 포함되어 있으면 사용 전에 추가 설정이나 인증이 필요할 수 있습니다.
Codex가 함께 제공된 앱을 통해 데이터를 보낼 때는 해당 앱의 약관과 개인정보 정책이 적용됩니다.

플러그인 제거 또는 끄기

플러그인을 제거하려면 플러그인 브라우저에서 해당 플러그인을 다시 열고 Uninstall plugin 을 선택합니다.

플러그인을 제거하면 Codex에서 플러그인 번들이 제거되지만, 함께 제공된 앱은 ChatGPT에서 관리하기 전까지 설치된 상태로 남아 있습니다.

플러그인을 설치된 상태로 유지하되 끄고 싶다면 ~/.codex/config.toml의 해당 항목을 enabled = false로 설정한 뒤 Codex를 다시 시작합니다.

[plugins."gmail@openai-curated"]
enabled = false