Passer au contenu principal
15 Les agents de codage se connectent aux modèles locaux via Tokios. Tous utilisent le format standard de l’API OpenAI ou Anthropic — vous modifiez 2 éléments : l’URL de base et votre clé API. Une fois votre modèle enregistré en tant que déploiement Tokios, chaque agent ci-dessous y accède via le même point de terminaison.
Prérequis : Avant de configurer l’un des agents ci-dessous, vous avez besoin d’un modèle local en cours d’exécution, d’un connecteur Tokios appairé, d’un déploiement enregistré et d’une clé API sk-tok-…. Consultez le Guide de démarrage rapide si vous ne les avez pas encore configurés.

Matrice de compatibilité des agents

L’appel d’outils signifie que l’agent peut envoyer tools dans la requête et analyser tool_calls depuis la réponse. Que cela fonctionne de bout en bout dépend à la fois de l’agent et du modèle local — Qwen3-Coder-30B, Llama-3-70B et Mistral gèrent tous bien les appels d’outils sur vLLM.

Agents basés sur un IDE

Ces agents résident dans votre éditeur et envoient des requêtes de complétion au fur et à mesure que vous codez. Tous utilisent le format de l’API OpenAI Chat Completions, sauf indication contraire.

Cline et Roo Code

Cline et sa fourche Roo Code utilisent tous deux un fournisseur « Compatible OpenAI ». Définissez les champs 3 dans les paramètres de l’extension :
  1. Fournisseur API : OpenAI Compatible
  2. URL de base : https://api.tokios.com/v1
  3. API Key: your sk-tok-… key
  4. ID du modèle : le nom de votre déploiement (par exemple, qwen3-coder-tunnel)
Les deux sont entièrement configurés via le panneau des paramètres — aucun fichier de configuration n’est à modifier. Consultez les guides Cline et Roo Code pour la configuration complète.

Continuer

Continue lit ~/.continue/config.yaml. Ajouter une entrée de modèle :
Consultez le guide Continue. Notez que Continue prend en charge à la fois Chat Completions et Responses — utilisez Chat Completions pour les modèles locaux.

Cursor

La substitution de modèle personnalisée de Cursor accepte une URL de base et une clé API. La prise en charge varie selon la version de Cursor — vérifiez que le routage par URL de base personnalisée fonctionne dans votre build avant de vous y fier :
  1. Ouvrez Cursor Settings → Models.
  2. Ajoutez un modèle personnalisé avec l’URL de base https://api.tokios.com/v1 et votre clé sk-tok-….
Consultez le guide Cursor pour les notes spécifiques à la version.

Zed

Zed prend en charge des fournisseurs compatibles OpenAI personnalisés dans son settings.json :
La clé API ne va pas dans settings.json — saisissez-la dans l’interface utilisateur du fournisseur LLM de Zed, ou exportez TOKIOS_API_KEY (Zed dérive le nom de la variable à partir de l’ID du fournisseur). Consultez le guide Zed.

JetBrains AI Assistant

L’assistant JetBrains AI prend en charge le BYOK (Bring Your Own Key) via les paramètres de son plugin. Saisissez l’URL de base et la clé API dans les champs du fournisseur personnalisé :
  • URL de base : https://api.tokios.com/v1
  • API Key: your sk-tok-… key
Consultez le guide JetBrains AI Assistant.

VS Code Copilot

Le support BYOK de GitHub Copilot est en cours de développement. Lorsque votre version de VS Code prend en charge les fournisseurs personnalisés, pointez-la vers :
  • URL de base : https://api.tokios.com/v1
  • API Key: your sk-tok-… key
Consultez le guide VS Code Copilot pour la dernière compatibilité.

Agents de terminal

Ceux-ci s’exécutent dans votre shell et utilisent des variables d’environnement ou des fichiers de configuration pour se connecter.

Claude Code

Claude Code utilise le format d’API d’Anthropic — et non celui d’OpenAI. Définissez les variables d’environnement 2 :
Remarque : l’URL de base ne comporte pas de suffixe /v1 pour le format Anthropic. Consultez le guide Claude Code pour conserver ces paramètres entre les sessions.

OpenAI Codex

OpenAI Codex utilise l’API Responses (wire_api=responses). Définissez l’URL de base dans ~/.codex/config.toml :
env_key désigne le nom de la variable contenant votre clé plutôt que la clé elle-même, et disable_response_storage est requis car Tokios fournit la surface Responses de manière stateless. Ensuite, exécutez :
Consultez le guide OpenAI Codex.

Aider

Aider lit l’URL de base et la clé depuis l’environnement, et nécessite le préfixe de modèle openai/ :
Consultez le guide Aider.

OpenCode

OpenCode utilise l’AI SDK (Vercel) en interne. Ajoutez un fournisseur personnalisé dans opencode.json :
Consultez le guide OpenCode.

Goose

Le fournisseur openai intégré à Goose accepte un hôte personnalisé. Goose persiste ces données dans ~/.config/goose/config.yaml :
Pour un fournisseur nommé, déposez plutôt un fichier JSON dans ~/.config/goose/custom_providers/. Consultez le guide Goose.

Pi et omp

Pi utilise un fournisseur personnalisé avec api: openai-completions. omp (oh-my-pi) hérite du même schéma — providers est un mappage indexé par le nom du fournisseur, et les clés sont en camelCase. omp lit ~/.omp/agent/models.yml ; Pi lit ~/.pi/agent/models.json :
Consultez les guides Pi et omp.

Hermes Agent

Hermes Agent se connecte à n’importe quel point de terminaison /v1/chat/completions compatible OpenAI. Il lit ~/.hermes/config.yaml, avec les clés de fournisseur imbriquées sous model: :
Consultez le guide Hermes Agent.

Schéma de configuration universel

Chaque agent ci-dessus suit le même schéma en 3 étapes :
  1. Définissez l’URL de base sur https://api.tokios.com/v1 (OpenAI) ou https://api.tokios.com (Anthropic).
  2. Définissez la clé API sur votre clé sk-tok-….
  3. Définissez le modèle sur le nom de votre déploiement enregistré.
Si votre agent n’est pas répertorié ici mais prend en charge une URL de base personnalisée compatible OpenAI, il fonctionnera presque certainement. Essayez les variables d’environnement universelles :

Compatibilité de l’appel d’outils par moteur

L’appel d’outils nécessite à la fois la prise en charge par l’agent et par le backend. Voici quels moteurs locaux le gèrent :
L’appel d’outils dépend du modèle, et non uniquement du moteur. Un modèle doit être affiné ou invité à émettre une structure tool_calls structurée dans sa réponse. Qwen3-Coder-30B, Llama-3-70B-Instruct et Mistral-7B-Instruct gèrent tous les appels d’outils de manière fiable. Muse Glimmer 30B est spécifiquement entraîné pour cela : invocation d’outils selon des schémas précis, avec récupération en cas d’échec dans les workflows multi-étapes.

Meilleurs modèles locaux pour les agents de codage

Pour DGX Spark (mémoire unifiée 128 Go), Qwen3-Coder-30B à Q4_K_M est le point idéal — il s’intègre facilement, génère rapidement et gère bien les appels d’outils. Pour Strix Halo, utilisez llama.cpp avec Vulkan pour la vitesse de génération de tokens la plus élevée.
DeepSeek-V4-Flash-0731 est le choix actuel de DeepSeek pour les agents de codage. Sa fiche de modèle officielle signale des gains majeurs par rapport à la version de prévisualisation sur Terminal Bench 2.1, DeepSWE et Toolathlon-Verified. Il nécessite encore un hôte multi-appareils. Consultez le guide matériel local, puis validez les appels d’outils avec les paramètres exacts d’exécution, reasoning_effort, de longueur de contexte et d’échantillonnage que vous prévoyez d’utiliser.
Muse Glimmer 30B est l’option qui s’exécute entièrement sur un seul GPU de 24 Go, et Meta l’a entraînée pour l’utilisation d’outils agents — mais ses benchmarks sont rapportés par le fournisseur sans reproduction indépendante pour le moment. Utilisez les paramètres d’échantillonnage propres à Meta (temperature 1.0, top_p 0.95, top_k 64) ; réutiliser des valeurs ajustées pour un autre modèle local est une cause fréquente de dégradation de la sortie.

Un seul point de terminaison les sert tous

Vous n’avez pas besoin de reconfigurer votre modèle lorsque vous changez d’agent. Enregistrez votre déploiement une seule fois dans Tokios, créez une clé sk-tok-…, et dirigez n’importe quel agent vers le même point de terminaison. Passez de Aider à Claude Code en modifiant les variables d’environnement 2 ; votre modèle, votre connecteur et votre déploiement restent identiques.

Démarrage rapide

Configurez un connecteur et enregistrez votre premier déploiement.

Clients compatibles

La matrice complète des clients compatibles avec 39, pas seulement les agents de codage.

Choisissez un modèle local

Sélectionnez le bon modèle pour votre matériel et votre cas d’utilisation.

Clés API

Créez, scopez et faites tourner les clés pour les collègues et les agents.