Codex クイックスタート
Windows、macOS、Linux に Codex をインストールし、Modelflare APIキーを接続して Responses API リクエストを確認します。
このガイドでは、Codex を Modelflare に接続して最初のリクエストを成功させます。最短で設定する場合は方法 A を使います。設定を一つずつ作成する場合は、方法 B の各ステップで自分の OS のコマンドを実行してください。
1. APIキーを作成
Modelflare コンソールにログインし、APIキー を開いて gpt-5.6-sol にアクセスできるキーを作成します。このモデルを含む default 以外の任意のルートを選択してください。指定された唯一のルートはありません。
作成した APIキーは、次の手順で一度だけ貼り付けます。
2. 設定方法を選択
方法 A: インストーラーを実行
ターミナルに慣れていない場合は、先にインタラクティブ練習を開いてください。視覚的なリハーサルであり、パソコンは変更しません。
macOS または Linux
通常のユーザーで次を実行します。
curl -fsSL https://modelflare.dev/install/codex.sh | sh
VPS やコンテナですでに root としてログインしている場合は、次を実行します。
curl -fsSL https://modelflare.dev/install/codex.sh | MODELFLARE_ALLOW_ROOT=1 sh
通常のパソコンでは sudo を付けないでください。
Windows PowerShell
通常の Windows ユーザーで PowerShell を開き、次を実行します。
irm https://modelflare.dev/install/codex.ps1 | iex
インストーラーは言語と Modelflare APIキーの入力を求め、gpt-5.6-sol へのアクセスを確認します。既存ファイルは変更前にバックアップされます。完了したら「接続を確認」に進んでください。
方法 B: Codex の設定を一つずつ作成
Modelflare のセットアップスクリプトを実行しない場合は、次の順序で設定します。各ステップで、自分の OS に対応するコマンドだけを実行してください。
方法 B では、ユーザーの .codex ディレクトリに config.toml と auth.json の 2 ファイルを作成します。
ステップ 1: Codex CLI をインストール
Windows PowerShell
irm https://chatgpt.com/codex/install.ps1 | iex
codex --version
Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version
macOS
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version
ステップ 2: .codex ディレクトリを作成して移動
Windows PowerShell
New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Set-Location "$HOME\.codex"
Linux
mkdir -p ~/.codex
cd ~/.codex
macOS
mkdir -p ~/.codex
cd ~/.codex
ステップ 3: config.toml を作成
Windows PowerShell
$config = @'
cli_auth_credentials_store = "file"
model_provider = "modelflare"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_supports_reasoning_summaries = true
[model_providers.modelflare]
name = "Modelflare"
base_url = "https://modelflare.dev/v1"
wire_api = "responses"
requires_openai_auth = true
'@
$utf8NoBom = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText(
(Join-Path (Get-Location) "config.toml"),
$config,
$utf8NoBom
)
Linux
cat > config.toml << 'EOF'
cli_auth_credentials_store = "file"
model_provider = "modelflare"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_supports_reasoning_summaries = true
[model_providers.modelflare]
name = "Modelflare"
base_url = "https://modelflare.dev/v1"
wire_api = "responses"
requires_openai_auth = true
EOF
chmod 600 config.toml
macOS
cat > config.toml << 'EOF'
cli_auth_credentials_store = "file"
model_provider = "modelflare"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_supports_reasoning_summaries = true
[model_providers.modelflare]
name = "Modelflare"
base_url = "https://modelflare.dev/v1"
wire_api = "responses"
requires_openai_auth = true
EOF
chmod 600 config.toml
ステップ 4: auth.json を作成
JSON オブジェクト内の YOUR_MODELFLARE_API_KEY を、Modelflare コンソールで作成した完全な API Key に置き換えてください。ファイルは有効な JSON のままにし、OPENAI_API_KEY フィールドを使用します。provider に auth コマンドブロックを追加しないでください。現在の Codex バージョンでは、この API Key 経路に requires_openai_auth = true が必要です。
Windows PowerShell
$authJson = @'
${CODEX_MANUAL_AUTH_JSON}
'@
$utf8NoBom = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText(
(Join-Path (Get-Location) "auth.json"),
$authJson,
$utf8NoBom
)
Linux
cat > auth.json << 'EOF'
${CODEX_MANUAL_AUTH_JSON}
EOF
chmod 600 auth.json
macOS
cat > auth.json << 'EOF'
${CODEX_MANUAL_AUTH_JSON}
EOF
chmod 600 auth.json
ステップ 5: Codex を起動
Windows PowerShell
Set-Location $HOME
New-Item -ItemType Directory -Force "my-codex-project" | Out-Null
Set-Location "my-codex-project"
codex --model gpt-5.6-sol
Linux
cd ~
mkdir -p my-codex-project
cd my-codex-project
codex --model gpt-5.6-sol
macOS
cd ~
mkdir -p my-codex-project
cd my-codex-project
codex --model gpt-5.6-sol
3. 接続を確認
インストーラーを使用した場合は、開いている Codex CLI、IDE、デスクトップセッションを完全に終了してください。新しいターミナルを開き、プロジェクトのディレクトリで次を実行します。
codex --model gpt-5.6-sol
設定完了後、Codex App をダウンロードして使うこともできます。
Codex に次のように入力します。
現在使用中のモデルと provider を一文で確認してください。
通常の応答が返れば設定完了です。
よくある問題
| 症状 | 対処 |
|---|---|
| 401 | APIキーをコピーし直し、削除または無効化されていないことを確認します。 |
| model_not_found | APIキーを編集し、gpt-5.6-sol にアクセスできるルートを選択します。 |
| ChatGPT ログインが表示される | Codex の全セッションを完全に終了して開き直します。 |
| codex が見つからない | 新しいターミナルを開きます。Windows では codex.cmd も試してください。 |