# Set Codex Model

> codex-wrapper のデフォルトモデルを設定ファイルに保存・確認する。引数なしで現状表示、モデル名を渡すと保存。

- Skill: `yumeno/set-codex-model-2` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add yumeno/set-codex-model-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yumeno/set-codex-model-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/set-codex-model-2

---


# /set-codex-model — デフォルトモデルを設定する

`codex-wrapper.conf` にデフォルトモデル名を保存し、以後 `-Model` / `--model` 未指定でも
そのモデルが使われるようにします。引数なしで呼ぶと現状を表示します。

設定ファイルの default は `$HOME/.agents/add_codexcli/codex-wrapper.conf` です。
`CODEX_WRAPPER_CONFIG` 環境変数で上書きできます。

> **解決順位（ラッパー側）:**
> 1. `--model` / `-Model` CLI 引数
> 2. `$CODEX_WRAPPER_MODEL` 環境変数
> 3. `codex-wrapper.conf` の `model=...`
> 4. 何もなければ codex CLI のデフォルト（不明なので表示しない）

## 引数の解釈

- 引数なし → 現状を表示
- 引数あり（モデル名 1 つ）→ 保存

利用可能なモデル名は `/list-codex-models` で確認できます。

## 手順

### 1. ラッパースクリプトを呼び出す

> **重要 (許可プロンプト回避):** wrapper を呼ぶときは
> **素の 1 コマンドで直接呼ぶこと。** 変数代入の前置やコマンド置換 (`OUTPUT=$(...)`) は
> 許可傘から外れて承認要求が出る。stdout はそのまま tool result に返るので捕捉不要。
> wrapper のパスは **必ず double quote で囲む**。
> この SKILL.md 自身のディレクトリ直下の `scripts/` を絶対 path に解決
> (通常 `$CLAUDE_SKILL_DIR/scripts/`) してから、そのパスを使う。

#### Windows + Claude Code (主用途)

**引数なし（現状表示）:**
```bash
powershell -ExecutionPolicy Bypass -NoProfile -File "<scripts-root>\codex-wrapper.ps1" -ShowModel
```

**モデル名を渡して保存:**
```bash
powershell -ExecutionPolicy Bypass -NoProfile -File "<scripts-root>\codex-wrapper.ps1" -SetModel "gpt-5.5"
```

不正な文字を含むモデル名は wrapper 側で拒否される (`^[A-Za-z0-9._:/-]+$` のみ許可)。

#### Linux/Mac native 環境

```bash
bash "<scripts-root>/codex-wrapper.sh" --show-model
bash "<scripts-root>/codex-wrapper.sh" --set-model "gpt-5.5"
```

### 2. 失敗検知 (重要)

wrapper が失敗したとき (例: 不正な文字を含むモデル名)、**stdout の先頭に
`[CODEX_WRAPPER_ERROR]` で始まる行が出る**。tool result のいずれかの行が
`[CODEX_WRAPPER_ERROR]` で始まっていたら、**成功扱いせず wrapper のエラーとして提示する**。例:

```
## codex-wrapper の呼び出しに失敗しました

(sentinel 行とそれ以降のエラー詳細をそのまま掲示)
```

成功時は sentinel が出ないので、以下の通常フォーマットを使う。

### 3. 結果を以下の形式で提示

**引数なし（現状表示）の場合**:
```
## codex-wrapper の現在のモデル設定

(コマンドの出力をそのまま貼る。例: model=gpt-5.5 (source: config))

---
*変更するには `/set-codex-model <モデル名>`*
```

**引数ありで保存した場合**:
```
## codex-wrapper のデフォルトモデルを更新

保存先: (config_file のパス)
新しい既定モデル: (保存した値)

---
*以後 `/ask-codex` や `/ask-codex-with-context` で `--model` / `-Model` 未指定の場合、このモデルが使われます。*
```

### 4. 特定のエラーパターンへの補足

ステップ 2 の失敗検知 (`[CODEX_WRAPPER_ERROR]` sentinel) で wrapper の失敗を検出した上で、
特に **モデル名に不正な文字が含まれていた** ケースでは sentinel の後に以下のような行が続く:

```
[CODEX_WRAPPER_ERROR] model name from -SetModel contains unsafe characters: '...' (allowed: A-Z a-z 0-9 . _ : / -)
```

このパターンを見つけたら、ユーザーには **「モデル名の文字が許可されない (英数 / `.` / `_` / `:` / `/` / `-` のみ可)」** 旨を平易に伝える。