Codex CLIのインストール方法｜Mac・Windows・Linux別の手順とログインまで

「Codex CLIを使ってみたいけれど、インストールのコマンドが何通りもあって、どれを使えばいいのか分からない」「Windowsでも動くのか、WSLが必要なのか、記事によって書いてあることが違う」と迷っていないでしょうか。

Codex CLIは、OpenAIのAIエージェント「Codex」を、パソコンのターミナル（文字でコマンドを入力して操作する画面）から使うための道具です。現在の公式の手順では、Mac・Linuxはコマンド1行、WindowsはPowerShellでコマンド1行でインストールでき、Node.jsも必要ありません。

この記事では、インストールの前に確認すること、方法の選び方、OS別の手順、ログインと最初の設定、アップデート、よくあるエラーの対処までを順に説明します。内容は2026年10月時点の公式ドキュメントとGitHubのREADMEをもとにしています。コマンドや対応環境は変わることがあるので、実行する前に公式ページもあわせて確認してください。

インストールの前に確認すること

Codex CLIとは

Codex CLIは、OpenAIが提供する、パソコン上で動くコーディングエージェント（プログラムを書いたり直したりするAI）です。プロジェクトのフォルダでターミナルから起動すると、Codexがファイルを読み、修正し、コマンドを実行しながら作業を進めます。「このプロジェクトの中身を説明して」「このエラーの原因を調べて直して」のように日本語で頼めます。

CLIは「コマンドライン・インターフェース」の略で、マウスではなく文字の入力で操作する道具のことです。黒い画面に慣れていない人には少し取っつきにくいですが、スクリプトに組み込んで決まった作業を自動化しやすいという強みがあります。

デスクトップアプリで足りないか

Codexは、CLIのほかにChatGPTのデスクトップアプリやVS Codeなどの拡張機能からも使えます。デスクトップアプリでは、フォルダを選んで画面上で依頼し、できあがったファイルや変更点をそのまま確認できます。ターミナルの操作に慣れていない場合は、まずデスクトップアプリで十分なことが多いです。

GitHubのREADMEでは、デスクトップアプリを使いたい場合はCLIからcodex appを実行するか、Codexのアプリのページを開くよう案内されています。両方を入れて、場面によって使い分けることもできます。

必要なもの

• アカウント：ChatGPTの有料プラン（Plus・Pro・Business・Edu・Enterprise）か、OpenAIのAPIキー。公式の料金ページでは、Free・Goプランで案内されているのはデスクトップアプリでの利用で、CLIはPlus以上とAPIキーの欄に載っています
• パソコン：macOS（Apple Silicon・Intel）、Linux（x86_64・arm64）、Windows。Windowsは11が推奨で、10の場合はバージョン1809以降が必要とされています
• 作業するフォルダ：Codexに読ませたいプロジェクトのフォルダ。最初は大事なファイルが入っていない練習用のフォルダがおすすめです

料金は、ChatGPTのPlusが月20ドル、Proは月100ドルからと公式の料金ページに載っています。APIキーで使う場合は、プランの月額ではなく、APIの使用量に応じた従量課金になります。

会社のPCに入れる場合

会社から支給されたPCに入れる場合は、インストールの前に情報システムの担当者に確認しておきましょう。確認しておきたいのは次の点です。

• ソフトウェアを自分でインストールしてよいか（管理者権限が必要か）
• 社内のネットワークからchatgpt.comやreleases.openai.comに接続できるか
• 社内のプロキシや、独自の証明書を使ったネットワークになっていないか
• 業務のプログラムやデータをAIに読ませてよいか、社内のルールがあるか

Windowsの公式ドキュメントでも、会社が管理するPCではOSのバージョンに問題がなくても、セットアップの一部が社内の設定で止められることがあると説明されています。

インストール方法の選び方

Codex CLIの入れ方は、公式に4通り案内されています。どれで入れても、使える機能は同じです。

公式インストーラー

いちばん手軽な方法です。コマンドを1行貼り付けて実行するだけで、Codex CLIの本体がダウンロードされます。Node.jsのような別のソフトを先に入れる必要がありません。READMEによると、インストーラーは標準でreleases.openai.comからファイルを取得し、取得できない場合はGitHub Releasesに切り替えます。

以前は「npmで入れる」と書かれた記事が多くありましたが、現在の公式ページでは、Mac・Linux・Windowsのどれも、このインストーラーが最初に案内されています。

会社のネットワークでreleases.openai.comへの接続が止められている場合は、取得元をGitHub Releasesに固定することもできます。READMEでは、環境変数CODEX_INSTALLER_USE_RELEASES_OPENAI_COMをfalseにして実行する方法が案内されています。

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

Windowsでは、PowerShellで$env:CODEX_INSTALLER_USE_RELEASES_OPENAI_COM='false'; irm https://chatgpt.com/codex/install.ps1 | iexと実行します。どちらの取得元を許可するかは会社の方針によるので、担当者と相談して決めてください。

npm

npmは、Node.js（JavaScriptをパソコン上で動かす仕組み）についてくる、ソフトの管理ツールです。すでにNode.jsで開発をしていて、ほかの道具もnpmで管理している人に向いています。必要なNode.jsのバージョンは公式には書かれていないので、エラーが出る場合は公式インストーラーに切り替えるのが簡単です。

Homebrew

Homebrewは、Macでよく使われるソフトの管理ツールです。ほかの開発ツールもHomebrewで入れている人なら、同じ流れでCodex CLIも管理できます。Homebrewを使っていない人が、Codexのためだけに入れる必要はありません。

Mac・Linuxでのインストール手順

MacとLinuxは、同じインストーラーのコマンドで入れられます。ここでは公式インストーラーを使う手順を説明します。

1. ターミナルを開くMacは「アプリケーション」→「ユーティリティ」の「ターミナル」を開きます。Spotlight（command＋スペース）で「ターミナル」と入力しても開けます。Linuxは、使っているデスクトップ環境の端末アプリを開きます。
2. インストーラーのコマンドを実行する次のコマンドを貼り付けて、Enterキーを押します。
   curl -fsSL https://chatgpt.com/codex/install.sh | sh
3. 新しいターミナルを開くインストールが終わったら、いったんターミナルを閉じて開き直します。開き直すことで、codexというコマンドが使えるようになったことがターミナルに反映されます。
4. 作業フォルダに移動するcdコマンドで、Codexに作業させたいフォルダに移動します。例：cd ~/projects/sample
5. Codexを起動するcodexと入力してEnterキーを押します。初回はログインの画面が表示されます。ログインの手順は後の章で説明します。

手順5で起動の画面が表示されれば、インストールは完了です。codex: command not foundのように表示される場合は、「よくあるエラーと対処」の章を確認してください。

ターミナルに慣れていない人向けの基本操作

Codexを起動する前に「作業フォルダに移動する」必要があります。ターミナルをほとんど使ったことがない人は、次の3つの操作だけ覚えておけば十分です。

Macでは、Finderのフォルダをターミナルの画面にドラッグ＆ドロップすると、そのフォルダの場所が文字で入力されます。cd （cdのあとに半角スペース）と打ってからフォルダをドラッグすれば、長い場所を手で打たずに移動できます。

Homebrewで入れる場合

Homebrewを使っている場合は、次のコマンドでも入れられます。

brew install --cask codex

インストールが終わったら、作業フォルダでcodexと入力して起動します。

npmで入れる場合

Node.jsとnpmがすでに入っている場合は、次のコマンドでも入れられます。

npm install -g @openai/codex

-gは「パソコン全体で使えるように入れる」という意味です。これがないと、コマンドを実行したフォルダの中だけに入ってしまいます。

手動でダウンロードする場合

GitHubの最新リリースのページから、使っているパソコンに合ったファイルを選んでダウンロードする方法もあります。READMEで案内されているファイルは次のとおりです。

展開すると、ファイル名にパソコンの種類が入った1つの実行ファイルが出てくるので、codexに名前を変えて使います。パスの通し方など自分で設定することが増えるため、特別な理由がなければインストーラーを使う方が簡単です。

画面のないLinuxサーバーで使う場合

サーバーのように画面やブラウザがない環境では、ブラウザでのログインがうまくいかないことがあります。公式ドキュメントでは、この場合はデバイスコードでのログイン（ベータ版）が勧められています。

codex login --device-auth

表示されたリンクを手元のパソコンのブラウザで開き、ログインしてから、画面に出たワンタイムコードを入力します。事前に、個人のアカウントならChatGPTのセキュリティ設定、会社のワークスペースなら管理者の設定で、デバイスコードでのログインを有効にしておく必要があります。

Windowsでのインストール手順

Codex CLIは、Windowsでもそのまま動きます。WSL（Windowsの中でLinuxを動かす仕組み）は必須ではありません。ここではPowerShellで公式インストーラーを使う手順を説明します。

1. PowerShellを開くスタートメニューで「PowerShell」と入力し、「Windows PowerShell」を開きます。公式ページでは、新しく開いたPowerShellのウィンドウで実行するよう案内されています。
2. インストーラーのコマンドを実行する次のコマンドを貼り付けて、Enterキーを押します。
   powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
3. PowerShellを開き直すインストールが終わったら、ウィンドウを閉じて新しいPowerShellを開きます。
4. 作業フォルダに移動するcdコマンドで作業フォルダに移動します。例：cd C:\Users\ユーザー名\projects\sample
5. Codexを起動するcodexと入力してEnterキーを押し、ログインに進みます。

npmで入れる場合は、Mac・Linuxと同じnpm install -g @openai/codexが使えます。

Windowsのサンドボックス

Codexは、AIが実行するコマンドが触れる範囲を制限する「サンドボックス」という仕組みの中で動きます。Windowsでは、公式に3つの方式が用意されています。

公式ドキュメントでは、デスクトップアプリは対応する端末ならMXCを自動で選ぶと説明されています。CLIだけで使う場合は、設定ファイル（config.toml）にprefer_mxc = trueを書くとMXCを優先できます。会社のPCで管理者の許可が出せない場合は、情報システムの担当者が先にCLIを入れて、elevatedのサンドボックスを準備しておく方法も案内されています。

また、winget（Windowsのソフト管理ツール）が使える状態であることが前提とされています。入っていない場合は、Windowsを最新の状態に更新してください。

WSLを使う場合

WSLは必須ではありませんが、Linux向けの開発ツールを使っている人や、すでにWSLの中で開発している人は、WSLの中にCodexを入れることもできます。その場合、CodexはLinuxとして動き、Windowsのサンドボックスは使いません。

• 使えるのはWSL2です。WSL1はCodex 0.114までの対応で、0.115以降は使えません
• WSLの中では、Mac・Linuxと同じcurl -fsSL https://chatgpt.com/codex/install.sh | shで入れます
• 作業フォルダは/mnt/c/...のようなWindows側ではなく、Linux側のホームフォルダ（例：~/code/my-app）に置くと、動作が速く、権限のトラブルも少なくなります

ログインと最初の設定

インストールが終わったら、ChatGPTのアカウントでログインします。初めてcodexを起動すると、ログインの方法を選ぶ画面が表示されます。

1. 作業フォルダでCodexを起動するターミナルで作業フォルダに移動し、codexと入力します。
2. 「Sign in with ChatGPT」を選ぶログインの方法の中から、ChatGPTでのログインを選びます。
3. ブラウザでログインする自動でブラウザが開くので、ChatGPTのアカウントでログインします。ログインが終わると、ブラウザからCodexにログイン情報が渡されます。
4. ターミナルに戻るターミナルに戻ると、依頼を入力できる状態になっています。
5. 小さな依頼を試すまずは「Tell me about this project」や「このプロジェクトについて説明して」のように、ファイルを変えない依頼から試します。

公式のクイックスタートでは、作業の前後にGitでチェックポイント（その時点の状態の記録）を作っておき、必要なら元に戻せるようにすることが勧められています。Gitを使っていない場合は、最初はフォルダごとコピーを取ってから試すと安心です。

あとからログインし直すときはcodex login、今どの方法でログインしているかを確かめるときはcodex login status、ログアウトするときはcodex logoutを使います。

最初に試したい依頼の例

インストールとログインが終わったら、ファイルを壊す心配の少ない依頼から試して、Codexの進め方に慣れていきます。

APIキーで使う場合

ChatGPTのプランではなく、OpenAIのAPIキーで使うこともできます。APIキーで使うと、料金はプランの月額ではなく、APIの標準料金での従量課金になります。会社でCodexの費用を別に管理したい場合や、自動化の仕組みに組み込む場合に向いています。

printenv OPENAI_API_KEY | codex login --with-api-key

ただし公式ドキュメントでは、APIキーではクラウドの機能（GitHubでの自動レビューやSlack連携など）は使えないか、制限があると説明されています。

最初に決めたい権限

Codexには、AIが技術的にどこまで触れるかを決める「サンドボックス」と、いつ人に確認を求めるかを決める「承認」の2つの設定があります。公式ドキュメントで案内されている主な組み合わせは次のとおりです。

公式ドキュメントによると、起動したフォルダがGitで管理されていればAuto、管理されていなければRead Onlyが勧められます。作業中は/permissionsと入力すると切り替えられ、/statusで今の設定と書き込める範囲を確認できます。初めて使うときは、Read Onlyで中身を説明してもらうところから始めると安心です。

設定ファイル（config.toml）

使うモデルや権限の初期値は、ホームフォルダの~/.codex/config.tomlに書いておけます。CLIとIDE拡張は同じ設定を読み込むので、一度書いておけばどちらにも反映されます。プロジェクトごとに変えたい場合は、そのフォルダに.codex/config.tomlを置きます。会社のPCでは、管理者が設定を固定している場合もあります。

アップデートの方法

Codex CLIは更新の頻度が高く、新しいモデルや機能は新しいバージョンでないと使えないことがあります。アップデートは、入れたときと同じ方法で行います。

codex updateで更新する

CLIのリファレンスには、codex updateというコマンドも載っています。入れたバージョンが自動更新に対応している場合は、このコマンドで新しい版の確認と更新ができます。対応していない場合は、上の表の方法で更新してください。

更新したほうがよい理由

古いバージョンのままだと、新しいモデルが選べない、設定の書き方が変わってエラーになる、といったことが起きます。たとえば公式ドキュメントでは、以前使えた承認の設定approval_policy = "untrusted"が廃止され、設定に残っていると起動できないことがあると案内されています。調子がおかしいと感じたら、まず最新版にしてから試すのが近道です。

よくあるエラーと対処

インストールやログインでつまずきやすい場面と、確認する点をまとめました。

社内ネットワークで止まるとき

会社のネットワークでは、外部への通信がプロキシを通る、独自の証明書で通信を検査している、といった設定がよくあります。公式ドキュメントでは、社内の証明書を使う場合は環境変数CODEX_CA_CERTIFICATEに証明書ファイル（PEM形式）の場所を指定してからログインする方法が案内されています。

ただし、ネットワークやセキュリティの設定を自分の判断で変えるのは避けてください。どの設定にすべきかは会社によって違うので、エラーの画面を保存して、情報システムの担当者に相談するのが確実です。ログインの問題を調べるときは、codex loginを実行すると記録されるログファイル（codex-login.log）も手がかりになります。

それでも解決しないとき

Codex CLIはオープンソースで公開されていて、GitHubのリポジトリ（openai/codex）で不具合の報告が集まっています。同じエラーが報告されていないかを検索すると、原因や回避策が見つかることがあります。Windowsのサンドボックスの問題については、公式ドキュメントでCODEX_HOME/.sandbox/sandbox.logのログを添えて報告するよう案内されています。

よくある質問

まとめ

インストールが終わったら、まずは練習用のフォルダで「このプロジェクトについて説明して」と頼むところから始めてみてください。慣れてきたら、少しずつ任せる作業を増やしていくのがおすすめです。

会社のPCへの導入や、権限・社内ルールの決め方で迷う場合は、INTERCREATE JAPANのCodex導入支援もご利用いただけます。