Date
2026/06/03
Category
Codex
Title
Codex CLI インストール手順|Mac/Linux/Windows
「Codex CLIをインストールしたいけれど、Mac・Linux・Windowsで手順が違いそうで不安」「公式インストーラとnpm、Homebrew、どれを選べばいいのか分からない」——そんな声を中小企業のIT担当者からよく聞きます。本記事では codex cli install をテーマに、3OSすべての公式インストール手順、認証フロー、初期設定、社内導入で詰まりやすいポイントまでを、株式会社Fyveがクライアント現場で得た知見と公式情報をもとに整理します。読み終わるころには、Mac・Linux・Windowsのどの端末でも迷わず導入できる状態を目指します。
Codex CLIは、OpenAIが開発するターミナル常駐型のAIコーディングエージェントです。ローカルのファイルを読み・書き・実行する権限を持ったAIが、対話形式で開発作業を進めてくれます。2026年現在の最新版はRustで書かれており、起動が軽く、Mac・Linux・Windowsのいずれのネイティブ環境でも動作します。
インストール作業に入る前に、3つの前提を押さえておくと、後段の手順で迷うことが激減します。
結論から言うと、私たちが中小企業のクライアント環境で標準採用しているインストール方法は、OSごとの公式シェルスクリプトです。npmやHomebrewといった選択肢もありますが、公式スクリプトが最もトラブルが少なく、アップデート時の挙動も統一されています。

macOSのターミナルで以下のコマンドを実行してください。Apple Silicon(M1/M2/M3/M4)・Intel Macのどちらでも同じコマンドです。Claude CodeやCodexに「ターミナルを開いてこのコマンドを実行し、完了後にバージョン確認まで進めて」と頼めば、初心者でも安心して進められます。
curl -fsSL https://chatgpt.com/codex/install.sh | shcodex --versionインストール完了後、ターミナルを一度閉じて再度開くと、PATH設定が反映されて codex コマンドが認識されます。
Ubuntu・Debian・Rocky Linux・Amazon Linux 2023など、主要ディストリビューションで同一コマンドが使えます。シェルがbashまたはzshであれば追加設定は不要です。CI/CD環境やDocker内で運用する場合は環境変数による非対話型認証も可能ですが、まずはローカル端末で対話型認証を一度通しておくのが安全です。
curl -fsSL https://chatgpt.com/codex/install.sh | shcodex --versionWindowsでは、管理者権限でPowerShellを開いて以下のコマンドを実行します。中小企業のWindows環境では、社内システム部門経由でPowerShellの実行ポリシー変更が必要なケースもあるため、事前に確認しておくとスムーズです。
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"codex --versionこのコマンドは「現在のセッションだけ実行ポリシーをByPassにして、公式インストーラを取得・実行する」という指示です。PowerShellの設定そのものを変更するわけではないため、企業のセキュリティポリシー的にも比較的通りやすい書式になっています。
Windows環境では、インストール後にコマンドプロンプトまたはPowerShellを再起動してから codex を実行してください。
公式シェルスクリプトが社内ポリシーで使えない場合や、すでにnpm・Homebrewで開発環境を統一している場合は、パッケージマネージャー経由のインストールも選択できます。私たちのクライアントでは、Node.js環境をすでに持っている開発チームに対してはnpm経由を推奨することもあります。
Node.js 22以降があれば npm install -g @openai/codex で導入できます。パッケージ名は必ず @openai/codex(スコープ付き)を指定してください。スコープなしの codex パッケージは2012年に作られた無関係の古いプロジェクトです。誤って後者をインストールすると意味の分からないエラーが出て原因特定に時間を取られます。クライアント現場でも実際に1社、ここで半日溶かしたケースがありました。
Homebrewで開発ツールを管理しているMacユーザーは brew install codex が使えます。ただしHomebrewの更新サイクルに依存するため最新版反映に数日のラグが出ます。最新機能をすぐ試したい場合は公式シェルスクリプト方式の方が早いです。
社外ネットワークからのcurl実行が禁止されている企業では、GitHubのReleasesページから対応プラットフォームのバイナリ(例:macOS Apple Siliconなら codex-aarch64-apple-darwin.tar.gz、Windows x86_64なら codex-windows-x86_64.zip)を直接ダウンロードし、PATHの通ったディレクトリに配置する方法が使えます。配布物を一度社内サーバーにステージングしてから展開する企業に向いている方式です。
インストール完了後、ターミナルで codex を実行します。初回起動時に2つの認証選択肢が表示されます。

OPENAI_API_KEY を読みに行く方式。CI環境や自動化サーバー向け中小企業の業務利用であれば、まずはChatGPTサインイン一択です。すでに会社でChatGPT Businessを契約済みであれば、追加コストなしでCodex CLIが使えるようになります。これは私たちが顧問契約先に最初に伝える、最も費用対効果の高いポイントの1つです。サインイン完了後、対話プロンプトが表示されれば導入完了です。
インストールと認証が終わった直後、追加で設定しておくと社内運用が安定する項目があります。すべてオプションですが、私たちのクライアントには標準で案内している内容です。
2026年6月時点のCodex CLIは、GPT-5.5 Codexをデフォルトモデルとして自動選択します。基本的にこのままで問題ありませんが、明示的に確認・変更したい場合は対話プロンプトで /model と入力します。GPT-5.4・GPT-5.3-Codexなど複数モデルから選択できます。最初は深く考えずデフォルトで運用するのが楽です。
Codex CLIは起動したディレクトリ配下のファイルすべてを参照可能になります。ホームディレクトリ直下で起動すると、AIが意図せず個人ファイルを読みに行ってしまう可能性があります。必ずプロジェクト専用ディレクトリに移動してから起動する運用を社内ルール化してください。私たちが顧問契約先にAIツール導入する際は、この運用ルールを社内ドキュメント化するところまで伴走しています。
Windowsネイティブ版のCodex CLIは、AppContainerベースのサンドボックスでファイルシステム書き込みとネットワーク接続を制限しています。OpenAI公式が「experimental(実験的)」と表記している領域です。業務環境で導入する場合は、社内共有ドライブへの書き込みと社内プロキシ経由のAPI通信が想定通り動くかを、導入初日に必ず検証してください。
私たちの経験では、社内プロキシ環境で7割のWindows端末は標準動作、3割で追加設定が必要、というのが2026年春時点の体感値です。
導入が完了したら、以下の3ステップで動作確認をしてから社内展開に進むのがおすすめです。クライアント現場で実際に使っているチェックリストです。
codex --version を実行し、バージョン番号が表示されることを確認。コマンド未認識の場合はターミナル再起動かPATH設定を見直すcodex 起動後、対話プロンプトで「Hello」と入力し、AIから返答が来るかで認証成立を確認ここまでは公式手順ベースの一般論ですが、私たちが実際の中小企業導入で繰り返し見てきたWindows環境ならではのハマりどころを3つ共有します。
Restricted が強制されていると、-ExecutionPolicy ByPass がグループポリシーで上書きされる。情シスと相談し開発者用PCに RemoteSigned 以上を付与する交渉が必要HTTP_PROXY・HTTPS_PROXY を明示設定すれば解消するchcp 65001 でコードページをUTF-8に切り替えれば解決するケースがほとんど無事に導入が完了したら、次は実際の業務で使い倒すフェーズに入ります。Codex CLIは「インストールして満足」では効果が出ません。毎日の業務のどこに組み込むかが本質的な差を生みます。
Codex CLIの全体像と他CLI版機能の解説はこちらの記事で詳しく扱っています。
初心者向けにCodex全般を順序立てて学びたい方は、こちらが導入動線として最適です。
VSCode拡張版との使い分けを検討中の方には、こちらの記事が参考になります。
本記事ではCodex CLIをMac・Linux・Windowsの3OSすべてに導入する手順を、公式情報と中小企業導入経験をもとに整理しました。要点は以下の通りです。
curl -fsSL https://chatgpt.com/codex/install.sh | shpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"@openai/codex(スコープ必須)、Macなら brew install codex株式会社Fyveでは中小企業向けに月15万円の専属AI活用顧問サービスを提供しています。Codex CLI導入から業務フロー組み込み、社員教育、運用ルール策定までを月10時間の作業枠で伴走します。「インストールはできたが次に何をすればいいか分からない」段階の企業に最も効果が出る設計です。初月無料で全機能を試せます。
Company
株式会社Fyve
Address
〒810-0001
福岡県福岡市中央区天神4丁目6-28
天神ファーストビル7階
Tel
080-1460-2728
info@fyve.co.jp