Configuration de Switch

Ouvrir l’interface de configuration

Icône de la barre de menus

macOS / Linux : cliquez sur l’icône de la barre de menus → « Configuration ».

Zone de notification système

Windows : clic droit sur l’icône de la zone de notification → « Ouvrir la configuration ».

Raccourci clavier

Ctrl+Shift+S (Win/Linux) / Cmd+Shift+S (macOS).

---

Ajouter un fournisseur de modèles

Onglet « FournisseurProviderFournisseur de modèles, c'est-à-dire un service de modèles en amont (API cloud ou service d'inférence local). Switch permet de configurer plusieurs Provider et de router selon des règles. » → « Ajouter un fournisseur », renseignez le nom du fournisseur + l’API Base URL + l’API Key :

Fournisseur	API Base URL	API Key
Lurus API recommandé	https://hub.lurus.cn/v1	Lurus Key (commençant par sk-) ; pour les modèles, cliquez sur « Détection automatique »
OpenAI	https://api.openai.com/v1	sk-... (officiel)
Anthropic	https://api.anthropic.com/v1	sk-ant-...
Ollama (local)	http://localhost:11434/v1	(laisser vide)

---

Routage

Configurer les règles de routage

Définissez quelle requête est dirigée vers quel fournisseur ; les requêtes non correspondantes sont dirigées vers le fournisseur par défaut (par défaut → Lurus API).

Routage par nom de modèle : gpt-* → OpenAI ; claude-* → Anthropic ; deepseek-* / * (autres) → Lurus API ; llama* → Ollama. JSON :

{ "rules": [
    { "pattern": "gpt-*", "provider": "OpenAI" },
    { "pattern": "claude-*", "provider": "Anthropic" },
    { "pattern": "llama*", "provider": "Ollama" },
    { "pattern": "*", "provider": "Lurus API" }
  ] }

Routage par application (avancé) : définissez des routages différents pour différentes applications locales :

{
  "app_rules": [
    {
      "app": "cursor",
      "default_provider": "Lurus API",
      "model_override": "deepseek-reasoner"
    },
    {
      "app": "continue",
      "default_provider": "Ollama"
    }
  ]
}

---

Configuration du port du proxy

« Général » → « Port d’écoute », par défaut 11434. En cas de conflit de port (par exemple avec Ollama), changez-le pour un autre port (par exemple 11435), et modifiez en conséquence côté application base_url=http://localhost:11435/v1 (api_key peut être renseigné librement, Switch utilise la provider key configurée).

Conflit de port

Le port par défaut 11434 est identique au port par défaut d’Ollama. Lorsque les deux s’exécutent sur la même machine, changez Switch pour un autre port (par exemple 11435) et mettez à jour en conséquence le base_url côté application.

---

Fichier de configuration complet

La configuration de Switch est enregistrée dans :

Plateforme	Chemin
Windows	%APPDATA%\LurusSwitch\config.json
macOS	~/Library/Application Support/LurusSwitch/config.json
Linux	~/.config/LurusSwitch/config.json

Exemple complet de config.json :

{
  "listen_port": 11434,
  "log_requests": true,
  "start_on_login": true,
  "providers": [
    {
      "name": "Lurus API",
      "base_url": "https://hub.lurus.cn/v1",
      "api_key": "sk-your-lurus-key",
      "enabled": true
    },
    {
      "name": "Ollama",
      "base_url": "http://localhost:11434/v1",
      "api_key": "",
      "enabled": true
    }
  ],
  "routing": {
    "default_provider": "Lurus API",
    "rules": [
      { "pattern": "llama*",  "provider": "Ollama" },
      { "pattern": "qwen*",   "provider": "Ollama" },
      { "pattern": "*",       "provider": "Lurus API" }
    ]
  }
}

---

Vérifier la configuration

L’onglet « État » affiche : l’état de connexion de chaque fournisseur (vert = normal, rouge = échec), les règles de routage actuellement actives, les journaux des requêtes récentes. Vérification en ligne de commande (un JSON normal renvoyé indique un succès) :

curl http://localhost:11434/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-chat","messages":[{"role":"user","content":"ping"}]}'

---

Étapes suivantes

Étapes suivantes

Surveillance des coûtsServeurs MCPConfiguration d'équipe