CodexインストールMac｜方法と現行版・トラブル対処の確認

CodexインストールMacで最初に選ぶ入口

Macで「Codexを入れる」と考えたとき、最初に決めるのは同じ名前の入口を混ぜないことです。Codex CLIはターミナルから現在のフォルダーを作業場所として使うため、コードを読む、ファイルを編集する、確認結果を見るという流れを自分の開発環境に合わせられます。一方、Codexアプリは画面からプロジェクトや会話を扱い、複数の作業を見比べるときに向いています。どちらもAIコーディングエージェントですが、起動方法、設定の置き場所、問題が起きたときに見る画面が違います。

導入前に「ターミナル中心か、画面中心か」「コードはMacのローカルフォルダーにあるか」「Homebrewやnpmをすでに使っているか」を確認します。CLIとアプリを同日に入れても構いませんが、最初の動作確認は一つに絞る方が原因を追いやすくなります。

CLIを選ぶ場合

CLIは、すでにターミナルでGitや開発用のコマンドを使っている人に自然な入口です。プロジェクトのフォルダーへ移動してからcodexを起動するため、どのコードを対象にしているかを意識しやすく、返ってきた差分をローカルのエディターで確認できます。公式READMEではMacまたはLinux向けにシェル形式の導入方法が案内され、Homebrewとnpmも選択肢になっています。導入方法が複数あるからこそ、最初に一つを選び、実行ファイルの場所を控えておくことが大切です。

Codexアプリを選ぶ場合

アプリは、ターミナルのコマンドを覚えるより、プロジェクトと作業の状態を画面で見たい人に向いています。OpenAIの公式紹介では、macOS向けのCodexアプリで複数のエージェントを別々のスレッドとして扱い、差分を見てエディターへ戻る考え方が説明されています。アプリを入れたことはCLIのcodexコマンドが使える証明ではありません。アプリとCLIを比べるときは、入口ごとの版、開いているプロジェクト、結果の確認場所を分けて記録します。

導入前にMacの状態を確認する

導入がうまくいかないとき、原因はインストーラーそのものではなく、MacのCPU種別、macOSの版、シェルのPATH、既存のCodexの残りであることがあります。まず状態を記録しておけば、Homebrewからnpmへ切り替えたときも何が変わったのかを比較できます。現在のターミナルがzshか、別のシェルかも確認し、設定を追加する場所を間違えないようにします。

特にApple SiliconのMacではarm64用、Intel Macではx86_64用の実行ファイルを選びます。見た目が同じMacでも配布物が異なるため、友人や同僚から受け取った手順をそのまま使わず、手元の結果を基準にしてください。

Step 1: Apple SiliconかIntelかを確認する

ターミナルを開き、次のコマンドでCPU種別とmacOSの版を確認します。uname -mがarm64ならApple Silicon、x86_64ならIntel Macです。system_profilerの結果も残すと、Rosettaを介したターミナルを使っていないかを確認しやすくなります。

uname -m
sw_vers -productVersion
system_profiler SPHardwareDataType | grep -E "Chip|Processor Name|Memory"

Apple SiliconなのにターミナルだけがIntel向けとして動いている場合、Homebrewの場所やnpmの導入先が分かれることがあります。最初の導入では、通常使うターミナルを一つに決め、上の結果と導入先をセットで保存します。

Step 2: シェルと必要な道具を確認する

公式インストーラーを使うなら、ネットワークへ接続できること、curlとshが使えることを確認します。Homebrewを使うならbrew、npmを使うならnodeとnpmの版も記録します。環境の確認は次のようにまとめられます。

echo "$SHELL"
command -v curl
command -v brew
command -v node
command -v npm

すべてのコマンドが見つかる必要はありません。公式インストーラーだけを使うならHomebrewやnpmは不要です。逆に、npmを選ぶならNode.jsの導入経路も揃え、複数のNode管理方法がPATHに混ざっていないかを確認します。

公式インストーラーでCodex CLIを導入する

現在のOpenAI Codex公式READMEでは、MacまたはLinux向けにhttps://chatgpt.com/codex/install.shを使う方法が示されています。インストーラーはMacの種類に合うCLIを用意し、終わった後にcodexコマンドを呼び出せる状態を作ります。実行前にURLが公式READMEと一致することを確認し、ターミナルへ貼り付けた内容を読み違えないようにします。公式の案内はOpenAI CodexのREADMEで確認できます。

導入後の確認までを一つの作業と考えることが重要です。インストーラーが完了した表示だけでは、今開いているシェルが新しいPATHを読んでいるか、別のCodexを優先していないかまでは分かりません。次の手順で導入、シェルの再読み込み、版番号の確認を順に行います。

Step 3: 公式のinstall.shを実行する

通常のターミナルで次のコマンドを実行します。管理者権限を最初から付ける必要はありません。途中で権限や保存先を尋ねられた場合は、表示されたパスを読み、意図した場所かを確認して進めます。

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

1. 実行前に、公式READMEの導入行とURLが一致していることを確認します。
2. 表示されたMacのアーキテクチャ、取得された版、PATHに関する案内を控えます。
3. 終了後にターミナルを新しく開き、同じMacで新しいシェルを使います。

コマンドが途中で止まった場合は、同じものを何度も繰り返す前に、最後に表示された行を保存します。通信の制限、証明書、保存先の権限、既存のCodexとの衝突を分けて調べると、再導入だけを繰り返さずに済みます。

Step 4: Homebrewまたはnpmで導入する

Homebrewを普段から使っているなら、公式READMEにあるbrew install --cask codexを選べます。Node.js環境をすでに管理しているなら、npm install -g @openai/codexも候補です。どちらが優れているというより、更新の管理場所をどこに置くかの違いです。同じMacで公式インストーラー、Homebrew、npmを順番に試すと複数の実行ファイルが残りやすいため、まず一つの方法で確認します。

brew install --cask codex

# npmを使う場合
npm install -g @openai/codex

Homebrewを選んだ場合はbrew list --cask codexで管理対象を確認し、npmを選んだ場合はnpm config get prefixでグローバルな導入先を確認します。導入元を切り替える前に、現在のcommand -v codexとcodex --versionを保存しておくと、版の混在を見つけられます。

Step 5: GitHub Releasesの配布物を使う

パッケージ管理ツールを使わず、配布された実行ファイルを版ごとに置きたい場合は、公式のGitHub Releases一覧からMac向けの資産を選びます。Apple Siliconはcodex-aarch64-apple-darwin.tar.gz、Intel Macはcodex-x86_64-apple-darwin.tar.gzです。名称に含まれるaarch64とx86_64を確認してから取得してください。

1. uname -mの結果と一致するMac向けアーカイブを選びます。
2. ダウンロードしたアーカイブを展開し、中の実行ファイルの名前と権限を確認します。
3. 自分で管理する$HOME/.local/binなどへ置く場合は、その場所をPATHへ追加してからcommand -v codexを実行します。
4. 公式のリリースページに表示されたチェックサムを使える場合は、取得物の値と照合します。

配布物を手で置く方法は、版を固定しやすい一方、更新とPATH管理を自分で行う必要があります。導入後にcodex --versionが返らない場合は、実行権限、CPU種別、PATHの順に確認します。Macのシステム領域へ無理に置かず、管理場所を一つに決める方が後から追跡しやすくなります。

インストール直後に起動とサインインを確認する

Codex CLIは、導入が終わっただけでは実際の作業へ入っていません。現在のシェルが呼び出している実体、表示された版、ChatGPTへのサインイン、プロジェクトを開いた場所を確認して、初回の状態を記録します。ここを省くと、後でアプリを開いたときにCLIと同じ設定が使われているのか判断しにくくなります。

導入直後の確認は、問題が起きたときの基準点にもなります。版番号、実行ファイルの場所、MacのCPU、使った導入方法を同じメモに残しておけば、更新や再起動の後にどこが変わったかを比べられます。サインインできたことと、対象プロジェクトを正しく開けたことも別の確認項目として扱います。

Step 6: 実行ファイルと版番号を確認する

新しいターミナルで次のコマンドを実行します。command -vは現在選ばれている実行ファイルの場所、type -aは同名の候補を含めた情報を表示します。Homebrew、npm、個別配置のいずれを選んでも、ここで実体を確認できるようにします。

command -v codex
type -a codex
codex --version

表示されたパスが想定と違うなら、PATHの順番を変える前に、どの導入方法で置かれたファイルかを調べます。/opt/homebrew/binはApple SiliconのHomebrewでよく使われ、/usr/local/binはIntel Macや個別設定で見かけますが、場所だけで正しいと決めつけません。版番号と導入元を一緒に記録してください。

Step 7: ChatGPTでサインインして小さな確認を行う

codexを実行すると、初回はブラウザーを使ったChatGPTへのサインインを求められます。画面の案内に従ってサインインし、ターミナルへ戻った後に、まず読み取り中心の小さな依頼を試します。プロジェクトの場所を明示し、目的、変更してよい範囲、結果を確認する方法を短く伝えると、初回から大きな差分を作らずに済みます。

1. 対象プロジェクトへ移動し、pwdで現在地を確認します。
2. codexを起動し、サインイン画面と表示されたアカウントを確認します。
3. 最初は構成の説明や対象ファイルの一覧など、結果を読みやすい依頼から始めます。
4. 返ってきた説明と差分を読み、意図したフォルダーを扱っているかを確認します。

Codexアプリから始める場合も考え方は同じです。プロジェクトの選択、サインイン状態、結果を確認する場所を分けて見ます。CLIが起動したからといってアプリ側の作業が完了したことにはならず、アプリが起動したからといってターミナルのPATHが直ったことにもなりません。

CodexアプリをMacへインストールする

デスクトップアプリを使いたい場合は、OpenAIのCodexアプリ公式紹介から現在の案内へ進みます。この紹介記事はmacOS向けアプリの発表と、2026年3月4日にWindows対応が追加されたことを説明しています。Mac向けの記事を読むときも、CLIの導入ページとアプリのダウンロードページを混ぜずに確認します。

アプリは、複数の作業を画面で切り替えたいとき、差分を見ながらエディターへ戻りたいときに便利です。一方、ターミナルの既存設定、シェルのPATH、Homebrewの管理状態を直接直すものではありません。アプリを入れた後にCLIも使うなら、両方を同時に変更せず、アプリの起動確認とCLIの版確認を別々に済ませます。

Step 8: 公式ページからアプリを入れる

アプリの導入では、検索結果にある第三者の再配布ページではなく、OpenAIの案内からダウンロードへ進みます。ダウンロードしたファイルを開き、アプリケーションフォルダーへ移した後、初回起動の表示とサインイン画面を確認します。macOSが開発元や権限について警告した場合は、表示内容を読み、公式ページから取得したファイルかを確認してから判断します。

1. OpenAIの公式Codexアプリ案内を開き、Mac向けの現在のダウンロード先を確認します。
2. Macのチップ種別に合う案内を選び、取得元のドメインを確認します。
3. アプリケーションフォルダーへ移し、初回起動、サインイン、プロジェクトの表示を確認します。
4. CLIも使う場合は、別のターミナルでcommand -v codexとcodex --versionを実行します。

アプリの版とCLIの版は別に表示されることがあります。問い合わせや不具合の記録には、アプリの情報画面、CLIの版番号、MacのCPU種別、再現した入口を一緒に残すと、同じ問題を一つにまとめずに済みます。

2026年8月29日時点の現行版を確認する

今回の時事フックは、Mac向けの導入手順が新しくなったという単発の発表ではなく、公式の配布方法とリリースの並びが更新され続けていることです。GitHubのCodex Releasesでは、2026年8月27日に0.150.1がLatestとして公開され、2026年8月28日には0.151.0-alpha系の先行版も並んでいます。0.150.1の変更欄には、保持した画像を圧縮時の予算へ含める修正が記載されています。

これは、Macへ導入する版を数字の大きさだけで決めない方がよいという意味です。先行版の新しい機能を試したい場合は用途を限定し、通常の開発環境では安定版を基準にします。記事や動画が別の日の版を紹介していても、実行前に公式ReleasesでLatest、Pre-release、対象CPUの配布物を確認してください。

Step 9: 安定版と先行版を分けて記録する

リリース一覧を開いたら、版番号だけでなく、安定版か先行版か、公開日、使った導入経路を記録します。Macに複数のCodexがあると、先行版を入れたつもりでも別の安定版が起動することがあります。次のような表を自分のメモへ作ると比較しやすくなります。

この記録があれば、更新後に挙動が変わっても、版の変更と導入経路の変更を分離できます。先行版を常用する必要がない場合は、安定版のリリースページに戻り、CPUに合う配布物を選び直します。

Step 10: 更新前後の確認を同じ条件で行う

更新するときは、いきなり大きなプロジェクトで試さず、まず同じターミナル、同じフォルダー、同じ短い依頼で結果を比べます。codex --versionが変わったことだけでは、実際の問題が直ったとは限りません。起動、プロジェクトの読み取り、差分の表示、必要な確認の四つを分けて見ます。

Homebrewならbrew info --cask codex、npmならnpm list -g @openai/codexで管理元の状態も確認できます。公式インストーラーを使った場合は、導入時に表示された保存先とcommand -v codexを比べます。更新後に別の実体が選ばれていたら、導入を繰り返す前にPATHの候補を整理します。

Macで起きやすい問題と切り分け

Macの導入トラブルは、「インストールが失敗した」と一言でまとめないことが解決への近道です。ダウンロードできない、実行ファイルが見つからない、見つかるが起動しない、起動するがサインインやプロジェクト表示で止まる、という段階を分けます。各段階で見る情報が違うため、導入方法を変える前にエラーの全文、版番号、CPU種別、実行場所を残してください。

エラーの表示は短く見えても、前後の行に原因の手がかりが含まれることがあります。ターミナルの入力、最後に成功したコマンド、Macのスリープや再起動の有無も控え、同じ条件で再現するかを確認します。ひとつの設定を変えた後にもう一度同じ確認を行うと、どの変更が影響したかを追いやすくなります。

Step 11: codexが見つからない場合

zsh: command not found: codexと表示されたら、最初にターミナルを新しく開き、command -v codexを実行します。それでも見つからない場合は、導入が完了していないか、導入先がPATHに含まれていません。Homebrewならbrew list --cask codex、npmならnpm config get prefixを確認し、表示された場所とシェルの設定を照合します。

command -v codex
type -a codex
brew list --cask codex 2>/dev/null
npm config get prefix
echo "$PATH"

PATHへ新しい場所を加える場合は、現在使っているシェルに合う設定ファイルへ一つずつ追加します。設定を変えた後は新しいターミナルで再確認し、複数の候補が出たら最初の行だけで判断しません。

Step 12: CPU種別と実行ファイルが合わない場合

Apple SiliconなのにIntel向けの配布物を選んだ、またはIntel Macへarm64用を置いた場合、起動失敗や予期しない互換性の問題につながります。uname -m、command -v codex、file "$(command -v codex)"を実行して、選んだ配布物と実体を照合します。ターミナルをRosettaで開いている場合は、通常のターミナルでも同じ結果になるかを比べます。

uname -m
command -v codex
file "$(command -v codex)"

配布物を取り直すときは、先に現在のファイルをどの方法で入れたか記録します。Homebrew管理のファイルを手で置き換えたり、npmの導入先だけを消したりすると、次の更新時に同じ混乱が起きます。導入元を一つに絞り、版番号まで確認します。

Step 13: npm導入後に起動できない場合

GitHubの公式Issueには、macOS 15.6のApple Siliconでnpm install -g @openai/codex自体は完了する一方、ネイティブ実行ファイルの起動で失敗する報告があります。すべてのMacで起きる現象ではありませんが、導入完了と起動成功は別に確認すべきだと分かります。報告の詳細はopenai/codexのIssue #21199で確認できます。

この場合はNode.jsの版、npmの導入先、MacのCPU種別、codex --versionのエラーを保存します。Homebrewや公式インストーラーへ切り替える前に、別の方法で起動できたか、どの版で失敗したかを比較します。問題が特定のNode.jsや配布物に限られるなら、無関係な設定まで変えずに済みます。

Step 14: サインインやアプリ起動で止まる場合

CLIの版番号が返るのにサインイン画面から戻れない場合は、ブラウザーで使っているアカウント、既定ブラウザー、ネットワークの制限を順に確認します。アプリが起動直後に閉じる場合は、アプリの版、macOSの版、直前に変更した設定、CLIでは再現するかを分けて記録します。アプリの不具合をCLIのPATH問題として扱わないことが大切です。

サインインをやり直す前に、画面に出た案内と時刻を保存し、同じ操作を短時間に繰り返さないようにします。公式のダウンロード先から取得したか、アプリの情報画面に表示される版が何か、別のMacや別の入口で同じ結果になるかを確認すれば、アカウント、アプリ、通信のどこに原因があるかを切り分けやすくなります。

初回のコーディング作業を小さく始める

Codexは、導入した直後に大きな改修を依頼するより、作業場所と確認方法を確かめる小さな依頼から始める方が使いやすくなります。Macのファイル権限、ターミナルの現在地、プロジェクトの構成、結果の見方を一度に確認できるからです。導入チェックと実際の開発作業を分けることで、問題が出たときに導入と依頼内容を混同しません。

最初の作業では、Codexの返答をそのまま採用するのではなく、Macの画面とプロジェクトの状態を照合します。現在地が合っているか、説明されたファイルが実際に存在するか、変更が依頼した範囲に収まっているかを確認します。この小さな照合を習慣にすると、CLIとアプリを使い分けるときも判断の基準がぶれません。

Step 15: 読み取り中心の依頼から始める

最初の依頼は、プロジェクトの構成、使用言語、起動方法、関連ファイルを説明してもらう内容にします。変更を求めず、対象フォルダーを限定し、返答に含めてほしい項目を伝えると結果を読みやすくなります。説明が現在地と合っているかを自分で確認し、次の依頼へ進む前に対象範囲を決めます。

1. pwdで作業場所を表示します。
2. codexを起動し、対象フォルダーと目的を伝えます。
3. ファイルの変更を行わず、構成と確認方法の説明を受けます。
4. 説明に出たファイルを自分のエディターで開き、現在地と一致するか確認します。

この手順なら、Codexが別のフォルダーを見ていたり、Mac側と別の環境を参照していたりする問題に早く気づけます。説明が正しくても、次の編集でどこまで任せるかは改めて決め、差分を読む時間を確保してください。

Step 16: 変更後の差分と確認結果を読む

小さな修正を依頼した後は、変更されたファイル、変更理由、実行した確認、残っている注意点を順番に読みます。Codexが「完了」と返しても、自分の目的と一致しているとは限りません。Macで使うCLIやアプリの違いにかかわらず、結果を採用する判断は利用者が行います。

確認内容をメモへ残すと、次回の依頼を改善できます。導入経路、Codexの版、MacのCPU、プロジェクトの場所、変更したファイル、確認したコマンドを一組にして記録します。版を更新した後も同じ確認を行えば、道具の更新と作業結果の変化を比べやすくなります。

まとめ

Codex インストール Macの要点は、CLI、Codexアプリ、GitHub Releasesの配布物を別の入口として扱い、Apple SiliconかIntelかを確認してから導入することです。CLIなら公式READMEにあるcurl、Homebrew、npmから一つを選び、アプリならOpenAIの公式案内から取得します。導入後はcommand -v codex、type -a codex、codex --versionで実体と版番号を確認し、アプリの版とは分けて記録します。

2026年8月29日時点では、GitHub Releasesの安定版0.150.1を通常利用の基準にし、0.151.0-alpha系は用途を限定して扱うのが分かりやすい判断です。起動できないときは、再導入を急がず、CPU、導入経路、PATH、版番号、エラー表示を順番に切り分けます。最後に読み取り中心の小さな依頼で現在地と結果を確かめれば、MacでのCodex利用を落ち着いて始められます。

参照した公式URL

• OpenAI Codex公式README
• Codexのインストールとビルド
• OpenAI Codex Releases
• OpenAIのCodexアプリ紹介
• macOS arm64での起動問題に関する公式Issue