Codex 0.125の変更点と現行版の違い・移行手順と確認方法

Codex 0.125とは何か――公開時期と位置づけ

Codex 0.125.0は、OpenAIが公開しているCodexリポジトリのリリース版です。公式ページではタグ名をrust-v0.125.0とし、2026年4月24日18時に公開されたこと、前の版からの変更を新機能・不具合修正・文書・内部整理に分けて示しています。ここでいう0.125はGPTのモデル名ではなく、Codex CLIや関連するサーバー機能を含むソフトウェア側の版番号です。モデルを選ぶ設定とCLIの版番号を混同しないことが、最初の確認点になります。出典は公式の0.125.0リリースノートです。

この版の特徴は、利用者が一つの画面でコードを生成する機能よりも、Codexを複数の接続口から扱う際の状態を揃えた点にあります。app-serverは画面や別のクライアントからCodexのスレッド、ツール、権限を扱うための層です。0.125では接続の選択肢、スレッドの読み出し方、環境の維持、設定の受け渡しがまとめて更新されました。そのため、単独のターミナル利用者には差が小さく見えても、IDEやプラグイン、遠隔の実行環境と組み合わせる利用者には意味の大きい版です。

0.124.0から0.125.0へ何が動いたか

前の版との差分を細かく追うと、単発の機能追加ではなく、接続状態を説明可能にするための変更が多いことが分かります。全差分はrust-v0.124.0と0.125.0の比較ページで確認できます。記事や紹介文だけで判断せず、実際に使う接続方法と権限の境界に関係する項目を先に読むと、更新の影響を見積もりやすくなります。

0.125と現行0.150.1を分けて考える理由

0.125.0は過去の特定版、0.150.1は2026年8月27日に公開された現行の安定版です。公式の0.150.1リリースノートには、遠隔コンパクションで保持した画像もトークン予算に数え、必要に応じて古い画像を整理する修正が記載されています。0.125の機能説明を読むときは、現行版にも同じ挙動が残っているかをリリース履歴で照合してください。

主要な変更1――app-server連携の接続方法が増えた

0.125.0の大きな柱は、app-serverを介してCodexの状態を扱うための接続とデータ受け渡しが増えたことです。公式の新機能欄にはUnixソケット転送、ページングに対応したresumeとfork、環境を維持する仕組み、遠隔スレッド設定・保存の基盤が並んでいます。これらは一つの便利ボタンではなく、クライアントが長く接続し、必要な範囲だけスレッドを読み、同じ環境を再利用するための部品です。

従来の感覚では、Codexを開いて依頼を送り、結果を読めば作業は完結します。しかし別の画面から同じスレッドを表示したり、長い履歴から必要な部分だけを取り出したり、同じ状態の環境で続きに戻ったりするには、接続方式と状態管理を分けて考える必要があります。0.125はその境目を公式のサーバー機能に寄せ、クライアントごとに違う実装を持ち込む範囲を狭めました。

Unixソケットはローカル接続の選択肢

Unixソケットは、同じコンピューター上のプロセス同士が通信するための接続方法です。ネットワークポートを開く方式と比べて、接続先をローカルに限定しやすく、開発環境の中でapp-serverとクライアントを組み合わせる設計に向きます。0.125のリリースノートに記載されているのは、app-server連携がこの方式にも対応したという事実であり、全利用者が設定変更を迫られるという意味ではありません。

導入前には、現在のクライアントがどの方式でapp-serverへ接続しているかを確認します。Unixソケットへ切り替える場合は、ソケットの保存場所、プロセスの起動順、終了時に残るファイル、複数のクライアントが同時に接続する条件を記録します。接続できるかだけでなく、再接続時に同じスレッドと権限状態を取得できるかまで確認すると、運用上の見落としを減らせます。

resumeとforkのページングで長い履歴を扱う

resumeは以前のスレッドへ戻る操作、forkは過去の状態から別の流れを作る操作です。履歴が長くなると、全件を一度に読み出すより、ページ単位で必要な範囲を取得する方が画面やクライアントの負荷を抑えられます。0.125では、この再開と分岐にページングを使えるようにする変更が入りました。

実際に確認するときは、短いスレッド、長いスレッド、分岐直後のスレッドをそれぞれ用意し、一覧の続きが重複せず欠落もしないかを見ます。ページの境界で最後の発言が二重に表示されないこと、古い発言を指定したときに意図した位置へ戻れること、分岐元と分岐先を取り違えないことが大切です。履歴の量が増えてから調べるのではなく、少量のデータで読み出しの規則を先に把握します。

主要な変更2――権限プロファイルが複数の層をまたぐ

0.125.0では、権限プロファイルがTUIのセッション、ユーザーのターン、MCPのサンドボックス状態、シェルの追加権限、app-server APIの間で受け渡されるようになりました。権限プロファイルは、どの操作を許可し、どの操作を確認付きにし、どこまでを拒否するかをまとめた状態です。重要なのは設定項目が増えたことではなく、入口が変わっても同じ判断材料を使いやすくなったことです。

たとえば、ターミナルでは確認を求める操作が、別のクライアントを通すと無条件に許可されるなら、利用者は安全な境界を判断できません。反対に、あらゆる操作を拒否してしまうと、読み取りやテストまで進めにくくなります。0.125の変更は、許可状態を接続層の外へ持ち運び、各層が勝手に別の意味へ変換しないための土台と捉えると理解しやすくなります。

設定の引き継ぎを確認する観点

権限プロファイルを確認するときは、許可された操作の名前だけを見るのでは足りません。どの画面で選んだ状態か、次のユーザー入力へ残るか、MCPのツール呼び出しへ伝わるか、追加権限を求めたときに表示が変わるかを順番に見ます。app-server APIを利用している場合は、画面の表示とAPIが返す状態が一致することも確かめてください。

利用者が残すとよい確認記録

更新前後で、利用した入口、選択した権限プロファイル、読み取り・書き込み・コマンド実行の結果、確認を求められた場面を短く残します。特に「許可された」と「実際に処理が完了した」は別の事実です。実行結果、拒否理由、再試行後の変化まで記録しておけば、版を戻すか現行版へ進むかを感覚で決めずに済みます。

主要な変更3――プラグインとモデル一覧の扱いが整理された

0.125.0では、app-serverのプラグイン管理から遠隔プラグインを導入したり、設定済みのマーケットプレイスを更新したりできるようになりました。さらにモデル提供元がモデル検出を担当し、AWSやBedrockのアカウント状態をアプリ側へ示す変更も含まれています。どちらも、利用できる機能やモデルを固定の一覧だけで判断せず、接続先から得た状態を確認する方向の変更です。

プラグインは便利ですが、追加した瞬間にすべてのツールが同じ条件で使えるとは限りません。名称、提供元、読み書きの範囲、必要な接続、失敗時の表示を確認してから使います。モデル一覧についても、表示された名前だけで性能を決めつけず、モデルの用途、推論設定、利用可能な入口を別々に確認します。リリースノートは機能の追加を示しますが、料金や提供地域などの条件は公式の製品資料で補ってください。

遠隔プラグインを追加する前の確認

まず現在のマーケットプレイス一覧と、すでに利用しているプラグインを記録します。次に追加するものがどのサーバーへ接続し、どんなデータを読み書きし、失敗した場合にどこへ戻せるかを確認します。更新後は、一覧に表示されること、起動できること、必要なツールだけが見えること、不要になった場合に外せることを順番に試します。プラグインの導入を目的にするのではなく、担当する作業が短くなるかで採否を決めるのが要点です。

モデル検出とアカウント状態を混同しない

モデル検出は「どのモデルが選択候補として見えるか」を扱う仕組みであり、アカウント状態は「その接続先を利用できる条件を満たすか」に関わる情報です。候補に表示されても、契約、地域、接続先の設定によって使えない場合があります。0.125へ更新した後は、一覧表示、選択、短い検証、長めのコード読解という順で確かめ、表示されたことだけを利用可能の根拠にしないでください。

主要な変更4――JSON出力とトレースで結果を読みやすくする

Codex exec --jsonは、プログラムから結果を扱う利用者向けの出力形式です。0.125.0では、推論に使ったトークンの使用量がJSONに含まれるようになりました。文章の長さだけでは作業の重さを推測しにくい場面で、通常の出力と使用量を並べて見られるようになります。これにより、同じ種類の依頼を複数回試したときに、結果の差を印象ではなく記録で比べられます。

同じリリースには、ツール、コードモード、セッション、複数エージェントの関係を記録するトレースと、調査用の縮約コマンドも含まれています。トレースは利用者が毎回読むための長いログではなく、どの処理がどの処理を呼び、どこで状態が切り替わったかを後から調べるための材料です。問題が起きたときに最終文だけを見ず、入力、ツール、出力、版番号をつなげて確認できます。

推論トークン表示をどう使うか

まず同じ依頼を同じモデルと設定で一度だけ実行し、JSONの使用量と終了状態を保存します。次に依頼の前提を短くした場合、対象範囲を狭めた場合、検証方法を明記した場合を比べます。使用量が減っても必要なテストや説明が消えていれば成功とは言えません。数字は安さを競うためではなく、作業の条件と結果を揃えるために使います。

トレースを見るときの注意

トレースの関係を読むときは、時刻だけで処理の順番を判断しないようにします。並行して進む処理や、同じツールを複数回呼ぶ処理があるため、セッションID、親子関係、終了理由を合わせて見ます。問題の原因を特定できないときは、必要な行だけを抜き出して、利用した版と設定の要点を添えます。大量の記録を読むこと自体を目的にせず、再現に必要な手掛かりへ絞ることが大切です。

Codex 0.125を確認する手順

0.125.0を新しく使う場合でも、0.150.1から過去の変更を調べる場合でも、版番号と結果を分けて記録します。以下の順番なら、接続の問題、権限の問題、モデルの問題、出力の問題を混ぜずに確認できます。最初から長い履歴や複数のプラグインを同時に持ち込むのではなく、短いスレッドと読み取り中心の処理から始めるのがコツです。各段階で「何を確認したか」「どんな結果だったか」「次に何を変えるか」を残しておけば、旧版の再現と現行版の比較を同じ尺度で行えます。失敗した場合も、接続を変えたのか、権限を変えたのか、モデルを変えたのかを振り返りやすくなります。

Step 1: 現在の版と導入経路を記録する

最初にCodexの版番号を確認し、表示された値をそのまま記録します。確認に使うコマンドはcodex --versionです。パッケージマネージャーで入れたのか、アプリに含まれる機能なのか、別のクライアントからapp-serverへ接続しているのかも書き添えます。入口が違えば更新方法も戻し方も変わるため、版番号だけをメモして終わりにしないでください。

Step 2: 0.125の差分から影響範囲を選ぶ

公式リリースノートを開き、Unixソケット、resumeとfork、権限プロファイル、プラグイン、モデル検出、JSON出力のうち、現在使うものだけを選びます。すべてを一度に検証すると原因が混ざります。たとえばターミナルだけなら、まず版番号、短い依頼、JSON出力の三点を見てから、app-serverやプラグインへ広げます。

Step 3: 小さなスレッドで接続と権限を試す

新しい空のプロジェクトや安全な検証用の場所で、短い依頼を一つ送ります。読み取りだけの処理、確認を求める処理、拒否される処理を順に選び、表示と結果が一致することを確かめます。次に同じスレッドをresumeし、必要ならforkして、履歴と権限の両方が意図した状態を保っているか確認します。

Step 4: 現行版へ移る場合は同じ検証を再度行う

0.125で確認した入力と期待結果を残したまま、現行版へ移って同じ手順を繰り返します。0.150.1では画像を保持した遠隔コンパクションの予算処理が修正されているため、画像を含む会話を扱う場合は、古い画像が必要以上に残らないか、重要な情報が失われないかも追加で見ます。版を替えた後に依頼文まで変えると比較できないので、条件はできるだけ固定してください。

0.125から現行版へ移るときの判断

0.125.0の機能を必要としているからといって、必ず0.125へ戻る必要はありません。現在の版で同じ接続、権限、プラグイン、JSON出力が提供されているなら、現行版を使いながら0.125の変更意図だけを確認できます。一方、古いクライアントや社内の接続部品が0.125を前提としている場合は、版を上げる前に通信方式と状態の受け渡しを確認します。

判断は、版番号の新しさだけで決めません。次の観点を順に比べると、更新の影響が見えます。

1. 今使っている入口で、同じスレッドを再開・分岐できるか確認する。
2. 権限プロファイルが画面、MCP、コマンド実行の各場面で一致するか確認する。
3. プラグインとモデルの一覧が、必要なものだけを候補として示すか確認する。
4. JSON出力に必要な終了状態と使用量が残るか確認する。
5. 画像を含む長い会話を扱う場合は、現行版のコンパクション結果を確認する。

この比較で問題がなければ、0.125の環境を長く維持するより、現行版の修正と公式資料を追う方が管理しやすくなります。逆に、特定の接続方式や権限の受け渡しが崩れるなら、更新を止める前に公式のリリース履歴と設定資料を読み、どの変更が原因かを切り分けます。

よくある誤解と確認ポイント

版番号に関する記事では、機能の説明と利用条件が一緒に読まれやすく、0.125の変更を現在のすべての環境へそのまま当てはめてしまうことがあります。Codexは入口、クライアント、モデル、権限、接続方式の組み合わせで見える動作が変わるため、リリースノートに書かれた変更と、自分の環境で確認できた結果を分けて扱ってください。ここでは、導入前に誤解しやすい点を整理します。 公開日と現在の版を照合してから読むことも忘れないでください。過去の記述を現在の仕様だと決めつけず、公式資料で最後に確認した日付を残すと判断が安定します。

0.125はGPTモデルの世代ではない

Codex 0.125.0の数字は、Codex側のソフトウェア版です。GPTのモデル名、推論の強さ、契約プランとは別の値なので、0.125へ更新したからモデルの能力が同じ割合で変わるとは限りません。モデルを選んだ結果と、CLIがどの版で動いているかをそれぞれ表示して確認してください。

app-serverの変更は全利用者に必須ではない

Unixソケットや遠隔スレッド設定は、app-serverを介して別のクライアントや接続方式を使う人ほど影響が大きい変更です。ターミナルで短い依頼だけを行う人は、まず版番号と通常の操作が成立するかを見れば足ります。使っていない接続機能まで設定し直すと、かえって本来の問題が見えにくくなります。

リリースノートと製品条件は別に読む

公式リリースノートは、版に含まれる変更を確認する一次資料です。料金、提供地域、契約上の利用条件、対応するモデルは別の公式ページで変わる可能性があります。Codexの概要はOpenAI Codex公式ページ、利用方法や設定はOpenAI DevelopersのCodex資料も併せて確認してください。

まとめ――0.125を現行版の確認表として使う

Codex 0.125.0は、app-serverの接続、スレッドのページング、環境の維持、権限プロファイル、プラグイン管理、モデル検出、JSON出力、トレースをまとめて前へ進めた版です。個別の新機能を覚えるより、どの入口からどの状態を読み、どんな結果を記録するかという視点で捉えると、変更の意味がつながります。

一方、2026年8月29日時点の最新安定版は0.150.1です。0.125を使い続けることを目的にせず、公式リリースノートの項目を現行版で再確認し、スレッド、権限、モデル、出力、画像を含む会話の順に小さく検証してください。版番号を確認し、公式資料を参照し、結果を残す。この三つを守れば、過去版の調査も現行版への移行も落ち着いて進められます。