How do I install the Model Router skill?

Run npx skillmds@latest add aiai-mastermind/model-router in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Model Router safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Model Router?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Model Router free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Model Router?

AiAi-Mastermind (@aiai-mastermind) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Model Router by aiai-mastermind — Agent Skill

Name: Model Router
Author: AiAi-Mastermind

File contents

Model Router - routing knowledge

This skill teaches the three ways to run work on a routed model (any model your proxy serves), and how to switch models. The proxy is CLIProxyAPI running locally; it holds the user's OTHER subscription logins (ChatGPT/Codex, Gemini, Grok, Kimi). The main Claude session always stays on its normal direct login.

Configuration (shared by everything in this plugin)

Env var	Default	Meaning
`MODEL_ROUTER_URL`	`http://127.0.0.1:8317`	proxy address
`MODEL_ROUTER_KEY`	`my-proxy-key`	an `api-keys` entry from the proxy's config.yaml
`MODEL_ROUTER_MODEL`	`gpt-5.6-sol`	default routed model
`MODEL_ROUTER_EFFORT`	`low`	default worker effort

Mode 1 - orchestrator + worker (the flagship): `/fabsol <brief>`

Your main model plans and verifies; the routed model does 100% of the building via headless calls. Cheapest way to ship real builds - see the fabsol command.

Mode 2 - one-shot worker run (any model, one task)

ANTHROPIC_BASE_URL="${MODEL_ROUTER_URL:-http://127.0.0.1:8317}" \
ANTHROPIC_AUTH_TOKEN="${MODEL_ROUTER_KEY:-my-proxy-key}" \
claude -p "the task" \
  --model "${MODEL_ROUTER_MODEL:-gpt-5.6-sol}" \
  --effort "${MODEL_ROUTER_EFFORT:-low}" \
  --bare --max-turns 20 --permission-mode acceptEdits

Or use the wrapper: scripts/worker.sh "the task" [model] [effort] (scripts/worker.ps1 on Windows).

Mode 3 - full session on a routed model (terminal or VSCode)

scripts/session.sh [model] (or session.ps1) launches a whole Claude Code terminal session on the routed model. scripts/vscode.sh [folder] (or vscode.ps1) does the same for a VSCode window - it uses a separate VSCode profile dir because an already-running VSCode ignores new env vars. In such a session, the plugin's worker subagent also resolves, so subagents can run on routed models too.

Switching models

Any ID the proxy serves works everywhere a model is named. Discover what your proxy serves:

curl -s "${MODEL_ROUTER_URL:-http://127.0.0.1:8317}/v1/models" \
  -H "Authorization: Bearer ${MODEL_ROUTER_KEY:-my-proxy-key}"

Only logged-in providers appear. Set MODEL_ROUTER_MODEL to switch the default everywhere at once, or pass a model per call. See the README's model table for provider login commands.

Hard rule

NEVER set ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN on the main session's environment or route a Claude subscription login through the proxy - Anthropic's terms ban subscription OAuth in third-party tools. Routed env vars belong on individual headless calls (or a deliberate scripts/session launch for non-Claude models) only.

---name: model-routerdescription: How to run Claude Code sessions, one-shot workers, and subagents on any model through the local proxy - model IDs, env config, and the three usage modes---# Model Router - routing knowledgeThis skill teaches the three ways to run work on a routed model (any model yourproxy serves), and how to switch models. The proxy is CLIProxyAPI runninglocally; it holds the user's OTHER subscription logins (ChatGPT/Codex, Gemini,Grok, Kimi). The main Claude session always stays on its normal direct login.## Configuration (shared by everything in this plugin)| Env var | Default | Meaning ||---|---|---|| `MODEL_ROUTER_URL` | `http://127.0.0.1:8317` | proxy address || `MODEL_ROUTER_KEY` | `my-proxy-key` | an `api-keys` entry from the proxy's config.yaml || `MODEL_ROUTER_MODEL` | `gpt-5.6-sol` | default routed model || `MODEL_ROUTER_EFFORT` | `low` | default worker effort |## Mode 1 - orchestrator + worker (the flagship): `/fabsol <brief>`Your main model plans and verifies; the routed model does 100% of the buildingvia headless calls. Cheapest way to ship real builds - see the fabsol command.## Mode 2 - one-shot worker run (any model, one task)```bashANTHROPIC_BASE_URL="${MODEL_ROUTER_URL:-http://127.0.0.1:8317}" \ANTHROPIC_AUTH_TOKEN="${MODEL_ROUTER_KEY:-my-proxy-key}" \claude -p "the task" \ --model "${MODEL_ROUTER_MODEL:-gpt-5.6-sol}" \ --effort "${MODEL_ROUTER_EFFORT:-low}" \ --bare --max-turns 20 --permission-mode acceptEdits```Or use the wrapper: `scripts/worker.sh "the task" [model] [effort]`(`scripts/worker.ps1` on Windows).## Mode 3 - full session on a routed model (terminal or VSCode)`scripts/session.sh [model]` (or `session.ps1`) launches a whole Claude Codeterminal session on the routed model. `scripts/vscode.sh [folder]` (or`vscode.ps1`) does the same for a VSCode window - it uses a separate VSCodeprofile dir because an already-running VSCode ignores new env vars. In such asession, the plugin's `worker` subagent also resolves, so subagents can run onrouted models too.## Switching modelsAny ID the proxy serves works everywhere a model is named. Discover what yourproxy serves:```bashcurl -s "${MODEL_ROUTER_URL:-http://127.0.0.1:8317}/v1/models" \ -H "Authorization: Bearer ${MODEL_ROUTER_KEY:-my-proxy-key}"```Only logged-in providers appear. Set `MODEL_ROUTER_MODEL` to switch the defaulteverywhere at once, or pass a model per call. See the README's model table forprovider login commands.## Hard ruleNEVER set `ANTHROPIC_BASE_URL` / `ANTHROPIC_AUTH_TOKEN` on the main session'senvironment or route a Claude subscription login through the proxy - Anthropic'sterms ban subscription OAuth in third-party tools. Routed env vars belong onindividual headless calls (or a deliberate scripts/session launch fornon-Claude models) only.

Frequently asked questions

Model Router