Mac で使う OpenAI Codex のインストール手順と初期設定
OpenAI が提供する Codex は、AI を活用してコーディングを大幅に効率化するツールです。macOS 向けには専用のデスクトップアプリと、ターミナルから使える Codex CLI の 2 種類が用意されており、用途やスキルレベルに合わせて選択できます。本記事では、Mac への具体的なインストール手順から初期設定、日常的なコーディングタスクの依頼方法、そして macOS ならではの注意点まで、実際の操作フローに沿って解説します。
OpenAI Codex は 2026 年 2 月にmacOS 専用デスクトップアプリとして正式リリースされ、複数のエージェントを並列で動かしながらコーディングを自動化できる環境を提供します。Apple Silicon（M1 以降）および Intel Mac の両方に対応したバイナリが公式サイトから入手できます。
インストールは GUI アプリと CLI の 2 ルートがあり、どちらもChatGPT アカウントまたは OpenAI API キーで認証します。Plus・Pro・Business・Enterprise・Edu プランのユーザーは追加費用なしで利用できます。
2026 年 4 月のアップデートで追加されたコンピューター操作機能により、Codex がスクリーンを認識してカーソルを動かし、Finder・Xcode・Safari などのネイティブアプリを横断したタスクを自律的にこなせるようになりました。Mac ユーザーにとって特に恩恵が大きいアップデートです。
目次 (18)
- Codex の概要と macOS 対応状況
- macOS での動作要件
- インストール方法：デスクトップアプリと CLI の 2 つのルート
- ルート 1: Codex デスクトップアプリ
- ルート 2: Codex CLI（ターミナル）
- 初期設定と OpenAI アカウント認証
- ChatGPT アカウントで認証する場合
- API キーで認証する場合
- 実際の使い方：コーディングタスクの依頼方法
- デスクトップアプリの操作フロー
- CLI でのタスク依頼
- コンピューター操作機能（2026 年 4 月追加）
- macOS 特有の注意点とトラブルシューティング
- Gatekeeper ブロックへの対処
- Apple Silicon と Rosetta
- Node.js バージョンの競合（npm 経由でインストールした場合）
- macOS のファイルアクセス権限
- Codex の料金と無料枠
Codex の概要と macOS 対応状況
OpenAI Codex は、大規模言語モデルを活用してコードの生成・編集・テスト実行までをエンドツーエンドで処理するエージェント型コーディングツールです。もともと API として提供されていた技術が、2026 年 2 月に macOS ネイティブアプリとして生まれ変わりました。
OpenAI 公式ブログ「Introducing the Codex app」 によると、Codex アプリはプロジェクトごとにスレッドを分離して並列管理できる設計になっており、複数の作業を同時並行で進めてもコンテキストが失われません。2026 年 3 月には Windows 版も追加されましたが、macOS 版は Apple Silicon に最適化されたバイナリが用意されており、M1 以降の Mac では処理速度の恩恵を最大限に受けられます。
macOS での動作要件
Codex デスクトップアプリの動作要件は以下のとおりです。
- macOS Ventura (13.0) 以降
- Apple Silicon（M1、M2、M3 以降）または Intel チップ搭載 Mac
- インターネット接続（エージェント処理はクラウドで実行）
- ChatGPT アカウント（Plus 以上推奨）または OpenAI API キー
Codex アプリ公式ドキュメント には Apple Silicon 版と Intel 版の両ダウンロードリンクが掲載されており、自分の Mac に合ったバイナリを選択できます。
インストール方法：デスクトップアプリと CLI の 2 つのルート
Codex を Mac で使うには、GUI 操作を好むユーザー向けのデスクトップアプリと、ターミナルワークを好むユーザー向けの Codex CLI の 2 通りがあります。どちらも同じ OpenAI アカウントで認証でき、それぞれに適した用途があります。デスクトップアプリはビジュアルな差分確認や並列スレッド管理に優れており、CLI はスクリプトや既存のターミナル操作フローに組み込みやすい点が特徴です。
ルート 1: Codex デスクトップアプリ
developers.openai.com/codex/app にアクセスして「Download for macOS」ボタンをクリックします。Apple Silicon 版と Intel 版が別リンクで提供されているため、自分の Mac のチップ種別（アップルメニュー → この Mac について で確認可能）に合ったものをダウンロードしてください。
- ダウンロードした
.dmgファイルを開き、Codex.app をアプリケーションフォルダへドラッグします。 - 初回起動時、macOS の Gatekeeper が「開発元を確認できません」と表示する場合があります。システム設定 → プライバシーとセキュリティ → 「このまま開く」をクリックして許可します。
- アプリが起動したら、画面の指示に従って ChatGPT アカウントでサインインするか、API キーを入力します。
ルート 2: Codex CLI（ターミナル）
Codex CLI 公式ドキュメント では、ワンコマンドで全環境に対応したインストーラーを実行する方法が案内されています。
- ターミナルを開き、以下のインストールコマンドを実行します。
curl -fsSL https://chatgpt.com/codex/install.sh | sh
- インストールが完了したら、
codexと入力してエンターキーを押します。 - 初回起動時に認証フローが始まり、ブラウザが開いて ChatGPT アカウントへのログインを求められます。
Homebrew ユーザーは brew install codex でも導入できます。また npm 経由では npm install -g @openai/codex（Node.js 18 以上・npm 8 以上が前提）で同様にインストール可能です。Homebrew または公式インストーラーを使う場合は Node.js の事前インストールは不要です。
初期設定と OpenAI アカウント認証
インストール後の初回起動では、必ず認証を完了させてから実際の作業に入ります。認証方法は「ChatGPT アカウント」と「API キー」の 2 択です。用途や利用規模によって選択が変わるため、それぞれの特徴を把握したうえで設定を進めましょう。
ChatGPT アカウントで認証する場合
デスクトップアプリを起動すると「Sign in with ChatGPT」ボタンが表示されます。クリックするとブラウザが開き、openai.com のログインページに遷移します。ここで普段 ChatGPT を使っているアカウントの認証情報を入力してサインインすると、アプリへ自動でリダイレクトされ、セッションが確立されます。
CLI の場合も同様に、codex 初回起動時にブラウザが自動で開き、同じフローで認証できます。ブラウザが自動起動しない場合は、ターミナルに表示される URL をコピーしてブラウザに貼り付けてください。
API キーで認証する場合
platform.openai.com の「API Keys」ページで新しいキーを発行し、アプリの設定画面または CLI の対話プロンプトに貼り付けます。API キー認証を使う場合は、従量課金（Pay as you go）でのアクセスとなり、利用量に応じてクレジットが消費されます。個人開発やカジュアルな利用には ChatGPT アカウント認証のほうがコストを見通しやすくおすすめです。
認証後はプロジェクトフォルダを選択します。デスクトップアプリでは「+ New Project」からフォルダを指定するだけです。CLI の場合は cd でプロジェクトディレクトリに移動してから codex を起動すれば、そのディレクトリがコンテキストになります。
実際の使い方：コーディングタスクの依頼方法
認証とプロジェクト設定が完了すると、すぐにコーディングタスクを依頼できます。Codex はテキストで指示を受け取り、コードを生成・編集・テスト実行して結果を返す一連のフローを自律的にこなします。
デスクトップアプリの操作フロー
- 画面左のサイドバーからプロジェクトを選択し、「New Thread」をクリックします。
- メッセージ入力欄に自然言語で依頼を書きます。例えば「この Python スクリプトに型ヒントを追加して、mypy でエラーが出ないようにして」のように具体的に指示します。
- エージェントが実行中はスレッドに進捗が表示されます。複数のスレッドを同時に走らせることも可能で、並列処理による時間短縮が図れます。
- 完了後はアプリ内の「Review」ペインで差分を確認し、変更を承認またはロールバックします。
CLI でのタスク依頼
ターミナルで codex を起動した後、プロンプトに依頼内容を入力します。
> 現在のディレクトリの main.ts に ESLint エラーを修正するコードを書いて
CLI には「完全自律モード」と「確認ありモード」があり、--auto-edit フラグを付けると確認なしでファイルを編集します。慎重に作業したい場合はデフォルトの確認ありモードを推奨します。詳しいオプション一覧は codex --help で確認できます。
コンピューター操作機能（2026 年 4 月追加）
Codex コンピューター操作ドキュメント に詳細があるとおり、2026 年 4 月のアップデートで Codex がスクリーンを認識しながら Mac を直接操作できるようになりました。Xcode でのビルド確認、Safari でのレンダリングチェック、Figma でのデザイン参照といった、従来は人が手動でブリッジしていた操作を Codex 自身が行います。バックグラウンドで複数エージェントが動作する際も、あなた自身の作業とカーソルが干渉しないよう設計されています。
macOS 特有の注意点とトラブルシューティング
macOS 環境特有のはまりポイントをまとめます。
Gatekeeper ブロックへの対処
公式インストーラー以外から取得した Codex バイナリを実行しようとすると、「開発元を確認できないため開けません」というダイアログが出ることがあります。この場合は以下のいずれかで対処します。
- システム設定 → プライバシーとセキュリティ → セキュリティ欄の「このまま開く」をクリック。
- または以下のコマンドで検疫属性を削除します。
xattr -d com.apple.quarantine /usr/local/bin/codex
Apple Silicon と Rosetta
M1 以降の Mac で Intel 向けバイナリを誤ってダウンロードした場合、Rosetta 2 を通じて動作するため起動時に変換処理が発生し、初回のみ時間がかかります。パフォーマンスを最大化するために、ダウンロード前にチップの種類を確認し Apple Silicon 版を選ぶようにしてください。
Node.js バージョンの競合（npm 経由でインストールした場合）
npm 経由でインストールした場合は Node.js 18 未満の環境で動作しません。node -v でバージョンを確認し、古い場合は nvm install 20 && nvm use 20 などで更新してください。公式インストーラーや Homebrew 経由であれば Node.js は不要です。
macOS のファイルアクセス権限
Codex がファイルやフォルダにアクセスしようとすると、macOS がアクセス許可ダイアログを表示することがあります。特にデスクトップや書類フォルダを操作する際は、システム設定 → プライバシーとセキュリティ → ファイルとフォルダ で Codex アプリへの権限を付与してください。
Codex の料金と無料枠
Codex 公式ドキュメント によると、Codex の料金体系は ChatGPT の有料プランに含まれる形で提供されています。ChatGPT Plus（月額 20 ドル）・Pro・Business・Enterprise・Edu のいずれかに加入していれば、追加費用なしで Codex の CLI・ウェブ版・IDE 拡張・デスクトップアプリのすべてにアクセスできます。
リリース当初の限定期間中は ChatGPT Free および Go プランでも利用可能で、Plus 以上のプランではレート制限が通常の 2 倍に引き上げられるキャンペーンが実施されました。API キー経由で利用する場合は従量課金となり、生成トークン量に応じてコストが発生します。
2026 年 6 月時点では、Codex の機能が ChatGPT アプリ本体へ統合される方向で開発が進んでおり、今後はさらに広いプランのユーザーが追加コストなしで利用できるようになる見込みです。最新の料金情報は OpenAI の Codex ページ で随時アップデートされています。
macOS で Codex を使い始めるための全手順を解説しました。デスクトップアプリと CLI のどちらを選ぶかはワークスタイル次第ですが、まずはデスクトップアプリで直感的に操作感をつかんでから、慣れてきたら CLI に移行するのがスムーズな進め方です。macOS 固有のアクセス権限や Gatekeeper の挙動を事前に把握しておくことで、セットアップ時の躓きを最小限に抑えられます。
