Claude Code 플러그인의 구성 요소
Anthropic의 플러그인 문서는 다음과 같이 설명합니다: "Claude Code 플러그인은 Claude Code가 하나의 단위로 설치하고 로드하는 스킬, 에이전트, 훅, MCP 서버 또는 기타 구성 요소의 디렉토리입니다."
플러그인의 매니페스트는 .claude-plugin/plugin.json에 위치합니다. 대부분의 플러그인은 플러그인 목록과 각 플러그인을 가져올 위치가 나열된 카탈로그인 마켓플레이스에서 제공됩니다.
플러그인을 설치하면 Claude Code는 이를 설정에 기록합니다. 각 플러그인은 <entry-name>@<marketplace> 형식의 설치 ID를 가지며, Anthropic은 이를 Claude Code가 설정 파일의 enabledPlugins 아래에 쓰는 키라고 설명합니다. 사용자 범위에 설치된 플러그인의 경우 해당 항목은 ~/.claude/settings.json에 들어갑니다. 귀하 또는 귀하의 조직이 등록한 마켓플레이스는 extraKnownMarketplaces 아래에 나타날 수 있습니다.
마이그레이션에서 중요한 두 가지 다른 위치는 다음과 같습니다:
- 플러그인의 설치된 파일. Claude Code는 이를
CLAUDE_PLUGIN_ROOT로 노출합니다. 문서는 이 경로가 "플러그인이 업데이트될 때 변경되므로 그곳에 상태를 기록하지 마십시오"라고 경고합니다. - 플러그인의 데이터 디렉토리. Claude Code는 이를
~/.claude/plugins/data/<id>/에 위치한CLAUDE_PLUGIN_DATA로 노출합니다. 이는 "첫 참조 시 생성되고 플러그인 업데이트 전반에 걸쳐 유지"되며, Anthropic은 설치된 종속성, 생성된 코드 및 캐시를 일반적인 콘텐츠로 나열합니다.
플러그인은 구성 값을 요청할 수도 있습니다. 매니페스트 참조에 따르면 민감한 것으로 표시된 값은 settings.json 대신 "보안 저장소에 저장"됩니다.
Codex 가져오기가 제공하는 항목
OpenAI의 가져오기 흐름이 시작점입니다. 두 곳에서 사용할 수 있습니다:
- ChatGPT 데스크톱 앱: 설정(Settings)의 가져오기(Import)에서 Claude Code, Claude Cowork 또는 Cursor로부터 가져올 수 있습니다.
- Codex CLI: 유휴 세션에서
/import를 사용하여 Claude Code 또는 Cursor로부터 가져올 수 있습니다.
OpenAI 문서는 가져오기 대상 범위를 나열합니다. 플러그인도 목록에 포함되어 있으며, AGENTS.md가 되는 지침 파일, config.toml로 매핑되는 settings.json, 스킬, MCP 서버 구성, 훅, 스킬이 되는 슬래시 명령, 서브 에이전트 등이 포함됩니다. Claude Code의 프로젝트 memory는 Codex memory로 이동하며, 지난 30일 동안의 채팅은 ChatGPT 채팅이 됩니다.
미리 안심할 수 있는 점은 "가져오기가 기존 에이전트 설정을 변경하거나 삭제하지 않는다"는 것입니다. Claude Code 플러그인은 현재 위치에 설치된 상태로 계속 작동합니다.
두 도구를 당분간 함께 사용할 계획이라면, 데스크톱 앱에서 가져온 작업을 동기화 상태로 유지할 수도 있습니다. OpenAI는 설정의 가져오기에서 자동 업데이트를 켜서 "가져온 작업을 원래 에이전트와 동기화 상태로 유지"하고 같은 위치에서 가져오기 기록을 검토할 수 있다고 설명합니다. 이는 Claude Code에서 계속 업데이트하는 플러그인의 경우 중요합니다. 일회성 가져오기만으로는 최신 상태를 유지할 수 없기 때문입니다.
Codex가 플러그인을 찾는 방법
플러그인의 경우, 문서는 감지 단계를 다음과 같이 설명합니다: ".claude/settings.json에서 플러그인을 감지할 때, Codex는 extraKnownMarketplaces에서 구성된 마켓플레이스 소스를 읽습니다."
공식 마켓플레이스에 대한 폴백(fallback)도 있습니다. enabledPlugins 목록에 claude-plugins-official의 플러그인이 포함되어 있지만 마켓플레이스 소스가 나열되지 않은 경우, Codex는 anthropics/claude-plugins-official을 소스로 추론합니다.
앱 서버 참조에 따르면, 플러그인 항목에 대해 Codex는 각 마켓플레이스 이름과 "마이그레이션을 시도할 수 있는" 플러그인 이름을 나열합니다. 이 표현에 주목할 필요가 있습니다. 감지는 Codex가 무엇을 시도할지 알려주는 것이지, 모든 플러그인이 변경 없이 작동한다는 의미는 아닙니다.
감지는 점진적으로 이루어집니다. OpenAI는 "아직 작업이 필요한 항목만 반환한다"고 명시합니다. 예를 들어, AGENTS.md가 이미 존재하고 비어 있지 않으면 Codex는 지침 파일 단계를 건너뛰며, 스킬 가져오기는 기존 스킬 디렉토리를 덮어쓰지 않습니다. 이미 Codex의 일부를 수동으로 설정했다면 가져오기가 이를 대체하지 않습니다.
Codex가 읽을 수 있는 플러그인 형식
Codex는 .codex-plugin/plugin.json에 매니페스트가 있는 자체 플러그인 형식을 가지고 있습니다. 또한 Claude 형식의 플러그인과 마켓플레이스도 읽을 수 있습니다.
가장 명확한 설명은 GitHub에서 플러그인을 가져오는 워크스페이스 관리자를 위한 OpenAI 가이드에 있습니다. 마켓플레이스 리포지토리는 다음 파일 중 하나를 포함해야 합니다:
.agents/plugins/marketplace.json: Codex 마켓플레이스.claude-plugin/marketplace.json:plugins배열이 있는 "Claude 호환 마켓플레이스".claude-plugin/plugin.json: "마켓플레이스 매니페스트가 없을 때의 독립형 Claude 플러그인"
동일한 가이드에서는 마켓플레이스 항목이 ".codex-plugin/plugin.json이 있는 네이티브 플러그인, Claude 호환 플러그인, Agent Plugins 1.0 패키지 또는 지원되는 스킬 패키지를 참조할 수 있다"고 언급합니다.
이 워크스페이스 가져오기는 ChatGPT 워크스페이스용 관리자 기능이며, 현재 GitHub 리포지토리만 지원합니다. 팀이 이미 GitHub에서 Claude Code 마켓플레이스를 관리하고 있다면, 관리자는 각 플러그인을 변환하는 대신 워크스페이스가 해당 리포지토리를 가리키도록 설정할 수 있습니다.
가져오기 후 후속 조치가 필요한 사항
가져오기는 첫 번째 단계일 뿐입니다. OpenAI 문서는 가져온 설정을 신뢰하기 전에 검토해야 할 사항을 나열하며, 플러그인도 여기에 포함됩니다. 목록에는 다음이 포함됩니다:
- 가져온 스킬 및 에이전트의 도구 제한 또는 권한
- 사용자 정의 인증, 헤더, 환경 변수 또는 전송 방식이 있는 MCP 서버 설정 (여기서 "다시 로그인해야 할 수도 있음")
- "가져오기 후 동작이 다를 수 있는 훅"
- "수동 후속 조치가 필요한 플러그인, 마켓플레이스 또는 기타 설정"
데스크톱 앱에서 가져오기는 "가져온 플러그인 또는 연결에 여전히 설정이 필요한지 확인"하고 설정 완료가 필요할 때 상태 카드를 표시합니다. '완료(Finish)'를 선택하면 남은 단계를 안내합니다.
워크스페이스 가져오기의 경우 또 다른 단계가 있습니다. 설치 및 인증 설정은 리포지토리에서 가져오지 않으며, "플러그인을 가져온다고 해서 멤버에게 앱 액세스 권한을 주거나 계정을 연결해주지는 않습니다." 각 사용자는 여전히 자신의 계정을 직접 연결해야 합니다.
Codex에서 플러그인 훅이 작동하는 방식
이번 마이그레이션에서 훅은 가장 많은 주의가 필요합니다. Codex는 여러분이 검토하기 전까지 훅을 실행하지 않기 때문입니다.
플러그인이 활성화되면 Codex는 사용자, 프로젝트 및 관리형 훅과 함께 해당 플러그인의 수명 주기 훅을 로드할 수 있습니다. 기본적으로 플러그인 루트 내부의 hooks/hooks.json을 찾습니다.
호환성을 위해 Codex는 플러그인 훅 명령에 Claude Code가 사용하는 것과 동일한 환경 변수를 제공합니다. OpenAI의 훅 문서에 따르면 "Codex는 기존 플러그인 훅과의 호환성을 위해 CLAUDE_PLUGIN_ROOT 및 CLAUDE_PLUGIN_DATA도 설정합니다." Codex 자체의 대응물인 PLUGIN_ROOT 및 PLUGIN_DATA는 설치된 플러그인 루트와 플러그인의 쓰기 가능한 데이터 디렉토리를 가리킵니다.
저장된 데이터에 대해 이것이 의미하는 바를 주목하십시오. Codex는 자체 PLUGIN_DATA와 함께 해당 변수를 직접 설정합니다. 가져오기 문서의 전송 항목 목록에는 플러그인 데이터 디렉토리가 포함되어 있지 않습니다. 플러그인이 Claude Code 쪽의 ~/.claude/plugins/data/<id>/에 유용한 것을 구축했다면, Codex에 그것이 있다고 가정하기 전에 플러그인에 필요한지 확인하십시오.
또 다른 차이점은 검토입니다. "플러그인 훅은 다른 훅과 동일한 이벤트 스키마를 사용합니다. 실행하기 전에 검토하고 신뢰하십시오." CLI에서는 /hooks로 검토합니다. 데스크톱 앱에서는 컴포저에서 'Review hooks'를 선택하거나 설정의 훅(Hooks)을 엽니다. 또한 "플러그인 업데이트로 번들 스크립트가 변경되면, 훅 정의가 그대로 유지되더라도 Codex는 새로운 검토를 요구합니다." 저희는 왜 Codex 훅 검토가 필요한가에 대한 가이드에서 검토 주기를 다룬 바 있습니다.
시작하기 전 확인 사항
- 보유 목록 작성. 사용자 및 프로젝트 범위의 Claude Code 설정 파일에서
enabledPlugins및extraKnownMarketplaces를 확인하십시오. - 민감한 구성 메모. 플러그인이 보안 저장소에 저장한 값은
settings.json에 없으므로 다시 입력할 계획을 세우십시오. - 데이터를 보관하는 플러그인 찾기. 플러그인이 의존하는 콘텐츠가 있는 디렉토리가 있는지
~/.claude/plugins/data/를 확인하십시오. - 훅 식별. 어떤 플러그인이 훅을 실행하는지 기록하여 Codex에서 무엇을 검토해야 할지 파악하십시오.
- 팀 플러그인과 개인 플러그인 분리. 팀 마켓플레이스는 관리자가 한 번에 처리하는 것이 더 나을 수 있습니다.
사람들이 흔히 하는 실수
모든 플러그인이 변경 없이 작동할 것이라 기대함. Codex는 마이그레이션을 시도할 수 있는 플러그인을 나열합니다. 일부는 수동 후속 조치가 필요합니다.
훅이 즉시 실행될 것이라 가정함. Codex는 플러그인 훅을 실행하기 전에 검토하고 신뢰할 것을 요구합니다.
비밀 정보(Secrets)를 잊어버림. 민감한 값은 Codex가 읽는 설정 파일이 아니라 보안 저장소에 보관됩니다.
팀 마켓플레이스 플러그인을 하나씩 재설치함. 워크스페이스 관리자가 GitHub에서 마켓플레이스 전체를 가져올 수 있습니다.
가져오기가 Claude Code에 영향을 줄 것이라 기대함. 기존 설정을 변경하거나 삭제하지 않습니다.
수동 마이그레이션
1단계: 플러그인 및 마켓플레이스 인벤토리 작성
활성화된 각 플러그인, 해당 마켓플레이스, 훅 보유 여부, 데이터 또는 민감한 설정 보관 여부를 기록합니다.
2단계: 가져오기 실행
ChatGPT 데스크톱 앱의 설정 > 가져오기를 사용하거나, 유휴 Codex CLI 세션에서 /import를 사용합니다. Claude Code 설정을 선택하고 원하는 플러그인을 고릅니다.
3단계: 설정 완료 및 로그인
데스크톱 앱의 상태 카드를 따르고, 필요한 MCP 서버에 로그인하며, 민감한 값을 다시 입력합니다.
4단계: 훅 검토 및 신뢰
CLI에서 /hooks를 열거나 데스크톱 앱에서 'Review hooks'를 열어 각 플러그인 훅을 읽고 실행하려는 훅을 신뢰함으로 표시합니다.
5단계: 익숙한 작업으로 각 플러그인 테스트
마이그레이션된 각 플러그인으로 잘 아는 작업을 실행하고, 결과를 Claude Code의 결과와 비교합니다.
더 나은 방법: 플러그인이 의존하는 컨텍스트를 한곳에 유지하기
플러그인은 스킬, 훅, 도구와 같은 절차를 담고 있습니다. 플러그인이 작동하는 대상은 컨벤션, 결정 사항, 제약 조건과 같은 프로젝트의 컨텍스트이며, 이는 두 도구 모두에서 동일해야 합니다.
MemoryLake는 결정 사항, 컨벤션 및 그 이면의 이유와 같은 프로젝트 컨텍스트를 위한 memory 계층입니다. 여러분이 직접 관리하는 한곳에 보관되며 ChatGPT, Claude Code, Codex 등 연결된 어시스턴트에서 사용할 수 있습니다.
항목은 여러분의 언어로 직접 작성합니다. Claude Code 플러그인, 데이터 디렉토리, 설정 파일, Codex 플러그인 또는 훅, AGENTS.md 파일 또는 어떤 벤더의 스토어에서도 데이터를 읽거나 쓰거나 삭제하지 않습니다. 플러그인 가져오기 및 훅 검토는 OpenAI와 Anthropic이 설명하는 방식 그대로 작동합니다.
1단계: API 키 생성
로그인 후 대시보드에서 키를 생성합니다. 플러그인 구성 파일이나 리포지토리에 노출되지 않도록 주의하십시오.

2단계: 첫 번째 memory 업로드
플러그인이 가정하는 사항부터 시작하십시오: 스킬이 강제하는 컨벤션, 훅 이면의 이유, 플러그인이 의존하는 프로젝트 결정 사항 등입니다. 항목당 하나의 컨벤션 또는 결정을 작성합니다.

3단계: AI 및 에이전트 연결
Claude Code와 Codex, 그리고 사용하는 ChatGPT 또는 기타 어시스턴트를 연결합니다. 두 코딩 도구 모두 병행해서 실행하는 동안 동일한 항목을 활용할 수 있습니다.

실제적인 변화
첫 번째 차이점은 모든 플러그인이 완벽하게 이동하는 것에 의존하지 않는 마이그레이션입니다. 설정 이면의 컨텍스트는 이미 기록되어 있습니다.
두 번째는 두 도구를 사용하는 동안의 일관성입니다. 업데이트한 컨벤션은 편집한 도구뿐만 아니라 Claude Code와 Codex에 동시에 적용됩니다.
세 번째는 더 명확한 검토입니다. Codex에서 플러그인의 훅을 읽을 때, 기록해 둔 해당 훅의 존재 이유와 대조하여 확인할 수 있습니다.
Claude Code에서 Codex로 플러그인을 이동하기 위한 모범 사례
먼저 인벤토리를 작성하십시오. 어떤 플러그인, 마켓플레이스, 훅, 저장된 데이터를 보유하고 있는지 파악하십시오.
가져오기 기능을 사용하십시오. 설정에서 플러그인을 감지하며 Claude Code 설정을 변경하지 않습니다.
감지 결과를 검증 목록으로 취급하십시오. Codex는 마이그레이션을 시도할 수 있는 플러그인을 나열합니다.
훅을 신중하게 검토하십시오. 이해하는 것만 신뢰하고, 플러그인 업데이트 후에는 새로운 검토가 필요함을 인지하십시오.
비밀 정보를 다시 입력하십시오. 민감한 설정은 가져오기가 읽는 파일에 포함되어 있지 않습니다.
팀 마켓플레이스는 관리자에게 맡기십시오. GitHub의 Claude 호환 마켓플레이스를 워크스페이스로 가져올 수 있습니다.
공유 컨텍스트를 두 도구 외부에 두십시오. 플러그인은 이동하지만, 그 이면의 이유는 한곳에 머물러야 합니다.
결론
Codex는 Claude Code 플러그인을 가져올 수 있습니다. 가져오기 기능은 Claude Code 설정에서 enabledPlugins 및 extraKnownMarketplaces를 읽고, 공식 마켓플레이스를 추론하며, 마이그레이션을 시도할 수 있는 플러그인을 나열합니다. Codex는 Claude 형식의 플러그인과 마켓플레이스를 읽으며, 기존 플러그인 훅이 실행될 수 있도록 CLAUDE_PLUGIN_ROOT 및 CLAUDE_PLUGIN_DATA를 설정합니다.
여전히 사용자의 조치가 필요한 사항: 훅은 실행 전 검토 및 신뢰를 거쳐야 하며, 민감한 설정과 로그인은 다시 수행해야 하고, 플러그인 데이터 디렉토리는 가져오기 대상에 포함되지 않습니다. 이 사항들을 각각 확인하고, 익숙한 작업으로 각 플러그인을 테스트하며, 플러그인이 작동하는 프로젝트 컨텍스트를 두 도구 모두 사용할 수 있는 곳에 보관하십시오.