# List Codex Models

> Codex CLI が認識しているモデル一覧を取得する。`--model` に渡せる値を確認したい時に使う。

- Skill: `yumeno/list-codex-models-2` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add yumeno/list-codex-models-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yumeno/list-codex-models-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Yumeno (https://skillmd.com/u/yumeno)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yumeno/list-codex-models-2

---


# /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 (主用途)

オプションなし (名前リスト):
```bash
powershell -ExecutionPolicy Bypass -NoProfile -File "<scripts-root>\list-codex-models.ps1"
```

オフライン (`-Bundled`):
```bash
powershell -ExecutionPolicy Bypass -NoProfile -File "<scripts-root>\list-codex-models.ps1" -Bundled
```

raw JSON (`-Json`):
```bash
powershell -ExecutionPolicy Bypass -NoProfile -File "<scripts-root>\list-codex-models.ps1" -Json
```

`-Bundled` と `-Json` の併用も可。引数の組み合わせは `$ARGUMENTS` のキーワードに応じて選ぶ。

#### Linux/Mac native 環境

```bash
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)
```
````

### 4. 必要に応じて、`/ask-codex -Model <name>` のような使い方の例を添える