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.tomlauth.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 も試してください。