Codex 1個のバージョンに揃える方法と起動先の確認手順

「1個のバージョン」は普段使う環境ごとに決める

「codex 1個のバージョン」と検索するとき、解決したい問題は多くの場合、更新したはずの版と実際に開く版の食い違いです。この記事では、普段使う環境で起動するCodex CLIの導入先を一つに決め、更新する場所を迷わない状態にすることを目標にします。パソコン内の関連ファイルをすべて一つにする作業とは区別して考えます。

Codex CLIは端末からコードの調査、変更、コマンドの実行を行う道具です。OpenAIのCLI案内では、端末で使うCLIに加えて、デスクトップアプリ、ブラウザー、エディター拡張など別の利用画面も紹介されています。CLIを整理するために、それらを一緒に削除したり、同じ番号へ揃えたりする必要はありません。

WindowsのPowerShellとWSLのLinux端末を両方使っている場合も、どちらを主に使うかを先に決めます。Windows側の導入を更新しただけでは、WSL側で同じ実行ファイルが選ばれたことの確認にはなりません。両方必要なら、それぞれについて残す導入経路と版番号を記録します。「環境ごとに迷わず一つを選べる」という基準なら、必要な使い分けも保てます。

0.166.0の公開を機に起動先を確認する理由

OpenAIの公式更新履歴には、2026年10月29日付でCodex CLI 0.166.0が掲載されています。会話記録をキーボードで選択する機能や、通信状態を中心に診断する codex doctor --network-only などが案内されました。新しい機能を試す前に、いま開いている端末がどの版を使っているか確認する場面です。

ここで「更新したのに新機能が見えない」という症状を、すぐに機能の不具合と判断しないことが大切です。更新した場所と起動した場所が違えば、旧版を開いたままになる可能性があります。一方、版番号が一致しても、設定、利用画面、提供条件が違う場合があります。起動先の整理は原因を一段ずつ絞るための準備です。

今回紹介された通信診断も、同じパソコンに入っているCodexをすべて数えて整理する機能とは読み替えません。公式説明が示す診断の対象と、自分で確かめる導入先の一覧は役割が違います。版と起動先が一致したうえで通信の問題が残る場合に、利用中の版で提供される診断を検討する流れにすると、調査の順番が明確になります。

CLIの版とモデル名を分けて記録する

CLI本体の版は、端末に入っているCodexプログラムの版です。モデル名は、依頼を処理するモデルの選択を示します。デスクトップアプリに表示される版は、そのアプリの更新情報です。この三つを同じ欄へ書いてしまうと、何を更新した結果なのか後から追えなくなります。

公式のCLI案内でも、端末上の画面例にはモデルと作業ディレクトリーが別々に表示されています。モデルを選ぶ操作とCLIの導入操作も別のものとして説明されています。したがって、モデル名が同じだからCLIも同じ版、あるいはCLIを更新したからすべてのモデルが使える、という判断はできません。利用できるモデルは、自分の画面に示される選択肢と提供条件を確認します。

整理するときの記録は、次のように項目を分けると読み返しやすくなります。これは記事で提案する作業用の記録例であり、Codexがこの形式の表を出力するという意味ではありません。

起動する版を一本に整理する手順

整理は、古そうなファイルを先に消すところから始めません。普段使う端末で現状を調べ、残す導入経路を決め、その経路の更新後に起動先を再確認します。使わない導入を取り除く判断は、その後です。以下のコマンドは読者が自分の端末で確認するための例で、Codexへの依頼文として入力するものではありません。

作業中にエラーが出たら、その時点の表示を残します。「昨日は使えた」という記憶だけで整理を続けるより、端末の種類、版番号、起動先、エラーの全文がある方が比較できます。WindowsとWSLで結果が違った場合は、同じ表の別行として扱い、それぞれの環境で確認を完了させてください。

Step 1: 普段使う端末で版を記録する

普段Codexを使っている端末を開き、次のコマンドで版番号を記録します。別の端末アプリを新しく開いて調べるだけでは、普段の環境と条件が揃わない場合があります。まず実際に困っている端末で確認し、その後に比較対象の端末へ進むと、違いを追いやすくなります。

codex --version

表示された数字は省略せず、そのまま控えます。版を示す文字列に試験版の表記が含まれる場合も、正式な公開版と同じものとして扱わず、記録へ残します。この記事の確認基準日は2026年10月31日ですが、後日この記事を読む場合は、その日の公式公開情報と照合してください。

Step 2: Windowsで起動先の候補を確認する

PowerShellでは、次のコマンドで codex に一致する候補を確認できます。種類と場所を併記することで、実行ファイルに加えて別名や関数などが関係していないかも調べられます。出力が複数行あっても、その行数だけで独立したCodexが同じ数だけ入っているとは断定しません。

Get-Command codex -All | Select-Object CommandType, Name, Source, Definition

npmなどの導入方法によっては、同じ導入先に複数の呼び出し用ファイルが置かれることがあります。拡張子の違うファイルを見つけたという理由だけで片方を消すと、その端末から呼び出せなくなる可能性があります。ファイル名だけで判断せず、保存場所と導入経路を合わせて見てください。

Step 3: WSLや別の端末でも同じ観点で調べる

WSLでBashを使っている場合は、次のコマンドで名前の解決先を調べます。その結果を、同じ端末で得た版番号と組み合わせて記録します。Windows側で確認した場所を、そのままLinux側の起動先として書き写さないようにしてください。

type -a codex
codex --version

別のシェルを使っている場合は、そのシェルに対応したコマンドの検索方法を使います。見つかった候補のうち、今後も使う環境がどれかを整理し、必要なものまで削除しないようにします。仕事でWSLだけを使うなら、まずWSL側の確認を完了させるなど、利用頻度を基準に進めると判断しやすくなります。

Step 4: 残す導入経路で版を揃える

残す経路は、今後も更新方法を説明できるものを選びます。公式CLIページでは複数の導入方法が選べます。npmで管理する場合、2026年10月29日の公式更新履歴には0.166.0を指定する次の導入コマンドが掲載されています。

npm install -g @openai/codex@0.166.0

これはnpmで0.166.0を指定する例です。別の方法で管理している導入へ、そのまま重ねて追加する前に、npmへ管理を移すつもりなのかを決めます。組織が利用版を指定している場合は、その指定に合わせてください。ここでは他の導入をすぐ削除せず、選んだ経路で意図した版が使えるかを先に確かめます。

Step 5: 新しい端末で結果を再確認する

更新後は、開いたままのCodexで作業を続ける前に、新しい端末を開いて版番号と起動先をもう一度調べます。更新前と同じ場所を使っているか、意図した版が表示されるかを表で比較してください。数字だけが変わった場合も、場所だけが変わった場合も、その理由を確認してから次へ進みます。

期待した版が選ばれることを確かめたら、不要な導入を、その導入方法に合った削除手順で整理します。共有のフォルダー全体や設定の保存先を一括で消す必要はありません。削除対象を一つ整理するたびに再確認し、最後に普段の作業フォルダーから問題なく利用できることを確かめます。

版が揃わないときは変更点を一つずつ戻って調べる

更新しても古い版が表示される場合は、まず更新対象と起動先が一致するか確認します。起動先が違えば、同じ更新を繰り返しても普段使う版が変わらない可能性があります。PowerShellの候補一覧と更新前の記録を見比べ、どの導入を変更したのか説明できる状態に戻してください。

コマンド自体が見つからなくなった場合は、不要と判断した導入が、実際には普段使う起動先だった可能性があります。設定の初期化へ進む前に、残した経路の公式導入手順とコマンドの検索結果を照合します。ここでモデルの設定や会話の履歴まで変更すると、起動先以外の条件も変わり、原因が追いにくくなります。

同じ版が起動するのに依頼が失敗する場合は、導入先の整理と分けて扱います。サインイン、利用枠、通信状態、作業フォルダーへのアクセスなど、別の条件を確認する段階です。0.166.0の公式説明にある通信診断を試す場合も、まずその版を使っているかを確かめ、表示された診断結果を基に次の確認を決めます。版を揃えることだけで、すべてのエラーが解消するわけではありません。

整理を終える基準を記録に残す

作業を終える基準は、普段使う環境から意図したCodex CLIが開き、版番号と導入経路を説明できることです。WindowsとWSLを両方使うなら、各環境について確認結果を残します。複数の関連ファイルが残っているという理由だけで、さらに削除を続ける必要はありません。

次回の更新のために、確認した日、利用環境、残した導入経路、CLIの版、起動先を短く記録しておくと便利です。新しい版が公開されたときは、同じ項目を更新前後で比較します。公式公開情報はOpenAIの更新履歴、導入方法はCodex CLIの案内を参照し、使う環境での確認結果と合わせて判断してください。