@euraika-bert/claude-model-router 0.0.0-stage → 0.1.1
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/LICENSE +21 -0
- package/README.md +304 -2
- package/bin/claude-model-router.mjs +31 -0
- package/files/codex.mjs +629 -0
- package/files/com.bert.claude-kimi-router.plist +28 -0
- package/files/configure.mjs +190 -0
- package/files/kimi-oauth.mjs +168 -0
- package/files/kimi-router.mjs +520 -0
- package/files/mistral.mjs +526 -0
- package/files/models-sync.mjs +319 -0
- package/files/secrets.mjs +55 -0
- package/files/update-check.mjs +48 -0
- package/install.ps1 +79 -0
- package/install.sh +149 -0
- package/package.json +41 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Euraika BV
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,305 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Claude Model Router
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Een lokale router voor macOS, Linux en Windows die extra modellen aan Claude Code toevoegt zonder de ingebouwde Claude-modellen te vervangen.
|
|
4
|
+
|
|
5
|
+
Beschikbaar via `/model`, telkens alleen voor de providers waarvoor je een key of login hebt:
|
|
6
|
+
|
|
7
|
+
- **Alle Claude-modellen**, ongewijzigd via Anthropic, inclusief nieuwe modellen zoals **Fable 5.2** zodra Anthropic ze aanbiedt.
|
|
8
|
+
- **Kimi K3.1 Pro** met 1M context, via je bestaande Kimi Code-OAuth-login.
|
|
9
|
+
- **Mistral Large 4** en **GLM 5.3 (Mistral Hosted)** met 1M context, via een Mistral API-key.
|
|
10
|
+
- **Qwen 3.8/3.7 Max**, **DeepSeek V4 Pro**, **DeepSeek V4.1 Flash** en **GLM 5.3** met 1M context, via Alibaba Cloud Bailian (token plan, regio `ap-southeast-1`).
|
|
11
|
+
- **GPT 6 Astra**, **GPT 6.1 Terra**, **GPT 6.1 Sol** en **GPT 5.6 Luna** via je ChatGPT-account (login van de Codex CLI).
|
|
12
|
+
- **MiniMax M3.1 Flash** en **MiniMax M3** met 1M context, via een MiniMax M Plan API-key.
|
|
13
|
+
- **Automatisch toegevoegde modellen** uit de catalogi van Mistral, Kimi en ChatGPT/Codex; zie [Automatische modelsynchronisatie](#automatische-modelsynchronisatie).
|
|
14
|
+
|
|
15
|
+
De repository bevat **geen API-keys, OAuth-tokens of persoonlijke `settings.json`**.
|
|
16
|
+
|
|
17
|
+
## Hoe het werkt
|
|
18
|
+
|
|
19
|
+
Claude Code stuurt API-verzoeken naar `http://127.0.0.1:8765`. De router leest de model-ID en kiest de juiste route:
|
|
20
|
+
|
|
21
|
+
| Model | Route | Authenticatie |
|
|
22
|
+
| --- | --- | --- |
|
|
23
|
+
| `k3.1-pro[1m]` en de andere modellen uit de Kimi-catalogus (bv. `k3`, `k3-256k`, `k3.1-pro-highspeed`) | `api.kimi.com/coding` | Bestaande Kimi Code-OAuth-credentials, automatisch vernieuwd |
|
|
24
|
+
| `mistral-large-4[1m]`, `zai-glm-5-3[1m]` en alle ID’s en aliassen uit de Mistral-catalogus (bv. `mistral-medium-latest`, `codestral-latest`, `glm-5-2`) | `api.mistral.ai/v1/chat/completions` | Mistral API-key uit de macOS Keychain (Windows: DPAPI-bestand) |
|
|
25
|
+
| `qwen*`, `deepseek*`, `glm*` (bv. `qwen3.8-max[1m]`, `deepseek-v4-pro[1m]`, `glm-5.3[1m]`), behalve `zai-glm-*` en ID’s uit de Mistral-catalogus | `token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic` | Bailian token-plan API-key uit de macOS Keychain (Windows: DPAPI-bestand) |
|
|
26
|
+
| `gpt-*` (bv. `gpt-6-astra`, `gpt-6.1-sol`) | `chatgpt.com/backend-api/codex/responses` | ChatGPT-OAuth-login van de Codex CLI (`~/.codex/auth.json`, `codex login`), automatisch vernieuwd |
|
|
27
|
+
| `MiniMax-*` (bv. `MiniMax-M3.1-Flash[1m]`, `MiniMax-M3[1m]`) | `api.minimax.io/anthropic` | MiniMax M Plan API-key uit de macOS Keychain (Windows: DPAPI-bestand) |
|
|
28
|
+
| Alle andere modellen | `api.anthropic.com` | Bestaande Claude Code-login wordt ongewijzigd doorgestuurd |
|
|
29
|
+
|
|
30
|
+
**Claude-modellen.** Claude Code behandelt een `ANTHROPIC_BASE_URL` die niet naar `api.anthropic.com` wijst als externe gateway. Dan toont het een ingebakken, verouderde modellijst, bijvoorbeeld Fable 5.1 in plaats van Fable 5.2. De router stuurt Claude-verzoeken ongewijzigd door; daarom zet de installer `_CLAUDE_CODE_ASSUME_FIRST_PARTY_BASE_URL=1`. Claude Code haalt dan zelf de actuele modellijst bij Anthropic op, en nieuwe Claude-modellen verschijnen vanzelf in `/model`.
|
|
31
|
+
|
|
32
|
+
**Aliyun.** De route gebruikt de Anthropic-compatibele endpoint van Bailian. Verzoeken worden 1-op-1 doorgestuurd met de key als Bearer-token; de `[1m]`-suffix wordt van het model-ID gestript, net als bij Kimi. Host en pad zijn te overschrijven met `ALIYUN_ANTHROPIC_HOST` / `ALIYUN_ANTHROPIC_PATH` (handig voor een andere regio of de `/compatible-mode/v1`-endpoint). Alleen modellen die op het token plan staan werken; `GET /compatible-mode/v1/models` toont wat het plan aanbiedt, maar niet alles daarvan is ook gekocht. Test een model daarom altijd met een echte aanroep voordat je het toevoegt.
|
|
33
|
+
|
|
34
|
+
**MiniMax.** De route gebruikt de Anthropic-compatibele endpoint van MiniMax (M Plan) en werkt net als de Aliyun-route: verzoeken worden 1-op-1 doorgestuurd met de key als Bearer-token en de `[1m]`-suffix wordt gestript (MiniMax weigert die zelf: `unknown model`). De host is te overschrijven met `MINIMAX_ANTHROPIC_HOST` (het pad staat vast op `/anthropic`). De catalogus (`/v1/models`) bevat ook uitgefaseerde M2.x-modellen en geen contextgroottes; MiniMax-modellen worden daarom niet automatisch gesynchroniseerd maar cureer je in `files/configure.mjs`, na een echte test.
|
|
35
|
+
|
|
36
|
+
**Mistral en GLM.** De router vertaalt Anthropic Messages van en naar Mistral’s OpenAI-compatibele formaat, inclusief streaming, afbeeldingen, tool-aanroepen en het effort-niveau. Mistral-modellen accepteren elk een andere set `reasoning_effort`-waarden, of helemaal geen. Bij een weigering leest de router de toegestane waarden uit de foutmelding en probeert hij het verzoek opnieuw met de dichtstbijzijnde waarde. Wat hij zo leert, onthoudt hij tot de router herstart.
|
|
37
|
+
|
|
38
|
+
**ChatGPT/Codex.** De router vertaalt naar de OpenAI Responses API van de Codex-backend. Die ondersteunt alleen streaming; non-streaming verzoeken worden intern gestreamd en als één bericht teruggegeven. De login (`~/.codex/auth.json`) wordt vóór verloop automatisch vernieuwd: refresh 5 minuten voor expiratie, één refresh tegelijk, atomisch weggeschreven. Welke modellen je account aanbiedt, staat in de Codex-catalogus; de router voegt ze automatisch toe. Klasse-indeling: astra = Fable, sol = Opus, terra = Sonnet, luna = Haiku. De Codex-modellen hebben 272k context (de 6.1-modellen 500k), dus niet 1M. Ze staan daarom zonder `[1m]` in `/model`, met `autoCompactWindow` op 95% van de context, zoals de Codex CLI zelf rekent.
|
|
39
|
+
|
|
40
|
+
**Tools.** Dynamische `ToolSearch`-tools gaan naar alle routes. MCP-tools die Claude Code als `tool_addition`-blokken stuurt, zet de router voor Kimi, Aliyun en MiniMax om naar gewone `tools`-entries. Tools zonder `input_schema` (bv. de `advisor`-tool) krijgen een expliciet leeg schema: MiniMax weigert ze anders met `function parameters is empty (2013)`.
|
|
41
|
+
|
|
42
|
+
**Quota-failover.** Bereikt een provider zijn gebruikslimiet (HTTP 429/402, of 403 met een quotamelding zoals `AccessDenied.Unpurchased` of `Throttling`), dan probeert de router het verzoek automatisch op een model van dezelfde klasse bij een andere provider, nooit bij Anthropic:
|
|
43
|
+
|
|
44
|
+
- Kimi → `qwen3.8-max` → `zai-glm-5-3`
|
|
45
|
+
- Aliyun → `zai-glm-5-3` → `k3.1-pro`
|
|
46
|
+
- Mistral → `qwen3.8-max` → `k3.1-pro`
|
|
47
|
+
- ChatGPT → `qwen3.8-max` → `zai-glm-5-3`
|
|
48
|
+
- MiniMax → `qwen3.8-max` → `k3.1-pro`
|
|
49
|
+
|
|
50
|
+
Providers zonder key of login worden in de keten overgeslagen. Een provider die een quotafout gaf, wordt 5 minuten overgeslagen en daarna automatisch opnieuw geprobeerd. Faalt ook het laatste model in de keten, dan krijgt Claude Code die foutmelding. Overschakelingen staan in de log (`Quota limit on ...; switching to ...`): op macOS in `~/.claude/logs/kimi-router.error.log`, op Windows in `%USERPROFILE%\.claude\logs\kimi-router.log`.
|
|
51
|
+
|
|
52
|
+
**Provider zonder login.** Kies je een model van een provider zonder key of login, dan antwoordt de router met HTTP 503 en een melding als `run 'kimi login'`. Hij blijft draaien, dus andere sessies hebben er geen last van.
|
|
53
|
+
|
|
54
|
+
## Automatische modelsynchronisatie
|
|
55
|
+
|
|
56
|
+
Bij het starten van de router en daarna elke 12 uur haalt de router de modelcatalogus op van elke provider waarvoor je een key of login hebt:
|
|
57
|
+
|
|
58
|
+
| Provider | Catalogus | Welke modellen |
|
|
59
|
+
| --- | --- | --- |
|
|
60
|
+
| Mistral | `api.mistral.ai/v1/models` | Chatmodellen met tool-support die niet zijn uitgefaseerd |
|
|
61
|
+
| Kimi | `api.kimi.com/coding/v1/models` | Alle modellen |
|
|
62
|
+
| ChatGPT/Codex | `chatgpt.com/backend-api/codex/models` | Modellen die de Codex CLI toont, voor jouw versie van de Codex CLI |
|
|
63
|
+
|
|
64
|
+
Aliyun doet niet mee: die catalogus bevat ook modellen die je plan weigert. Aliyun-modellen voeg je zelf toe in `files/configure.mjs`, na een echte test.
|
|
65
|
+
|
|
66
|
+
Wat de sync doet:
|
|
67
|
+
|
|
68
|
+
1. **Routeren.** Elk ID en elke alias uit de catalogus gaat naar die provider. Die routering gaat vóór de Aliyun-regel, dus Mistral-modellen als `glm-5-2` gaan naar Mistral.
|
|
69
|
+
2. **Kiezen.** Modellen met minstens 100k context die nog niet in `/model` staan, worden kandidaat. Per groep aliassen kiest de router één ID: bij voorkeur een `-latest`-alias, anders het kortste ID. Modellen met 1M context krijgen `[1m]`.
|
|
70
|
+
3. **Testen.** Elke nieuwe kandidaat krijgt eerst een echte test via de router: een tool-aanroep zonder streaming en daarna een gestreamd antwoord op het toolresultaat, zonder failover. Pas als die slaagt, komt het model in `modelPicker.options`, met de beschrijving *Automatisch toegevoegd uit de …-catalogus* en `autoCompactWindow` gelijk aan de context (maximaal 1M). Een mislukte test (bv. door een opgebruikt quotum) wordt bij de volgende sync herhaald; de reden staat in `/__health` onder `modelSync.probeFailures`.
|
|
71
|
+
4. **Klasse.** `behavesAs` volgt uit de naam:
|
|
72
|
+
- `astra` → Fable
|
|
73
|
+
- `luna`, `small`, `ministral` → Haiku
|
|
74
|
+
- `sol`, `large`, `pro`, `max` → Opus
|
|
75
|
+
- `terra`, `medium`, `flash`, `highspeed`, `codestral`, `leanstral` → Sonnet
|
|
76
|
+
- overige GLM- en Kimi-modellen → Opus
|
|
77
|
+
- de rest → Sonnet
|
|
78
|
+
5. **Beheren.** De router past alleen items aan die hij zelf heeft toegevoegd; de lijst staat in `~/.claude/router-models.json`. Verdwijnt een model uit de catalogus, of verdwijnt de login, dan haalt hij het item weg. Vóór elke wijziging maakt hij een back-up naar `~/.claude/backups/settings.json.router-sync-*`. Als er niets verandert, schrijft hij niets.
|
|
79
|
+
|
|
80
|
+
## Vereisten
|
|
81
|
+
|
|
82
|
+
- macOS (`launchd` en Keychain), Linux met systemd (user service) of Windows 10/11 (Taakplanner en Windows PowerShell 5.1, standaard aanwezig).
|
|
83
|
+
- Claude Code 2.1.242 of later. Dat nieuwe Claude-modellen vanzelf verschijnen, is geverifieerd met Claude Code 2.1.322.
|
|
84
|
+
- Node.js 22 of later.
|
|
85
|
+
- Alle providers hieronder zijn **optioneel**. De installer zet alleen de providers aan waarvoor een key of login aanwezig is; de rest komt niet in `/model` en doet niet mee aan failover of synchronisatie.
|
|
86
|
+
- **Kimi:** Kimi Code CLI en een actieve login via `kimi login`.
|
|
87
|
+
- **Mistral en GLM:** een geldige Mistral API-key met toegang tot deze modellen.
|
|
88
|
+
- **Qwen, DeepSeek en GLM via Aliyun:** een Bailian token-plan API-key voor regio `ap-southeast-1`.
|
|
89
|
+
- **ChatGPT (GPT-modellen):** de Codex CLI met een actieve login via `codex login` (ChatGPT-account).
|
|
90
|
+
- **MiniMax (M Plan):** een MiniMax M Plan API-key van [platform.minimax.io](https://platform.minimax.io/console/plan).
|
|
91
|
+
|
|
92
|
+
## Installeren en updaten via npm (macOS, Linux, Windows)
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
npx @euraika-bert/claude-model-router@latest install
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
Dit start de installer van je platform (`install.sh` op macOS en Linux, `install.ps1` op Windows) uit het npm-pakket. Hetzelfde commando werkt ook om te **updaten**. Je instellingen, keys en logins blijven behouden.
|
|
99
|
+
|
|
100
|
+
**Updatemelding:** de router vraagt één keer per dag de laatste versie op bij `registry.npmjs.org` en stuurt daarbij niets over jou of je setup mee. Is er een nieuwere versie, dan toont Claude Code bij het starten van een sessie een melding met het updatecommando; dat komt van een SessionStart-hook die de installer in `settings.json` zet. Er wordt nooit automatisch geüpdatet. Uitzetten: zet `CLAUDE_MODEL_ROUTER_NO_UPDATE_CHECK=1` in de omgeving van de router. De versie zie je in `/__health` (`version`, `latestVersion`, `updateAvailable`) of met `npx @euraika-bert/claude-model-router version`.
|
|
101
|
+
|
|
102
|
+
## Installeren op macOS
|
|
103
|
+
|
|
104
|
+
Via npm (zie hierboven), of vanuit een kopie van deze repository:
|
|
105
|
+
|
|
106
|
+
```bash
|
|
107
|
+
./install.sh
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
De installatie:
|
|
111
|
+
|
|
112
|
+
1. kopieert de routerbestanden naar `~/.claude/` en een reservekopie naar `~/.local/share/claude-model-router/`;
|
|
113
|
+
2. installeert het herstelcommando als `~/.local/bin/claude-model-router-setup`;
|
|
114
|
+
3. vraagt je Mistral API-key, Aliyun token-plan key en MiniMax M Plan key via een verborgen prompt als die nog niet in de Keychain staan (Enter = overslaan);
|
|
115
|
+
4. detecteert welke providers bruikbaar zijn: de Keychain-items `claude-code-mistral`/`claude-code-aliyun`/`claude-code-minimax`, `kimi login` en `codex login`;
|
|
116
|
+
5. maakt een back-up van `~/.claude/settings.json` in `~/.claude/backups/` en zet alleen de instellingen van die providers erin; items van providers zonder login worden weggehaald;
|
|
117
|
+
6. installeert en start `com.bert.claude-kimi-router` als LaunchAgent, en toont welke providers zijn overgeslagen en hoe je ze aanzet.
|
|
118
|
+
|
|
119
|
+
Herstart daarna Claude Code en open `/model`. Een provider later toevoegen: regel de key of login en voer daarna `claude-model-router-setup` opnieuw uit.
|
|
120
|
+
|
|
121
|
+
Niet-interactief installeren kan met:
|
|
122
|
+
|
|
123
|
+
```bash
|
|
124
|
+
MISTRAL_API_KEY='...' ALIYUN_API_KEY='...' MINIMAX_API_KEY='...' ./install.sh
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
Deze variabelen kunnen in je shellgeschiedenis terechtkomen; de verborgen interactieve prompt heeft daarom de voorkeur.
|
|
128
|
+
|
|
129
|
+
## Installeren op Windows
|
|
130
|
+
|
|
131
|
+
> **Status:** de Windows-installatie is nog niet op een echte Windows-machine getest. Ze is wel van begin tot eind gedraaid in een Linux-container met PowerShell 7.7, waarbij Taakplanner en de poortcheck zijn nagebootst; zie [Bekende beperkingen](#bekende-beperkingen).
|
|
132
|
+
|
|
133
|
+
Open PowerShell in de clone; beheerdersrechten zijn niet nodig. Voer uit:
|
|
134
|
+
|
|
135
|
+
```powershell
|
|
136
|
+
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
De Windows-installatie doet hetzelfde als `install.sh`, met deze verschillen:
|
|
140
|
+
|
|
141
|
+
- **Keys:** de Mistral-, Aliyun- en MiniMax-key worden met DPAPI versleuteld bewaard in `%LOCALAPPDATA%\claude-model-router\` (`claude-code-mistral.dpapi`, `claude-code-aliyun.dpapi`, `claude-code-minimax.dpapi`). Alleen jouw Windows-account kan ze ontsleutelen.
|
|
142
|
+
- **Router:** draait als geplande taak `claude-model-router` die start bij het aanmelden. Een verborgen PowerShell-lus (`%USERPROFILE%\.claude\kimi-router-run.ps1`) herstart de router binnen 2 seconden na een crash. Bij het aanmelden kan heel kort een venster verschijnen.
|
|
143
|
+
- **Log:** stdout en stderr komen in één bestand: `%USERPROFILE%\.claude\logs\kimi-router.log`.
|
|
144
|
+
- **Herinstallatie:** een nieuwe installatie stopt de draaiende router; de lus start hem meteen opnieuw met de nieuwe bestanden.
|
|
145
|
+
- **Herstellen:** er is geen herstelcommando zoals `claude-model-router-setup`; voer `install.ps1` opnieuw uit vanuit de clone.
|
|
146
|
+
|
|
147
|
+
Kimi en ChatGPT/Codex werken zodra `kimi login` en `codex login` hun login in `%USERPROFILE%\.kimi-code` en `%USERPROFILE%\.codex` zetten. Dat zijn de standaardlocaties; `KIMI_CODE_HOME` en `CODEX_HOME` worden gerespecteerd.
|
|
148
|
+
|
|
149
|
+
Niet-interactief installeren:
|
|
150
|
+
|
|
151
|
+
```powershell
|
|
152
|
+
$env:MISTRAL_API_KEY = '...'; $env:ALIYUN_API_KEY = '...'; $env:MINIMAX_API_KEY = '...'
|
|
153
|
+
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
## Installeren op Linux
|
|
157
|
+
|
|
158
|
+
> **Status:** getest op Ubuntu 22.04 met echte systemd (Node 24): installatie, de service (`active`/`enabled`), key-bestanden met rechten `600`, `/__health`, automatische herstart na een crash (~11 s), `systemctl --user restart` en de verwijderstappen hieronder. Daarnaast echte verzoeken via de router voor Mistral (7 modellen), ChatGPT/Codex (6) en MiniMax (2): non-streaming, streaming en een tool-roundtrip, plus echte Claude Code-sessies (2.1.303) met Read- en Bash-tool. Kimi en Aliyun zijn niet getest (quota op). Ook getest in een Debian-container met Node 22.
|
|
159
|
+
|
|
160
|
+
Gebruik dezelfde `./install.sh` als op macOS. Op Linux zijn er deze verschillen:
|
|
161
|
+
|
|
162
|
+
- **Keys:** elke key staat als apart bestand met rechten `600` in `~/.config/claude-model-router/` (`claude-code-mistral`, `claude-code-aliyun`, `claude-code-minimax`; respecteert `XDG_CONFIG_HOME`). Linux heeft geen keychain waar een achtergrondservice altijd bij kan; de Codex- en Kimi-logins bewaren hun tokens op dezelfde manier.
|
|
163
|
+
- **Service:** een systemd user service `claude-model-router.service` in `~/.config/systemd/user/`. Die start bij je login. Wil je de router ook zonder login (bv. via SSH): `loginctl enable-linger $USER`.
|
|
164
|
+
- **Logs:** dezelfde bestanden als op macOS, in `~/.claude/logs/`.
|
|
165
|
+
- **Herstarten:** `systemctl --user restart claude-model-router`.
|
|
166
|
+
|
|
167
|
+
## Opnieuw installeren of herstellen
|
|
168
|
+
|
|
169
|
+
Op elk platform werkt `npx @euraika-bert/claude-model-router@latest install`. Op macOS en Linux kan het ook offline met de reservekopie, na een verwijderde of beschadigde configuratie:
|
|
170
|
+
|
|
171
|
+
```bash
|
|
172
|
+
claude-model-router-setup
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
Op Windows: voer `install.ps1` opnieuw uit. Alle installers zijn idempotent: je kunt ze meerdere keren uitvoeren. Overige instellingen blijven behouden en dubbele modelkeuzes worden vermeden.
|
|
176
|
+
|
|
177
|
+
Als de Kimi-credentials ontbreken, voer dan `kimi login` uit en daarna opnieuw de installer. Als op macOS of Linux ook de reservekopie ontbreekt, installeer dan opnieuw via `npx`.
|
|
178
|
+
|
|
179
|
+
## Controleren
|
|
180
|
+
|
|
181
|
+
Controleer de router, de logins en de modelsynchronisatie:
|
|
182
|
+
|
|
183
|
+
```bash
|
|
184
|
+
curl --fail --silent http://127.0.0.1:8765/__health
|
|
185
|
+
```
|
|
186
|
+
|
|
187
|
+
Op Windows: `Invoke-RestMethod http://127.0.0.1:8765/__health`.
|
|
188
|
+
|
|
189
|
+
De geïnstalleerde versie zie je ook met `npx @euraika-bert/claude-model-router version`.
|
|
190
|
+
|
|
191
|
+
Het antwoord bevat onder meer:
|
|
192
|
+
|
|
193
|
+
- `version`, `latestVersion` en `updateAvailable` (de geïnstalleerde en de laatste versie op npm);
|
|
194
|
+
- `kimiLoginAvailable`, `mistralLoginAvailable`, `aliyunLoginAvailable`, `codexLoginAvailable` en `minimaxLoginAvailable`;
|
|
195
|
+
- `modelSync`, met daarin `syncedAt`, per provider het aantal modellen en eventuele fouten, `pickerManaged` (de automatisch toegevoegde items) en `probeFailures`.
|
|
196
|
+
|
|
197
|
+
Controleer daarna in Claude Code:
|
|
198
|
+
|
|
199
|
+
1. `/model` toont de nieuwste Claude-modellen (bv. Fable 5.2), de modellen van je providers en de automatisch toegevoegde modellen.
|
|
200
|
+
2. Een korte prompt werkt met elk gewenst model.
|
|
201
|
+
3. Een eenvoudige Bash-opdracht werkt ook met een gekozen model.
|
|
202
|
+
|
|
203
|
+
De parser voor de Mistral-effortwaarden heeft een eigen controle: `node test/mistral-effort.test.mjs`. Het tokengebruik (cached tokens), de Codex-requestvorm en de versiecontrole controleer je met `node test/usage.test.mjs`.
|
|
204
|
+
|
|
205
|
+
## Authenticatie en geheimen
|
|
206
|
+
|
|
207
|
+
- **Kimi:** gedeelde credentials uit `~/.kimi-code/credentials/kimi-code.json` of, bij nieuwere versies van `kimi login`, het nieuwste `kimi-code-env-<hash>.json`. De router vernieuwt tokens via Kimi’s OAuth-flow en schrijft ze atomisch terug.
|
|
208
|
+
- **Mistral en GLM:**
|
|
209
|
+
- macOS: Keychain-item `claude-code-mistral`;
|
|
210
|
+
- Linux: `~/.config/claude-model-router/claude-code-mistral` (rechten `600`);
|
|
211
|
+
- Windows: `%LOCALAPPDATA%\claude-model-router\claude-code-mistral.dpapi`;
|
|
212
|
+
- of de `MISTRAL_API_KEY`-omgevingsvariabele in het router-proces.
|
|
213
|
+
- **Qwen (Aliyun):**
|
|
214
|
+
- macOS: Keychain-item `claude-code-aliyun`;
|
|
215
|
+
- Linux: `~/.config/claude-model-router/claude-code-aliyun` (rechten `600`);
|
|
216
|
+
- Windows: `claude-code-aliyun.dpapi`;
|
|
217
|
+
- of de `ALIYUN_API_KEY`-omgevingsvariabele in het router-proces.
|
|
218
|
+
- **MiniMax (M Plan):**
|
|
219
|
+
- macOS: Keychain-item `claude-code-minimax`;
|
|
220
|
+
- Linux: `~/.config/claude-model-router/claude-code-minimax` (rechten `600`);
|
|
221
|
+
- Windows: `claude-code-minimax.dpapi`;
|
|
222
|
+
- of de `MINIMAX_API_KEY`-omgevingsvariabele in het router-proces.
|
|
223
|
+
- **ChatGPT/Codex:** de OAuth-login van de Codex CLI in `~/.codex/auth.json`. De router vernieuwt het token via `auth.openai.com` en schrijft het atomisch terug.
|
|
224
|
+
- **Claude:** de router bewaart geen Anthropic-token; inkomende authenticatie wordt alleen doorgestuurd naar `api.anthropic.com`.
|
|
225
|
+
- De router houdt keys 5 minuten in het geheugen. Op Windows ontsleutelt hij ze via Windows PowerShell, wat het eerste verzoek na die 5 minuten iets vertraagt (niet gemeten).
|
|
226
|
+
- Logs bevatten geen API-keys of requestberichten.
|
|
227
|
+
|
|
228
|
+
## Bekende beperkingen
|
|
229
|
+
|
|
230
|
+
- De router draait lokaal; Claude Code-cloudsessies gebruiken deze configuratie niet.
|
|
231
|
+
- Claude Code Remote Control vereist een directe verbinding met `api.anthropic.com` en is niet beschikbaar via deze lokale route.
|
|
232
|
+
- `_CLAUDE_CODE_ASSUME_FIRST_PARTY_BASE_URL` is een niet-gedocumenteerde interne instelling van Claude Code. Negeert een update die, dan toont `/model` weer verouderde Claude-modellen. Kies het model dan via zijn ID, bv. `/model claude-fable-5-2`. `ANTHROPIC_DEFAULT_FABLE_MODEL` helpt niet: daarmee bleef de picker Fable 5.1 tonen.
|
|
233
|
+
- Verwijder je een automatisch toegevoegd model met de hand uit `/model`, dan zet de volgende sync het terug. Er is (nog) geen uitsluitlijst.
|
|
234
|
+
- De sync en Claude Code schrijven allebei naar `settings.json`. Schrijven ze precies tegelijk, dan kan één van de twee wijzigingen verloren gaan. Het venster is klein en de sync maakt altijd eerst een back-up.
|
|
235
|
+
- Ministral 3B/8B/14B werken via de router, maar zijn zwak als agent: na een foutmelding van een tool geven ze vaak op.
|
|
236
|
+
- Codex-modellen boven 272k context (de catalogus noemt maximaal 872k) zijn niet getest.
|
|
237
|
+
- De weergegeven kosten in Claude Code kunnen bij aangepaste modellen afwijken van de werkelijke providerfacturatie.
|
|
238
|
+
- **Verificatiestatus (13 november 2026):**
|
|
239
|
+
- De MiniMax-route is op 13 november 2026 volledig getest: non-streaming, streaming (eindigt op `message_stop`) en een tool-use-round trip voor zowel `MiniMax-M3.1-Flash[1m]` als `MiniMax-M3[1m]` via de router (met `x-router-probe: 1`), én daarna met echte Claude Code-sessies op beide modellen, inclusief een Bash-toolronde. Eerste poging faalde in echte sessies met `function parameters is empty (2013)`: Claude Code stuurt tools zonder `input_schema` (bv. `advisor`) en MiniMax weigert die na conversie; de router geeft zulke tools nu een expliciet leeg schema.
|
|
240
|
+
- De Kimi- en Aliyun-routes zijn na de eerdere wijzigingen niet opnieuw met echte verzoeken getest, omdat beide quota op waren; de Aliyun-quota resetten op 5 december 2026, 16:00 UTC.
|
|
241
|
+
- De nieuwe Kimi-catalogusmodellen worden automatisch toegevoegd zodra hun test slaagt.
|
|
242
|
+
- Linux is getest op Ubuntu 22.04 met echte systemd (17 november 2026, in een geïsoleerde `HOME`): installatie en service, plus echte verzoeken en Claude Code-sessies voor Mistral, ChatGPT/Codex en MiniMax. Niet getest: Kimi en Aliyun (quota op) en een machine zonder `enable-linger`.
|
|
243
|
+
- **End-to-end op macOS (17 november 2026):** alle 23 modellen met beschikbaar quotum uit `/model` (Codex 9, Mistral 12, MiniMax 2) slagen voor non-streaming, streaming en een tool-roundtrip via de router (`x-router-probe: 1`), plus echte Claude Code-sessies op Claude Haiku, Mistral Medium, GLM 5.3, DeepSeek, MiniMax M3.1-Flash en GPT 6.1 Terra/Sol.
|
|
244
|
+
- Windows is alleen in een container getest. Nog onbewezen op echte Windows: de DPAPI-versleuteling, Windows PowerShell 5.1, het registreren van de geplande taak, het verborgen venster, Claude Code op Windows, en de loginlocaties van `kimi login` en `codex login`.
|
|
245
|
+
|
|
246
|
+
## Verwijderen
|
|
247
|
+
|
|
248
|
+
Op macOS: stop de service en verwijder de routerbestanden:
|
|
249
|
+
|
|
250
|
+
```bash
|
|
251
|
+
launchctl bootout "gui/$(id -u)/com.bert.claude-kimi-router"
|
|
252
|
+
rm ~/Library/LaunchAgents/com.bert.claude-kimi-router.plist
|
|
253
|
+
rm ~/.claude/kimi-router.mjs ~/.claude/kimi-oauth.mjs ~/.claude/mistral.mjs ~/.claude/secrets.mjs ~/.claude/codex.mjs ~/.claude/models-sync.mjs ~/.claude/update-check.mjs ~/.claude/router-models.json
|
|
254
|
+
rm -r ~/.local/share/claude-model-router ~/.local/bin/claude-model-router-setup
|
|
255
|
+
```
|
|
256
|
+
|
|
257
|
+
Op Linux:
|
|
258
|
+
|
|
259
|
+
```bash
|
|
260
|
+
systemctl --user disable --now claude-model-router
|
|
261
|
+
rm ~/.config/systemd/user/claude-model-router.service
|
|
262
|
+
rm ~/.claude/kimi-router.mjs ~/.claude/kimi-oauth.mjs ~/.claude/mistral.mjs ~/.claude/secrets.mjs ~/.claude/codex.mjs ~/.claude/models-sync.mjs ~/.claude/update-check.mjs ~/.claude/router-models.json
|
|
263
|
+
rm -r ~/.config/claude-model-router # de keys
|
|
264
|
+
rm -r ~/.local/share/claude-model-router ~/.local/bin/claude-model-router-setup
|
|
265
|
+
```
|
|
266
|
+
|
|
267
|
+
Op Windows (PowerShell):
|
|
268
|
+
|
|
269
|
+
```powershell
|
|
270
|
+
Unregister-ScheduledTask -TaskName claude-model-router -Confirm:$false
|
|
271
|
+
Get-NetTCPConnection -LocalAddress 127.0.0.1 -LocalPort 8765 -State Listen -ErrorAction SilentlyContinue | ForEach-Object { Stop-Process -Id $_.OwningProcess -Force }
|
|
272
|
+
Remove-Item "$env:USERPROFILE\.claude\kimi-router.mjs", "$env:USERPROFILE\.claude\kimi-oauth.mjs", "$env:USERPROFILE\.claude\mistral.mjs", "$env:USERPROFILE\.claude\secrets.mjs", "$env:USERPROFILE\.claude\codex.mjs", "$env:USERPROFILE\.claude\models-sync.mjs", "$env:USERPROFILE\.claude\update-check.mjs", "$env:USERPROFILE\.claude\kimi-router-run.ps1", "$env:USERPROFILE\.claude\router-models.json"
|
|
273
|
+
Remove-Item -Recurse "$env:LOCALAPPDATA\claude-model-router" # de versleutelde keys
|
|
274
|
+
```
|
|
275
|
+
|
|
276
|
+
Pas daarna op elk systeem `~/.claude/settings.json` aan; maak vooraf een back-up. Verwijder:
|
|
277
|
+
|
|
278
|
+
- `ANTHROPIC_BASE_URL` en `_CLAUDE_CODE_ASSUME_FIRST_PARTY_BASE_URL`;
|
|
279
|
+
- de Kimi-waarden `ANTHROPIC_CUSTOM_MODEL_OPTION_*`;
|
|
280
|
+
- de SessionStart-hook met `update-check.mjs` onder `hooks`;
|
|
281
|
+
- de aangepaste `modelPicker`- en `modelSettings`-items, inclusief de items met de beschrijving *Automatisch toegevoegd uit de …-catalogus*.
|
|
282
|
+
|
|
283
|
+
De macOS-Keychain-items en de Kimi- en Codex-logins blijven bestaan, tenzij je ze apart verwijdert.
|
|
284
|
+
|
|
285
|
+
## Repository-indeling
|
|
286
|
+
|
|
287
|
+
- `package.json` en `bin/claude-model-router.mjs` — het npm-pakket en het `npx`-commando, dat de installer van je platform start.
|
|
288
|
+
- `.gitlab-ci.yml` en `scripts/` — CI: tests en een scan op geheimen bij elke push; bij een versietag (`npm version patch`, daarna `git push --follow-tags`) publiceert de CI automatisch naar npm.
|
|
289
|
+
- `install.sh` — installatie en herstel op macOS en Linux.
|
|
290
|
+
- `install.ps1` — installatie op Windows.
|
|
291
|
+
- `files/configure.mjs` — schrijft de routerinstellingen in `settings.json` voor de providers met een key of login; beide installers gebruiken dit script.
|
|
292
|
+
- `files/kimi-router.mjs` — de localhost-router: modelselectie, Kimi-, Aliyun- en MiniMax-doorsturing, quota-failover en `/__health`.
|
|
293
|
+
- `files/kimi-oauth.mjs` — Kimi OAuth-tokenrefresh met gedeelde credentials.
|
|
294
|
+
- `files/mistral.mjs` — vertaling tussen Anthropic en Mistral, inclusief de terugval voor `reasoning_effort`.
|
|
295
|
+
- `files/codex.mjs` — ChatGPT/Codex-route: OAuth-refresh uit `~/.codex/auth.json` en vertaling tussen Anthropic Messages en de OpenAI Responses API.
|
|
296
|
+
- `files/secrets.mjs` — leest de Mistral-, Aliyun- en MiniMax-key uit de macOS Keychain, een DPAPI-bestand (Windows) of een bestand met rechten `600` (Linux).
|
|
297
|
+
- `files/models-sync.mjs` — automatische synchronisatie van de Mistral-, Kimi- en Codex-catalogi, plus de logincontrole per provider.
|
|
298
|
+
- `files/update-check.mjs` — versienummer en dagelijkse updatecheck (via `/__health`); met `--session-notice` de melding voor de SessionStart-hook.
|
|
299
|
+
- `files/com.bert.claude-kimi-router.plist` — LaunchAgent-configuratie (macOS).
|
|
300
|
+
- `test/mistral-effort.test.mjs` — controle voor de parser van Mistral-effortwaarden.
|
|
301
|
+
- `test/usage.test.mjs` — controle dat cached tokens uit `input_tokens` gehaald worden (Mistral/Codex), plus de Codex-effortmapping en `environmentContext`.
|
|
302
|
+
|
|
303
|
+
## Licentie
|
|
304
|
+
|
|
305
|
+
MIT, © 2026 Euraika BV. Zie [LICENSE](LICENSE).
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// npx entry point: runs the platform installer shipped in this package (install.sh on macOS/Linux,
|
|
3
|
+
// install.ps1 on Windows). The installers stay the single implementation.
|
|
4
|
+
import { spawnSync } from 'node:child_process';
|
|
5
|
+
import path from 'node:path';
|
|
6
|
+
import { fileURLToPath } from 'node:url';
|
|
7
|
+
import { VERSION } from '../files/update-check.mjs';
|
|
8
|
+
|
|
9
|
+
const root = path.join(path.dirname(fileURLToPath(import.meta.url)), '..');
|
|
10
|
+
const command = process.argv[2] ?? 'install';
|
|
11
|
+
|
|
12
|
+
if (command === 'version' || command === '--version' || command === '-v') {
|
|
13
|
+
console.log(VERSION);
|
|
14
|
+
} else if (command === 'install' || command === 'update') {
|
|
15
|
+
const result = process.platform === 'win32'
|
|
16
|
+
? spawnSync(
|
|
17
|
+
path.join(process.env.SystemRoot || 'C:\\Windows', 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe'),
|
|
18
|
+
['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', path.join(root, 'install.ps1')],
|
|
19
|
+
{ stdio: 'inherit' },
|
|
20
|
+
)
|
|
21
|
+
: spawnSync('bash', [path.join(root, 'install.sh')], { stdio: 'inherit' });
|
|
22
|
+
if (result.error) console.error(result.error.message);
|
|
23
|
+
process.exit(result.status ?? 1);
|
|
24
|
+
} else {
|
|
25
|
+
console.log(`claude-model-router ${VERSION}
|
|
26
|
+
|
|
27
|
+
Gebruik:
|
|
28
|
+
npx @euraika-bert/claude-model-router@latest install installeren of updaten (macOS, Linux, Windows)
|
|
29
|
+
npx @euraika-bert/claude-model-router version geïnstalleerde pakketversie tonen`);
|
|
30
|
+
process.exit(command === 'help' || command === '--help' || command === '-h' ? 0 : 1);
|
|
31
|
+
}
|