Fournisseurs IA

Les Génies IA de VMark ont besoin d'un fournisseur IA pour générer des suggestions. Vous pouvez utiliser un outil CLI installé localement ou vous connecter directement à une API REST.

Configuration rapide

La façon la plus rapide de démarrer :

1. Ouvrez Paramètres > Intégrations
2. Cliquez sur Détecter pour rechercher les outils CLI installés
3. Si un CLI est trouvé (ex. Claude, Gemini), sélectionnez-le — vous avez terminé
4. Si aucun CLI n'est disponible, choisissez un fournisseur REST, entrez votre clé API et sélectionnez un modèle

Un seul fournisseur peut être actif à la fois.

Fournisseurs CLI

Les fournisseurs CLI utilisent des outils IA installés localement. VMark les exécute en tant que sous-processus et diffuse leur sortie vers l'éditeur.

Fournisseur	Commande CLI	Installation
Claude	claude	Claude Code
Codex	codex	OpenAI Codex CLI
Gemini	gemini	Google Gemini CLI

Comment fonctionne la détection CLI

Cliquez sur Détecter dans Paramètres > Intégrations. VMark parcourt votre $PATH à la recherche de chaque commande CLI et indique leur disponibilité. Si un CLI est trouvé, son bouton radio devient sélectionnable.

Avantages

• Aucune clé API requise — le CLI gère l'authentification avec votre connexion existante
• Nettement moins cher — les outils CLI utilisent votre abonnement (ex. Claude Max, ChatGPT Plus/Pro, Google One AI Premium), qui est un forfait mensuel fixe. Les fournisseurs API REST facturent par jeton et peuvent coûter 10 à 30 fois plus pour une utilisation intensive
• Utilise votre configuration CLI — les préférences de modèle, les prompts système et la facturation sont gérés par le CLI lui-même

Abonnement vs API pour les développeurs

Si vous utilisez également ces outils pour le vibe-coding (Claude Code, Codex CLI, Gemini CLI), le même abonnement couvre à la fois les Génies IA de VMark et vos sessions de codage — sans coût supplémentaire.

Configuration : Claude CLI

1. Installez Claude Code : npm install -g @anthropic-ai/claude-code
2. Exécutez claude une fois dans votre terminal pour vous authentifier
3. Dans VMark, cliquez sur Détecter, puis sélectionnez Claude

Configuration : Gemini CLI

1. Installez Gemini CLI : npm install -g @google/gemini-cli (ou via le dépôt officiel)
2. Exécutez gemini une fois pour vous authentifier avec votre compte Google
3. Dans VMark, cliquez sur Détecter, puis sélectionnez Gemini

Fournisseurs API REST

Les fournisseurs REST se connectent directement aux API cloud (ou locales). Chacun nécessite un endpoint, une clé API et un nom de modèle. Les réponses arrivent d'un seul bloc lorsque la requête se termine — les fournisseurs REST ne diffusent pas les jetons au fil de l'eau ; les fournisseurs CLI, si.

Fournisseur	Endpoint par défaut	Variable d'environnement
Anthropic	https://api.anthropic.com	ANTHROPIC_API_KEY
OpenAI	https://api.openai.com	OPENAI_API_KEY
Compatible OpenAI	(à définir vous-même)	—
Google AI	(intégré)	GOOGLE_API_KEY ou GEMINI_API_KEY
Ollama (API)	http://localhost:11434	—

Champs de configuration

Lorsque vous sélectionnez un fournisseur REST, trois champs apparaissent :

• Point de terminaison API — L'URL de base (masquée pour Google AI, qui utilise un endpoint fixe). Un /v1 final ne pose pas de problème — VMark le normalise afin que le chemin ne soit pas doublé (ex. https://host/v1 et https://host fonctionnent tous les deux)
• Clé API — Votre clé secrète. Elle est conservée dans le magasin d'identifiants de votre système d'exploitation, jamais dans localStorage ni dans un fichier de paramètres en clair — voir Où sont stockées les clés API
• Modèle — L'identifiant du modèle (ex. claude-sonnet-4-5-20250929, gpt-4o, gemini-2.0-flash)

Remplissage automatique par variable d'environnement

VMark lit les variables d'environnement standard depuis l'environnement de son propre processus. Si ANTHROPIC_API_KEY, OPENAI_API_KEY ou GOOGLE_API_KEY / GEMINI_API_KEY (vérifiées dans cet ordre) est défini, le champ de clé API se remplit automatiquement lorsque vous sélectionnez ce fournisseur.

Les variables que VMark voit dépendent de la façon dont il a été lancé. Une clé exportée dans un profil shell tel que ~/.zshrc ou ~/.bashrc :

export ANTHROPIC_API_KEY="sk-ant-..."

n'atteint VMark que si vous lancez l'application depuis ce shell. Lancé depuis le Dock, le Finder, Spotlight ou un lanceur de bureau, VMark ne lit pas votre profil shell, et le champ reste donc vide — collez la clé à la place. Sous Windows, une variable d'environnement utilisateur ou système fonctionne quelle que soit la façon dont VMark est lancé.

Configuration : Anthropic (REST)

1. Obtenez une clé API sur console.anthropic.com
2. Dans VMark Paramètres > Intégrations, sélectionnez Anthropic
3. Collez votre clé API
4. Choisissez un modèle (par défaut : claude-sonnet-4-5-20250929)

Configuration : OpenAI (REST)

1. Obtenez une clé API sur platform.openai.com
2. Dans VMark Paramètres > Intégrations, sélectionnez OpenAI
3. Collez votre clé API
4. Choisissez un modèle (par défaut : gpt-4o)

Configuration : compatible OpenAI (DeepSeek, Groq, OpenRouter, …)

De nombreux fournisseurs parlent le même protocole qu'OpenAI (/v1/chat/completions, authentification Bearer). L'emplacement Compatible OpenAI se connecte à n'importe lequel d'entre eux — DeepSeek, Groq, OpenRouter, Together, Moonshot, une passerelle auto-hébergée, etc. — sans entrée dédiée par fournisseur.

Il ajoute un champ supplémentaire par rapport aux autres fournisseurs REST : un Nom du fournisseur modifiable, afin que la ligne affiche « DeepSeek » (ou ce que vous avez défini) au lieu du libellé générique.

Exemple — DeepSeek :

1. Obtenez une clé API sur platform.deepseek.com
2. Dans VMark Paramètres > Intégrations, sélectionnez Compatible OpenAI
3. Définissez Nom du fournisseur sur DeepSeek (facultatif, purement cosmétique)
4. Définissez Point de terminaison API sur https://api.deepseek.com (un /v1 final ne pose pas de problème — VMark le normalise)
5. Collez votre clé API
6. Définissez Modèle sur deepseek-chat (ou deepseek-reasoner). Saisissez-le directement, ou cliquez sur actualiser pour récupérer la liste des modèles de l'endpoint

L'endpoint est obligatoire — il n'y a pas d'hôte par défaut pour cet emplacement. Utilisez les boutons Tester (⚡) et Tester le modèle (🧪) pour vérifier la connexion avant d'exécuter un génie.

Configuration : Google AI (REST)

1. Obtenez une clé API sur aistudio.google.com
2. Dans VMark Paramètres > Intégrations, sélectionnez Google AI
3. Collez votre clé API
4. Choisissez un modèle (par défaut : gemini-2.0-flash)

Configuration : Ollama API (REST)

Utilisez ceci lorsque vous souhaitez un accès de style REST à une instance Ollama locale, ou lorsqu'Ollama s'exécute sur une autre machine de votre réseau.

1. Assurez-vous qu'Ollama est en cours d'exécution : ollama serve
2. Dans VMark Paramètres > Intégrations, sélectionnez Ollama (API)
3. Définissez l'endpoint sur http://localhost:11434 (ou votre hôte Ollama)
4. Laissez la clé API vide
5. Définissez le modèle sur le nom de votre modèle téléchargé (ex. llama3.2)

Choisir un fournisseur

Situation	Recommandation
Claude Code déjà installé	Claude (CLI) — zéro configuration, utilise votre abonnement
Codex ou Gemini déjà installé	Codex / Gemini (CLI) — utilise votre abonnement
Besoin de confidentialité / hors ligne	Installez Ollama → Ollama (API) à http://localhost:11434
Modèle personnalisé ou auto-hébergé	Ollama (API) avec votre endpoint
DeepSeek / Groq / OpenRouter / toute API compatible OpenAI	Compatible OpenAI — définissez l'endpoint, la clé et le modèle
Option cloud la moins chère	N'importe quel fournisseur CLI — l'abonnement est nettement moins cher que l'API
Pas d'abonnement, usage léger uniquement	Définissez la variable d'env de clé API → fournisseur REST (paiement par jeton)
Besoin de la meilleure qualité de sortie	Claude (CLI) ou Anthropic (REST) avec claude-sonnet-4-5-20250929

Remplacement de modèle par génie

Les génies individuels peuvent remplacer le modèle par défaut du fournisseur en utilisant le champ frontmatter model :

---
name: quick-fix
description: Quick grammar fix
scope: selection
model: claude-haiku-4-5-20251001
---

Cela est utile pour diriger les tâches simples vers des modèles plus rapides/moins chers tout en conservant un modèle puissant par défaut.

Fiabilité et délais d'attente

VMark protège chaque appel au fournisseur afin qu'un CLI bloqué ou une réponse API malformée ne puisse jamais paralyser l'éditeur :

• Délai d'attente du sous-processus CLI : chaque invocation d'un fournisseur CLI s'exécute sous un délai d'attente d'exécution. Si le CLI ne répond pas, VMark annule l'appel, renvoie l'erreur au génie et libère le processus — le pool de threads ne peut pas être bloqué par un sous-processus incontrôlé.
• Sécurité de parsing JSON REST : si un fournisseur REST renvoie une réponse de forme inattendue (page d'erreur HTML, JSON tronqué, dérive de schéma après un changement en amont), VMark renvoie une erreur typée au frontend au lieu de laisser le listener IA attendre indéfiniment. Vous verrez l'erreur dans la bannière de statut du génie avec une option de réessai.
• Jetons d'annulation : les étapes longues de génie ou de workflow peuvent être annulées à tout moment — Annuler dans le sélecteur de génie ou fermer le panneau et la requête en cours s'interrompt proprement.
• Client HTTP partagé : les fournisseurs REST partagent un seul client reqwest avec pool de connexions, de sorte que les exécutions de génie consécutives ne payent pas à chaque fois le coût de la poignée de main TCP/TLS.
• Découverte du PATH sur Windows : sur Windows, VMark lit le PATH complet de l'utilisateur (y compris les entrées uniquement PowerShell) lors de la détection des CLIs, de sorte que les outils installés par l'utilisateur qui fonctionnent dans un terminal fonctionnent également dans VMark.

Où sont stockées les clés API

Les clés API sont conservées dans le magasin d'identifiants du système d'exploitation — Trousseau macOS, Gestionnaire d'identifiants Windows ou Secret Service sous Linux — sous le nom de service app.vmark.secrets, avec une entrée par fournisseur. VMark n'en garde une copie en mémoire que pour la session en cours ; les paramètres de fournisseur enregistrés ne contiennent jamais de clé, et rien n'est écrit dans localStorage. Une clé enregistrée par une ancienne version de VMark dans un fichier de paramètres en clair est déplacée dans le trousseau la première fois que la nouvelle version la charge, et la copie en clair n'est supprimée qu'après que l'écriture dans le trousseau a été relue avec succès.

Si le trousseau refuse une écriture, VMark affiche une notification d'erreur au lieu de garder silencieusement la clé en mémoire. Sur macOS, une version de développement signée ad hoc peut redemander l'accès au trousseau après chaque nouvelle signature ; une version publiée ne le demande qu'une fois.

Notes de sécurité

• Les clés API sont stockées dans le trousseau du système — voir ci-dessus ; elles ne sont jamais écrites dans les fichiers de paramètres de VMark ni dans localStorage
• Les variables d'environnement sont lues lorsque vous sélectionnez un fournisseur et ne remplissent qu'un champ de clé vide
• Les fournisseurs CLI utilisent votre authentification CLI existante — VMark ne voit jamais vos identifiants
• Toutes les requêtes partent directement de votre machine vers le fournisseur — aucun serveur VMark n'est intermédiaire

Dépannage

« Aucun fournisseur IA disponible » — Cliquez sur Détecter pour rechercher des CLIs, ou configurez un fournisseur REST avec une clé API.

Le CLI indique « Introuvable » — Le CLI n'est pas dans votre $PATH. Installez-le ou vérifiez votre profil shell. Sur macOS, les applications GUI peuvent ne pas hériter du $PATH du terminal — essayez d'ajouter le chemin à /etc/paths.d/.

Le CLI est bloqué / pas de réponse — Le délai d'attente d'exécution de VMark annulera l'appel automatiquement ; vous verrez une erreur dans la bannière de statut du génie. Si un CLI particulier dépasse systématiquement le délai, exécutez-le d'abord depuis un terminal pour confirmer qu'il fonctionne là, puis vérifiez s'il nécessite une authentification interactive.

Le fournisseur REST renvoie 401 — Votre clé API est invalide ou expirée. Générez-en une nouvelle depuis la console du fournisseur.

Le fournisseur REST renvoie 429 — Vous avez atteint une limite de débit. Attendez un moment et réessayez, ou passez à un autre fournisseur.

Le fournisseur REST renvoie du JSON tronqué ou inattendu — VMark renvoie une erreur de parsing typée (ex. « list_models returned an unexpected response shape »). Vérifiez l'URL de l'endpoint et que le contrat de l'API correspond au type de fournisseur sélectionné ; certaines passerelles auto-hébergées annoncent des URLs compatibles OpenAI mais livrent un schéma différent.

Réponses lentes — Les fournisseurs CLI ajoutent une surcharge de sous-processus. Pour des réponses plus rapides, utilisez des fournisseurs REST qui se connectent directement. Pour l'option locale la plus rapide, utilisez Ollama avec un petit modèle.

Erreur « Modèle non trouvé » — L'identifiant du modèle ne correspond pas à ce que le fournisseur propose. Consultez la documentation du fournisseur pour les noms de modèles valides.

Voir aussi

• Génies IA — Comment utiliser l'assistance à l'écriture par IA
• Configuration MCP — Intégration IA externe via le protocole MCP