개발
2026.10.06 · 4분
WSL 에서 Codex CLI 를 업데이트했는데 새 모델이 보이지 않으면 먼저 지금 실행되는 codex 가 어느 것인지 확인한다. 내 경우 원인은 세 겹이었다. 공식이 아닌 snap 패키지가 3월 버전(0.114.0)에 멈춰 있었다. npm 전역 패키지는 nvm 의 node 버전마다 따로 깔려 있었다. 업데이트 중인 설치가 끝나기 전에 실행하기도 했다. 해결은 공식 방법으로 다시 깔고 설치가 끝날 때까지 기다린 뒤 snap 판을 지우는 것이다.
Codex 를 열었는데 새로 나온 모델을 고를 수 없었다. OpenAI 의 Codex changelog 는 새 모델 공지마다 같은 안내를 붙인다. 2026-04-23 GPT-5.5 공지의 문장은 이렇다.
If you don’t see GPT-5.5 yet, update the CLI, IDE extension, or Codex app to the latest version.
모델마다 「최소 몇 버전」이 정해져 있다는 문장은 찾지 못했다. 공지는 늘 「최신으로 올려라」라고만 쓴다. 그러니 새 모델이 안 보이면 버전부터 의심하는 게 순서다.
codex --version
# codex-cli 0.114.0
2026-10-06 기준 npm 최신은 0.160.1 이었다. 반년 넘게 뒤처져 있었다.
type -a 로 같은 이름의 명령을 전부 본다. which 하나로는 맨 앞의 것만 보여서 뒤에 숨은 설치를 놓친다.
type -a codex
which -a codex
내 기계에서는 이랬다.
/snap/bin/codex → snap 패키지 codex, 0.114.0@openai/codex, 0.128.0@openai/codex, 0.160.1. 그런데 bin/codex 링크가 없었다실제로 실행되던 것은 맨 위의 snap 판이었다.
stable 채널이 멈춰 있어서다. snap refresh 는 지금 따라가는 채널에 새 버전이 있을 때만 받는다. Snap 문서의 문장이다.
The above will check the channel being tracked by the snap. If a newer version of the snap is available, it will be downloaded and installed.
snap info codex 를 보면 stable 채널은 2026-03-14 의 0.114.0 이었다. edge 채널은 9월 말에도 갱신됐지만 기본으로 따라가는 stable 이 멈춰 있으니 snap refresh 는 「최신 상태」라고만 답한다.
더 중요한 건 게시자다. snap 스토어의 codex 게시자는 jcat (jcat-nysasounds) 로, OpenAI 가 아니다. 이름 옆에 확인된 게시자 표시(✓)도 없다. Snap 문서는 그 표시를 이렇게 설명한다.
The ✓ alongside videolan in the above output indicates that the snap publisher has been verified.
설명 문구가 OpenAI 소개 문장을 그대로 써서 공식처럼 보이지만 OpenAI 의 설치 문서에는 snap 이 아예 나오지 않는다.
[의견] 공식 설치 경로가 아닌 패키지로 코딩 에이전트를 돌리는 것은 업데이트가 늦는 것보다 신뢰 쪽이 더 걸린다. 지우는 편이 낫다.
sudo snap remove codex
nvm 을 쓰면 전역 npm 패키지가 node 버전마다 따로 깔린다. nvm README 의 설명이다.
NVM_BIN - where node, npm, and global packages for the active version of node are installed.
예전에 node v20 을 쓸 때 npm install -g @openai/codex 를 했다면, 그 Codex 는 v20 아래에만 있다. 나중에 기본 node 를 v24 로 바꾸면 v24 에는 Codex 가 없다. PATH 에서 nvm 다음 순서로 /snap/bin 이 오면, 그 빈자리를 snap 판이 차지한다.
node 를 올릴 때 전역 패키지를 함께 옮기는 방법도 README 에 있다.
If you want to install a new version of Node.js and migrate npm packages from a previous version:
nvm install --reinstall-packages-from=<예전 버전> <새 버전>
이미 버전을 바꾼 뒤라면, 지금 쓰는 node 에서 Codex 를 다시 깔면 된다.
Missing optional dependency 오류가 난다. 2026-10-06 에 npm install -g @openai/codex@latest 를 돌리는 동안 실행해 보니 이렇게 나왔다.
Error: Missing optional dependency @openai/codex-linux-x64. Reinstall Codex: npm install -g @openai/codex@latest
npm 의 @openai/codex 는 껍데기다. 실제 실행 파일은 @openai/codex-linux-x64 라는 플랫폼별 패키지에 따로 들어 있고 이번에 받은 크기가 300MB 를 넘었다. 이 기계에서는 15:20:54 에 시작한 설치가 15:25 무렵 끝났다. 그사이에는 패키지 폴더는 있는데 실행 파일과 bin/codex 링크가 아직 없다.
오류 문구가 「다시 설치하라」고 하지만 그 전에 설치가 아직 돌고 있는지부터 본다. 다시 깔기 시작하면 받던 것을 처음부터 다시 받는다.
ps -eo pid,etime,args | grep "npm install" | grep -v grep
이 줄이 비고 npm 이 ok 로 끝난 뒤에 새 터미널을 열어 확인한다.
OpenAI 문서가 먼저 권하는 것은 npm 이 아니라 설치 스크립트다. Codex CLI 문서의 문장이다.
Install the Codex CLI with the standalone installer for macOS and Linux.
curl -fsSL https://chatgpt.com/codex/install.sh | sh
업데이트도 같은 스크립트를 다시 돌리는 방식이다. npm 을 쓰고 싶으면 README 의 명령을 쓴다.
npm install -g @openai/codex
어느 쪽이든 한 가지 방법만 쓴다. 스크립트·npm·snap 이 섞이면, 이번처럼 무엇이 실행되는지 PATH 순서가 정한다.
snap 판이 멈춘 0.114 는 WSL1 을 지원한 마지막 버전이기도 하다. OpenAI 의 WSL 문서가 이렇게 적는다.
WSL1 was supported through Codex 0.114. Starting in Codex 0.115, the Linux sandbox moved to bubblewrap, so WSL1 is no longer supported.
PowerShell 에서 wsl -l -v 로 버전을 확인한다. 1 이면 WSL2 로 옮긴 뒤에 올려야, 업데이트하고 나서 Codex 가 아예 안 도는 일을 피한다. 내 기계는 WSL2 였다.
type -a codex
codex --version
새 터미널에서 첫 줄이 쓰려는 설치(스크립트 또는 지금 node 의 npm)이고 버전이 최신이면 된다. 내 경우 로그인 셸에서는 0.160.1 이 잡혔다.
그런데 nvm 이 없는 환경에서는 아직 snap 판이 잡혔다. PATH 를 /usr/bin:/bin:/snap/bin 으로만 주고 실행하니 0.114.0 이었다. cron 처럼 셸 설정을 읽지 않는 곳에서 codex 를 부르면 옛 버전이 돈다는 뜻이다. snap 판을 지워야 이 갈림이 없어진다.
type -a codex 로 실행되는 설치를 전부 본다./snap/bin/codex)은 공식이 아니고 stable 채널이 멈춰 있다. sudo snap remove codex 로 지운다.Missing optional dependency 는 끝날 때까지 기다린다.이 글은 AI 가 조사·초안을 작성하고 사람이 검수한 뒤 발행했습니다. 사실관계는 아래 출처에서 확인할 수 있습니다.