Codex CLIのインストール手順｜Windows・Mac対応

公開: 2026年8月3日

Codex CLIは、npmコマンド1つでWindows・Mac・Linuxのどの環境にも導入できます。この記事では、npmとHomebrewを使ったインストール手順、起動からChatGPTアカウントでのサインインまでの流れ、動作確認の方法を、実際のコマンド例とともに解説します。所要時間は5分程度です。

前提・動作環境

対応OS: macOS、Linux、Windows(公式にネイティブ対応したバイナリが提供されています)
Node.js: npm経由でインストールする場合はNode.js 22以降が必要です
アカウント: ChatGPT Plus以上のプラン、またはOpenAIのAPIキー
シェル: Windowsの場合はPowerShell、Mac・LinuxはTerminal(bash/zsh)

Codex自体がどんなツールかまだ把握していない方は、先に「Codexとは?できることや料金を解説」を読んでおくと、インストールする意味が理解しやすくなります。

インストール方法を選ぶ

Codex CLIには主に3つのインストール方法があります。

方法	コマンド	対応OS
npm	`npm install -g @openai/codex`	Windows / Mac / Linux
Homebrew	`brew install --cask codex`	Mac
インストールスクリプト	`curl -fsSL https://chatgpt.com/codex/install.sh \| sh`	Mac / Linux

すでにNode.jsを導入済みであれば、OSを問わず動くnpm経由のインストールが最もシンプルです。Node.jsを入れたくない場合は、Rust製バイナリを直接取得するインストールスクリプトやHomebrewを使う方法もあります。

npmでインストールする(Windows・Mac・Linux共通)

Node.js 22以降がインストール済みであることを確認したら、ターミナル(WindowsならPowerShell)で次のコマンドを実行します。

npm install -g @openai/codex

注意点として、npmのパッケージ名は必ずスコープ付きの @openai/codex を指定してください。スコープなしの codex という名前のパッケージは無関係の別ツールなので、誤ってインストールしないよう気をつけましょう。

Macでインストールする(Homebrew)

Homebrewを使っている場合は、npmより簡単にインストールできます。

brew install --cask codex

npmと違いNode.jsのバージョンを気にする必要がなく、Homebrewの brew upgrade でそのままアップデートできる点がメリットです。Mac・Linuxでは、Homebrewの代わりに公式のインストールスクリプトを使うことも可能です。

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

Windowsでインストールする際の注意点

Windowsでは、npm経由のインストールが最も安定した方法です。事前にNode.js 22以降を公式サイトからインストールしておき、PowerShellで npm install -g @openai/codex を実行してください。インストール後に codex コマンドが認識されない場合は、npmのグローバルインストール先(npm config get prefix で確認できます)にPATHが通っているか確認しましょう。

なお、Linux向けのツールチェーンに慣れている方や、サンドボックス機能をより厳密に使いたい方は、WSL2(Windows Subsystem for Linux)上にCodex CLIを導入する方法もあります。WSL2上であればMac・Linuxと同じ手順(npmまたはインストールスクリプト)がそのまま使えます。

起動とサインイン

インストールが終わったら、作業したいプロジェクトのフォルダに移動してから codex を実行します。

cd my-project
codex

初回起動時にサインイン方法を選ぶ画面が表示されます。

Sign in with ChatGPT: ChatGPTアカウント(Plus以上のプラン)でブラウザ経由でログインします。追加のAPI課金なしで利用できる方法で、多くのユーザーにはこちらが推奨されています。
APIキーでサインイン: OpenAIのAPIキーを使う方法です。使った分だけ課金される従量課金制になります。

どちらの方法でも、一度サインインすれば認証情報が保存され、次回以降はログインなしで codex を起動できます。Codexの基本的な操作方法は「Codex CLIの使い方を解説」で詳しく紹介しています。

動作確認とアップデート

インストールが正しく完了しているかは、バージョン確認コマンドで確認できます。

codex --version

codex-cli 0.21.0

数字の部分はリリース時期によって変わりますが、このような形式でバージョンが表示されれば成功です。

アップデートは、インストールした方法と同じコマンドを再実行するだけです。

# npmでインストールした場合
npm install -g @openai/codex

# Homebrewでインストールした場合
brew upgrade --cask codex

# インストールスクリプトを使った場合
curl -fsSL https://chatgpt.com/codex/install.sh | sh

つまずきポイント/よくあるエラー

codex: command not found と表示される: npmのグローバルインストール先にPATHが通っていません。npm config get prefix で表示されたディレクトリ配下の bin(Windowsでは直下)をPATHに追加してください。
無関係な codex パッケージが入ってしまった: npmで npm install -g codex のようにスコープなしでインストールすると、別の無関係なパッケージが入ります。一度アンインストールし、@openai/codex を指定し直してください。
npmインストール時にNode.jsのバージョンエラーが出る: Node.js 22未満だとインストールに失敗することがあります。Node.jsを最新のLTS版にアップデートしてから再実行してください。
サインイン画面がブラウザで開かない: 社内ネットワークやプロキシ環境が原因で、認証用URLへのアクセスがブロックされている場合があります。表示されたURLを手動でブラウザに貼り付けてアクセスすると解決することがあります。

よくある質問

npmとHomebrew、どちらでインストールすべきですか?

すでにNode.js 22以降が入っていればnpmが簡単です。Node.jsを管理したくないMacユーザーは、Homebrewやインストールスクリプトを使う方法がおすすめです。

ChatGPTアカウントとAPIキー、どちらでサインインすべきですか?

ChatGPT Plus以上のプランに加入済みなら、追加課金なしで使える「Sign in with ChatGPT」が手軽です。従量課金で細かく管理したい場合や組織でAPIキーを発行している場合はAPIキーでのサインインを選びましょう。

Windowsでネイティブ動作とWSL2、どちらが良いですか?

通常の利用であればWindowsネイティブ(npm経由)で問題ありません。Linux向けの開発環境をすでに使っている場合や、サンドボックス機能を厳密に使いたい場合はWSL2上への導入も検討してください。

まとめ

Codex CLIは npm install -g @openai/codex を実行するだけで、Windows・Mac・Linuxのどの環境にも導入できます。Macであれば brew install --cask codex を使う方法もあり、どちらも導入後は codex コマンドで起動し、ChatGPTアカウントまたはAPIキーでサインインすれば準備は完了です。codex --version で正しくインストールされたか確認し、アップデートはインストール時と同じコマンドを再実行するだけです。インストール後の具体的な使い方は「Codex CLIの使い方を解説」、より実践的な活用方法は「Codexの使い方完全ガイド」、Codex全体の概要をまだ確認していない方は「Codexとは?できることや料金を解説」もあわせてご覧ください。