/list-codex-models — 利用可能なモデルを列挙する
codex debug models を呼び出して、Codex CLI が知っているモデル名を一覧表示します。
/ask-codex や /ask-codex-with-context で -Model (PS) / --model (bash) に何を渡せるか確認するためのスキル。
disable-model-invocationについて: デフォルトはtrue(手動起動のみ)。 自動呼び出しの必要性は低いので基本このままで OK。
引数の解釈
$ARGUMENTS は省略可能。以下のキーワードを含むと挙動が変わる:
bundled/オフライン→-Bundled/--bundledを付ける(バイナリ同梱カタログのみ)json/生→-Json/--jsonを付ける(raw JSON 出力)- それ以外 → 名前リスト(デフォルト)
手順
1. ヘルパースクリプトを呼び出す
重要 (許可プロンプト回避): wrapper / helper を呼ぶときは 素の 1 コマンドで直接呼ぶこと。 変数代入の前置やコマンド置換 (
OUTPUT=$(...)) は 許可傘から外れて承認要求が出る。stdout はそのまま tool result に返るので捕捉不要。 helper のパスは 必ず double quote で囲む。 この SKILL.md 自身のディレクトリ直下のscripts/を絶対 path に解決 (通常$CLAUDE_SKILL_DIR/scripts/) してから、そのパスを使う。
Windows + Claude Code (主用途)
オプションなし (名前リスト):
powershell -ExecutionPolicy Bypass -NoProfile -File "<scripts-root>\list-codex-models.ps1"
オフライン (-Bundled):
powershell -ExecutionPolicy Bypass -NoProfile -File "<scripts-root>\list-codex-models.ps1" -Bundled
raw JSON (-Json):
powershell -ExecutionPolicy Bypass -NoProfile -File "<scripts-root>\list-codex-models.ps1" -Json
-Bundled と -Json の併用も可。引数の組み合わせは $ARGUMENTS のキーワードに応じて選ぶ。
Linux/Mac native 環境
bash "<scripts-root>/list-codex-models.sh"
オプション: --bundled / --json。
2. 失敗検知 (重要)
helper が失敗したとき、stdout の先頭に [CODEX_WRAPPER_ERROR] で始まる行が出る。
tool result のいずれかの行が [CODEX_WRAPPER_ERROR] で始まっていたら、モデル一覧ではなく
helper のエラーとして提示する。例:
## list-codex-models の呼び出しに失敗しました
(sentinel 行とそれ以降のエラー詳細をそのまま掲示)
成功時は sentinel が出ないので、以下の通常フォーマットを使う。
3. 結果を以下の形式でユーザーに提示する
名前リストの場合:
## Codex CLI が認識しているモデル
(取得したモデル名を箇条書きで)
---
*`codex debug models` の出力より。実際に使えるモデルは認証種別(ChatGPT Plus / API キー)で異なる場合あり。*
--json 指定の場合:
## Codex CLI モデルカタログ (raw JSON)
```json
(取得した JSON)
```