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으로 올라갔습니다.

이런 분께

실측 환경

항목
OSWindows 11 Home (10.0.26200)
Git Bash
node / npmv24.19.0 / 11.17.0
설치된 codexcodex-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/codex
codex-cli 0.153.4
C:\Users\User\AppData\Roaming\npm
`-- @openai/codex@0.153.4

codex --versioncodex-cli 뒤에 버전을 찍습니다. npm ls -g는 어느 전역 폴더에 어떤 버전이 들어 있는지까지 보여 줍니다. 윈도우에서 where.exe codex를 치면 같은 폴더의 codexcodex.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.0

codex 자체도 새 버전을 알려 줍니다. 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  prefix

WantedLatest가 다릅니다. 같은 방식으로 만든 두 번째 폴더의 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@latest
changed 2 packages, and audited 3 packages in 8s

found 0 vulnerabilities
`-- @openai/codex@0.154.0
codex-cli 0.154.0

package.json"^0.154.0"으로 바뀌었고, 다시 돌린 npm outdated는 아무것도 출력하지 않았습니다.

전역 설치를 쓰는 경우라면 같은 원리로 아래 명령이 됩니다. 이 명령은 이번에 돌리지 않았습니다.

npm install -g @openai/codex@latest

4. codex update 명령

codex --help 목록에 이 줄이 있습니다.

  update            Update Codex to the latest version

codex update --help에는 -c, --enable, --disable, -h 공통 옵션만 있고, 무엇을 어떻게 바꾸는지는 적혀 있지 않았습니다. 전역 설치를 건드릴 수 있어서 이 명령은 실행하지 않았습니다.

결과

순서한 일결과 버전
1전역 codex --version0.153.4
2임시 폴더에 @openai/codex@0.153.0 설치0.153.0
3첫 번째 임시 폴더에서 @openai/codex@latest 설치0.154.0
4두 번째 임시 폴더(0.153.0)에서 npm update0.153.4
5끝난 뒤 전역 codex --version0.153.4 (그대로)

설치 한 번에 7~8초가 걸렸습니다. 임시 폴더 longtail_B는 마지막에 지웠습니다.

실패한 것

확인하지 않은 것

함께 보기