Skip to main content
Goose est l’agent de codage open-source de Block sur la machine. Goose ne dispose pas de fournisseur Tokios intégré, mais il prend en charge les fournisseurs personnalisés via un fichier JSON, vous pouvez donc le pointer vers https://api.tokios.com/v1 et accéder à n’importe quel modèle derrière votre connecteur.

​
Prérequis

​
Configurer un fournisseur personnalisé

Créez un fichier de fournisseur personnalisé pour Goose. La configuration des fournisseurs personnalisés a changé au fil des versions de Goose, donc confirmez le schéma JSON exact (noms de champs, clés requises ou optionnelles, et si un tableau models ou une structure différente est attendu) par rapport à votre version installée.
Créez un fichier JSON dans ~/.config/goose/custom_providers/ :
tokios.json
Le fichier nomme une variable d’environnement plutôt que de contenir la clé elle-même, donc exportez-la avant de démarrer Goose :
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 que votre backend (Ollama, llama.cpp, vLLM ou LM Studio) utilise. Parce que api_key_env ne stocke que le nom de la variable, ce fichier est sûr à valider ; la clé n’y entre jamais.
Si les requêtes 404, vérifiez comment votre version de Goose interprète base_url. L’exemple de fournisseur personnalisé de Goose écrit le chemin complet de l’endpoint (.../v1/chat/completions) plutôt que simplement la racine /v1, et les deux formes ne sont pas interchangeables — essayez https://api.tokios.com/v1/chat/completions si https://api.tokios.com/v1 échoue.

​
Alternative : le fournisseur OpenAI intégré

Si vous préférez ne pas ajouter de fichier fournisseur, le fournisseur openai intégré de Goose accepte un hôte personnalisé. Goose les persiste dans ~/.config/goose/config.yaml :
OPENAI_HOST est la racine de l’hôte et OPENAI_BASE_PATH est le chemin de la requête, qui par défaut est v1/chat/completions — le chemin que Tokios sert, donc vous le laissez normalement non défini.

​
Alternative : variable d’environnement

Au lieu d’un fichier fournisseur personnalisé, vous pouvez pointer le client compatible OpenAI de Goose vers Tokios avec la variable d’environnement OPENAI_HOST. Confirmez contre votre version installée si OPENAI_HOST attend l’hôte nu ou le chemin /v1 complet, et s’il nécessite un appairage avec OPENAI_API_KEY pour l’authentification.
Goose traite Anthropic comme un fournisseur distinct de première partie, et une URL de base Anthropic générique n’est pas encore disponible (suivie comme une demande de fonctionnalité ouverte : block/goose#3777). Utilisez l’emplacement du fournisseur compatible OpenAI ci-dessus pour atteindre Tokios.

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

L’agent de Goose 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 soutenu par un modèle disposant d’un solide support pour les appels d’outils avant de vous fier à Goose pour des modifications réelles. Consultez Choisir un modèle par tâche pour obtenir des conseils sur l’adéquation d’un modèle avec le travail de codage agentique.

​
Dépannage

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

​
Prochaines étapes

Démarrage rapide

Configurez votre connecteur, enregistrez un modèle et créez une clé API à partir de zéro.

Choisissez un modèle par tâche

Associez un modèle local au travail de codage agentique avant de le connecter à Goose.