Codex DesktopでGPT-5.6 Lunaに「Ultra」を表示し、サブエージェントを使う方法

Posted at 2026-09-16

Codex DesktopでGPT-5.6 Lunaに「Ultra」を表示し、サブエージェントを使う方法【非公式・Windows】

動作確認環境

Codex Desktop: 26.908.70816
確認日: 2026-09-15
OS: Windows
変更対象: config.toml / models_cache.json
結果: GPT-5.6 LunaにUltraを表示し、Luna + Ultra指定のサブエージェントを実際に起動・完了できた

注意
この記事では、Codex Desktopのローカル設定とモデルキャッシュを書き換えて、通常はGPT-5.6 Lunaに表示されないUltraとMulti-agent V2を使える状態にする方法を紹介します。
OpenAIのアカウント権限やモデル利用権限そのものを書き換える方法ではありません。また、Codex Desktopのアップデートやモデルキャッシュの再取得によって設定が元に戻る可能性があります。

先にやることまとめ

変更するのは 2ファイル・3か所 です。

Codex Desktopを完全に終了します。
設定ディレクトリを開きます（エクスプローラーのアドレスバーに以下を入力）。
%USERPROFILE%\.codex\
(フルパス例: C:\Users\[ユーザー名]\.codex\)
対象の2ファイル（config.toml、models_cache.json）をバックアップします。

1. `config.toml` の編集

model = "gpt-5.6-luna"
model_reasoning_effort = "ultra"

2. `models_cache.json` の編集

"slug": "gpt-5.6-luna" を検索し、以下を変更します。

supported_reasoning_levels 配列に追加:

{
  "effort": "ultra",
  "description": "Maximum reasoning with automatic task delegation"
}

multi_agent_version の変更:
```
"multi_agent_version": "v2"
```

保存後にCodex Desktopを起動すると、UIの推論レベルに「Ultra」が表示され、サブエージェント（model: gpt-5.6-luna, reasoning_effort: ultra）の実行・親エージェントへの結果返却まで完了できるようになります。

変更前のLuna

通常、Codex DesktopにおけるGPT-5.6 Lunaの登録状態は以下の通りです。

モデル: GPT-5.6 Luna
reasoning: low / medium / high / xhigh / max
multi-agent version: v1

今回は、ローカル定義を以下のように変更します。

reasoning: low / medium / high / xhigh / max / ultra
multi_agent_version: v2

設定手順

1. Codex Desktopを完全に終了する

設定ファイルを書き換える前に、Codex Desktopを完全に終了します。
アプリが起動したままだと、終了時やモデル情報の更新時に設定ファイルが上書きされる可能性があります。タスクマネージャー等でプロセスが残っていないことを確認してください。

2. 設定ファイルをバックアップする

PowerShellを開き、次のコマンドを実行します（改行エラーを防ぐためパイプライン接続で記述しています）。

$codexDir = Join-Path $env:USERPROFILE ".codex"
$stamp = Get-Date -Format "yyyyMMdd-HHmmss"

Copy-Item -LiteralPath (Join-Path $codexDir "config.toml") -Destination (Join-Path $codexDir "config.toml.bak-$stamp")
Copy-Item -LiteralPath (Join-Path $codexDir "models_cache.json") -Destination (Join-Path $codexDir "models_cache.json.bak-$stamp")

実行後、次の形式でバックアップファイルが生成されます。

config.toml.bak-YYYYMMDD-HHMMSS
models_cache.json.bak-YYYYMMDD-HHMMSS

3. `config.toml` を変更する

テキストエディタで %USERPROFILE%\.codex\config.toml を開きます。

モデルと推論レベルを次のように設定します。

model = "gpt-5.6-luna"
model_reasoning_effort = "ultra"

注意: すでに同じキーが存在する場合は新規追加せず、既存の値を書き換えてください（重複定義エラーを避けるため）。

4. `models_cache.json` からLunaを探す

テキストエディタで %USERPROFILE%\.codex\models_cache.json を開きます。

ファイル内から "slug": "gpt-5.6-luna" を検索し、そのオブジェクト内にある "supported_reasoning_levels" 配列を探します。

5. Lunaに `ultra` を追加する

配列内の "max" ブロックの末尾にカンマ（,）を付け、その後ろに次を追加します。

{
  "effort": "ultra",
  "description": "Maximum reasoning with automatic task delegation"
}

編集後の supported_reasoning_levels 配列の例:

"supported_reasoning_levels": [
  {
    "effort": "low",
    "description": "Fast responses with lighter reasoning"
  },
  {
    "effort": "medium",
    "description": "Balances speed and reasoning depth for everyday tasks"
  },
  {
    "effort": "high",
    "description": "Greater reasoning depth for complex problems"
  },
  {
    "effort": "xhigh",
    "description": "Extra high reasoning depth for complex problems"
  },
  {
    "effort": "max",
    "description": "Maximum reasoning depth for the hardest problems"
  },
  {
    "effort": "ultra",
    "description": "Maximum reasoning with automatic task delegation"
  }
]

6. `multi_agent_version` をV2へ変更する

同じLunaオブジェクトの中から "multi_agent_version": "v1" を探し、次のように書き換えます。

"multi_agent_version": "v2"

7. JSONの構文（Syntax）を確認する

JSONの記述ミス（カンマの過不足など）を防ぐため、PowerShellで検証コマンドを実行します。

$codexDir = Join-Path $env:USERPROFILE ".codex"
Get-Content -Raw (Join-Path $codexDir "models_cache.json") | ConvertFrom-Json | Out-Null

エラーが表示されずにプロンプトが戻れば、構文は正常です。

8. 設定の反映を確認する

PowerShellで次のスクリプトを実行し、正しく書き換わったか確認します。

$codexDir = Join-Path $env:USERPROFILE ".codex"
$models = Get-Content -Raw (Join-Path $codexDir "models_cache.json") | ConvertFrom-Json
$luna = $models.models | Where-Object { $_.slug -eq "gpt-5.6-luna" }
$luna | Select-Object slug, display_name, multi_agent_version, @{Name="reasoning_levels"; Expression={ $_.supported_reasoning_levels.effort -join ", " }}

期待される出力:

slug                : gpt-5.6-luna
display_name        : GPT-5.6-Luna
multi_agent_version : v2
reasoning_levels    : low, medium, high, xhigh, max, ultra

9. Codex Desktopを起動する

Codex Desktopを起動し、モデル選択欄から「GPT-5.6 Luna」を選択します。推論レベルに「Ultra」が表示されていれば設定完了です。

サブエージェントの実際の動作

設定完了後、実際にサブエージェントが動作します。例えば、次のようなプロンプトを実行します。

この作業をサブエージェントに委譲してください。
ファイルは変更せず、
ワークスペースのディレクトリ構成だけを確認して、
結果を短く報告してください。

Codexは以下の設定でサブエージェントを自動起動します。

model: gpt-5.6-luna
reasoning_effort: ultra

サブエージェントがワークスペースを確認し、親エージェントへ結果を返却して正常終了します。

GPT-5.6 Luna
     ↓
   Ultra
     ↓
サブエージェント起動
     ↓
  タスク実行
     ↓
親エージェントへ結果を返却

変更前後の比較

項目	変更前	変更後
Lunaの推論レベル	`low` 〜 `max` (5段階)	`ultra` を追加 (6段階)
Multi-agent version	`v1`	`v2`
LunaのUltra表示	なし	あり
Luna + Ultra選択	不可	可能
サブエージェント	利用不可	起動・完了可能
UIからの利用	選択不可	通常通り選択可能

技術的な背景と留意点

「Luna Ultra」の正式提供について

OpenAIはGPT-5.6において「Sol」「Terra」「Luna」の3つの階層を公開しています。ローカルモデルカタログのデフォルトでは、SolとTerraにはUltraが存在する一方、LunaにはUltraが含まれず multi_agent_version も v1 となっていました。

今回の設定で動作することは確認できていますが、クライアント側のカタログ定義を書き換えている形となるため、OpenAIが公式にサポートをアナウンスしている機能ではありません。

サーバー内部の処理に関する注意

Codex Desktop側の挙動上は正常に完了しますが、APIサーバー内部の処理実態までは把握できません。

max 以上の推論計算量が割り当てられているか
Luna専用のUltra設定として処理されているか
サーバー側で別の推論設定へフォールバックされているか

といった点はクライアント側からは検証できないため留意してください。

UltraとMulti-agent

UltraはMulti-agent orchestration（親エージェントが複数のサブエージェントにタスクを並列委譲し、結果を統合する構造）に関連する設定です。

親エージェント
 ├─ サブエージェントA
 ├─ サブエージェントB
 ├─ サブエージェントC
 └─ サブエージェントD
         ↓
     結果を統合

Lunaの定義を v2 に更新することで、このMulti-agent V2の経路を利用したタスク委譲が可能になります。

参考情報

OpenAI 公式

GPT-5.6
GPT-5.6 Builder’s Guide
OpenAI API Reference: Create an agent

関連するCodex Issue

openai/codex-plugin-cc Issue #751
openai/codex Issue #36294

まとめ

Codex Desktop（26.908.70816 / Windows）において、config.toml と models_cache.json の2箇所を修正することで、UI上に「Ultra」を表示させ、Multi-agent V2によるサブエージェントの起動および親エージェントへの結果集約まで実行可能であることが確認できました。

※この記事はAIを利用して作成しました。

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up