Codex のバージョン更新方法と最新版を確認するコマンド

Codex が頻繁にアップデートされる理由

OpenAI Codex は 2025 年 5 月のパブリックリリース以降、継続的に更新が公開されている。GitHub の openai/codex リポジトリの Releases ページを参照すると、各バージョンがどのような変更を含むかを一覧で確認できる。

バグ修正とエラー対応の積み重ね

v0.141 から v0.142 へのアップデートでは、サンドボックス実行環境の安定性向上とコンテキスト圧縮アルゴリズムの改善が含まれた。古いバージョンを使い続けると、すでに修正された 429 Too Many Requests の処理ミスや AGENTS.md 読み込みの不具合が再発することがある。アップデートはこうした既知の問題を一掃する最短の手段だ。

対応モデルの追加と新機能へのアクセス

Codex が利用できるモデル一覧はバージョンによって異なる。v0.141 以降では GPT-5.3 のサポートが追加され、codex --model gpt-5.3 の指定が有効になった。最新モデルを使うには、それに対応したバージョンの Codex CLI が必要になる。OpenAI の公式モデル一覧でも各モデルの提供状況を確認できる。

現在インストールされているバージョンを確認する

Step 1: バージョン番号を表示する

ターミナルで以下を実行する。

codex --version

出力例:

0.142.2

バージョンが表示されない場合、Codex がインストールされていないか、PATH に npm グローバルディレクトリが含まれていない。

Step 2: npm でインストール状態を確認する

npm list -g @openai/codex

@openai/codex@0.142.2 のように表示されればインストール済みだ。empty と表示される場合はインストールされていない。

Codex を最新版に更新する

Step 1: 最新バージョンが存在するか確認する

npm outdated -g @openai/codex

更新が必要な場合、現在のバージョン（Current）と最新バージョン（Latest）が並んで表示される。

Package             Current  Wanted   Latest   Location
@openai/codex       0.141.0  0.142.2  0.142.2  global

何も表示されなければ、すでに最新版がインストールされている。

Step 2: 更新コマンドを実行する

npm update -g @openai/codex

npm update は package.json の semver 範囲内の更新を適用する。確実に最新版を取得したい場合は @latest を指定して再インストールする。

npm install -g @openai/codex@latest

npm 公式レジストリの @openai/codex ページでは、現時点での最新バージョンをすぐに確認できる。

Step 3: 更新後にバージョンを再確認する

codex --version

最新バージョン番号が表示されれば更新成功だ。

npx 経由で常に最新版を実行する方法

グローバルインストールを避けたい場合、npx を使えばインストール不要で常に最新版を実行できる。

npx @openai/codex@latest --help

ただし毎回ダウンロードが発生するため、頻繁に使う環境ではグローバルインストールの方が実用的だ。試しに使ってみたい場合やバージョンを切り替えてテストしたい場合に有効な手段となる。

macOS・Linux での権限エラー（EACCES）を解消する

npm install -g が EACCES permission denied で失敗する場合、npm のグローバルディレクトリの所有者が root になっているケースが多い。sudo を使って回避することもできるが、npm の公式ドキュメントでは別のアプローチを推奨している。

Step 1: npm グローバルディレクトリを確認する

npm config get prefix

出力が /usr/local や /usr の場合、一般ユーザーには書き込み権限がない。

Step 2: グローバルディレクトリをホーム配下に変更する

npm config set prefix ~/.npm-global

~/.bashrc または ~/.zshrc に以下を追記する。

export PATH=~/.npm-global/bin:$PATH

ターミナルを再起動またはシェルを再読み込みした後、再度インストールコマンドを実行する。

npm install -g @openai/codex@latest

Windows 環境での更新手順

Windows では PowerShell またはコマンドプロンプトを管理者として実行したうえで、同じ npm コマンドを使う。

npm install -g @openai/codex@latest

Node.js を winget や nvm-windows でインストールしている場合、PATH の競合が起きることがある。where codex コマンドで実行されているバイナリのパスを確認し、意図しないバージョンが使われていないかを確かめる。

更新が反映されない場合の対処

キャッシュをクリアして再インストールする

npm のキャッシュが原因で古いパッケージが使われ続けることがある。

npm cache clean --force
npm install -g @openai/codex@latest

nvm 使用時のバージョン不一致を解消する

nvm（Node Version Manager）を使用している場合、nvm use で切り替えたバージョンと npm の向き先がずれることがある。nvm-sh/nvm リポジトリに記載の設定方法に従い、使用する Node.js バージョンを固定したうえで再インストールする。

nvm use 20
npm install -g @openai/codex@latest
codex --version

Node.js バージョンの要件を確認する

Codex CLI は Node.js 18 以上を必要とする。以下で確認できる。

node --version

v16 以下の場合は Node.js を更新してから、Codex のインストールを行う。

リリースノートを確認してから更新する

破壊的変更が含まれる場合に備え、更新前にリリースノートに目を通しておくと安心だ。

npm で最新バージョン番号を調べる

npm info @openai/codex version

GitHub Releases でリリース内容を確認する

openai/codex の Releases ページでは、各バージョンの変更点が詳細に記述されている。「Breaking Changes」の項目があれば、更新後に動作が変わる可能性があるため、確認してから更新を進めるとよい。

バージョンを固定して安定運用する

チームで同じバージョンを使い続けたい場合、@ でバージョンを固定してインストールする。

npm install -g @openai/codex@0.142.2

プロジェクト単位で管理する場合は package.json の devDependencies に固定バージョンを記述し、npm ci で再現性のあるインストールを行う方法もある。これによりチームメンバー全員が同じ挙動の Codex CLI を使えるようになる。

まとめ

Codex の更新は npm install -g @openai/codex@latest の一行で完結する。更新前には codex --version でバージョンを確認し、更新後は同コマンドで反映を検証する。エラーが出た場合は Node.js のバージョン要件（18 以上）と npm グローバルディレクトリの権限を最初に確認しよう。

最新バージョンの情報は GitHub の openai/codex Releases ページと npm の @openai/codex ページで常に確認できる。定期的な更新を習慣にすることで、バグ修正の恩恵と最新モデルへのアクセスを維持しながら Codex を活用できる。