はじめに
本記事では、OpenAI Codex CLI の最新情報（2025年11月時点）をもとに、macOS および Windows（WSL2含む） の両環境で素早くセットアップできる方法をまとめます。
Codex CLI は、OpenAI が提供するターミナル上で動作するコーディング支援エージェントであり、ChatGPT の知識を活かしながら、コード補完、生成、解析、ドキュメント化などを行えます。開発者がエディタを離れずに、自然言語による開発支援を受けられる点が魅力です。
最新情報サマリ
概要
- Codex CLI は OpenAI が開発するコーディング支援CLIツール。
- オープンソースで GitHub 上に公開されています。
- 対応プラットフォーム：macOS／Linux（公式）、Windows は WSL2 経由での利用が推奨。
主なインストール方法
-
npm（Node.js）経由でのグローバルインストール：
npm install -g @openai/codex -
bun 経由でのインストール（高速な代替手段）：
bun install -g @openai/codexbun は npm より高速に動作し、特に macOS・Linux 環境でおすすめです。Bun 未導入の場合は以下で導入可能：
curl -fsSL https://bun.sh/install | bash -
macOS向け Homebrew インストール：
brew install codex -
GitHub Releases からの直接ダウンロード：
OS別バイナリが用意されています。
要件・注意事項
- macOS 12 以降、Ubuntu 20.04 以降が推奨。
- Windows は WSL2 経由での実行を推奨。
- Node.js または Bun の最新バージョンが必要（推奨：Node.js v22 以上／Bun v1.1 以上）。
- 初回起動時に ChatGPT アカウントまたは API キーの設定が必要。
1. 前提条件・動作環境
| 項目 | 内容 |
|---|---|
| 対応OS | macOS 12以降／Windows11 (WSL2推奨) |
| 必要ツール | Node.js / npm または Bun、Homebrew |
| 認証 | ChatGPT アカウントまたは OpenAI APIキー |
APIキーは以下のように環境変数で設定できます。
export OPENAI_API_KEY="your_api_key"
Windows PowerShell では：
setx OPENAI_API_KEY "your_api_key"
2. Macでのインストール手順
2.1 npmでのインストール
node --version
npm install -g @openai/codex
codex --version
2.2 Bunでのインストール
bun install -g @openai/codex
codex --version
BunはNode.jsより高速で、Macの開発環境に最適です。
2.3 Homebrewでのインストール
brew update
brew install codex
codex --version
2.4 バイナリでのインストール
-
GitHub Releases から対応バイナリをダウンロード。
-
解凍し、実行権限を付与。
chmod +x codex mv codex /usr/local/bin/
2.5 初回起動・認証
codex
起動後、サインインまたはAPIキーの設定を求められます。
3. Windowsでのインストール手順
3.1 WSL2の利用を推奨
- Windowsの「機能の有効化」でWSLを有効化。
- UbuntuなどのディストリビューションをMicrosoft Storeからインストール。
3.2 WSL2上でのnpmまたはBunインストール
npmの場合
npm install -g @openai/codex
Bunの場合
bun install -g @openai/codex
確認：
codex --version
3.3 Windowsネイティブバイナリ（実験的）
- GitHub ReleasesからWindows用バイナリをダウンロード。
- PATHに追加して実行可能に。
3.4 初回起動・認証
codex
サインイン画面またはAPIキー設定画面が開きます。
4. 共通の初期設定
設定ファイルは以下の場所に生成されます：
~/.codex/config.toml
設定例
model = "gpt-5-codex"
model_reasoning_effort = "medium"
hide_agent_reasoning = true
[tools]
web_search = true
5. 動作確認
簡単なテストとして、以下を実行してみましょう。
codex "Explain this Python code"
CLI上でAIによる解説が返ってくれば成功です。
6. トラブルシューティング
| 問題 | 原因 | 対処 |
|---|---|---|
codex コマンドが見つからない |
PATH未設定 | npmまたはBunのグローバルパスを再確認 |
| 認証画面が出ない／APIキーMissing | 設定ミス | 環境変数または設定ファイルを確認 |
| Windowsネイティブで動作しない | 制限あり | WSL2経由で再試行 |
| Node.js/Bunバージョンエラー | 旧バージョン利用 | 最新版を利用（Node.js v22+ または Bun v1.1+） |
まとめ
- Codex CLIは、ChatGPT技術をターミナル操作に持ち込む強力な開発支援ツール。
- macOSではHomebrewまたはBun、WindowsではWSL2＋npm/Bun経由が安定的。
- 初回認証と設定ファイルの構築で、すぐに開発支援AIを利用可能。
開発者にとって、Codex CLIは「手元で動くコーデ