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.153.4（2026年9月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.153.4でした。¹²¹⁰
• Codex自体のインストールにはwingetを避けてください。 OpenAIは OpenAI.Codex パッケージを公開していますが、0.147.0から0.152.0までのマニフェストのプルリクエストが2026年8月7日以降 microsoft/winget-pkgs でマージされないまま溜まっており、執筆日にインストールできる最新版は、npmの0.153.4に対して0.146.1です。³¹⁰
• codex update はスクリプト、npm、Homebrewのインストールをカバーします（v0.128.0以降）。TUIがすでに持っていたインストールチャネルの検出を再利用し、対応するアップグレードを実行します。wingetでのインストールは認識するチャネルに含まれないため、そちらは winget upgrade OpenAI.Codex で更新してください。残りの手動の対応は、インストーラーの再実行、npm install -g @openai/codex@latest、または brew upgrade --cask codex です。⁴¹¹
• バージョン固定は、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)
brew install --cask codex

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

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

codex --version      # codex-cli 0.153.4
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 にリネームしてください。¹⁵

インストーラーは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でネイティブに動作し、サンドボックスモードは二つあります。elevated が推奨モードで、専用の低権限サンドボックスユーザー、ファイルシステムの権限境界、ファイアウォールルール、ローカルポリシーの変更を使い、管理者が承認するセットアップが必要です。unelevated はフォールバックで、あなたのユーザーから派生した制限付きWindowsトークンとACLベースのファイルシステム境界でコマンドを実行します。⁸ モードは config.toml で選びます。

[windows]
sandbox = "elevated"   # or "unelevated"

OpenAIの指針は、デフォルトではネイティブサンドボックスを使い、Linuxネイティブのツールが必要なとき、ワークフローがすでにWSL2にあるとき、あるいはどちらのネイティブWindowsサンドボックスモードも要件に合わないときにWSLを選ぶ、というものです。⁸ 一つ区別しておくべきこと：Windowsのセットアップは自身のセットアップ手順のためにマシンに winget があることを前提としますが、それはwingetを通じてCodexをインストールすることとは別です。OpenAIはそのパッケージを公開しています。リリースワークフローには、安定版リリースについて microsoft/winget-pkgs にマニフェストのプルリクエストを開く winget ジョブがあります。しかし、それらの提出は0.146.1のマニフェストが2026年8月7日にマージされて以降、マージされずに溜まっています。0.147.0から0.152.0までのリクエストは執筆時点ですべて未処理のままで、0.153.0から0.153.4についてはリクエスト自体が存在しません。CLIには何の問題もありません。パッケージのインデックスが遅れているだけです。³⁸

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

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

Codexは自分自身を更新しません。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 でのみ更新されます。⁴ 手動の対応は、そちらを好む場合やマシンイメージをスクリプト化している場合のために、次のとおりです。

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.150.0から0.153.4までが2026年8月26日から9月4日のあいだに出荷されているので、「自分が使っているもの」と「最新」の差は四半期ではなく一週間であることが多いのです。⁹

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

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

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

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

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

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

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

インストールした経路で削除します。

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 を追加します。¹² すべて削除します。

rm -f ~/.local/bin/codex ~/.local/bin/codex-code-mode-host   # the second link exists on macOS installs only
rm -rf ~/.codex/packages/standalone

インストール時に ~/.local/bin が PATH になかった場合、あるいはインストーラーが競合するHomebrew、npm、bunのインストールを見つけてエントリを書き換えた場合、スクリプトはシェルのプロファイルにもマークされたブロックを追記しています。~/.zprofile（macOSのzsh）、~/.bash_profile、~/.zshrc、~/.bashrc、または ~/.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 に書き込みます。まずstandaloneディレクトリを削除し、次に参照先を失ったbinジャンクションを削除し、最後に環境変数のユーザー Path 変数からエントリを取り除きます。¹⁷

Remove-Item -Recurse -Force "$env:USERPROFILE\.codex\packages\standalone"   # releases plus the current junction
cmd /c rmdir "$env:LOCALAPPDATA\Programs\OpenAI\Codex\bin"                  # the bin junction; rmdir removes the link, not a target

上のパッケージマネージャーによるアンインストールは ~/.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 の下のリリースが置き換わり、設定はそのまま残ります。¹²

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

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 も載っています。⁷¹³¹⁵ 「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は自動的に更新されますか？

いいえ。TUIが新しいリリースを確認してインストールチャネルに合った更新コマンドを提示し、codex update（v0.128.0以降）がそれを実行します。あなたが実行するまで、何もダウンロードも適用もされません。

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

インストールした経路を使ってください。npm uninstall -g @openai/codex、brew uninstall --cask codex、または winget uninstall OpenAI.Codex です。スクリプトでのインストールなら、~/.local/bin/codex のシンボリックリンク（macOSでは ~/.local/bin/codex-code-mode-host も）と ~/.codex/packages/standalone ディレクトリを削除します。Windowsでは、スクリプトでのインストールは %USERPROFILE%\.codex\packages\standalone、%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でネイティブに動作します（elevated が推奨、unelevated がフォールバック）。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.153.4）。npm view @openai/codex version は公開されている最新バージョンを示し、codex doctor はインストールパスと、PATH 上の別のコピーがそれを隠していないかを報告します。