Codex CLIのインストールと更新：Mac、Linux、Windows

OpenAI Codex CLIのインストールは、プラットフォームごとにコマンド一つです。macOSとLinuxでは curl -fsSL https://chatgpt.com/codex/install.sh | sh、Windowsでは powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" で、npmとHomebrewがサポートされる代替手段です。更新は codex update で、スクリプト、npm、Homebrewのインストールを認識し、そのチャネルのアップグレードを実行します。¹⁴¹¹ ほとんどのページが飛ばしているのは、最初のコマンドのあとに来る部分です。五つのインストール経路のどれを選ぶか、リリースに問題があったときにバージョンをどう固定するか、wingetパッケージがなぜnpmより数日から数週間遅れるのか、アンインストールのあと ~/.codex に何が残るのか。このページがそのリファレンスです。作業ごとに表を一つ、v0.163.0（2026年10月15日）時点の内容です。⁹

2026年10月15日更新（v0.163.0対応）。 このページの9月版から変わった点は4つあります。まずwingetのインデックスが動きました。マニフェストのリクエストが何週間も放置された夏のあと、0.156.0から0.161.0までの12件はオープンから1日以内にマージされましたが、0.162.0と0.162.1のリクエストは10月8日と9日から待たされたままです。そのため10月15日時点でwingetはnpmより3リリース遅れで、9月6日の14リリース（0.147.0から0.153.4）からは縮まっています。³¹⁰ Windowsのリリースには署名付きの install.ps1 が同梱されるようになりました（SHA-256の検査自体はそれ以前からあり、v0.162.0でWindows PowerShellでの不具合が修正されました）。¹⁸ Windowsには3つ目のサンドボックス実装であるMicrosoft Execution Containersも加わり、9月時点の2つのモードはそのフォールバックになりました。⁸ そして、Codexが対象となる対話セッションでデフォルトで起動するようになったバックグラウンドサーバーは独自のアップデーターを動かしており、古いスクリプトインストールではCLI自身のパッケージまで更新することがあります。²⁰ 以下のインストール、更新、固定に関する基準値はすべて10月15日に読み直しました。codex doctor の記述は0.153.4時点のものです。⁹¹⁰

TL;DR

• スタンドアロンのインストーラーが、OpenAIが先頭に置く経路です。 READMEとCLIドキュメントの両方でそうなっており、npmとHomebrewは代替手段として示されています（CLIドキュメントでは「you can also install」、READMEでは「can also be installed via」）。macOSとLinuxでは install.sh スクリプト、Windowsでは install.ps1 スクリプトです。コンパイル済みのバイナリをダウンロードするので、Nodeは不要です。¹¹¹
• npmとHomebrewはサポートされる代替手段です。 npm install -g @openai/codex は通常のパッケージ指定（@<version>）でバージョンを固定できます。brew install --cask codex は執筆時点でnpmと同じ0.163.0で、caskはリリースの13分後に更新されました。¹²¹⁰
• wingetは使えますが、数日から数週間遅れます。 OpenAIは OpenAI.Codex パッケージを公開しています。マニフェストのプルリクエストが何週間もマージされずに溜まっていた夏のあと、0.156.0（2026年9月22日）から0.161.0（10月7日）までの12件はそれぞれオープンから1日以内にマージされました。その後、0.162.0と0.162.1のリクエストが止まり、10月8日と9日から開いたままです。10月15日時点でインストールできる最新版はnpmの0.163.0に対して0.161.0で、安定版3リリース分の遅れです。0.163.0のリクエストもまだ開いています。³¹⁰
• codex update はスクリプト、npm、Homebrewのインストールをカバーします（v0.128.0以降）。TUIがすでに持っていたインストールチャネルの検出を再利用し、対応するアップグレードを実行します。wingetでのインストールは認識するチャネルに含まれないため、そちらは winget upgrade OpenAI.Codex で更新してください。残りの手動の対応は、インストーラーの再実行、npm install -g @openai/codex@latest、または brew upgrade --cask codex です。⁴¹¹
• バックグラウンドサーバーはアップデーターを動かしており、古いスクリプトインストールではCLIまで更新することがあります。 v0.157.0（2026年9月25日UTC）以降、Codexは対象となる対話セッションで、管理されたバックグラウンドサーバーをデフォルトで起動します。インストーラーが latest チャネルを選んでいた場合、そのサーバーは起動の5分後、以後は1時間ごとに更新を確認し、インストーラーを実行します。新しいデーモンは ~/.codex/packages/app-server-daemon の下に置かれますが、古いスクリプトインストールから最初に起動されたデーモンは、CLI自身のパッケージである ~/.codex/packages/standalone/current を使い続けます。止めるスイッチは ~/.codex/app-server-daemon/settings.json の "updater": { "autoUpdateEnabled": false } で、codex app-server daemon restart で反映されます。²⁰¹²
• バージョン固定は、install.sh では --release <version>、install.ps1 の行の前では $env:CODEX_RELEASE、npmでは @<version> です。 Homebrewのcaskは現在のバージョン一つだけを追跡し、固定はできません。²¹²
• パッケージをアンインストールしても状態は消えませんが、 スクリプトでのインストールでは rm -rf ~/.codex がCLI自体も削除します。インストーラーがリリースを ~/.codex/packages/standalone の下に置いているからです。¹²

Codex CLIはどうやってインストールしますか？

OpenAI自身のドキュメントが示す順に四つの経路、¹¹¹ それに加えてOpenAIがドキュメント化していないWindowsのwingetです。³

# Standalone installer, no Node required (macOS, Linux, WSL) -- the route OpenAI lists first
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

# npm (needs Node.js 16+; pins with a plain @version spec)
npm install -g @openai/codex

# Homebrew (macOS, Linux)
brew install --cask codex

# winget (Windows; lags npm, see the platform section)
winget install OpenAI.Codex

そのあと、インストールされたことを確認してサインインします。

codex --version      # codex-cli 0.163.0
codex login          # ChatGPT account (recommended) or an API key

最初のスクリプトインストールでは、プロファイルブロックは新しいシェルでしか効きません。インストールしたターミナルで codex が見つからなければ、そこで export PATH="$HOME/.local/bin:$PATH" を実行するか、新しいターミナルを開いてください。インストーラーは終了時に同じ二行（「Current terminal」と「Future terminals」）を表示します。¹²

生のバイナリが良いですか？ すべてのGitHubリリースにはプラットフォーム別のtarball（codex-aarch64-apple-darwin.tar.gz、codex-x86_64-apple-darwin.tar.gz、codex-x86_64-unknown-linux-musl.tar.gz、codex-aarch64-unknown-linux-musl.tar.gz）が付いており、v0.106.0以降は同じ install.sh が各リリースにアセットとして添付されています。各アーカイブにはプラットフォーム名が含まれたエントリが一つだけ入っているので、展開後に codex にリネームしてください。¹⁵ リリースページには、これらのtarballの周りにさまざまなファイルが加わっています。各バイナリの .zst とmacOS向け .dmg の兄弟ファイル、バイナリと codex-code-mode-host ヘルパーとripgrepをまとめた codex-package-<target>.tar.gz バンドル（インストーラーとHomebrewのcaskがダウンロードするのはこちらです）、codex-app-server と codex-responses-api-proxy のバイナリ、そして openai_codex_cli_bin のPythonホイールです。このホイールはOpenAIのPython SDK用に固定されたランタイムであって、CLIを pip で入れる経路ではありません。⁵¹²

インストーラーはOpenAIがホストするリリース基盤から取得します。chatgpt.com/codex/install.sh は releases.openai.com にリダイレクトされます。これはv0.146.0で入った変更で、GitHub Releasesはフォールバックのホストとして残っています。⁶ OpenAIのアーティファクトホストをブロックまたは制限しているがGitHubは許可しているネットワークでは、リリースアセットからスクリプトを取得し、バイナリもGitHubから取るよう指示します。¹¹²

curl -fsSL https://github.com/openai/codex/releases/latest/download/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh

変数はパイプの sh 側に置きます。VAR=value curl ... | sh という形は変数を curl にしか適用しないので、スクリプトはそれを見ることがなく、黙ってデフォルトのままになります。PowerShellでは、インストールの行を実行する前に $env:CODEX_INSTALLER_USE_RELEASES_OPENAI_COM = 'false' を設定してください。

どの経路を選ぶべきですか？

Codexはどのプラットフォームをサポートしていますか？

Windowsでは、CodexはWindowsサンドボックスとともにPowerShellでネイティブに動作し、2026年10月時点で実装は3つあります。最も新しいのはMicrosoft Execution Containers（MXC）で、MicrosoftがWindows 11 24H2と25H2で導入したプロセス分離です。デスクトップアプリは、デバイスが対応していればコンシューマー向けアカウントでこれを優先します。CLIがこれを使うのは、[features] の下に prefer_mxc = true が設定されている場合（このときはレガシーモードがフォールバックになります）か、[windows] sandbox = "mxc" で明示的に選んだ場合です。後者は、機能がない場合やポリシーがブロックしている場合にフォールバックせず失敗します。v0.162.0以降は、1コマンドのテスト（codex -c windows.sandbox=mxc sandbox ...、期待される出力は MXC_OK）で、保存された選択を変えずに試せます。従来の2つのモードは、いまはレガシーのフォールバックです。elevated が推奨モードで、専用の低権限サンドボックスユーザー、ファイルシステムの権限境界、ファイアウォールルール、ローカルポリシーの変更を使い、管理者が承認するセットアップが必要です。unelevated は、あなたのユーザーから派生した制限付きWindowsトークンとACLベースのファイルシステム境界でコマンドを実行し、ネットワークの分離はより弱くなります。⁸ フォールバックは config.toml で選びます。

[windows]
sandbox = "elevated"   # or "unelevated"; "mxc" selects the containers explicitly

OpenAIの指針は、デフォルトではネイティブサンドボックスを使い、Linuxネイティブのツールが必要なとき、ワークフローがすでにWSL2にあるとき、あるいはネイティブWindowsサンドボックスのどの実装も要件に合わないときにWSLを選ぶ、というものです。⁸ 一つ区別しておくべきこと：Windowsのセットアップは自身のセットアップ手順のためにマシンに winget があることを前提としますが、それはwingetを通じてCodexをインストールすることとは別です。OpenAIはそのパッケージを公開しています。リリースワークフローには、安定版リリースについて microsoft/winget-pkgs にマニフェストのプルリクエストを開く winget ジョブがあります。そしてインデックスの夏の停滞は終わりましたが、それで解消したわけではありません。ここでの日付はUTCです。0.148.0から0.152.0までのリクエストは8月18日から9月1日にかけてオープンされ、9月11日にマージされました（0.151.0は9月30日、0.149.1は10月1日）。0.147.0のリクエストはマージされずにクローズされ、コミュニティメンバーによる0.154.0の提出も同様でした。OpenAIのワークフローは、0.152.1と0.153.xから0.155.xについてはリクエストを1件も開いていません。0.156.0（9月22日）から0.161.0（10月7日）までは、12件のマニフェストが続けてオープンから1日以内にマージされました。その後、0.162.0と0.162.1のリクエストが止まり、10月8日と9日から開いたままです。10月15日時点でインデックスには138バージョンがあり、最新は0.161.0、npmより安定版3リリース遅れで、0.163.0のリクエストもまだ開いています。CLIには何の問題もありません。パッケージが数日から数週間遅れるだけです。³⁸

Node.jsが必要なのはnpm経路だけです。インストールスクリプトはコンパイル済みのバイナリをダウンロードし、Homebrewのcaskは依存関係を宣言していません。¹²

Codex CLIはどうやって更新しますか？

実行しているCLIは自分自身を更新しません。ただし、バックグラウンドサーバーのアップデーターが同じパッケージを管理している場合は別です（サーバーが packages/standalone から起動された古いスクリプトインストール。後述します）。TUIが新しいリリースに気づき、あなたのインストールチャネル向けのコマンドを提示します。実行するのはあなたで、組み込みのコマンドはスクリプト、npm、Homebrewのインストールをカバーします。⁴ 起動時のチェック自体は設定キーです。config.toml の check_for_update_on_startup = false で、リファレンスはこれを「Check for Codex updates on startup (set to false only when updates are centrally managed)」と説明しています。更新を中央で管理する組織は requirements.toml で features.in_app_updates = false を設定します。¹⁶

codex --version                      # what you run now
npm view @openai/codex version       # newest published

codex update                         # built-in, v0.128.0+; detects your install channel

codex update は2026年4月30日のv0.128.0で登場しました。これを追加したプルリクエストは、TUIが更新の案内にすでに使っていたインストールチャネルの検出と更新の実行機構を再利用しています。チャネルのマップはnpm（およびbun、pnpm、Vite+の変種）、Homebrew、UnixとWindowsのスタンドアロンインストーラーをカバーします。wingetのインストールはそこに含まれないため、wingetでインストールしたCodexは winget upgrade OpenAI.Codex でのみ更新されます。10月15日に読み直すと、マップには新しいエントリが1つあります。ターミナルが復元されたあとにローカルのバックグラウンドサーバーを置き換えるデーモンのアクションです。またスタンドアロンのコマンドは、いまは CODEX_NON_INTERACTIVE=1 付きでインストーラーを実行します。wingetは依然として含まれていません。⁴ 手動の対応は、そちらを好む場合やマシンイメージをスクリプト化している場合のために、次のとおりです。

curl -fsSL https://chatgpt.com/codex/install.sh | sh   # standalone: re-run the installer
npm install -g @openai/codex@latest                    # npm
brew upgrade --cask codex                              # Homebrew
winget upgrade OpenAI.Codex                            # winget (to whatever winget has)

irm https://chatgpt.com/codex/install.ps1 | iex           # standalone on Windows: re-run the installer

リリースは速い安定版ラインで出ています。0.160.0から0.163.0までの安定版6リリースが2026年10月1日から10月15日のあいだに出荷されているので、「自分が使っているもの」と「最新」の差は四半期ではなく一週間であることが多いのです。⁹

バックグラウンドサーバーは自分で更新される

スケジュールに沿って新しいバイナリを取得するのは、バックグラウンドサーバーだけです。v0.157.0（2026年9月25日UTC）以降、Codexは対象となる対話セッションで管理されたバックグラウンドサーバーをデフォルトで起動し、インストーラーが安定版の latest チャネルを選んでいた場合、そのサーバーは切り離されたアップデーターのループを起動します。ループは起動の5分後、以後は1時間ごとに更新を確認してそのたびにインストーラーを実行し、実行中のサーバーは新しいバイナリで再起動します。0.163.0でインストールされたデーモンは専用のパッケージ ~/.codex/packages/app-server-daemon に置かれます（インストーラーの CODEX_INSTALL_DAEMON_ONLY=1 モードで、ユーザーのCLIコマンドとシェルの設定には手を付けません）。しかし、古いスクリプトインストールから最初に起動されたデーモンは ~/.codex/packages/standalone/current を使い続け、そのスケジュール更新はこのパッケージ、つまりあなたが入力するCLIそのものを更新します（インストーラーがチャネルのマーカーを記録するより前のインストールでは、次に latest をインストールしたあとに限られます。そのインストールは codex update が行います。それまでデーモンは更新せずにサービスを続けます）。固定したリリースは固定されたままです。インストーラーは latest のインストールのときだけ auto-update-version マーカーを書き、明示的なリリースでは削除します。スクリプト自身のコメントもその規則を「Scheduled updates still require the selected release to follow the latest channel.」と述べています。ユーザーごとのスイッチは ~/.codex/app-server-daemon/settings.json の "updater": { "autoUpdateEnabled": false } で、隣に updateIntervalMinutes があります。codex app-server daemon restart で有効・無効の状態が反映され、間隔の変更は次の待機から効きます。codex app-server daemon stop はサーバーを停止し（まず穏当な終了要求を送り、猶予時間を過ぎれば強制終了します。アップデーターのループはpidで管理される別プロセスなので、停止後に確認してください）、TUIの /daemon はサーバーを再起動します（v0.163.0）。これらの更新はアプリケーションのネットワークポリシーに従います（v0.163.0）。明示的な codex app-server daemon update は、自動更新がオフでも最新の安定版を選び、インストーラーとリリースが対応していれば、レガシーのデーモンを専用のパッケージルートへ移します。さらに、固定されたパッケージを本番の更新対象に戻し（自動更新の設定そのものは保たれます）、実行中のサーバーを再起動するので、進行中や待機中の作業が中断されることがあります。停止しているサーバーは停止したままです。デーモン自身のREADMEは、これを実験的なものとしています。²⁰¹²

特定のバージョンはどうやってインストールしますか？

npmとインストールスクリプトはどちらもバージョンで固定できます。Homebrewはできません。²¹²

npm install -g @openai/[email protected]                                          # npm: exact version
curl -fsSL https://chatgpt.com/codex/install.sh | sh -s -- --release 0.162.1  # script: --release flag
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_RELEASE=0.162.1 sh    # script: env var, on the sh side
winget install OpenAI.Codex --version 0.161.0                                 # winget: only what it has
codex --version                                                               # verify the rollback took

環境変数の形では位置に注意してください。CODEX_RELEASE=0.162.1 はパイプのあと、sh の前に置く必要があります。curl の前に書くと変数は curl にだけ適用され、固定したつもりのあいだにスクリプトは latest をインストールします。¹² WindowsではPowerShellスクリプトが唯一のパラメーターとして $Release = $env:CODEX_RELEASE を宣言し、空なら latest にフォールバックするので、固定とは同じセッションで設定したその変数のことです。¹⁷

$env:CODEX_RELEASE = '0.162.1'; irm https://chatgpt.com/codex/install.ps1 | iex

あとで解除してください（Remove-Item Env:CODEX_RELEASE）。この変数はそのセッションの残りのあいだ設定されたままなので、同じセッションで後から実行するインストーラーは、codex update が起動するものも含めて、その固定を引き継ぎます。¹⁷

npmには、プレリリース系統向けの alpha dist-tagもあります（10月15日時点で 0.163.0-alpha.11。10月14日UTCに公開され、安定版0.163.0のほぼ2日前です）。npm install -g @openai/codex@alpha でそれを追えます。v0.161.0以降は、古いalphaやホットフィックスを公開してもこのタグが後退しなくなりました。¹⁰²¹

固定は、リリースがあなたの環境を壊したときの正しい手です。issueを立て、最後に問題のなかったバージョンに固定し、先へ進む。固定のたびに codex --version で確認してください。PATH 上の別の場所にある二つ目のインストールが、黙って自分のバイナリを提供し続けるからです。インストールスクリプトはまさにこれを検査します。PATH にすでにHomebrew、npm、bunが管理する codex を見つけると、「Multiple managed Codex installs can be ambiguous because PATH order decides which one runs」と警告し、対応するアンインストールを代わりに実行することを提案します。Homebrewの場合はmacOSのプレフィックス /opt/homebrew と /usr/local で判定し、それもmacOSでのみ行うので、Linuxbrewの codex は検出されません。¹² codex doctor は事後に同じ状態を Environment の下に報告します。⁷

Codex CLIはどうやってアンインストールしますか？

まず、codex がまだ PATH にあるうちにバックグラウンドサーバーを停止し、それからインストールした経路で削除します。

codex app-server daemon stop     # first; skip if no server runs
npm uninstall -g @openai/codex
brew uninstall --cask codex
winget uninstall OpenAI.Codex

スクリプトでのインストールには、問い合わせるパッケージマネージャーがありません。インストーラーは ~/.local/bin に codex のシンボリックリンク（CODEX_INSTALL_DIR で上書き可能）を置き、それは ~/.codex/packages/standalone/current の中のバイナリ（現行リリースでは current/bin/codex）を指します。current 自体も、ダウンロードした各リリースが置かれる ~/.codex/packages/standalone/releases/ へのシンボリックリンクです。macOSでは、インストーラーは最初のリンクの隣に二つ目のシンボリックリンク codex-code-mode-host を追加します。¹² v0.157.0以降は、バックグラウンドサーバーもあるかもしれません。そのパッケージは ~/.codex/packages/app-server-daemon の下に（古いインストールから最初に起動されたサーバーなら standalone パッケージそのもの）、状態は ~/.codex/app-server-daemon/ の下にあります（settings.json、daemon.pid と daemon-updater.pid、standalone パッケージから動いているサーバーなら app-server.pid と app-server-updater.pid、そして daemon.lock）。²⁰ まずそれを停止し、それからすべて削除します。

codex app-server daemon stop                                 # the background server; its updater is a separate process
pgrep -fl "app-server" || true                               # what is still running
grep -H . ~/.codex/app-server-daemon/*.pid 2>/dev/null       # the recorded pids, by file

サーバーは codex app-server --listen unix:// として動き、リモートコントロールが有効なら --listen の前に --remote-control が付きます（listenの引数はスキームだけで、ソケットのパスはコマンドラインに現れません）。アップデーターは codex app-server daemon pid-update-loop として動きます。どのプロセスがバックグラウンドサーバーのものかは、~/.codex/app-server-daemon/ の下のpidファイルで判断します。専用のデーモンなら daemon.pid と daemon-updater.pid、standalone パッケージから動いているサーバーなら app-server.pid と app-server-updater.pid です。stop が終わらせるのはサーバーであってアップデーターではなく、アップデーターはマシンを再起動するまで間隔ごとに起き続けます。そこに記録されたpidがまだ生きていれば、この時点で kill <pid> で終了させてください。それ以外の codex app-server プロセスは、あなたが動かしている別の何かのものです。そのうえで残りを削除します。¹²²⁰

rm -f ~/.local/bin/codex ~/.local/bin/codex-code-mode-host   # the second link exists on macOS installs only
rm -rf ~/.codex/packages/standalone ~/.codex/packages/app-server-daemon   # the CLI's package and the server's
rm -rf ~/.codex/app-server-daemon                            # the server's settings, pid files and lock

インストール時に ~/.local/bin が PATH になかった場合、あるいはインストーラーが競合するHomebrew、npm、bunのインストールを見つけてエントリを書き換えた場合、スクリプトはシェルのプロファイルにもマークされたブロックを追記しています。~/.zprofile（macOSのzsh）、~/.bash_profile（macOSのbash）、~/.zshrc（Linuxのzsh）、~/.bashrc（Linuxのbash）、または ~/.profile（その他のシェル）の # >>> Codex installer >>> から # <<< Codex installer <<< までです。その三行を削除すれば完了です。¹²

Windowsでは、install.ps1 は %USERPROFILE%\.codex\packages\standalone（その変数を設定していれば %CODEX_HOME%\packages\standalone）の下に同じ配置を保ちます。ダウンロードしたリリースは releases\ に、有効なリリースを指す current ジャンクションがあります。codex.exe は %LOCALAPPDATA%\Programs\OpenAI\Codex\bin（CODEX_INSTALL_DIR で上書き可能）を通じて公開され、これ自体が current\bin へのジャンクションです。そしてプロファイルブロックの代わりに、そのbinパスを今後のPowerShellセッションのためにユーザーの PATH に書き込みます。バックグラウンドサーバーも同じ場所に2つのフォルダー、packages\app-server-daemon と app-server-daemon を置きます。¹⁷²⁰ サーバーを停止し、standaloneディレクトリとサーバーの2つのフォルダーを削除し、次に参照先を失ったbinジャンクションを削除し、最後に環境変数のユーザー Path 変数からエントリを取り除きます。¹⁷

codex app-server daemon stop                                                  # the background server; its updater is a separate process
Get-Process codex* -ErrorAction SilentlyContinue                              # what is still running
Get-ChildItem "$env:USERPROFILE\.codex\app-server-daemon\*.pid" -ErrorAction SilentlyContinue | ForEach-Object { "$($_.Name): $(Get-Content $_)" }   # the recorded pids, by file

判断に使うのはここでも同じpidファイルです。%USERPROFILE%\.codex\app-server-daemon\daemon.pid または daemon-updater.pid（standalone パッケージ上のサーバーなら app-server.pid と app-server-updater.pid）に記録されたpidのプロセスがまだ生きていれば、この時点で Stop-Process -Id <pid> で終了させてください。それ以外のCodexプロセスは、あなたが動かしている別の何かです。そのうえで残りを削除します。²⁰

Remove-Item -Recurse -Force "$env:USERPROFILE\.codex\packages\standalone"   # releases plus the current junction
Remove-Item -Recurse -Force "$env:USERPROFILE\.codex\packages\app-server-daemon", "$env:USERPROFILE\.codex\app-server-daemon" -ErrorAction SilentlyContinue   # the server's package and state
cmd /c rmdir "$env:LOCALAPPDATA\Programs\OpenAI\Codex\bin"                  # the bin junction; rmdir removes the link, not a target

codex sandbox uninstall（v0.162.0）は、レガシーのWindowsサンドボックスのための別の後片付けです。管理者権限でマシン全体のサンドボックスアカウントとネットワークルールを削除し、Codexのホームとサンドボックスのディレクトリには触れず、ほかのプラットフォームでは拒否されます。¹⁹

どの経路でも、バックグラウンドサーバーが動いていればまず停止し（codex app-server daemon stop）、~/.codex/packages/app-server-daemon があるか確認してください。デーモンのREADMEによれば、デーモンのパッケージがないとき bootstrap は呼び出し元のパッケージをそのフォルダーにコピーし、単体の実行ファイルではそれを用意できません。Homebrewやnpmでインストールした場合の自動起動がこのフォルダーを作るかどうかは、ここでは検証していません。フォルダーがあれば、パッケージマネージャーでのアンインストールのあとに、それと ~/.codex/app-server-daemon を削除してください。²⁰ 上のパッケージマネージャーによるアンインストールは ~/.codex/ に触れません。Homebrewの --zap も実際には同様です。caskの唯一のzap節は rmdir: "~/.codex" で、Homebrewは rmdir: をすでに空のディレクトリにしか適用しません。² そのディレクトリには config.toml、保存された認証情報、すべてのセッションが入っており、だからこそ再インストールするとログインと履歴が前回の続きから始まります。本当にまっさらな状態が欲しいときだけ削除し、スクリプトでのインストールでそれが何を意味するかを知っておいてください。

rm -rf ~/.codex   # discards config.toml, credentials, all sessions -- AND the CLI itself on a script install

状態を保ったままのクリーンな再インストールは、npmなら一行です。npm uninstall -g @openai/codex && npm install -g @openai/codex@latest。スクリプト経路では、インストーラーを再実行すると ~/.codex/packages/standalone/releases の下に新しいリリースが追加されて current がそれを指すように付け替えられ、古いリリースはあなたが削除するまでそのまま残ります。設定もそのまま残ります。¹²

ライフサイクル全体を表一つで

codex doctor は何を検査しますか？

codex doctor は、バグを報告する前や「昨日は動いていた」インストールをデバッグする前に実行するコマンドです。0.153.4では一つのレポートに七つのセクションを収めます。Notes、Environment（ランタイムとインストールの整合性）、Configuration（config.toml の読み込み状態、認証、MCP、サンドボックスポリシー）、Desktop App（v0.149.0で追加）、Updates、Connectivity、Background Serverです。--summary はコンパクト表示、--json は秘匿処理済みの機械可読形式、--all は省略されたリストの展開、--no-color はログ用です。0.153.4の codex doctor --help には --ascii も載っています。v0.162.0では、設定されたTUIモードがレポートに加わりました。^7131522 「Codexが壊れた」という報告の大半は、最初の画面で名指しされる何かに行き着きます。古い認証モード、パースに失敗した config.toml、あるいは PATH 上のものを隠している二つ目のインストールです。セクションごとの完全な解説はガイドにあります。

インストール後に変わること

新規インストールが最初につまずくのはバイナリではありません。v0.149.0以降、CLIは approval_policy = "untrusted" では起動を拒否するため、古いマシンからコピーした config.toml には一箇所の修正が必要です。¹³ Claude Codeから来ましたか？ 移行の記事は二つの設定を並べて対応づけており、フックの記事はCodexがモデルの周りで何を実行するかを扱っています。Codex CLIガイドが完全なリファレンスです。サンドボックスと承認モード、AGENTS.md、MCP、スキル、クラウドタスクまで。両方のツールを使っているなら、Claude Codeのインストールページがこのページの双子です。

よくある質問

Codex CLIを最新バージョンに更新するには？

codex update（v0.128.0以降）を実行してください。スクリプト、npm、Homebrewのどれでインストールしたかを検出し、そのチャネルのアップグレードを実行します。手動の対応は、インストールスクリプトの再実行、npm install -g @openai/codex@latest、または brew upgrade --cask codex です。wingetでのインストールは codex update が認識するチャネルではないので、そちらは winget upgrade OpenAI.Codex を使ってください。

Codex CLIは自動的に更新されますか？

CLIは自動では更新されませんが、例外が1つあります。TUIが新しいリリースを確認してインストールチャネルに合った更新コマンドを提示し、codex update（v0.128.0以降）がそれを実行します。例外は、v0.157.0以降Codexがデフォルトで起動するバックグラウンドサーバーです。latest チャネルでは起動の5分後、以後は1時間ごとに更新を確認し、古いスクリプトインストールから最初に起動されたサーバーは、latest のインストールでチャネルが記録されていれば、CLI自身のパッケージである ~/.codex/packages/standalone を更新します。これを止めるには、~/.codex/app-server-daemon/settings.json に "updater": { "autoUpdateEnabled": false } を設定し、codex app-server daemon restart を実行してください。

Codex CLIはどうやってアンインストールしますか？

バックグラウンドサーバーが動いていればまず停止し（codex app-server daemon stop）、それからインストールした経路を使ってください。npm uninstall -g @openai/codex、brew uninstall --cask codex、または winget uninstall OpenAI.Codex です。パッケージマネージャーでのアンインストールは ~/.codex/packages/app-server-daemon と ~/.codex/app-server-daemon を残すので、それらがないか確認してください。スクリプトでのインストールなら、同じように停止してから、~/.local/bin/codex のシンボリックリンク（macOSでは ~/.local/bin/codex-code-mode-host も）、~/.codex/packages/standalone ディレクトリ、そしてサーバーの ~/.codex/packages/app-server-daemon と ~/.codex/app-server-daemon を削除します。Windowsでは、スクリプトでのインストールは %USERPROFILE%\.codex\packages\standalone（とサーバーの packages\app-server-daemon と app-server-daemon フォルダー）、%LOCALAPPDATA%\Programs\OpenAI\Codex\bin のジャンクション、ユーザー PATH のエントリで、すべて削除してください。設定、認証情報、セッションは、あなたがそのディレクトリの残りを自分で削除するまで ~/.codex/ に残ります。

WindowsにCodex CLIをインストールするには？

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" を実行してください。CLIはWindowsサンドボックスとともにPowerShellでネイティブに動作します（prefer_mxc = true を設定してデバイスが対応していればMicrosoft Execution Containers、そうでなければ設定したレガシーモードで、未設定なら elevated です。[windows] sandbox = "mxc" を明示的に選ぶと、MXCを使うか失敗するかのどちらかで、フォールバックはありません）。WSL2はLinuxツールが必要なときやどのサンドボックス実装も合わないときの選択肢であって、必須ではありません。Windows 11が推奨ベースラインです。winget install OpenAI.Codex も動作しますが、安定版ラインから遅れています。

Codexのインストールにはnode.jsが必要ですか？

npm経路だけで、パッケージはNode 16以降を要求します。インストールスクリプト、PowerShellスクリプト、Homebrewのcaskはいずれもコンパイル済みの codex バイナリを提供するので、NodeのないマシンでもCodexを実行できます。

自分のCodexのバージョンを確認するには？

codex --version が表示します（例：codex-cli 0.163.0）。npm view @openai/codex version は公開されている最新バージョンを示し、codex doctor はインストールパスと、PATH 上の別のコピーがそれを隠していないかを報告します。