Codex アプリがインストールできないときの原因と対処法

Codex の動作要件を確認する

インストールを始める前に、使っているマシンの OS バージョンと環境が Codex の動作要件を満たしているかを確認する。要件を確認せずにインストールを進めると、途中でエラーが出るか、インストール後に起動しないという問題につながる。公式の要件は Codex の公式ページ（openai.com/codex）に記載されており、最新情報はそちらで確認するのが確実だ。

Codex デスクトップアプリは macOS と Windows を対象としており、Linux 向けデスクトップアプリは 2026 年 6 月現在では未対応だ。CLI（Codex CLI）については Linux も対応しているが、Node.js 22 以上の事前インストールが必要になる。Codex がどの入口を通じて提供されているかは複数あるため、自分が使いたい経路に合った要件を確認することが大切だ。

macOS の動作要件

macOS では macOS 12 Monterey 以上が必要だ。現在使っているバージョンは、画面左上のアップルメニューから「この Mac について」を開いて確認できる。macOS 11 Big Sur 以前のマシンでは Codex のデスクトップアプリが起動しないため、OS のアップグレードが必要になる。Apple Silicon（M1/M2/M3/M4 シリーズ）と Intel の両方に対応したユニバーサルバイナリが提供されているため、CPU の種類は問わない。ストレージの空き容量は最低でも 500MB 以上を確保しておくとインストールが安定しやすい。

Windows での要件と注意点

Windows では Windows 10 バージョン 1903（ビルド 18362）以上が必要で、Windows 11 は全バージョンで対応している。32 ビット版 Windows には対応していないため、64 ビット版の Windows が前提だ。企業が管理する Windows 端末では、ソフトウェアのインストールに管理者権限が必要になるケースが多い。管理者権限がない場合は個人でできる対処法がなく、IT 部門への権限申請が必要になる点に注意が必要だ。また、Windows Defender または社内のアンチウイルスソフトのリアルタイム保護が有効な場合に、インストーラーの実行をブロックすることがある。

macOS でインストールが失敗するとき

macOS での Codex インストールでよく起きるトラブルは、Apple の Gatekeeper によるブロックだ。Gatekeeper は Apple の公証を受けていないアプリや、Mac App Store 以外で配布されているアプリを自動的にブロックする仕組みで、Codex のアプリが新しくリリースされた直後や、公証手続きが更新に追いついていない場合に弾かれることがある。Gatekeeper のブロック以外にも、ダウンロードしたファイルの破損や、ディスク容量不足によるインストール失敗も起きる（参照: OpenAI Codex サポート | OpenAI Help Center）。

Gatekeeper がアプリをブロックするとき

Codex の .dmg ファイルをダウンロードして開こうとすると、「"Codex" は Apple によって確認されていないため開けません」または「開発元を確認できないため開けません」というダイアログが表示されることがある。このエラーが出た場合は次の手順で回避できる。

1. Finder でダウンロードした Codex のファイルを Ctrl キーを押しながらクリック（または右クリック）する。
2. コンテキストメニューから「開く」を選択する。
3. 確認ダイアログが表示されたら「開く」ボタンをクリックする。

この操作により Gatekeeper の警告を一時的に回避して開くことができる。一度この手順を踏むと、以降は通常通りダブルクリックで開けるようになる。「システム設定」→「プライバシーとセキュリティ」→「セキュリティ」の画面でも「このまま開く」ボタンが表示されている場合はそこから許可できる。

「破損しているため開けません」エラーが出るとき

「"Codex.app" は壊れているため、ゴミ箱に入れてください。」というメッセージが表示される場合は、ファイルの破損またはコード署名の問題が原因であることが多い。まずはダウンロードしたファイルを削除して、公式の Codex リリースページ（openai.com/codex）から改めてダウンロードし直すことを試みる。それでも同じエラーが出る場合は、ターミナルで次のコマンドを実行するとコード署名のキャッシュをクリアできる。

xattr -cr /Applications/Codex.app

このコマンドは Codex.app に付与されているクォランティン属性を削除する。ブラウザでダウンロードしたファイルには OS が自動でクォランティン属性を付けるため、Gatekeeper がそれをトリガーにブロックする仕組みだ。パス（/Applications/Codex.app）は Codex.app を実際に配置した場所に合わせて変更する。

Codex CLI が入らない・動かないとき

Codex CLI はターミナルから npm でインストールするが、前提となる Node.js のバージョンが古いとインストールコマンドが失敗する。また、グローバルインストール時の書き込み権限不足や、npm のキャッシュが壊れていることが原因でエラーになることもある。エラーメッセージを手がかりに原因を特定して対処する（参照: Codex CLI リポジトリ | GitHub）。

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

Codex CLI は Node.js 22 以上を必要とする。現在インストールされている Node.js のバージョンは node --version で確認できる。バージョンが 22 より古い場合は、Node.js の公式サイト（nodejs.org）からバージョン 22 LTS 以上をダウンロードしてインストールし直す必要がある。または nvm（Node Version Manager）を使って複数のバージョンを管理する方法もある。

node --version   # v22.x.x 以上であることを確認する
npm install -g @openai/codex

nvm を使う場合は nvm install 22 && nvm use 22 で Node.js 22 に切り替えてから npm install を実行するとよい。バージョン切り替え後はシェルを再起動するか source ~/.bashrc（zsh の場合は source ~/.zshrc）を実行してパスを更新する。

EACCES 権限エラーが出るとき

グローバルインストール（-g フラグ付き）で EACCES: permission denied エラーが出る場合は、npm のグローバルディレクトリへの書き込み権限がないことが原因だ。sudo を付けて解決する方法もあるが、npm のグローバルインストールディレクトリをホームディレクトリ配下に変更する方法が推奨される。

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'

この設定を行った後、~/.bashrc または ~/.zshrc に export PATH=~/.npm-global/bin:$PATH を追加してシェルを再読み込みし、改めて npm install -g @openai/codex を実行すると権限エラーなくインストールできる。

npm install が途中で止まるとき

インストール中にプロセスが止まってしまう場合は、npm のキャッシュが壊れている可能性がある。キャッシュをクリアしてから再試行すると解決することが多い。

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

それでも止まる場合はネットワーク接続を確認し、VPN や企業プロキシを経由している環境ではプロキシ設定が npm に反映されているかどうかをチェックする。プロキシ設定は npm config get proxy で確認できる。

アカウント・認証まわりのトラブル

Codex のアプリはインストールできても、サインイン時にエラーになるケースがある。Codex は OpenAI アカウントで認証するが、アカウントの状態やプランによってはサインインが弾かれる。インストール自体は成功しているのにサインインできない場合は、アカウント側の問題を確認するのが先決だ。

プランと利用資格を確認する

Codex のデスクトップアプリや Cloud 機能は、ChatGPT Plus または Pro に加入しているアカウント、あるいは Codex のアクセスが開放されたアカウントが対象になっている。無料プランのアカウントでもサインイン画面には進めることがあるが、その後の機能利用でエラーが表示されることがある。OpenAI のアカウント管理ページ（platform.openai.com）でプランを確認し、Codex が使えるプランに加入しているかどうかをチェックしてから再試行する。

ブラウザ認証が完了しないとき

Codex は初回サインイン時にブラウザを経由した認証を行う。アプリがブラウザを開いてサインインページを表示するが、その後「認証が完了しました」という画面が出ても Codex アプリ側に戻らないケースがある。この場合は一度アプリを終了して再起動し、もう一度サインインを試みる。それでも解決しない場合は、使用しているブラウザのキャッシュをクリアするか、別のブラウザをデフォルトブラウザとして設定して試すとうまくいくことがある。ブラウザのポップアップブロックが有効になっている場合も認証ウィンドウが開かない原因になるため、ポップアップを許可する設定も確認しておく。

それでも解決しないとき

上記の手順を試しても問題が解決しない場合は、OpenAI のヘルプセンター（help.openai.com）のサポートフォームから問い合わせる。問い合わせ時は OS のバージョン、表示されるエラーメッセージの全文、インストールしようとしている Codex のバージョン番号を添えると対応が早い。エラーメッセージはスクリーンショットか、テキストをそのまま貼り付けて送ると伝わりやすい。

Codex CLI を使っている場合は GitHub のリポジトリ（github.com/openai/codex）の Issues タブで同様の問題が報告されていないかを確認する方法もある。新しいリリース直後に発生する既知のバグについては、Issues に回避策が投稿されていることがある。インストールを試みた環境の詳細（OS バージョン、Node.js バージョン、エラーの全文）をまとめて Issue に投稿すると、コミュニティからの回答も得やすい。