Skip to main content
OpenCode est un agent de codage basé sur le terminal qui prend en charge des fournisseurs de modèles personnalisés. Ajoutez Tokios en tant que fournisseur dans opencode.json en utilisant le package @ai-sdk/openai-compatible, pointez options.baseURL vers https://api.tokios.com/v1, et listez le nom de votre déploiement Tokios sous models. OpenCode dirige ensuite chaque requête de l’agent via votre tunnel de connecteur privé vers votre modèle local.

​
Prérequis

​
Configurer OpenCode

Ajoutez un bloc de fournisseur Tokios à votre configuration opencode.json. L’emplacement exact du fichier de configuration (projet-local opencode.json par rapport à un chemin de configuration global) et les noms de clés précis (options, npm, models) peuvent varier selon les versions d’OpenCode, alors confirmez-les par rapport au schéma de fournisseur de votre version installée.
opencode.json
Remplacez gemma-tunnel par le nom de déploiement public que vous avez enregistré sur l’onglet Models — et non l’ID de modèle local utilisé par votre backend (Ollama, llama.cpp, vLLM ou LM Studio). Remplacez sk-tok-YOUR_KEY par votre propre clé, et évitez de la committer dans un fichier de configuration partagé ou sous contrôle de version.
options.baseURL doit inclure /v1. Le fournisseur compatible OpenAI d’OpenCode envoie des requêtes par rapport à cette URL, donc une URL de base sans /v1 ne parvient pas à atteindre la surface de l’API Tokios.

​
Choisissez un modèle capable d’utiliser des outils

L’agent d’OpenCode s’appuie sur l’appel d’outils pour lire des fichiers, exécuter des commandes et modifier du code. Tous les modèles locaux ne gèrent pas les appels d’outils de manière fiable — choisissez un déploiement basé sur un modèle avec un bon support d’appel d’outils avant de vous fier à l’agent d’OpenCode pour des modifications réelles. Voir Choisir un modèle local pour comparer les candidats.

​
Dépannage

La clé API envoyée par OpenCode est manquante, mal formée ou a été révoquée. Confirmez que options.apiKey contient la clé sk-tok-… complète sans espaces superflus, et vérifiez son statut dans l’onglet Keys.
La clé de modèle sous models ne correspond pas à un déploiement enregistré. Confirmez qu’elle correspond exactement au nom public sur l’onglet Models — pas à votre ID de modèle local Ollama, llama.cpp, vLLM ou LM Studio.
Le connecteur pour ce déploiement est hors ligne ou atteint sa limite de concurrence. Vérifiez l’onglet Connectors — le connecteur doit s’afficher comme Online, et la machine qui l’exécute doit être toujours active et accessible.

​
Prochaines étapes

Clients compatibles

Consultez l’URL de base et la configuration de la clé pour les autres clients compatibles OpenAI et Anthropic.

Choisissez un modèle local

Comparez les backends et les modèles avant de déployer des workflows agents.