@alexeiled/claude-router 1.19.1 → 1.19.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +1 -1
- package/CHANGELOG.md +11 -0
- package/README.md +2 -0
- package/docs/evaluation.md +8 -0
- package/docs/providers.md +96 -2
- package/package.json +1 -1
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "router",
|
|
3
3
|
"displayName": "Router",
|
|
4
|
-
"version": "1.19.
|
|
4
|
+
"version": "1.19.2",
|
|
5
5
|
"description": "Native model and effort routing within your provider. Anthropic, DeepSeek, z.ai, MiniMax, MiMo and Kimi defaults, custom provider profiles, classifier advice and one model per subagent.",
|
|
6
6
|
"author": {
|
|
7
7
|
"name": "Alexei Ledenev",
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,16 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 1.19.2 (2026-11-01)
|
|
4
|
+
|
|
5
|
+
### Added
|
|
6
|
+
|
|
7
|
+
- Document the explicit `model-proxy` custom profile for mixed Anthropic and DeepSeek sessions through a separately started native proxy. No built-in mixed-provider defaults, endpoint switching or credential handling are added to the Mod.
|
|
8
|
+
- Verify two-provider route switching, response-ID normalization, profile isolation and selected-file saves with the existing native hook harness.
|
|
9
|
+
|
|
10
|
+
### Upgrade
|
|
11
|
+
|
|
12
|
+
Restart Claude Code after updating. Existing profiles need no changes. To opt in, create a complete `model-proxy-router.json` in the selected account directory and follow the proxy setup guide. Every selected provider receives the unchanged conversation history.
|
|
13
|
+
|
|
3
14
|
## 1.19.1 (2026-10-31)
|
|
4
15
|
|
|
5
16
|
### Fixed
|
package/README.md
CHANGED
|
@@ -109,6 +109,8 @@ The Anthropic profile uses these activity defaults. Other profiles have [their o
|
|
|
109
109
|
|
|
110
110
|
A [routing mode](docs/routing-modes.md) trades cost against answer quality without new routes: `cost` takes a cheaper model or one effort level less where a turn allows it, `quality` one effort level more or the tier above, and `balanced`, the default, runs the routes as configured. Set it per session with `/router mode cost`, per project in `.claude/router.json`, or for the profile with `"mode"` in `router.json`.
|
|
111
111
|
|
|
112
|
+
For mixed Anthropic and DeepSeek sessions, use the explicit [model-proxy profile](docs/providers.md#mix-anthropic-and-deepseek-with-model-proxy) with a separately started local proxy. No built-in mixed-provider defaults are installed.
|
|
113
|
+
|
|
112
114
|
## Install
|
|
113
115
|
|
|
114
116
|
You need Claude Code 2.1.289 or newer and credentials for one [supported classifier](#supported-classifiers).
|
package/docs/evaluation.md
CHANGED
|
@@ -222,3 +222,11 @@ Limits:
|
|
|
222
222
|
- Failure signatures and pins are not present in the trace. The relevant route decisions are excluded from comparison.
|
|
223
223
|
- Most main rows are tool continuations or have no Jev advice. Only 37 advised decisions support the native comparison.
|
|
224
224
|
- Costs cover the next request. They use the last observed output size and do not model effort-dependent output length or future answer quality.
|
|
225
|
+
|
|
226
|
+
## model-proxy integration
|
|
227
|
+
|
|
228
|
+
The explicit two-provider profile is covered by custom-profile validation, native hook harness switching, bare response-ID normalization, selected-file saves and automatic-advice cases. There are no built-in mixed-provider model defaults.
|
|
229
|
+
|
|
230
|
+
A scoped native check on 2026-11-01 used Router 1.19.1 with Claude Code 2.1.316, the new proxy helper and an explicitly selected work account directory. A synthetic conversation completed pinned DeepSeek → Opus → DeepSeek with Read-tool continuation, followed by a successful automatic turn with Jev healthy. The proxy's [verification report](https://github.com/alexei-led/claude-proxy/blob/main/docs/verification.md#two-provider-integration-for-v013) owns this transport evidence.
|
|
231
|
+
|
|
232
|
+
This is not a routing-quality, savings, full-context or universal provider-history benchmark. Automatic switching in both directions remains covered by controlled harness cases rather than that pinned live sequence.
|
package/docs/providers.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Providers
|
|
2
2
|
|
|
3
|
-
Claude Router routes models and effort
|
|
4
|
-
Set a provider name and give the router a matching JSON file.
|
|
3
|
+
Claude Router routes models and effort through the Anthropic-compatible endpoint that Claude Code already uses.
|
|
4
|
+
Set a provider name and give the router a matching JSON file. Direct provider profiles need no proxy. The optional `model-proxy` profile uses a separately started local proxy.
|
|
5
5
|
|
|
6
6
|
**Built-in profiles:** Anthropic, DeepSeek, z.ai, MiniMax, MiMo and Kimi.
|
|
7
7
|
**Custom profiles:** OpenRouter, Ollama, other local servers, and other hosted providers with a Claude Code-compatible Anthropic endpoint.
|
|
@@ -45,6 +45,7 @@ The directory is `CLAUDE_CONFIG_DIR` when set, otherwise `~/.claude`.
|
|
|
45
45
|
| `minimax` | `minimax-router.json` | MiniMax-M3.1-Flash |
|
|
46
46
|
| `mimo` | `mimo-router.json` | MiMo-V2.6-Flash, MiMo-V2.6-Pro |
|
|
47
47
|
| `kimi` | `kimi-router.json` | Kimi-K3.1-Pro |
|
|
48
|
+
| `model-proxy` | `model-proxy-router.json` | None. Supply an explicit mixed-provider profile. |
|
|
48
49
|
| `openrouter` | `openrouter-router.json` | None. Supply a complete profile. |
|
|
49
50
|
| `ollama` | `ollama-router.json` | None. Supply a complete profile. |
|
|
50
51
|
| Any other valid name | `<provider>-router.json` | None. Supply a complete profile. |
|
|
@@ -206,6 +207,99 @@ MiMo's cost/quality modes change models where a neighbouring tier permits it; ot
|
|
|
206
207
|
Kimi uses only `low`, `high`, `max`, the documented controls, and never promotes a session into another model.
|
|
207
208
|
These are starting policies, not an optimal activity matrix. See [research and experiments](provider-experiments.md).
|
|
208
209
|
|
|
210
|
+
## Mix Anthropic and DeepSeek with model-proxy
|
|
211
|
+
|
|
212
|
+
`model-proxy` is a custom execution profile, not another classifier or routing engine.
|
|
213
|
+
Claude Code sends every request to one local `claude-proxy` endpoint. The proxy selects an explicitly configured upstream from the native model ID.
|
|
214
|
+
|
|
215
|
+
1. Install and configure [claude-proxy](https://github.com/alexei-led/claude-proxy/blob/main/docs/integration.md).
|
|
216
|
+
2. Save the following complete profile as `model-proxy-router.json` in the selected Claude Code configuration directory.
|
|
217
|
+
3. Start the proxy manually, then use its `connect` command from v0.1.3 or newer.
|
|
218
|
+
|
|
219
|
+
```json
|
|
220
|
+
{
|
|
221
|
+
"models": {
|
|
222
|
+
"deepseek": {
|
|
223
|
+
"id": "deepseek-flash[1m]",
|
|
224
|
+
"input": 0.3,
|
|
225
|
+
"output": 1.2,
|
|
226
|
+
"cacheRead": 0.006,
|
|
227
|
+
"contextWindow": 1000000,
|
|
228
|
+
"billing": "credits",
|
|
229
|
+
"efforts": [
|
|
230
|
+
"low",
|
|
231
|
+
"high",
|
|
232
|
+
"max"
|
|
233
|
+
],
|
|
234
|
+
"strength": 3,
|
|
235
|
+
"imageInput": true
|
|
236
|
+
},
|
|
237
|
+
"claude": {
|
|
238
|
+
"id": "claude-opus-5-5",
|
|
239
|
+
"input": 4,
|
|
240
|
+
"output": 20,
|
|
241
|
+
"cacheRead": 0.2,
|
|
242
|
+
"contextWindow": 1000000,
|
|
243
|
+
"billing": "plan",
|
|
244
|
+
"efforts": [
|
|
245
|
+
"low",
|
|
246
|
+
"medium",
|
|
247
|
+
"high",
|
|
248
|
+
"xhigh",
|
|
249
|
+
"max"
|
|
250
|
+
],
|
|
251
|
+
"strength": 4
|
|
252
|
+
}
|
|
253
|
+
},
|
|
254
|
+
"routes": {
|
|
255
|
+
"micro": {
|
|
256
|
+
"model": "deepseek",
|
|
257
|
+
"effort": "low"
|
|
258
|
+
},
|
|
259
|
+
"low": {
|
|
260
|
+
"model": "deepseek",
|
|
261
|
+
"effort": "low"
|
|
262
|
+
},
|
|
263
|
+
"medium": {
|
|
264
|
+
"model": "deepseek",
|
|
265
|
+
"effort": "high"
|
|
266
|
+
},
|
|
267
|
+
"high": {
|
|
268
|
+
"model": "claude",
|
|
269
|
+
"effort": "xhigh"
|
|
270
|
+
}
|
|
271
|
+
},
|
|
272
|
+
"activityRouting": "off",
|
|
273
|
+
"subagentRouting": "off",
|
|
274
|
+
"cache": {
|
|
275
|
+
"mode": "disabled"
|
|
276
|
+
}
|
|
277
|
+
}
|
|
278
|
+
```
|
|
279
|
+
|
|
280
|
+
These are experimental starting routes, not measured quality rankings. Both lower tiers use DeepSeek at low effort; medium uses high effort; high uses Opus at xhigh.
|
|
281
|
+
The price fields are API list-price estimates, not subscription charges. DeepSeek values use peak prices.
|
|
282
|
+
Cache-cost assumptions, activity routing and subagent routing are off initially; upstream caching remains active.
|
|
283
|
+
The default classifier is Jev and needs its existing plugin credential. Select another configured classifier explicitly if needed; no local classifier server is required.
|
|
284
|
+
|
|
285
|
+
```sh
|
|
286
|
+
# Terminal 1: the selected account's proxy configuration
|
|
287
|
+
claude-proxy --config /path/to/proxy.json
|
|
288
|
+
|
|
289
|
+
# Terminal 2: preserve that account's existing CLAUDE_CONFIG_DIR
|
|
290
|
+
claude-proxy connect --config /path/to/proxy.json -- claude --model 'deepseek-flash[1m]'
|
|
291
|
+
```
|
|
292
|
+
|
|
293
|
+
`connect` supplies `CLAUDE_ROUTER_PROVIDER=model-proxy`, the local URL and the separate local access header only to the child process.
|
|
294
|
+
It does not change saved OAuth, configure provider keys, start the proxy, or install this Mod.
|
|
295
|
+
Without the helper, the proxy guide documents equivalent process-local environment setup.
|
|
296
|
+
Endpoint and credential fields do not belong in this router JSON.
|
|
297
|
+
|
|
298
|
+
Open `/router` and check the selected file, classifier health and routing state before use.
|
|
299
|
+
The catalog must contain the bare native IDs; `[1m]` is client metadata, not a proxy alias.
|
|
300
|
+
Every selected provider receives the unchanged history. Approve each destination; do not mix company context into an unapproved provider.
|
|
301
|
+
Native Anthropic support does not guarantee compatibility with every tool or thinking history. Start with a fresh, non-sensitive conversation.
|
|
302
|
+
|
|
209
303
|
## Add another provider
|
|
210
304
|
|
|
211
305
|
No code change or provider registration is needed.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@alexeiled/claude-router",
|
|
3
|
-
"version": "1.19.
|
|
3
|
+
"version": "1.19.2",
|
|
4
4
|
"description": "Native Claude Code model and effort routing with Anthropic, DeepSeek, z.ai, MiniMax, MiMo and Kimi defaults, custom provider profiles, and classifier advice.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Alexei Ledenev",
|