AI 해결 노트 · 2026-09-17 · 실측 2026-09-17
Codex CLI 버전 확인과 업데이트 — npm update로는 0.153에서 0.154로 안 넘어간 실측
한 줄로
지금 버전은 codex --version, 최신 버전은 npm view @openai/codex version으로 봅니다. 올릴 때는 @latest를 붙여 설치하세요. 임시 폴더에서 0.153.0을 깔고 npm update를 돌렸더니 0.153.4까지만 올라갔고, @latest 설치는 0.154.0으로 올라갔습니다.
이런 분께
- codex가 최신인지 모르겠는 분
npm update를 돌렸는데 버전이 기대만큼 안 오른 분codex update라는 명령이 있는지 궁금한 분
실측 환경
| 항목 | 값 |
|---|---|
| OS | Windows 11 Home (10.0.26200) |
| 셸 | Git Bash |
| node / npm | v24.19.0 / 11.17.0 |
| 설치된 codex | codex-cli 0.153.4 (전역, C:\Users\User\AppData\Roaming\npm) |
npm 최신(latest) | 0.154.0 |
| 시험 방법 | 임시 폴더에 npm install --prefix로 설치. 전역 codex는 건드리지 않음 |
1. 지금 버전과 설치 위치 확인
codex --version
npm ls -g @openai/codexcodex-cli 0.153.4
C:\Users\User\AppData\Roaming\npm
`-- @openai/codex@0.153.4codex --version은 codex-cli 뒤에 버전을 찍습니다. npm ls -g는 어느 전역 폴더에 어떤 버전이 들어 있는지까지 보여 줍니다. 윈도우에서 where.exe codex를 치면 같은 폴더의 codex와 codex.cmd 두 개가 나왔습니다.
2. 최신 버전 확인
패키지 이름은 @openai/codex입니다.
npm view @openai/codex name version dist-tags --json{
"name": "@openai/codex",
"version": "0.154.0",
"dist-tags": {
...
"latest": "0.154.0",
...
"alpha": "0.155.0-alpha.16",
...
}
}(가운데는 줄였습니다. 원본에는 플랫폼별 태그가 더 있습니다.)
npm view @openai/codex versions는 이날 4,547개를 돌려줬고, 그중 x.y.z 형태는 186개였습니다. 출력 목록 끝부분에는 alpha와 플랫폼별 버전이 이어졌습니다. 최근 것은 이렇습니다.
0.152.0 0.152.1 0.153.0 0.153.1 0.153.2 0.153.3 0.153.4 0.154.0codex 자체도 새 버전을 알려 줍니다. codex doctor --summary 첫 부분에 이 줄이 있었습니다.
[up] updates 0.154.0 available (current 0.153.4)3. 임시 폴더에서 업데이트를 재현
전역 codex를 바꾸지 않으려고 %TEMP%\longtail_B 아래에 일부러 옛 버전 0.153.0을 깔았습니다.
npm install --prefix "C:\Users\User\AppData\Local\Temp\longtail_B\prefix" @openai/codex@0.153.0
npm outdated --prefix "C:\Users\User\AppData\Local\Temp\longtail_B\prefix"Package Current Wanted Latest Location Depended by
@openai/codex 0.153.0 0.153.4 0.154.0 node_modules/@openai/codex prefixWanted와 Latest가 다릅니다. 같은 방식으로 만든 두 번째 폴더의 package.json에는 "^0.153.0"이 기록돼 있었습니다. npm은 이 범위의 목표(Wanted)를 0.153.4로 보고, 0.154.0은 범위 밖으로 둔 것입니다.
두 번째 임시 폴더에서 실제로 npm update를 돌려 봤습니다.
npm update --prefix "...\longtail_B\prefix2"
npm ls --prefix "...\longtail_B\prefix2"changed 2 packages, and audited 3 packages in 7s
...
`-- @openai/codex@0.153.4"^0.153.0"이 적힌 이 폴더에서 npm update를 돌린 결과 0.153.4가 설치됐고, 실행 결과도 codex-cli 0.153.4였습니다. 최신 0.154.0에는 닿지 않았습니다.
첫 번째 폴더에서는 @latest를 붙여 다시 설치했습니다.
npm install --prefix "...\longtail_B\prefix" @openai/codex@latestchanged 2 packages, and audited 3 packages in 8s
found 0 vulnerabilities`-- @openai/codex@0.154.0
codex-cli 0.154.0package.json은 "^0.154.0"으로 바뀌었고, 다시 돌린 npm outdated는 아무것도 출력하지 않았습니다.
전역 설치를 쓰는 경우라면 같은 원리로 아래 명령이 됩니다. 이 명령은 이번에 돌리지 않았습니다.
npm install -g @openai/codex@latest4. codex update 명령
codex --help 목록에 이 줄이 있습니다.
update Update Codex to the latest versioncodex update --help에는 -c, --enable, --disable, -h 공통 옵션만 있고, 무엇을 어떻게 바꾸는지는 적혀 있지 않았습니다. 전역 설치를 건드릴 수 있어서 이 명령은 실행하지 않았습니다.
결과
| 순서 | 한 일 | 결과 버전 |
|---|---|---|
| 1 | 전역 codex --version | 0.153.4 |
| 2 | 임시 폴더에 @openai/codex@0.153.0 설치 | 0.153.0 |
| 3 | 첫 번째 임시 폴더에서 @openai/codex@latest 설치 | 0.154.0 |
| 4 | 두 번째 임시 폴더(0.153.0)에서 npm update | 0.153.4 |
| 5 | 끝난 뒤 전역 codex --version | 0.153.4 (그대로) |
설치 한 번에 7~8초가 걸렸습니다. 임시 폴더 longtail_B는 마지막에 지웠습니다.
실패한 것
npm update는 0.154.0까지 올리지 못했습니다. 오류는 아니고,npm outdated가 보여 준Wanted(0.153.4)까지 올라간 결과입니다.npm outdated는 올릴 것이 있을 때 종료 코드 1을 냈습니다. 스크립트에서 이 명령을 쓰면 실패로 읽힐 수 있습니다.
확인하지 않은 것
codex update를 실제로 돌렸을 때의 동작(무엇을 설치하는지, npm을 부르는지)은 확인하지 않았습니다.- 전역
npm install -g @openai/codex@latest는 실행하지 않았습니다. 전역 폴더 권한이나 실행 중인 codex 파일 잠금 같은 문제는 재지 않았습니다. - 첫 번째 임시 폴더의 설치 직후
package.json은 따로 찍지 않았습니다."^0.153.0"은 같은 명령으로 만든 두 번째 폴더에서 본 값입니다. - alpha 버전 설치와 맥·리눅스는 확인하지 않았습니다. 명령 프롬프트(cmd.exe)로는 임시 설치본의 버전 출력만 봤고, cmd.exe에서 설치·업데이트하는 과정은 확인하지 않았습니다.
codex doctor가 새 버전을 어디서 알아오는지는 확인하지 않았습니다.