Codex GUI/CLI インストールと設定

GUI のインストール

Codex を含むデスクトップアプリをインストールします。

Windows

Windows では公式インストーラーのほか、winget を使って Microsoft Store からインストールすることもできます。どちらか一方を選んでください。

Windows 公式インストーラーをダウンロード ↗

winget でインストール

PowerShell を開き、次の公式インストールコマンドを実行します：

PowerShell

winget install --id 9PLM9XGG6VKS -s msstore

インストール後、スタートメニューから ChatGPT を開いてログインします。

Linux

Linux デスクトップアプリは現在公式プレビュー版で、Ubuntu、Debian、Fedora、Arch Linux に対応し、x64 と ARM64 版が提供されています。

まずプロセッサーのアーキテクチャを確認します：

Terminal

uname -m

x86_64 は x64、aarch64 または arm64 は ARM64 です。

Ubuntu / Debian：.deb をダウンロードしてインストール

x64 .deb をダウンロード ↗ · ARM64 .deb をダウンロード ↗

ダウンロード後、ターミナルで Downloads ディレクトリへ移動し、該当するパッケージをインストールします：

x64

cd ~/Downloads
sudo apt install ./chatgpt_amd64.deb

ARM64

cd ~/Downloads
sudo apt install ./chatgpt_arm64.deb

Fedora：.rpm をダウンロードしてインストール

x64 .rpm をダウンロード ↗ · ARM64 .rpm をダウンロード ↗

ダウンロード後、ターミナルで Downloads ディレクトリへ移動し、該当するパッケージをインストールします：

x64

cd ~/Downloads
sudo dnf install ./chatgpt.x86_64.rpm

ARM64

cd ~/Downloads
sudo dnf install ./chatgpt.aarch64.rpm

Arch Linux：公式インストールスクリプトを使用

公式スクリプトがプロセッサーのアーキテクチャを検出し、署名済みの OpenAI パッケージリポジトリを設定して ChatGPT をインストールします。

Terminal

curl --proto '=https' --tlsv1.2 -fL -o install-arch.sh \
  https://persistent.oaistatic.com/codex-app-prod/linux/install-arch.sh
sudo bash install-arch.sh

インストール後、アプリケーションメニューから ChatGPT を開きます。ターミナルで chatgpt を実行して起動することもできます。 Linux 公式ガイドを見る ↗

macOS

macOS 14 以降では Apple Silicon と Intel の両方に対応しています。公式ダウンロードページが使用中の Mac に合うインストーラーを自動的に表示します。

macOS 公式ダウンロード ↗

インストール手順をすべて表示

1. 公式ダウンロードページを開き、現在の Mac 用に表示された .dmg インストーラーをダウンロードします。
2. ダウンロードした .dmg ファイルを開きます。
3. ChatGPT を Applications フォルダーへドラッグします。
4. Applications から ChatGPT を開き、ログインします。

CLI のインストール

OS に対応する方法でターミナル版をインストールします。

Windows

PowerShell で Codex CLI のインストール方法を選択します。

curl

curl で公式 Windows インストールスクリプトを取得して実行します。Node.js は不要です。

PowerShell

$codexInstaller = curl.exe -fsSL https://chatgpt.com/codex/install.ps1
if ($LASTEXITCODE -eq 0) {
  Invoke-Expression ($codexInstaller -join [Environment]::NewLine)
}

curl がない場合：curl をインストール

新しい Windows 10 と Windows 11 には通常 curl が含まれています。まず確認します：

curl.exe --version

コマンドが見つからない場合は、公式サイトからシステムのアーキテクチャに合う圧縮ファイルをダウンロードします。展開した bin ディレクトリをユーザーの Path 環境変数に追加し、PowerShell を開き直してください。

curl for Windows をダウンロード ↗

Chocolatey でインストール

Chocolatey がインストール済みの場合、管理者として PowerShell を開いて実行します：

PowerShell

choco install curl -y

Chocolatey がない場合： 公式インストールガイド ↗

インストール後、PowerShell を開き直してください。インストール方法はいずれか一つを選択してください。

npm

Node.js と npm がインストール済みの場合は、次を実行します：

PowerShell

npm.cmd install -g @openai/codex

npm がない場合：Node.js と npm をインストール

Node.js 公式サイトで LTS 版を選び、Windows インストーラー（.msi）をダウンロードし、既定の設定でインストールします。npm も同時にインストールされます。

Node.js をインストール ↗

Chocolatey でインストール

Chocolatey がインストール済みの場合、管理者として PowerShell を開いて実行します：

PowerShell

choco install nodejs-lts -y

Chocolatey がない場合： 公式インストールガイド ↗

インストール後、PowerShell を開き直してください。インストール方法はいずれか一つを選択してください。

PowerShell を開き直して、インストール結果を確認します：

node --version
npm.cmd --version

インストール後、PowerShell を開き直して Codex のバージョンを確認します：

cmd /c codex --version

WSL では Linux タブを選び、WSL 内でインストール、設定、起動を行います。

バージョンが表示されればインストール完了です。更新も同じ方法で行い、複数のバージョンの混在を避けます。

Linux

ディストリビューションに合った Node.js LTS をインストールし、ターミナルで Codex を追加します。

Node.js 公式ダウンロード ↗

Terminal

node --version
npm --version
npm install -g @openai/codex
codex --version

バージョンが表示されればインストール完了です。更新も同じ方法で行い、複数のバージョンの混在を避けます。

macOS

ターミナルで Homebrew を使ってインストールします。Homebrew がなければ下の npm 手順も使えます。

Terminal

brew install --cask codex
codex --version

Node.js がある場合：npm でインストール

Node.js が未インストールの場合： Node.js をインストール ↗

npm install -g @openai/codex
codex --version

バージョンが表示されればインストール完了です。更新も同じ方法で行い、複数のバージョンの混在を避けます。

Supakook への接続

GUI と CLI は共通の設定を使用します。Supakook API キーを用意し、一度設定してください。

Windows

ユーザーホーム内の .codex フォルダーで config.toml を編集します。フォルダーがない場合は、下の PowerShell コマンドで作成できます。

ユーザー設定ファイル： .codex\config.toml

PowerShell

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
notepad "$env:USERPROFILE\.codex\config.toml"

Linux

ユーザー設定ファイル： ~/.codex/config.toml

nano を使用

設定ファイルを開く

mkdir -p ~/.codex
nano ~/.codex/config.toml

設定を貼り付け、Ctrl+O、Enter で保存し、Ctrl+X で終了します。

nano がない場合：nano をインストール

Linux ディストリビューションに対応するコマンドを実行し、インストール後に上の編集コマンドを実行してください。

Ubuntu / Debian

sudo apt update
sudo apt install nano

Fedora

sudo dnf install nano

Arch Linux

sudo pacman -Syu nano

Vim を使用

設定ファイルを開く

mkdir -p ~/.codex
vim ~/.codex/config.toml

i で編集モードに入り、設定を貼り付けます。Esc を押し、:wq と入力して Enter で保存・終了します。

Vim がない場合：Vim をインストール

Linux ディストリビューションに対応するコマンドを実行し、インストール後に上の編集コマンドを実行してください。

Ubuntu / Debian

sudo apt update
sudo apt install vim

Fedora

sudo dnf install vim

Arch Linux

sudo pacman -Syu vim

macOS

ユーザー設定ファイル： ~/.codex/config.toml

設定ファイルを開く

mkdir -p ~/.codex
touch ~/.codex/config.toml
open -e ~/.codex/config.toml

以下の設定を config.toml に記入して保存してください。

config.toml

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.supakook.com/v1"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

同じ .codex フォルダーに auth.json を作成し、ご自身の API キーを入力して保存してください。

Windows

.codex\auth.json

PowerShell

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
notepad "$env:USERPROFILE\.codex\auth.json"

Linux

~/.codex/auth.json

nano を使用

設定ファイルを開く

mkdir -p ~/.codex
nano ~/.codex/auth.json

設定を貼り付け、Ctrl+O、Enter で保存し、Ctrl+X で終了します。

nano がない場合：nano をインストール

Linux ディストリビューションに対応するコマンドを実行し、インストール後に上の編集コマンドを実行してください。

Ubuntu / Debian

sudo apt update
sudo apt install nano

Fedora

sudo dnf install nano

Arch Linux

sudo pacman -Syu nano

Vim を使用

設定ファイルを開く

mkdir -p ~/.codex
vim ~/.codex/auth.json

i で編集モードに入り、設定を貼り付けます。Esc を押し、:wq と入力して Enter で保存・終了します。

Vim がない場合：Vim をインストール

Linux ディストリビューションに対応するコマンドを実行し、インストール後に上の編集コマンドを実行してください。

Ubuntu / Debian

sudo apt update
sudo apt install vim

Fedora

sudo dnf install vim

Arch Linux

sudo pacman -Syu vim

macOS

~/.codex/auth.json

設定ファイルを開く

mkdir -p ~/.codex
touch ~/.codex/auth.json
open -e ~/.codex/auth.json

auth.json

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

CC Switch でも設定できます。CODEX_HOME を指定した場合はそのフォルダーを使用します。WSL と Windows のユーザーフォルダーは別です。

再起動と確認

GUI

起動中の場合は完全に終了して再起動します。Codex でプロジェクトを開き、「こんにちは」と送信して基本的な接続を確認します。

CLI

実行中の CLI を終了し、プロジェクトフォルダーで起動します。

codex

Windows PowerShell では次も使用できます。

cmd /c codex

「こんにちは」と送信します。この設定の provider は OpenAI、モデルは gpt-5.5 です。

トラブルシューティング

• コマンドが見つからない：ターミナルを開き直し、PATH を確認します。
• キーがない：.codex/auth.json の OPENAI_API_KEY を確認します。
• 401/403：キー、残高、モデル権限を確認します。
• 404：Base URL、Responses 対応、モデル名を確認します。
• 設定が反映されない：CODEX_HOME、プロジェクト設定、起動引数を確認します。

公式デスクトップガイド · 公式 CLI ガイド · 認証