플러그인

개요

플러그인은 스킬, 앱 통합, 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