Codex CLI 설치되지 않음, 앱 업데이트 뒤 링크부터 확인하기

Codex CLI 설치되지 않음 표시가 앱 업데이트 뒤 나오면 전체 재설치 전에 command -v codex와 readlink로 현재 명령이 가리키는 실제 파일부터 확인하세요. 명령 링크만 예전 앱 경로를 가리키고 실제 CLI는 새 bundle 진입점에 남아 있을 수 있습니다.

먼저 현재 codex 명령의 출처를 확인합니다

터미널에서 먼저 PATH가 찾은 명령을 저장합니다.

codex_path="$(command -v codex || true)"
printf 'PATH codex: %s\n' "${codex_path:-not found}"

if [ -n "$codex_path" ]; then
  ls -l "$codex_path"
  readlink "$codex_path" || true
fi

command -v가 아무것도 찾지 못하면 끊어진 링크가 PATH 디렉터리에 남아 있어도 결과가 비어 있을 수 있습니다. 이때 빈 값에 readlink를 실행하지 말고, Mac에서 흔히 쓰는 두 명령 위치에 링크 자체가 남아 있는지 읽기 전용으로 확인합니다.

for candidate in /opt/homebrew/bin/codex /usr/local/bin/codex; do
  if [ -e "$candidate" ] || [ -L "$candidate" ]; then
    ls -l "$candidate"
    readlink "$candidate" || true
  fi
done

ls -l에서 codex -> 대상경로가 보이는데 대상이 없으면 dangling symlink 후보입니다. readlink 결과가 없다고 무조건 오류는 아닙니다. 일반 실행 파일이나 스크립트일 수도 있습니다.

/opt/homebrew/bin/codex라는 위치만 보고 앱이 만든 링크나 Homebrew 설치라고 단정하지 마세요. 현재 Mac의 정상 대조에서는 이 경로가 별도 npm 패키지의 JavaScript 실행 파일을 가리켰습니다.

설치 출처 자체가 불분명하면 Codex CLI 경고를 설치·설정·업데이트로 나누는 방법부터 확인하면 다른 종류의 경고를 이번 링크 문제로 오인하는 일을 줄일 수 있습니다.

앱 버전과 링크 대상을 함께 봅니다

공개 보고의 실패 조건은 macOS Apple Silicon, Codex Desktop 26.924.20706입니다. 기존 링크는 다음 예전 앱 경로를 가리켰지만 업데이트 뒤 대상 파일이 사라졌습니다.

/Applications/ChatGPT.app/Contents/Resources/codex

같은 앱 bundle에는 새 packaged entry가 남아 있었습니다.

/Applications/ChatGPT.app/Contents/Resources/codex-cli/bin/codex

작성자는 새 진입점을 직접 실행했을 때 codex-cli 0.158.0-alpha.2가 출력됐다고 기록했습니다. 즉, “CLI 전체 삭제”와 “PATH 링크의 대상만 사라짐”을 나눌 수 있었습니다.

현재 Mac에서 같은 두 entry의 존재와 실행 가능 여부만 안전하게 확인하려면 아래처럼 검사합니다. 경로가 실행 가능할 때만 --version을 호출합니다.

for entry in \
  /Applications/ChatGPT.app/Contents/Resources/codex \
  /Applications/ChatGPT.app/Contents/Resources/codex-cli/bin/codex; do
  if [ -x "$entry" ]; then
    printf 'executable: %s\n' "$entry"
    "$entry" --version
  else
    printf 'not executable or absent: %s\n' "$entry"
  fi
done

재설치 전에 세 가지 결과를 적습니다

확인 항목	결과	다음 판정
command -v codex	없음	PATH 또는 설치 출처 확인
링크 대상	경로는 있으나 대상 파일 없음	앱 업데이트 전 경로가 남았는지 확인
앱 bundle의 선언된 entry	존재하고 --version 성공	CLI 삭제보다 링크 발견 문제 가능성

세 번째 결과가 성공해도 앱 프로젝트의 빨간 상태가 즉시 풀렸다는 뜻은 아닙니다. 공개 이슈도 터미널 명령과 버전 실행은 확인했지만 sidebar badge 갱신은 독립 검증하지 않았습니다.

바로 링크를 바꾸기 전에 멈출 조건

공개 이슈의 경로를 모든 Mac에 그대로 복사하지 마세요. 다음 중 하나라도 다르면 먼저 설치 출처별 절차를 확인합니다.

• 앱 버전이 26.924.20706과 다릅니다.
• PATH의 codex가 npm 또는 Homebrew의 실제 설치 파일을 가리킵니다.
• 새 codex-cli/bin/codex 진입점이 없거나 실행되지 않습니다.
• 오류가 CLI 미설치가 아니라 인증, daemon, sandbox 오류입니다.

앱 bundle 내부 파일을 밖으로 복사하거나 추정한 경로로 링크를 덮어쓰면 다음 앱 업데이트에서 다시 끊길 수 있습니다. 먼저 현재 링크와 앱 manifest의 진입점을 보존하고, 공식 지원 설치 또는 후속 수정 여부를 확인해야 합니다.

별도 CLI를 다시 설치하기로 했다면 OpenAI 공식 문서가 안내하는 npm 설치 뒤 codex --version 확인 순서를 따르세요. 이 공식 설치 안내는 별도 CLI 설치 방법의 근거이며, Desktop 26.924.20706의 링크 문제를 공식적으로 확인하거나 고치는 문서는 아닙니다. 설치 뒤에도 다른 오류가 남으면 Codex CLI 세션 삭제 범위처럼 증상별 담당 글로 분리해 확인해야 합니다.

자주 묻는 질문

command -v codex가 나오면 설치는 정상인가요?

아닙니다. 심볼릭 링크 경로만 존재하고 목적지 파일이 사라진 경우도 있습니다. readlink와 대상 파일 존재를 함께 확인해야 합니다.

앱을 다시 설치하면 해결되나요?

공개 사례는 앱 파일 전체가 없는 문제가 아니라 기존 PATH 링크가 예전 bundle 진입점을 가리킨 경우였습니다. 재설치 전에 명령 출처와 링크 대상을 확인하면 불필요한 초기화를 피할 수 있습니다.

npm으로 설치한 Codex도 같은 문제인가요?

PATH가 npm 패키지의 실제 실행 파일을 가리킨다면 앱 bundle 링크 문제와 별개입니다. 설치 출처와 정확 오류 문구를 기준으로 다른 경로를 진단하세요.

검증 기준

• 마지막 업데이트일: 2026-09-26
• 확인 환경: macOS arm64, Desktop 26.803.81509·별도 npm Codex CLI 0.156.1의 정상 대조와 공개 Desktop 26.924.20706 실패 보고
• 공개 환경: Apple Silicon Mac 3대, Codex Desktop 26.924.20706, bundled CLI 0.158.0-alpha.2
• 로컬 대조: macOS arm64, Desktop 26.803.81509, 별도 npm Codex CLI 0.156.1
• 미확인: 전체 영향 범위, 링크 생성 주체, 공식 지원 복구 경로, 정확 검색량, sidebar badge 복구
• 주요 근거: OpenAI Codex 공개 이슈 #48214
• 공식 설치 대조: OpenAI Developers의 Codex 설치·버전 확인 예시