Goose avec un hôte OpenAI personnalisé
Définissez ces quatre variables avant de lancer Goose, et Goose fonctionne avec les modèles Claude, GPT et Grok grâce à votre clé AIGROW.
Vous avez déjà un code ? Utilisez-le sur l’accès API, puis créez une clé.
Shell, avant de lancer goose
export GOOSE_PROVIDER=openai
export OPENAI_HOST=https://aigrow.gg
export OPENAI_API_KEY=ag_your_key_here
export GOOSE_MODEL=claude-opus-5.5Remplacez ag_your_key_here par une clé obtenue sur l’accès API.
Où se trouve le réglage
- Fournisseurs personnalisés, macOS et Linux
~/.config/goose/custom_providers/- Fournisseurs personnalisés, Windows
%APPDATA%\Block\goose\config\custom_providers\
Ou un fournisseur personnalisé
Enregistrez ce fichier sous le nom aigrow.json dans le dossier des fournisseurs personnalisés. Ici, base_url est l’adresse complète des chat completions.
{
"name": "aigrow",
"engine": "openai",
"display_name": "AIGROW",
"api_key_env": "AIGROW_API_KEY",
"base_url": "https://aigrow.gg/v1/chat/completions",
"models": [
{
"name": "claude-opus-5.5",
"context_limit": 1000000
},
{
"name": "grok-4.7",
"context_limit": 500000
}
],
"supports_streaming": true,
"requires_auth": true
}Lancez ensuite une session avec ce fournisseur
Le fichier du fournisseur lit la clé dans AIGROW_API_KEY.
export AIGROW_API_KEY=ag_your_key_here
goose session start --provider aigrowQuel modèle choisir
Saisissez l’identifiant exactement comme il est écrit ici.
- Claude Opus 5.5
claude-opus-5.5 - Le modèle par défaut dans chaque bloc de cette page, et le modèle Claude le moins cher ici par token envoyé et reçu. Contexte : 1 000 000 tokens.
- Grok 4.7
grok-4.7 - Le prix de sortie le plus bas ici. Son contexte fait la moitié de celui des modèles Claude. Contexte : 500 000 tokens.
- GPT-6 Astra
gpt-6-astra - Pour un modèle GPT. Il coûte autant par token que Fable, et plus qu’Opus. Contexte : 1 050 000 tokens.
- Claude Fable 5.1
claude-fable-5.1 - Coûte plus cher par token qu’Opus. Comparez les deux dans le classement du code avant de changer. Contexte : 1 000 000 tokens.
La grille tarifaire indique chaque identifiant et son tarif en crédits, les tarifs de l’API Claude donnent les prix publics, et le classement des modèles pour le code compare les modèles sur des requêtes de programmation.
Vérifier que tout fonctionne
D’abord la clé seule, puis Goose avec cette clé.
La clé
Demandez la liste des modèles. Il faut une clé valide, et cela ne coûte rien.
curl https://aigrow.gg/v1/models -H "Authorization: Bearer ag_your_key_here"{
"object": "list",
"data": [
{ "id": "claude-opus-5.5", "object": "model", ... },
{ "id": "claude-fable-5.1", "object": "model", ... },
{ "id": "gpt-6-astra", "object": "model", ... },
{ "id": "claude-sonnet-5.5", "object": "model", ... },
{ "id": "gpt-6.1-sol", "object": "model", ... },
{ "id": "grok-4.7", "object": "model", ... },
...
],
"has_more": false
}Goose
Exécutez une requête avec le modèle indiqué.
goose run --model claude-opus-5.5 -t "Reply with the word ready"readyEn cas d’échec
D’abord les erreurs propres à Goose, puis les réponses que l’endpoint renvoie à n’importe quel outil.
- 404 à chaque requête
- OPENAI_HOST correspond à la racine, https://aigrow.gg, sans rien après : Goose ajoute lui-même v1/chat/completions. Si vous avez modifié OPENAI_BASE_PATH, remettez-le sur v1/chat/completions.
- 401 No api key passed in
- Goose n’a pas chargé la clé. Il ignore une clé écrite dans config.yaml : exportez donc OPENAI_API_KEY dans le shell ou enregistrez-la depuis Goose Desktop.
- goose configure n’accepte pas l’identifiant du modèle
- goose configure ne propose que les modèles qu’il connaît. Définissez plutôt GOOSE_MODEL, ou ajoutez --model quand vous lancez goose.
- Mon outil affiche une erreur 401 ou d’authentification
- La clé est absente ou mal saisie. Copiez-la de nouveau depuis Accès API sur le tableau de bord, et vérifiez qu’elle est bien transmise comme clé, et non comme nom de modèle. Une clé révoquée provoque la même erreur : créez-en une nouvelle et remplacez-la.
- J’obtiens une erreur 402 ou un message sur le crédit
- Votre solde est vide. Ouvrez Accès API sur le tableau de bord, activez un code ou achetez un autre pack, et la requête suivante passera. Rien d’autre à modifier.
- J’obtiens une erreur 404 ou « Unknown model »
- Le modèle doit être l’un de ceux que l’endpoint propose, par exemple claude-opus-5.5. Les écritures propres aux fournisseurs fonctionnent aussi (claude-opus-5-5, anthropic/claude-opus-5.5), mais un identifiant daté ou tout modèle hors du catalogue est rejeté avant que la requête soit transmise, et rien n’est facturé. Envoyez GET /v1/models avec votre clé pour obtenir la liste à jour, ou consultez les identifiants dans la grille tarifaire.
- Les requêtes sont rejetées avec l’erreur 429
- La capacité de l’endpoint est partagée entre tous les clients : environ 20 requêtes par minute et 4 simultanément. Chaque erreur 429 contient un en-tête retry-after, et les SDK OpenAI et Anthropic attendent ce délai puis réessaient automatiquement. Dans votre propre boucle, attendez le nombre de secondes indiqué ou réduisez le nombre de requêtes simultanées.
- Le modèle est indisponible pour le moment
- Une erreur 404 indiquant que le modèle n’est pas disponible pour le moment signifie qu’il est brièvement hors service chez le fournisseur en amont. Ce n’est pas un problème lié à votre clé ou à votre solde. Réessayez dans un instant ou envoyez la requête à un autre modèle.
- J’obtiens une erreur 502 ou 503
- Un incident passager en amont ou de configuration, sans débit sur votre solde. Réessayez la requête ; si l’échec persiste, contactez-nous via la boutique et nous examinerons le problème.
Ce qui ne fonctionne pas avec AIGROW
Une clé dans config.yaml. Goose la lit dans l’environnement ou dans son trousseau, jamais dans ce fichier.
Recherche web en direct au sein du modèle. Un outil de recherche web envoyé avec une requête reçoit une réponse fondée sur ce que le modèle sait déjà, sans résultats en direct. Un outil qui récupère des pages sur votre propre machine continue de fonctionner.
Tout point d’accès autre que ces trois : /v1/messages, /v1/chat/completions et /v1/models. L’API Responses, les embeddings et le comptage de tokens renvoient une erreur 404.
Les champs de routage tels que models, route, provider et plugins. Ils sont ignorés : une requête va donc toujours au seul modèle qu’elle indique.
Ce que coûte un mois d’utilisation de Goose
L’utilisation de Goose est facturée au token, aux tarifs en crédits de la grille tarifaire. Un agent renvoie toute la conversation à chaque étape : une longue tâche coûte donc plus que son dernier message ne le laisse penser. Le journal d’activité de l’accès API indique le coût de chaque requête.
Questions sur Goose et une API personnalisée
- OPENAI_HOST inclut-il /v1 ?
- Non. OPENAI_HOST vaut https://aigrow.gg, c’est-à-dire la racine, et Goose ajoute v1/chat/completions à partir de OPENAI_BASE_PATH. Un fichier de fournisseur personnalisé fonctionne autrement : son base_url est l’adresse complète des chat completions.
- Puis-je ajouter AIGROW dans Goose Desktop ?
- Oui. Sous Settings > Models > Configure providers, choisissez Add Custom Provider, puis définissez le type sur OpenAI compatible, l’URL de l’API, votre clé et les identifiants de modèle.
- Comment utiliser un modèle que goose configure n’affiche pas ?
- Définissez GOOSE_MODEL avec l’identifiant, par exemple claude-opus-5.5, ou lancez goose run --model suivi de l’identifiant.
Sources : Goose Providers. Consulté le 21 octobre 2026.
Configurer un autre outil
- Claude CodeProtocole Anthropic
Quatre variables d’environnement, dans le shell ou dans settings.json.
- ClineProtocole OpenAI
Le fournisseur OpenAI Compatible, quatre champs dans l’écran des paramètres.
- Roo CodeProtocole OpenAI
Le fournisseur OpenAI Compatible, avec les mêmes champs que dans Cline.
- Kilo CodeProtocole OpenAI
Un fournisseur personnalisé dans l’onglet Providers ; la liste des modèles se remplit toute seule.
- ContinueProtocole OpenAI
Une entrée models dans config.yaml, avec provider openai et un apiBase.
- AiderProtocole OpenAI
OPENAI_API_BASE et OPENAI_API_KEY, puis openai/ avant l’identifiant du modèle.
- OpenCodeProtocole OpenAI
Un bloc provider dans opencode.json et la clé via /connect.
- ZedProtocoles Anthropic et OpenAI
Un fournisseur compatible Anthropic pour Claude, un fournisseur compatible OpenAI pour GPT et Grok.
- Vercel AI SDKProtocoles Anthropic et OpenAI
Le fournisseur OpenAI Compatible pour tous les modèles, ou le fournisseur Anthropic pour Claude.
- OpenAI Agents SDKProtocole OpenAI
Votre propre client AsyncOpenAI, basculé sur chat completions, avec le traçage désactivé.
- LangChainProtocoles Anthropic et OpenAI
ChatOpenAI avec base_url pour tous les modèles, ou ChatAnthropic pour Claude.
Le guide de l’API présente les SDK, curl, les endpoints et les limites de débit.
Collez le bloc : Goose fonctionne alors avec votre crédit.
Achetez un pack de crédits, utilisez le code reçu par e-mail sur l’accès API, créez une clé et placez-la à la place de ag_your_key_here.