Codex CLI のインストール方法：macOS・Windows・Linux で OpenAI のコーディングエージェントを使い始める

概要

Codex CLI は、ターミナル上で OpenAI のコーディングエージェントを利用するためのツールです。ただし 2026 年時点では、古い npm install -g @openai/codex だけを見て進めると、インストール方法や認証方式、PATH、ネットワーク設定でつまずくことがあります。

最短で安全に確認するなら、公式スクリプトまたは普段使っているパッケージマネージャーでインストールし、codex --version が実行できることを確認してから、テスト用プロジェクトで codex を起動します。失敗した場合は、すぐ再インストールを繰り返すのではなく、PATH、認証、ネットワークポリシー、現在の shell 環境を順番に確認します。

背景

Codex CLI のインストール方法を検索すると、古い情報もまだ見つかります。「Node.js 22 以上が必要」「codex --login を使う」「brew install codex を実行する」といった記述は、現在のバージョンや環境によっては正しくない場合があります。

公式 README では macOS、Linux、Windows が対象です。公式インストールスクリプト、npm、macOS の Homebrew cask、GitHub Release のバイナリなど複数の導入経路があります。重要なのは、どの認証方式を使うか、ターミナルから本当に codex が見えているか、会社・学校・VPN・プロキシ・セキュリティゲートウェイが通信を遮断していないかです。

インストール前の確認

まず現在の実行環境とコマンドパスを確認します。

node -v
npm -v
which node
which npm
uname -m

npm でインストールする場合、現在の npm パッケージの engines は node >=16 です。実運用では新しい LTS を使うのが無難です。nvm、fnm、volta を使っている場合は、グローバル npm パッケージのインストール先も確認します。

npm config get prefix
which codex

Windows では PowerShell/Windows Terminal で直接使うのか、WSL2 で使うのかを先に決めます。PATH、認証ファイル、設定場所が別になることがあります。

Codex CLI のインストール方法

方法 1：公式スクリプト

macOS または Linux では公式 README のコマンドを使えます。

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows PowerShell では次の形式です。

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

社内ポリシーでリモートスクリプトの実行が制限される場合は、先に内容を確認するか、npm、Homebrew、GitHub Release を使います。

方法 2：npm

npm install -g @openai/codex
codex --version
which codex

nvm で Node バージョンを切り替えると、グローバルパッケージの場所も変わることがあります。which codex が想定と違う場合は、再インストールより先に PATH を確認します。

方法 3：Homebrew

brew install --cask codex

古い記事にある brew install codex と cask は同じではありません。

方法 4：GitHub Release

パッケージマネージャーが使えない場合は、GitHub Releases から対象プラットフォーム用のバイナリをダウンロードします。

Apple Silicon Mac：codex-aarch64-apple-darwin.tar.gz
Intel Mac：codex-x86_64-apple-darwin.tar.gz
Linux x86_64：codex-x86_64-unknown-linux-musl.tar.gz
Linux arm64：codex-aarch64-unknown-linux-musl.tar.gz

chmod +x codex
sudo mv codex /usr/local/bin/codex
codex --version

ログインと認証

初回実行では通常ログインフローに入ります。

codex

公式 README では ChatGPT アカウントでのログインが推奨されています。利用可否は Plus、Pro、Business、Edu、Enterprise などのプランやワークスペース設定に関係する場合があります。API Key も利用できますが、OPENAI_API_KEY を設定するだけですべて解決するわけではありません。組織、課金、プロジェクト、モデル権限、Codex 設定も確認します。

export OPENAI_API_KEY="***"

$env:OPENAI_API_KEY="***"

基本的な使い方

cd my-project
codex

まずは読み取り中心の依頼で確認します。

このプロジェクトの構成を要約してください。

正常に動くことを確認してから小さな変更を依頼し、テストと Git diff で自分でも検証します。

トラブルシューティング

ケース 1：`codex: command not found`

実行ファイルが PATH にない、または別の Node バージョンのグローバルパッケージ配下に入っている可能性があります。

npm config get prefix
which codex
npm bin -g
echo $SHELL

ケース 2：Homebrew のコマンドが記事と違う

brew list | grep -i codex
brew list --cask | grep -i codex

公式 README の現在のコマンドと照合し、必要なら誤った項目を削除して cask を入れ直します。

ケース 3：ログインできたのに使えない

正しい ChatGPT アカウントでログインしているか
個人アカウントと会社/学校ワークスペースを混同していないか
現在のプランに Codex 利用権限があるか
API Key の組織、プロジェクト、課金、モデル権限が正しいか

ケース 4：WebSocket の再接続やタイムアウト

会社ネットワーク、VPN、プロキシ、SSL inspection が chatgpt.com や OpenAI 関連通信を遮断していないか確認します。

npm install -g @openai/codex@latest
codex --version

ケース 5：環境変数が見えない

printenv OPENAI_API_KEY >/dev/null && echo "set" || echo "missing"

実際のキーをログや文書に出さないようにします。

ケース 6：macOS のセキュリティで補助ツールがブロックされる

codex --version
codex doctor

rg などの補助実行ファイルが Gatekeeper や quarantine 属性で止まる場合があります。

ベストプラクティス

このリポジトリの構成を説明してください。
テストの実行方法を探してください。
このエラーログの原因を可能性順に整理してください。

変更前には git status を確認し、変更後は npm test や npm run build を実行します。API Key、顧客データ、本番パスワード、内部 token をプロンプトや設定ファイルに貼り付けないでください。

よくある間違い

Node バージョンだけで判断する

多くの失敗は PATH、グローバル npm パス、nvm 切り替え後のインストール場所が原因です。

古いインストールコマンドをそのまま使う

Codex CLI は変化が速いため、公式 README と最新 Release を先に確認します。

API Key と ChatGPT ログインを混同する

認証問題はインストール問題に見えがちです。

変更結果を検証しない

Codex はコードを変更できますが、プロジェクトの意図に必ず合うとは限りません。diff とテストで確認します。

結論

Codex CLI のインストール自体は難しくありません。時間がかかるのは、PATH、認証、アカウント権限、ネットワークポリシー、shell 環境の差分です。症状ごとに確認すれば、無駄な再インストールを減らせます。

参考文献

韓国語原文：この記事は韓国語原文をもとに、日本語読者向けに用語、確認手順、注意点を整理しています。韓国語原文を見る。