Codex plugin list에 app 식별자만 보일 때 확인할 것

Codex plugin list에 github나 notion 같은 이름과 app-6a… 같은 긴 식별자가 함께 보여도, 전체 플러그인 목록이 망가졌다고 단정할 수는 없습니다. 현재 확인한 Codex CLI 0.156.1에서는 같은 원격 marketplace 안에 읽을 수 있는 이름과 불투명한 ID가 함께 나왔습니다. 먼저 CLI 버전과 해당 행의 STATUS, VERSION, SOURCE를 확인하세요. 이름이 확인되지 않은 app-… 값을 실제 서비스 이름으로 추측해 설치하지 마세요.

어디에서 확인하나요?

이 확인은 웹 설정이 아니라 macOS 또는 Linux의 터미널에서 합니다. Codex CLI가 이미 설치되어 있어야 합니다.

codex --version
codex plugin list

첫 명령에서 버전이 나오고, 두 번째 명령에서 Marketplace 'openai-curated-remote' 구간이 나오면 목록을 읽을 수 있는 상태입니다. command not found가 나오면 표시 이름 문제가 아니라 CLI 실행 경로부터 확인해야 합니다. 로그인이나 원격 catalog 오류가 따로 나오면 그 오류도 이름 표시 문제와 분리합니다.

세 열을 먼저 봅니다

목록의 한 행에는 이름 외에도 다음 정보가 있습니다.

열	알 수 있는 것	알 수 없는 것
STATUS	설치 여부와 활성 상태	서비스가 안전하거나 내 계정에 적합한지
VERSION	catalog가 제시한 버전	문제의 수정 버전인지
SOURCE	connector·App SDK 같은 원본 식별자	사람이 읽는 정식 서비스 이름

2026년 9월 26일 macOS arm64의 Codex CLI 0.156.1에서 같은 출력의 openai-curated-remote 구간을 집계했을 때 app-<hex> 형식과 읽을 수 있는 slug 형식이 함께 있었습니다. 이는 “목록 전체가 비었다”거나 “모든 플러그인이 손상됐다”는 결과와 다릅니다.

github@openai-curated-remote          not installed
notion@openai-curated-remote          not installed
app-6a314a…@openai-curated-remote     not installed

위 예시는 열을 읽는 방법을 보여 주기 위해 길이를 줄였습니다. 실제 설치 명령에는 줄인 ID를 쓰면 안 됩니다.

app ID를 이름으로 추측해도 되나요?

권하지 않습니다. 공개 이슈에는 일부 ID가 공개 플러그인 페이지의 이름과 대응한다고 적혀 있지만, 현재 CLI 행 하나만으로 그 매핑을 확정할 수는 없습니다. 검색 결과에서 비슷한 ID를 찾았다는 이유만으로 설치 대상을 정하면 다른 앱을 고를 수 있습니다.

설치할 대상이 정해져 있다면 다음 순서가 안전합니다.

1. 목록에서 사람이 읽을 수 있는 정확한 plugin-name@marketplace-name을 찾습니다.
2. 공식 플러그인 화면이나 관리자가 준 정확한 이름과 대조합니다.
3. 이름이 일치할 때만 codex plugin add의 현재 도움말을 확인합니다.
4. 불투명 app-… 행밖에 없다면 설치를 보류하고 catalog 표시 이름이 확인될 때까지 기다립니다.

로컬 marketplace를 확인하는 명령은 다음과 같습니다.

codex plugin marketplace list

OpenAI 공식 문서는 이 명령이 Codex가 고려하는 marketplace와 해석된 root를 보여 준다고 설명합니다. 다만 이 명령이 원격 catalog의 불투명 이름을 사람이 읽는 이름으로 바꿔 준다는 뜻은 아닙니다.

MCP 서버가 설치됐는데 도구가 비어 보이는 별개 문제라면 Codex MCP enabled_tools가 비어 있을 때 확인하는 순서로 넘어가세요. 현재 글의 카탈로그 표시 이름과는 다른 문제입니다.

지우거나 다시 설치해야 하나요?

이 현상만으로는 그럴 근거가 없습니다. 아직 설치하지 않은 원격 항목에도 app-…가 보였기 때문에, 로컬 캐시 삭제나 기존 플러그인 제거부터 할 이유는 확인되지 않았습니다. 특히 remove는 실제 설치 상태를 바꾸므로 이름 표시 문제의 첫 진단으로 쓰지 않습니다.

다음처럼 분기하면 됩니다.

• 목록이 나오고 named/opaque 항목이 섞임: 표시 이름 문제로 보고 확인된 slug만 사용
• 목록 전체가 비거나 원격 오류가 명시됨: 인증·네트워크·marketplace 연결을 별도 진단
• 설치된 플러그인의 상태가 disabled/error임: 해당 플러그인의 설정과 연결을 별도 진단

목록 이름 외에 여러 검사가 경고를 낸다면 codex doctor warning을 개별 항목과 실제 기능으로 나누는 방법을 함께 보세요. 경고 하나를 전체 플러그인 고장으로 확대하지 않는 데 도움이 됩니다.

확인 범위

• 직접 확인: macOS arm64, Codex CLI 0.156.1, 2026-09-26의 codex plugin list 혼합 출력
• 공개 질문: openai/codex #48355의 Linux 보고
• 공식 근거: OpenAI Plugins 문서의 marketplace·manifest·displayName 설명
• 미확인: 정확한 회귀 시작 버전, 각 app-… ID의 정식 이름, 서버와 CLI 중 이름이 사라지는 단계, 수정 버전, 정확 검색량

이 글은 공개 이슈를 공식 원인 발표로 취급하지 않습니다. 해결 버전이 확인되기 전에는 “업데이트하면 고쳐진다”고 단정하지 않습니다.

자주 묻는 질문

app ID가 보이면 해킹된 플러그인인가요?

현재 확인한 혼합 목록만으로는 보안 침해·안전성·위조·손상 여부를 판정할 수 없습니다. 정확한 이름이 확인되지 않으면 설치를 보류하세요.

plugin marketplace list를 실행하면 app ID의 이름을 알 수 있나요?

공식 문서가 확인하는 범위는 marketplace와 해석된 root입니다. 원격 catalog의 불투명 ID를 서비스 이름으로 변환해 준다는 근거는 확인하지 못했습니다.

검증 기준

• 마지막 업데이트일: 2026-09-26
• 확인 환경: macOS arm64, Codex CLI 0.156.1
• 주요 근거: OpenAI 공식 Plugins 패키지 문서, openai/codex 공개 이슈 #48355
• 재확인 조건: OpenAI 공식 문서에 codex plugin list 이름 해석 규칙이 추가되거나, 공개 이슈에 확정 수정 버전이 기록되면 원인·해결 범위를 다시 판정합니다.