# Model Router

> 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

- **Type:** Skill
- **Install:** `agentstack add skill-aiai-mastermind-aiai-mastermind-tools-and-skills-model-router`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [AiAi-Mastermind](https://agentstack.voostack.com/s/aiai-mastermind)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [AiAi-Mastermind](https://github.com/AiAi-Mastermind)
- **Source:** https://github.com/AiAi-Mastermind/aiai-mastermind-tools-and-skills/tree/main/skills/model-router/skills/model-router

## Install

```sh
agentstack add skill-aiai-mastermind-aiai-mastermind-tools-and-skills-model-router
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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 `

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)

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

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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [AiAi-Mastermind](https://github.com/AiAi-Mastermind)
- **Source:** [AiAi-Mastermind/aiai-mastermind-tools-and-skills](https://github.com/AiAi-Mastermind/aiai-mastermind-tools-and-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-aiai-mastermind-aiai-mastermind-tools-and-skills-model-router
- Seller: https://agentstack.voostack.com/s/aiai-mastermind
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.