Imported from simokitafresh/multi-agent-shogun (skills/shogun-cli-switch/SKILL.md). Install upstream with npx skills add simokitafresh/multi-agent-shogun --skill shogun-cli-switch. Copyright stays with the author.

Script refs verified: 2026-07-13 将軍検分. checked_at以降の変更: yaml_field_set.sh 692b6c8d8(post-write検証統一+安全エスケープ、契約不変)、ninja_monitor.sh dafb63d60等(通知timestamp durable化+完了gap formal approval連動=内部監視ロジック。親AC偽CLEAR hotfix RC継続中のため次回commit時に再検分される)。切替手順の書き換え不要。

Script refs verified: 2026-07-02 cmd_karo_hotfix_skill_script_refs_202607021234. 対象scriptの2026-07-02T01:12以降差分をgit log/showで確認。直近変更は速度改善・内部検査強化・テンプレート修復・files_modified path guardで、各SKILL本文の呼び出し契約は維持。

Script refs verified: 2026-07-02 cmd_3642 / commit ba8b94d0e. scripts/lib/cli_lookup.sh 直近変更は cli_model_display() が sonnet-5-xhigh / opus-4-8-xhigh 等の非 claude- 接頭辞モデル名と effort suffix を表示名へ反映する修正。shogun_cli_switch.sh / switch_cli_mode.sh の呼び出し契約、cli_launch_cmd() のper-agent launch_cmd override契約、SKILL本文の実行手順に変更なし。切替後確認で表示名に effort が出る場合がある。

Script refs verified: 2026-06-20. shogun_cli_switch.sh は status/pin-2.1.87/unpin-latest/to-claude/to-codex/--agent/--scope/--dry-run/--settings-only を契約にする。CLI切替は scripts/switch_cli_mode.sh、Claude version切替は config/cli_profiles.yaml の profiles.claude.launch_cmd と個別 settings.yaml launch_cmd を正本にする。 Script refs verified: 2026-06-20 L821. switch_cli_mode.sh にstale active補正追加(@agent_state=active+task空→idle強制)。I/F変更なし。Codex sandbox環境でStop hookブロック→active残留→respawnスキップのインフラバグ修正。 Script refs verified: 2026-06-21. switch_cli_mode.sh relaunch方式をCtrl-C+send-keys→respawn-pane -kに変更(殿指摘2026-06-21: CLIごと再起動が基本)。ハングCLIにCtrl-Cが効かず再起動不能だった問題を根治。I/F変更なし。 Script refs verified: 2026-06-21T13:58. CLI種別とモデルの関係セクション追加(殿指摘2026-06-21)。GPT-5.5はCodex CLI必須、Claude CLIで--model gpt-5.5は表示のみ変更。TRIGGER拡張(モデル変更系キーワード追加)。DO NOT TRIGGER明確化(同一CLI内の/modelは対象外)。 Script refs verified: 2026-06-21T15:06. switch_cli_mode.sh 4修正(殿指示2026-06-21): (1)CLI種別変更時respawn強制(active判定バイパス) (2)model_nameファミリー不整合リセット (3)respawn前reset追加(Codex exit 2根因修正) (4)cooldown 5秒(高速連続respawn防止)。pre-bash-combined.sh Guard 9b簡素化(respawn-pane通過、model_switchのみBLOCK)。session_start_inject.sh cli_switch_pending待機状態追加。CLAUDE.md Step 0待機判定追加。双方向6連続100%成功+3人同時切替検証済み。 Script refs verified: 2026-06-24T00:35. switch_cli_mode.sh model_name SSOT修正系列(c3d290416→5972c7c34→d796b5a43)確認済み。現行契約は「CLI種別変更時に不整合model_nameを空へリセットし、settings.yaml/tmux変数同期とrespawnを行う」。gpt-5.5-low等のper-agent model_name確定値は必要時にyaml_field_setで明示設定する。I/F変更なし。 Script refs verified: 2026-06-24T08:25. switch_cli_mode.sh から shutsujin_departure.sh 呼出しを削除。理由: shutsujin_departureはセッション起動時の平時デフォルト復元であり、CLI切替直後に呼ぶとsettings.yamlをデフォルト層へ巻き戻して切替を打ち消す。post-switch verification(settings.type + tmux @agent_cli)を追加し、不一致なら成功表示せずexit 1。 Script refs verified: 2026-06-24T09:12. switch_cli_mode.sh 最新commit 78e46781d を確認。08:25追随内容(出陣リセット呼出し削除 + post-switch verification)のI/F変更なし。skill手順変更不要、mtime追随のみ。

Shogun CLI Switch

ピン留めOpus 4.6 1M（専用action以外を使うな）

「ピン留めOpus 4.6 1M」は次の一コマンドだけで実行する。

~/.codex/skills/shogun-cli-switch/scripts/shogun_cli_switch.sh \
  pin-opus-4.6-1m --agent <name>

このactionは、Claude Code 2.1.87確認、canonical model_name=claude-opus-4-6、固定版Opus high起動、/model default、実プロセス確認を順序保証する。既に正しい場合はrespawnもコマンド送信も行わず即時PASSする。切替が必要な場合は @cli_switch_pending=true を設定して重いRecoveryをスキップする。Recovery完了待ちで速度を稼ぐ設計は禁止する。次の二表示が揃わなければ非ゼロ終了し、完了扱いしない。

Opus 4.6 (1M context) with high effort
Set model to Opus 4.6 (1M context) (default)

pin-2.1.87単独はCLI版しか固定せず、デフォルトSonnetで起動しうる。 --model opus単独も1M確定ではない。独自のmodel_nameを作るな。

2026-07-27実測（影丸）: Sonnet 5 low→ピン留めOpus 4.6 1M highは6.18秒、同一状態への再実行は0.35秒。これを大幅に超える場合は待機せず実装バグとして扱う。

Quality metric: 将軍系CLI/version切替cmdのcmd_save.shチェック通過率（q1-q4 BLOCKなしで保存できた割合）。

Overview

multi-agent-shogun の指揮官/指定agentを Claude Code と Codex CLI の間で切り替え、必要に応じて Claude Code の pinned/latest version も切り替える。旧 /switch-to-codex と /switch-to-opus は本スキルへ統合済み。旧 /shogun-claude-version-switch の機能も保持する。

殿の指示→実行フロー（誰でも・いつでも・何回でも）

殿の指示を受けたら以下のフローで手順を導出し実行せよ。

Step 1: モデルファミリー判定

殿の指示に含まれるキーワード	モデルファミリー	必要なCLI
GPT-5.5, GPT	GPT系	Codex CLI
Opus, Sonnet, Haiku, Claude	Claude系	Claude CLI

Step 2: CLI種別切替（必要な場合のみ）

# 現状確認
~/.codex/skills/shogun-cli-switch/scripts/shogun_cli_switch.sh status

# GPT系に切替（1人）
~/.codex/skills/shogun-cli-switch/scripts/shogun_cli_switch.sh to-codex --agent <name>

# Claude系に切替（1人）
~/.codex/skills/shogun-cli-switch/scripts/shogun_cli_switch.sh to-claude --agent <name>

# 複数人同時（CSV指定）
~/.codex/skills/shogun-cli-switch/scripts/shogun_cli_switch.sh to-codex --scope hayate,kagemaru,saizo

Step 3: effort/fast設定

項目	Claude CLI	Codex CLI
model	`respawn-pane -k "claude --dangerously-skip-permissions --model sonnet --effort low"`	`~/.codex/config.toml` の `model = "gpt-5.5"` (全Codex共有)
effort	`--effort low\|medium\|high`（起動引数）	`config.toml` の `model_reasoning_effort = "low"` → respawn (全Codex共有)
fast	respawn後に `/fast` → Tab → Enter	`config.toml` の `service_tier = "fast"` → respawn (全Codex共有)

Codex注意: config.tomlは全Codex忍者共有。変更は全Codex忍者に影響するが、respawnした忍者のみ反映。

Claude Opus 5 コンテキスト指定(2026-07-25実験実証):

--model opus = claude-opus-5 (200Kコンテキスト)。1Mにはならない
--model 'claude-opus-5[1m]' = opus 5 1Mコンテキスト。明示指定必須
バナーで判別: 200K=Opus 5 with low effort · Claude Max / 1M=Opus 5 (1M context) with low effort
Claude Max はサブスクプラン名であり1Mの証拠ではない
launch_cmd例: $HOME/.local/bin/claude --dangerously-skip-permissions --model 'claude-opus-5[1m]' --effort low
v2.1.220のlatest CLI必須（pinned 2.1.87はopus 5未対応）

Codex CLI引数の実証結果(2026-07-20軍師実証):

--model gpt-5.6-sol: 有効。config.tomlのmodel値を上書き
--effort low/medium/high: 無効(exit 2)。Codex CLIに--effort引数は存在しない
--fast: 無効(exit 2)。Codex CLIに--fast引数は存在しない
-c model_reasoning_effort=medium: tmux respawn-pane経由だとquotingが崩れ無効化されることがある
config.toml model = "gpt-5.6-sol": 有効だがexit 2になるモデル名あり。gpt-5.6-solは--model経由でのみ動作する環境がある

正本(2026-07-27更新): per-agentのCLI/model/effortは config/settings.yaml を正本とし、scripts/agent_respawn.sh に起動コマンドを生成させる。共有 ~/.codex/config.toml のagent別書換えや直接 tmux respawn-pane は通常運用に使わない。 /effortコマンドは存在しない(実験実証6/6)。/modelはインタラクティブメニューのみ (引数不可)であり、作業中は使用しない。

モデル実験はactive worker paneで行わない（2026-07-21）: モデル/effortの組合せ検証は shogun_cli_switch.sh probe-codex --model <model> --effort <level> を使う。この経路は codex exec --ephemeral --ignore-user-config のisolated processで実行し、共有config checksum不変・全pane PID変化0を同時検証する。workerのtask中にself-respawnしてはならない。実運用の切替だけ、idle paneへ既存respawn経路を使う。

per-agent CLI/model切替の唯一の正規順（2026-07-27実機確認）

to-codex はCLI種別を切り替えるが、切替前のClaude系 model_name（例: sonnet-5-low）が settings/tmuxへ残る場合がある。to-codex の成功表示だけでモデル変更完了と判断するな。

# 1. 現状確認とdry-run
~/.codex/skills/shogun-cli-switch/scripts/shogun_cli_switch.sh status
~/.codex/skills/shogun-cli-switch/scripts/shogun_cli_switch.sh \
  to-codex --scope hayate,kotaro --dry-run

# 2. CLI種別をCodexへ切替（設定のみ。旧model_nameでの中間respawnを防ぐ）
#    既に対象全員がCodexならこの段階だけ省略可
~/.codex/skills/shogun-cli-switch/scripts/shogun_cli_switch.sh \
  to-codex --scope hayate,kotaro --settings-only

# 3. per-agent正本を更新（settings.yamlへsedを使わない）
for agent in hayate kotaro; do
  bash scripts/lib/yaml_field_set.sh config/settings.yaml \
    "$agent" model_name gpt-5.6-sol-low
done

# 4. 正本値から起動コマンドを再生成してrespawn
for agent in hayate kotaro; do
  bash scripts/agent_respawn.sh "$agent"
done

# 5. settings/tmux → 最新banner → 現在processの順で一次確認

agent_respawn.sh の出力に -c model_reasoning_effort=low -c service_tier=default が含まれることを確認する。完了条件は次の3点が全て一致すること:

settings/tmux: cli=codex model=gpt-5.6-sol-low
banner: model: gpt-5.6-sol low または最下部 gpt-5.6-sol low
process: 現在のpane子プロセスがCodexで、起動引数に model_reasoning_effort=low

capture-paneの上部に以前の失敗 error: unexpected argument '--effort' found が残っていても、それだけで現在の起動失敗と判定するな。paneの開始コマンド、最新banner、現在PIDの3点で判定する。今回の実機確認では旧エラー残像がありながら、両paneの現行bannerと processは gpt-5.6-sol low で一致した。

実行順の不変量:

CLI変更と最終モデル変更を同時に行う場合は、to-codex/to-claude --settings-onlyを先に行う。
次に yaml_field_set.sh でagent別の model_name（必要ならservice_tier）を確定する。
最後に agent_respawn.sh を実行する。正本更新前のrespawnは禁止。
--settings-onlyを省くと、旧model_nameで1回、確定model_nameで1回の二重respawnになる。 2026-07-27の3名一括切替で不要な中間respawnが3回発生したため、モデル併用切替では設定のみを正規経路とする。
CLI種別だけを変え、モデル名を変更しない依頼では従来どおりto-codex/to-claude単独でよい。
active/in_progress paneは殿の即時切替指示がない限りrespawnせず、設定反映を次の安全な再起動まで保留する。
完了判定は settings/tmux・最新banner・現在process の3点一致だけで行う。

Step 4: 一次確認（必須）

# 1) settings.yamlは固定行sed禁止。YAMLパースで対象agentだけ確認
python3 - <<'PY'
import yaml
agent = "<agent>"
print(yaml.safe_load(open("config/settings.yaml"))["cli"]["agents"][agent])
PY

# 2) tmux変数確認
tmux display-message -t shogun:2.<pane> -p 'agent=#{@agent_id} cli=#{@agent_cli} model=#{@model_name} state=#{@agent_state} task=#{@task_id} current=#{pane_current_command} start=#{pane_start_command}'

# 3) バナーで実モデルを確認（設定変更≠反映。一次確認が必須）
tmux capture-pane -t shogun:2.<pane> -p -S -60 | tail -30

# 4) 実プロセス確認（pane_current_command=bashでも子プロセスにclaude/codexがいる場合がある）
pid=$(tmux display-message -t shogun:2.<pane> -p '#{pane_pid}')
ps -o pid,ppid,stat,comm,args --forest -g "$pid" | sed -n '1,40p'

実行例

# 例1: 「hanzoをGPT5.5 low fastonに」
~/.codex/skills/shogun-cli-switch/scripts/shogun_cli_switch.sh to-codex --agent hanzo --settings-only
bash scripts/lib/yaml_field_set.sh config/settings.yaml hanzo model_name gpt-5.5-low
bash scripts/lib/yaml_field_set.sh config/settings.yaml hanzo service_tier fast
bash scripts/agent_respawn.sh hanzo
tmux capture-pane -t shogun:2.5 -p | tail -2  # → gpt-5.5 low fast 確認

# 例2: 「saizo をSonnet low に」(既にClaude CLIなら)
~/.codex/skills/shogun-cli-switch/scripts/shogun_cli_switch.sh to-claude --agent saizo --settings-only
bash scripts/lib/yaml_field_set.sh config/settings.yaml saizo model_name sonnet-5-low
bash scripts/agent_respawn.sh saizo
tmux capture-pane -t shogun:2.6 -p | head -3  # → Sonnet 4.6 with low effort 確認

# 例3: 「hayateとkagemaruを同時にCodexに」
~/.codex/skills/shogun-cli-switch/scripts/shogun_cli_switch.sh to-codex --scope hayate,kagemaru --settings-only
for a in hayate kagemaru; do
  bash scripts/lib/yaml_field_set.sh config/settings.yaml "$a" model_name gpt-5.6-sol-low
  bash scripts/agent_respawn.sh "$a"
done

# 例4: version切替
~/.codex/skills/shogun-cli-switch/scripts/shogun_cli_switch.sh pin-2.1.87      # 全員2.1.87固定
~/.codex/skills/shogun-cli-switch/scripts/shogun_cli_switch.sh unpin-latest     # 全員最新版

# 例5: 「karoをGPT5.5 medium fast onに」
~/.codex/skills/shogun-cli-switch/scripts/shogun_cli_switch.sh to-codex --agent karo --settings-only
bash scripts/lib/yaml_field_set.sh config/settings.yaml karo model_name gpt-5.5-medium
bash scripts/lib/yaml_field_set.sh config/settings.yaml karo service_tier fast
bash scripts/agent_respawn.sh karo
tmux capture-pane -t shogun:2.1 -p | tail -2  # → gpt-5.5 medium fast 確認

例6: 「karoをOpus 5 1M lowに」(2026-07-25実証)

~/.codex/skills/shogun-cli-switch/scripts/shogun_cli_switch.sh to-claude --agent karo --settings-only bash scripts/lib/yaml_field_set.sh config/settings.yaml karo model_name opus-5-1m-low bash scripts/lib/yaml_field_set.sh config/settings.yaml karo launch_cmd "$HOME/.local/bin/claude --dangerously-skip-permissions --model 'claude-opus-5[1m]' --effort low" bash scripts/agent_respawn.sh karo sleep 8 && tmux capture-pane -t shogun:2.1 -p -S -60 | grep -i "opus|context" # → Opus 5 (1M context) 確認

例7: 「karoをGPT5.5 medium、忍者6名をGPT5.5 low fastに」(一括切替 2026-06-23実証)

Step1: CLI種別を先にCodexへ統一

~/.codex/skills/shogun-cli-switch/scripts/shogun_cli_switch.sh to-codex --scope karo,hayate,kagemaru,hanzo,saizo,kotaro,tobisaru --settings-only

Step2: settings.yamlのagent別正本を確定

bash scripts/lib/yaml_field_set.sh config/settings.yaml karo model_name gpt-5.5-medium for a in hayate kagemaru hanzo saizo kotaro tobisaru; do bash scripts/lib/yaml_field_set.sh config/settings.yaml "$a" model_name gpt-5.5-low bash scripts/lib/yaml_field_set.sh config/settings.yaml "$a" service_tier fast done

Step3: 正本値から各paneを再生成

for a in karo hayate kagemaru hanzo saizo kotaro tobisaru; do bash scripts/agent_respawn.sh "$a"; done

Step4: settings/tmux・banner・processを一次確認

sleep 8 && for p in 1 3 4 5 6 7 8; do echo "pane $p: $(tmux capture-pane -t shogun:2.$p -p | grep -o 'gpt-5.5[^·]*')"; done


**実績**: 回1(3分/1名)→回3(2分/7名)。Step1-4を順序実行すれば全員2分で切替可能。

### anti-pattern（殿指摘2026-06-21）

**動いているCLIを弄ろうとするな。paneを殺す→正しいCLI+設定で起動が正道。**

| ❌ 間違い | ✅ 正しい |
|----------|----------|
| `/model gpt-5.5` で Claude→GPT変更 | `to-codex --agent <name>` |
| settings.yaml model_name変更のみ | respawn-pane -k + 起動引数 |
| `--effort low` を Codex CLI に渡す | config.toml の `model_reasoning_effort` |
| Claude CLI で `/fast` → Sonnet fast | `/fast` は Opus 4.6 に強制変更される |
| `codex --full-auto` で起動 | `codex` 単体起動(0.141.0でexit 2) |
| switch_cli_mode.sh後にsettings.yaml未確認 | 切替後に`grep type settings.yaml`で一次確認必須(2026-06-23: tmux変数のみ更新しsettings未反映の事故) |
| `to-codex`成功表示だけでGPTモデル反映済みと判断 | settingsの旧Claude model_name残存を確認し、yaml_field_set→agent_respawn→banner/tmux/process三点確認 |
| capture-pane内の過去`--effort`エラーだけで現行起動失敗と判断 | pane_start_command・最新banner・現在PIDを照合して残像と現行状態を分離 |
| CLI切替後に`shutsujin_departure.sh`実行 | セッション起動時だけ実行。切替中に呼ぶとsettings.yamlを平時デフォルトへ巻き戻す |
| `sed -n '27,33p' config/settings.yaml`など固定行で対象agent確認 | YAMLパースで`cli.agents.<agent>`を直接読む |
| `--model opus` でOpus 5 1Mと判断 | `--model 'claude-opus-5[1m]'` と明示指定。バナーに`(1M context)`表示を確認 |

## Safety

- まず `status` か `--dry-run` を実行せよ
- `active` / `assigned` task中に `pane_dead=1` を検知した場合は、`ninja_monitor.sh` がdeploy/stall graceより先に `respawn_dead_agent.sh` でdead-only自動復旧する。手動respawnを重ねず、`capture-pane -S -30` とtask statusで復旧・再開を確認せよ。live paneとidle taskは自動復旧対象外。
- CLI/version 切替は設定変更だけでは不十分。**idle paneのrespawnが必須**
- `active` / `in_progress` 相当のpaneはスキップし、設定だけを次回起動へ反映する
- `--settings-only` は、CLI+モデルを同時変更して最後に`agent_respawn.sh`を1回だけ行う場合、
  または次回respawnまで反映を保留する場合に使う。`scripts/switch_cli_mode.sh --no-relaunch`に対応する
- **切替後にsettings.yamlのtype/model_nameが正しいか`grep`で一次確認必須**。switch_cli_mode.shがtmux変数のみ更新しsettings未反映の事故あり(2026-06-23 LK007)
- **固定行sedでsettings確認禁止**。行番号は差分で動く。必ずPython/YAMLで `cli.agents.<agent>` を読む
- **切替後に実pane確認必須**。`tmux display-message`、`capture-pane`、必要時は`ps --forest -g #{pane_pid}`で「実CLI/実モデル/実プロセス」を確認する
- **shutsujin_departure.shはruntime CLI switchで実行禁止**。これはセッション起動時のデフォルト復元スクリプトであり、切替状態を巻き戻す
- 正本ランブックを先に読む: `docs/research/claude-code-version-runbook.md`
- Codex切替の前提: `~/.codex/config.toml` に `model_context_window = 1000000`、`model_auto_compact_token_limit = 900000`、hooks有効化があること
- Codexロール指示: `instructions/generated/codex-{role}.md` と AGENTS.md Recovery手順を使う
- 将軍切替時は殿が将軍ペインにいるため、別paneから実行せよ

## Options

```bash
~/.codex/skills/shogun-cli-switch/scripts/shogun_cli_switch.sh <status|pin-2.1.87|unpin-latest|to-claude|to-codex> [--agent <name>] [--scope <core|all|csv>] [--repo <path>] [--dry-run] [--settings-only]

Notes

pin-2.1.87 / unpin-latest の対象は Claude 系 pane のみ
to-claude / to-codex は settings.yaml の type を変更し、tmux @agent_cli / @model_name を同期する
2.1.87 固定資産が欠けている場合は停止して報告する
--agent 指定時: CLI切替では単一agentの type を変更、version切替では個別 launch_cmd を操作（cli_lookup.sh のオーバーライド機構を利用）
--agent + pin-2.1.87: 個別オーバーライドを削除しプロファイルデフォルト(ピン止め)に戻す
shutsujin再起動時は指揮官(shogun/karo/gunshi)をデフォルトClaude/Opusへ戻す。Codex切替は手動実行時のみの一時状態である

per-agent launch_cmd によるバージョン個別切替（2026-07-01 実装）

「いつでも誰でも個別もしくは複数をピン留めや最新版に自由自在に切り替えられる」 仕組み。

仕組み:

config/cli_profiles.yaml の claude.launch_cmd = ~/bin/claude (ピン留め2.1.87) がデフォルト
config/settings.yaml の per-agent 設定に launch_cmd: を追加するとその agent だけ上書き
scripts/lib/cli_lookup.sh の cli_launch_cmd() がこの値を読んで起動コマンドを決定
scripts/ninja_monitor.sh が respawn 時に cli_launch_cmd() を呼ぶため、設定後は次回 /clear 時に自動反映

個別に最新版へ切替:

# tobisaru を最新版(~/.local/bin/claude)に切替
bash scripts/lib/yaml_field_set.sh config/settings.yaml tobisaru launch_cmd "~/.local/bin/claude --dangerously-skip-permissions"

# 確認: cli_lookup で正しく読めるか
source scripts/lib/cli_lookup.sh && cli_lookup tobisaru && echo "launch: $(cli_launch_cmd tobisaru)"

固定版へ戻す:

# launch_cmd 行を削除すると cli_profiles.yaml のデフォルト(~/bin/claude)に戻る
python3 -c "
import yaml, re
with open('config/settings.yaml') as f: txt = f.read()
# launch_cmd 行を per-agent ブロックから除去
# ※ yaml_field_set.sh で空文字設定後に手動削除、または下記で直接編集
print('手動でsettings.yaml の tobisaru.launch_cmd 行を削除')
"

ninja_monitor が 2.1.87 に巻き戻す問題の根因と防止:

旧 cli_lookup.sh は settings.yaml の launch_cmd を読まず cli_profiles.yaml のみ参照していた
修正 (2026-07-01): _cli_launch_read_settings() に launch_cmd: ブランチと _CLI_LAUNCH_CMD_OVERRIDE 変数を追加
これにより settings.yaml per-agent launch_cmd が最優先で適用される
検証: source scripts/lib/cli_lookup.sh && cli_launch_cmd tobisaru → ~/.local/bin/claude ... であれば OK

実践検証結果（2026-06-21 殿指示で検証）

#	操作	方法	結果	知見
P1	Codex→Claude	`to-claude --agent`	✅	スキルが設定+respawn一括実行
P2	Opus→Sonnet(同一CLI)	`/model sonnet`	✅	同一CLI内は`/model`でOK
P3	Claude→Codex	`to-codex --agent`	✅	根因修正済み(reset+cooldown)。双方向6連続成功
P4	effort変更(Claude)	`respawn-pane -k --model --effort`	✅	pane殺す→起動引数指定が正道
P5	effort変更(Codex)	config.toml→respawn	✅	config.toml変更は即時反映されない。respawn必須
P6	fast off(Codex)	config.toml service_tier→respawn	✅	service_tier=default/fast。respawnで反映
P7	fast toggle(Claude)	`/fast` Tab Enter	✅	fast ONはOpus 4.6に強制変更。Sonnet fastは不可
C1	2人同時切替	`--scope hayate,kagemaru`	✅	CSV指定で一括切替
C2	3人同時切替	`--scope hayate,kagemaru,saizo`	✅	CLI種別変更はrespawn強制(active判定バイパス)

修正済みの問題と対策:

Codex exit 2 (pane dead): 根因=Claude CLIのターミナル設定残留。対策=respawn前にreset実行+5秒cooldown。双方向6回連続100%成功で検証済み
CLI種別変更時のrespawnスキップ: 根因=@agent_state=active残留。対策=current_cli≠TARGET_CLIならstale/busy判定スキップ
model_nameファミリー不整合: 根因=to-claude時にGPT model_nameが残留。対策=CLI種別変更時に不整合model_nameを自動リセット
CLI switch後の自動recovery: 対策=@cli_switch_pending→CLAUDE.md Step 0でrecovery全スキップ→CTX:0%待機

運用注意:

config.toml(effort/service_tier)は全Codex忍者共有。変更は全員に影響するがrespawnした忍者のみ反映
Claude /fast ONはモデルをOpus 4.6に強制変更する。Sonnet fastは存在しない

shogun-cli-switch

About