Codex CLIのインストールと設定|Windows・Mac・VS Code

この記事の要点

  1. Codex CLIをWindows、Mac、Linux、VS Codeに入れる手順と、サインイン、config.toml、MCPの初めの設定、アップデートの方法をまとめました。手順は2026年11月19日に公式のドキュメントで確認し、コマンドの出力は最新版0.170.0を実際に入れて確かめたものです。
  2. MacとLinuxは「curl -fsSL https://chatgpt.com/codex/install.sh | sh」、Windowsは新しいPowerShellでinstall.ps1のコマンドを実行して入れます。WindowsはWSLがなくても使え、Linuxのツールが要るときはWSL2の中に入れます。
  3. VS Codeでは、拡張機能「Codex – OpenAI's coding agent」(openai.chatgpt)を入れます。CLIと拡張機能は、設定ファイルとサインインの情報を共有します。
  4. 初めて起動すると、ChatGPTのアカウント、デバイスコード、APIキーからサインインの方法を選びます。設定は~/.codex/config.toml、MCPサーバーはcodex mcp addで足します。
  5. アップデートはcodex updateで行い、入れたときの方法(npmかスクリプト)に合わせて更新されます。アーカイブした会話は、デスクトップアプリの設定の「Archived chats」か、codex unarchiveで戻せます。
SHARE

Codex(コーデックス)を使い始めるには、ターミナルで動くCodex CLI、VS Codeなどのエディタの拡張機能、ChatGPTのデスクトップアプリのどれかを入れて、ChatGPTのアカウントでサインインします。 この記事では、Codex CLIをWindows、Mac、Linuxに入れる手順と、VS Codeへの拡張の入れ方、サインイン、config.tomlとMCPの初めの設定、アップデートの方法を順に説明します。

手順は2026年11月19日にOpenAIの公式のドキュメントで確かめました。 載せているコマンドの出力は、同じ日にLinux(Ubuntu 24.04)でCodex CLIの最新版0.170.0を実際に入れて確かめたものです。 Codexでできることや料金、使用量の上限は、Codexとは?使い方と料金、使用量の上限とリセットで説明しています。

Codexを入れる前に選ぶこと

Codexには、使う場所に合わせて3つの入れ方があります。

Codexの3つの入れ方
入れるもの向く人入れ方
Codex CLIターミナルで作業する人、スクリプトやCIで動かしたい人コマンドで入れる
IDE拡張VS Code、Cursor、Windsurfで作業する人エディタに拡張機能を入れる
デスクトップアプリ画面で差分や進み具合を見ながら頼みたい人ChatGPTのデスクトップアプリを入れる

デスクトップアプリ、CLI、IDE拡張は、同じパソコンの同じ設定ファイルを読みます。 CLIとIDE拡張は、サインインの情報も共有します。 迷うときは、ふだんターミナルで作業しているならCLIから、VS Codeで作業しているならIDE拡張から入れると始めやすくなります。

サインインの方法は、ChatGPTのアカウントか、OpenAIのAPIキーのどちらかを選びます。 ChatGPTのアカウントではプランに含まれる使用量で使い、APIキーではAPIの料金で使った分だけ払います。

Codex CLIをインストールする

Codex CLIは、公式のインストールスクリプトで入れるのが基本です。 Homebrewやnpmをふだん使っているなら、そちらでも入れられます。

macOSとLinuxで入れる

ターミナルを開いて、次のコマンドを実行します。

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

Linuxで実行すると、次のように表示されました。

==> Installing Codex CLI
==> Detected platform: Linux (x64)
==> Resolved version: 0.170.0
==> Downloading Codex CLI
==> Installing standalone package to $HOME/.codex/packages/standalone/releases/0.170.0-x86_64-unknown-linux-musl
==> Current terminal: export PATH="$HOME/.local/bin:$PATH" && codex
==> Future terminals: open a new terminal and run: codex
==> PATH was added to $HOME/.bashrc
Codex CLI 0.170.0 installed successfully.

スクリプトはcodexの実行ファイルを~/.local/binに置き、使っているシェルの設定ファイル(Linuxのbashなら~/.bashrc)にPATHを追加します。 新しいターミナルを開けば、codexで起動できます。 いま開いているターミナルで続けるときは、表示されたexport PATH=...の行を実行します。

HomebrewかnpmでCodex CLIを入れるときは、次のコマンドを使います。

brew install --cask codex
npm install -g @openai/codex

npmで入れるときは、先にNode.jsを入れておきます。

Windowsで入れる

Windowsでは、新しいPowerShellの画面を開いて、次のコマンドを実行します。

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

codexの実行ファイルは%LOCALAPPDATA%\Programs\OpenAI\Codex\binに置かれ、スクリプトがこの場所をユーザーのPATHに追加します。 入れ終わったら、新しいPowerShellの画面を開いてcodexを実行します。

Windowsでは、CodexはPowerShellとWindowsのサンドボックスの上で動くのが既定です。 WSLを入れなくても使えます。 OpenAIのドキュメントは、Windows 11を勧めています。 Windows 10は、最新の状態に更新したもの(1809以降)なら動きますが、Windows 11ほど安定しないとされています。

WSLで使う

Linux向けのツールが要るときや、リポジトリと作業の環境がすでにWSL2の中にあるときは、WSL(Windows Subsystem for Linux)の中にCodex CLIを入れます。 WSL1はCodex 0.115から使えなくなったので、WSL2を使います。

  • 1. WSLを入れる:管理者として開いたPowerShellかWindows Terminalで、wsl --installを実行します。
  • 2. WSLのシェルを開く:wslを実行して、Linuxのシェルに入ります。
  • 3. Codex CLIを入れる:WSLのシェルで、macOSとLinuxと同じcurl -fsSL https://chatgpt.com/codex/install.sh | shを実行し、codexで起動します。

作業するリポジトリは、/mnt/c/...のようなWindows側のフォルダではなく、~/code/my-appのようなLinux側のホームに置きます。 Windows側のフォルダで作業すると、ファイルの読み書きが遅くなることがあるためです。

GitHubのリリースから入れる

スクリプトを使わずに入れるときは、GitHubのopenai/codexのリリースから、OSに合うファイルをダウンロードします。 たとえば、Apple SiliconのMacはcodex-aarch64-apple-darwin.tar.gz、IntelのMacはcodex-x86_64-apple-darwin.tar.gz、x64のLinuxはcodex-x86_64-unknown-linux-musl.tar.gzです。 展開した実行ファイルの名前にはOSの種類が入っているので、codexに名前を変えて、PATHの通ったフォルダに置きます。

入ったか確かめる

新しいターミナルでcodex --versionを実行し、バージョン番号が出れば正しく入っています。

$ codex --version
codex-cli 0.170.0

0.170.0は、2026年11月19日の時点の最新版です。

初めて起動してサインインする

作業するプロジェクトのフォルダに移って、codexを実行します。 初めて起動すると、サインインの方法を選ぶ画面が出ます。

>_ OpenAI Codex (v0.170.0)

Welcome to Codex, OpenAI's command-line coding agent

Choose how you want to use Codex.

> 1. Sign in with ChatGPT
     Usage included with Plus, Pro, Business, and Enterprise plans
  2. Sign in with Device Code
     Sign in from another device with a one-time code
  3. Sign in another way
     Use an API key or another provider

Press enter to continue
サインインの3つの方法
選ぶもの使う場面
Sign in with ChatGPTふつうはこれを選ぶ。ブラウザが開き、ChatGPTのアカウントでサインインする
Sign in with Device CodeSSHでつないだサーバーなど、ブラウザのない環境で使う。別の機器のブラウザで1回限りのコードを入れる
Sign in another wayAPIキーで使う

デバイスコードでサインインするときは、先にChatGPTのセキュリティ設定で、デバイスコードでのログインを有効にしておきます。 会社のワークスペースでは、管理者がワークスペースの権限で有効にします。 コマンドから始めるときは、codex login --device-authを実行します。

APIキーで使うときは、環境変数OPENAI_API_KEYにキーを入れて、次のコマンドを実行します。

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

APIキーで使うときは、ChatGPTのワークスペースやクラウドを使う一部の機能は使えません。

サインインできたかは、codex login statusで確かめます。 サインインしていないときは、次のように出ます。

$ codex login status
Not logged in

サインインの情報は、~/.codex/auth.jsonか、OSの資格情報の保管場所に保存されます。 auth.jsonはパスワードと同じように扱い、人に渡したりリポジトリに入れたりしません。 サインアウトするときはcodex logoutを実行します。

Codex CLIの基本の使い方とコマンド

サインインしたら、入力欄にやってほしいことを書いて送ります。 最初は、プロジェクトの説明や小さな修正のように、範囲の狭い依頼から始めます。

このプロジェクトの構成と、テストの動かし方を説明してください。

OpenAIのドキュメントは、作業を頼む前と後にGitのコミットを作っておくことを勧めています。 コミットがあれば、Codexが変えたところを元に戻せます。

ターミナルで初めに使うことが多いコマンドは、次のとおりです。

Codex CLIの主なコマンド
コマンドすること
codex対話の画面を開く
codex exec "依頼"対話の画面を開かずに実行する。スクリプトやCIで使う
codex resume前の会話を選んで続ける。--lastで直前の会話
codex loginサインインする
codex mcpMCPサーバーを管理する(追加、一覧、削除)
codex update最新版に更新する
codex doctorインストール、設定、サインインの状態を診断する

対話の画面では、/で始まるスラッシュコマンドを使えます。

初めに使うスラッシュコマンド
コマンドすること
/modelモデルと推論の強さを選ぶ
/permissions確認なしでしてよい範囲を選ぶ
/statusいまの設定と、使ったトークンを見る
/initAGENTS.mdの雛形を作る
/mcp使えるMCPのツールを見る
/new新しい会話を始める
/resume保存した会話を開く
/review手元の変更をレビューしてもらう
/exit終わる

すべてのコマンドとスラッシュコマンドは、公式のDeveloper commandsのページに一覧があります。 入れたバージョンで使えるコマンドは、codex --helpで確かめられます。

VS CodeにCodexの拡張を入れる

VS Codeでは、OpenAIが出している拡張機能「Codex – OpenAI’s coding agent」(ID:openai.chatgpt)を入れます。 CursorとWindsurfにも、同じ拡張機能を入れられます。

VS CodeのMarketplaceにある拡張機能「Codex – OpenAI's coding agent」のページ。拡張機能の名前と発行元OpenAIの行と、Quick Openに貼るコマンド「ext install openai.chatgpt」の欄を赤枠で示している

VS CodeのMarketplaceの拡張機能のページです。 「Installation」の欄に、拡張機能を入れるコマンドが出ています。

  • 1. 拡張機能を入れる:Marketplaceのページの「Copy」を押して、ext install openai.chatgptをコピーします。VS CodeでQuick Open(Ctrl+P。Macは⌘+P)を開き、貼り付けてEnterを押します。
  • 2. Codexを開く:サイドバーのCodexのアイコンを押します。アイコンが見えないときは、コマンドパレットで「Codex: Open Codex Sidebar」を実行します。
  • 3. サインインする:「Sign in with ChatGPT」を押して、ブラウザでサインインします。APIキーで使うときは「Use API Key」を選び、キーを入れて「OK」を押します。

拡張機能は、Codex CLIと同じ設定ファイルとサインインの情報を使います。 CLIで足したMCPサーバーやconfig.tomlの設定は、拡張機能でもそのまま使えます。 設定ファイルは、Codexの画面の歯車のアイコンから「Codex Settings」を選び、「Open config.toml」で開けます。

Windowsで、リポジトリやツールがWSL2の中にあるときは、VS Codeの設定chatgpt.runCodexInWindowsSubsystemForLinuxをオンにすると、CodexがWSLの中で動きます。 WSLの中のフォルダを開くときは、WSLのシェルでプロジェクトのフォルダに移り、code .を実行してVS Codeを開きます。 VS Codeの左下の状態表示がWSL: ディストリビューション名になっていれば、WSLにつながっています。

JetBrainsのIDEとXcodeは、それぞれのIDEのAIの機能からCodexを選んで使います。 JetBrainsではAI Chatを開いてCodexを選び、Xcodeではコーディングアシスタントで新しいチャットを始めてCodexを選びます。

デスクトップアプリを入れる

Codexは、ChatGPTのデスクトップアプリの中でも使えます。 Windowsでは、Microsoft StoreからChatGPTのデスクトップアプリを入れます。 コマンドで入れるときは、PowerShellで次を実行します。

winget install --id 9PLM9XGG6VKS -s msstore

WindowsにGitが入っていないと、アプリの一部の機能を使えません。 その場合は、winget install Git.GitでGitを入れておきます。 Windowsのアプリは、Windowsに直接入れたCodex CLIと同じ%USERPROFILE%\.codexの設定を使います。

macOSでは、ChatGPTのダウンロードページからデスクトップアプリを入れます。

初めの設定をする

入れてサインインしたら、既定の設定、権限、Codexへの指示を決めておきます。

config.tomlで既定の設定を決める

Codexの設定は、config.tomlというファイルに書きます。

config.tomlの場所
範囲場所
自分の設定(macOS、Linux)~/.codex/config.toml
自分の設定(Windows)%USERPROFILE%\.codex\config.toml
プロジェクトだけの設定プロジェクトの.codex/config.toml

プロジェクトの設定は、そのプロジェクトを信頼したときだけ読み込まれます。 同じ項目が両方にあるときは、プロジェクトの設定が自分の設定より優先されます。

たとえば、次の2行は、作業中のフォルダの中で動き、その外に出る操作の前に確認を求める設定です。

approval_policy = "on-request"
sandbox_mode = "workspace-write"

既定のモデルを決めるときは、model = "モデル名"の行を足し、/modelで選べるモデルの名前を書きます。 1回だけ設定を変えて起動するときは、codex -c model="モデル名"のように-cで上書きできます。 書ける項目のすべては、公式のConfiguration Referenceに載っています。

権限を選ぶ

Codexが確認なしでしてよい範囲は、権限のモードで決めます。 CLIとIDE拡張の既定では、書き換えられるのは作業中のフォルダの中だけで、インターネットにはつながりません。 OpenAIのドキュメントは、ふだんの作業を「Ask for approval」から始めるように勧めています。 このモードでは、作業中のフォルダの外に出る操作の前に、Codexが止まって確認を求めます。

CLIでは/permissionsで、デスクトップアプリとIDE拡張では入力欄の下の切り替えで選びます。

AGENTS.mdに決まりを書く

AGENTS.mdは、Codexへの指示を書いておくファイルです。 テストの動かし方、コードの書き方、触ってはいけないファイルなどを書いておくと、依頼のたびに書かずに済みます。 対話の画面で/initを実行すると、作業中のフォルダにAGENTS.mdの雛形ができます。

Codexは、作業を始めるときに次の順でAGENTS.mdを読みます。

  • 1. 自分の指示:~/.codex/AGENTS.md。すべてのプロジェクトに使います。
  • 2. プロジェクトの指示:プロジェクトの根(ふつうはGitの根)から作業中のフォルダまで、各フォルダのAGENTS.mdを順に読みます。

作業中のフォルダに近いファイルほど後に読まれ、前の指示より優先されます。 既定では、合わせて32KiBに達したところで読み込みが止まるので、AGENTS.mdは短く保ちます。

MCPサーバーとプラグインを追加する

MCP(Model Context Protocol)は、Codexに外のツールやサービスをつなぐ仕組みです。 MCPサーバーを足すと、Codexが作業の中でそのツールを使えるようになります。

CLIでMCPサーバーを追加する

手元で動かすサーバーは--の後に起動のコマンドを書き、URLで公開されているサーバーは--urlを付けて追加します。 次は、公式のドキュメントの例にある2つのサーバー、OpenAIのドキュメントを調べるopenaiDeveloperDocs(URL)とContext7(手元で動かすサーバー)を足して、一覧を出した例です。

$ codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
Added global MCP server 'openaiDeveloperDocs'.
$ codex mcp add context7 -- npx -y @upstash/context7-mcp
Added global MCP server 'context7'.
$ codex mcp list
Name      Command  Args                      Env  Cwd  Status   Auth
context7  npx      -y @upstash/context7-mcp  -    -    enabled  Unsupported

Name                 Url                                Bearer Token Env Var  Status   Auth
openaiDeveloperDocs  https://developers.openai.com/mcp  -                     enabled  Unsupported

追加したサーバーは、config.tomlに次のように書き込まれます。 config.tomlにこの形で直接書いても、同じように追加できます。

[mcp_servers.openaiDeveloperDocs]
url = "https://developers.openai.com/mcp"

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

サーバーに環境変数を渡すときは、--env 名前=値を付けます。 トークンで認証するURLのサーバーは、--bearer-token-env-varで、トークンを入れた環境変数の名前を指定します。 OAuthでログインするサーバーは、codex mcp login サーバー名でログインします。 対話の画面で/mcpを実行すると、いま使えるMCPのツールを確かめられます。

デスクトップアプリとIDE拡張で追加する

画面から追加するときは、次の場所を開きます。

  • デスクトップアプリ:Settingsの「MCP servers」で「Add server」を押し、名前、種類(STDIOかStreamable HTTP)、コマンドかURLを入れて保存し、「Restart」を押します。
  • IDE拡張:Codexの画面の歯車のメニューから「MCP servers」を開き、同じように入れて保存し、拡張機能を再起動します。

同じパソコンのデスクトップアプリ、CLI、IDE拡張は、MCPの設定を共有します。 どれで追加しても、ほかの2つでそのまま使えます。

プラグインを入れる

プラグインは、スキルやMCPサーバーをまとめて入れられるものです。 CLIでは、codex plugin marketplace addでプラグインの配布元を足してから、codex plugin addで入れます。 対話の画面の/pluginsからも探して入れられます。

次は、動画生成AIのNoLangが公開しているCodex向けのプラグインを入れた例です。

$ codex plugin marketplace add mvrks-inc/nolang-plugin
Added marketplace `nolang` from https://github.com/mvrks-inc/nolang-plugin.git.
$ codex plugin add nolang@nolang
Added plugin `nolang` from marketplace `nolang`.

codex plugin listで、プラグインがinstalled, enabledになっていれば追加できています。 そのあと、Codexを起動し直します。 プラグインを入れたCodexに「NoLangでできることを60秒で紹介する動画を作って」のように頼むと、ナレーションとBGMの入った動画ができます。 初めて頼むときは、ブラウザでNoLangにログインして許可します。 このプラグインを動かすには、Node.js 20以上が要ります。 入れ方と使い方は、NoLangのMCP・CLIのページで説明しています。

Codexをアップデートする

Codex CLIは、codex updateで最新版に更新できます。 codex updateは、入れたときの方法に合わせて更新します。 npmで入れたCodexで実行すると、次のようにnpm install -g @openai/codexが動きました。

$ codex update

Updating Codex via `npm install -g @openai/codex`...

changed 2 packages in 1s

🎉 Update ran successfully! Please restart Codex.

インストールスクリプトで入れたCodexでは、同じスクリプトがもう一度動いて更新されました。 更新が終わったら、Codexを起動し直します。

codex updateを使わずに更新するときは、入れたときと同じ方法で次のように実行します。

  • インストールスクリプト:入れたときと同じコマンドをもう一度実行します。
  • npm:npm install -g @openai/codexを実行します。
  • Homebrew:brew upgrade --cask codexを実行します。

Codexは、起動するときに新しいバージョンがあるかを確かめます。 更新した後は、codex --versionでバージョン番号を確かめます。

アーカイブした会話を戻す

Codexでは、終わった会話をアーカイブして、一覧から外せます。 アーカイブした会話は消えずに残っていて、使っているアプリやツールごとに次の手順で戻せます。

  • デスクトップアプリ:Settingsの「Archived chats」を開き、戻したい会話の「Unarchive」を押します。戻した会話は、サイドバーの元の場所に出ます。
  • Web(chatgpt.com):Settingsの「Data Controls」から「Archived chats」を開いて戻します。
  • CLI:codex unarchiveに、会話のセッションIDか名前を付けて実行します。

CLIで会話をアーカイブするときは、codex archiveか、対話の画面の/archiveを使います。 アーカイブした会話は、~/.codex/archived_sessionsに保存されます。 codex deleteと/deleteは会話を完全に消すコマンドなので、あとで戻したい会話にはアーカイブを使います。

うまく動かないときに確かめること

入れた後に動かないときは、次の3つを確かめます。

  • codexが見つからない:インストールした後に、新しいターミナルを開いたかを確かめます。スクリプトが追加したPATHの設定は、新しく開いたターミナルで有効になります。WSLでは、which codexでWSLの中に入っているかを確かめます。
  • 古い記事のオプションが動かない:--full-autoや--approval-modeは、0.170.0のcodex --helpにありません。承認は-a(--ask-for-approval)でon-requestかneverを、サンドボックスは-s(--sandbox)でread-only、workspace-write、danger-full-accessのどれかを指定します。
  • 原因が分からない:codex doctorで、インストール、設定、サインイン、ネットワークの状態をまとめて診断できます。

サインインする前にcodex doctorを実行すると、次のようにauthの行が失敗になり、codex loginでサインインするよう案内が出ます。

$ codex doctor --summary --ascii
Codex Doctor v0.170.0 · linux-x86_64

Notes
   [XX] auth         no Codex credentials were found - Run codex login or provide an API key through a supported auth env var.
(中略)
17 ok | 1 idle | 3 notes | 2 warn | 1 fail failed

公式のドキュメントとGitHub

Codexの公式のドキュメントは、以前のdevelopers.openai.com/codexから、learn.chatgpt.comに移りました。 古いURLを開くと、learn.chatgpt.comの同じ内容のページに転送されます。 入れ方と設定で読むことの多いページは、次のとおりです。

Codexの入れ方と設定の公式のページ
知りたいことページ
CLIの入れ方と使い方Codex CLI
IDE拡張Codex IDE extension
サインインAuthentication
WindowsWindows sandbox
WSLWSL
config.tomlConfig basics
MCPModel Context Protocol
AGENTS.mdCustom instructions with AGENTS.md

Codex CLIのソースコードは、GitHubのopenai/codexで公開されています。 ライセンスはApache-2.0で、主にRustで書かれています。 新しいバージョンはリリースのページに載り、0.170.0は2026年11月18日に公開されました。 リポジトリでは不具合の報告(Issues)を受け付けていますが、外部からのプルリクエストは受け付けていません。 IDE拡張とクラウドの機能は、オープンソースではありません。

チームでCodexを使い始めるとき

チームでCodexを使い始めるときは、入れる方法、サインインの方法、権限のモード、AGENTS.mdの決まりをそろえておくと、使い方のばらつきを防げます。 決めた手順は、文書で配るほかに、説明の動画にして共有する方法もあります。 NoLangでは、手順書の文章や、PDFとPowerPointの資料をもとに、字幕とナレーションの入った説明の動画を作れます。 NoLangを会社で使っている例は、導入事例で紹介しています。 会社での使い方の相談は、お問い合わせから送れます。 詳しい資料は、下のボタンからダウンロードできます。

資料をダウンロード

よくある質問

Codex CLIは無料で使えますか?
Codex CLIは、GitHubでApache-2.0のライセンスで公開されていて、入れるのにお金はかかりません。使うときは、ChatGPTのアカウントでサインインしてプランに含まれる使用量で使うか、APIキーでサインインしてAPIの料金で使った分を払います。
VS Codeの拡張機能だけで、Codex CLIを入れずに使えますか?
使えます。VS Codeの拡張機能はCodexの実行ファイルを中に含んでいるので、拡張機能を入れてサインインすれば使えます。ターミナルでも使いたくなったらCodex CLIを入れ、両方を入れた場合は設定ファイルとサインインの情報を共有します。
Codex CLIをWindowsとWSLの両方に入れると、設定は共有されますか?
そのままでは共有されません。Windowsに直接入れたCodexは%USERPROFILE%\.codexを、WSLの中のCodexはLinux側のホームの~/.codexを使います。OpenAIのドキュメントは、そろえたいときはWSLの中でCODEX_HOMEを/mnt/c/Users/Windowsのユーザー名/.codexにする方法を案内しています。
SHARE
NoLang サービスご紹介資料
資料ダウンロード

NoLangの導入を
ご検討中の方

NoLangを
ご利用中の方

\無料ですぐ試せる/ AIで動画を作ってみる